跳至主要內容

Rovo Dev CLI 入门与进阶指南

约 2332 字大约 8 分钟...

2026 年更新：Rovo Dev 免费 Beta 已结束，原先「每日免费 Token」额度模型取消，现需订阅付费的 Rovo Dev Standard（约 20 美元/开发者/月，按积分计费）才能使用，详见文末「订阅与计费」一节。

Rovo Dev CLI 是由 Atlassian 公司（Jira 和 Trello 的母公司）推出的一款强大的 AI 编程助手，它直接集成在你的命令行终端中。你可以用它来编写代码、调试程序、管理项目，全程无需离开终端窗口，从而让你的工作流更加专注和高效。本指南将带你一步步完成安装、配置，并掌握从入门到进阶的核心用法。

第一步：一分钟快速安装

Atlassian CLI (acli) 支持 Windows, macOS 和 Linux。请根据你的操作系统选择对应的安装方式。

Windows 用户

  1. 打开 PowerShell：点击“开始”菜单，输入“PowerShell”，然后选择并打开它。
  2. 下载工具：根据你电脑的处理器架构，复制并粘贴下面对应的命令。绝大多数现代 PC 都使用 x86-64 架构。

    • 适用于绝大多数 Windows 电脑 (x86-64 架构):

      Invoke-WebRequest -Uri "https://acli.atlassian.com/windows/latest/acli_windows_amd64/acli.exe" -OutFile acli.exe

    • 适用于 ARM 架构的 Windows 设备 (如部分 Surface Pro 型号):

      Invoke-WebRequest -Uri "https://acli.atlassian.com/windows/latest/acli_windows_arm64/acli.exe" -OutFile acli.exe

macOS 用户

使用 Homebrew 是最简单的方式（先添加 Atlassian 官方 tap，再安装 acli）：

brew tap atlassian/homebrew-acli
brew install acli

Linux 用户

你可以下载二进制文件并手动安装：

# 下载适用于 amd64 架构的二进制文件
curl -LO https://acli.atlassian.com/linux/latest/acli_linux_amd64/acli

# 赋予执行权限
chmod +x acli

# (可选) 移动到系统路径以便全局调用
sudo mv acli /usr/local/bin/

验证安装

安装完成后，在终端窗口中运行以下命令。如果你能看到一长串帮助信息，就说明一切顺利。

acli --help

第二步：配置全局可用 (Windows 用户)

为了能从电脑的任何位置方便地调用 acli 命令，Windows 用户需要将其所在的文件夹路径添加到系统的 PATH 环境变量中。

  1. 为工具创建一个固定的“家”：新建一个不容易误删的文件夹，例如 C:\tools\acli，然后将刚刚下载的 acli.exe 文件移动进去。
  2. 打开环境变量设置：在 Windows 搜索栏中，输入“编辑系统环境变量”并打开它。
  3. 在弹出的窗口中，点击“环境变量...”按钮。
  4. 在上半部分的“用户变量”区域，找到名为 Path 的变量，选中它，然后点击“编辑...”。
  5. 点击“新建”，然后输入你存放 acli.exe 的文件夹路径（例如 C:\tools\acli）。
  6. 在所有打开的窗口上点击“确定”以保存更改。
  7. 至关重要的一步：关闭当前的 PowerShell 窗口，然后重新打开一个全新的。这一步是为了让 Windows 加载你刚刚的设置。现在，你可以在任何文件夹下输入 acli --version，命令应该可以成功执行了。

第三步：连接你的 Atlassian 账户

在开始使用 AI 功能前，你需要通过一个安全的 API 令牌将工具与你的 Atlassian 账户关联起来。

  1. 生成一个 API 令牌：
    • 访问你的 Atlassian 账户 API 令牌页面：https://id.atlassian.com/manage-profile/security/api-tokens。
    • 如果需要，请先登录。
    • 点击“创建 API 令牌”。
    • 给它起一个容易记住的名字，比如“我的 Rovo CLI”，然后点击“创建”。
    • 重要提示：点击“复制”并把这个令牌保存在一个安全的地方（比如密码管理器）。这个令牌只会出现一次，关闭窗口后你将无法再次查看它。
  2. 在终端中登录：

    • 回到你的终端窗口，运行以下命令：

      acli rovodev auth login

    • 工具会提示你输入 Atlassian 账户的邮箱地址，然后粘贴你刚刚复制的 API 令牌。

现在，你已经成功登录，一切准备就绪！

第四步：开始与你的 AI 助手对话

要开始你的第一个交互式会话，只需运行这个简单的命令：

acli rovodev run

你的终端会变成一个聊天界面，你可以用自然的中文向它提问、让它写代码片段、帮你调试程序，以及完成更多编程任务。

第五步：掌握核心用法

除了基础的交互式对话，Rovo Dev CLI 还提供了丰富的进阶功能来提升效率。

非交互模式

如果你想快速执行单个任务并立即看到结果，可以在 run 命令后直接跟上你的指令。

# 让 AI 为指定文件生成单元测试
acli rovodev run "为 @./src/utils.js 编写单元测试"

引用文件和目录

使用 @ 符号可以轻松地将文件或整个目录作为上下文提供给 AI，让它基于具体代码进行工作。

# 交互模式中，让 AI 解释一个文件
> 解释 @./src/main.js 的功能

# 交互模式中，让 AI 总结一个目录
> 总结 @./src/components/ 目录下所有组件的用途

常用的斜杠命令

在交互模式 (acli rovodev run) 中，你可以使用以下命令来管理会话：

  • /usage：查看当前会话的 Rovo Dev 积分（credits）消耗情况。
  • /clear：清空当前对话的消息历史，开始一个全新的对话。
  • /sessions：列出最近的会话，方便你切换或恢复到之前的对话。
  • /prune：在保留核心上下文的同时，压缩对话历史，以节省 Token 消耗。

第六步：管理 AI 的记忆

Rovo Dev CLI 有一个本地记忆系统，可以帮助它记住关于你项目的特定信息。记忆以 Markdown 文件形式保存，并在交互模式中通过 /memory 系列命令进行管理：

  • 项目记忆：保存在工作目录下的 AGENTS.md（以及 AGENTS.local.md）中，随项目共享。
  • 用户记忆：保存在 ~/.rovodev/AGENTS.md 中，对你所有的会话生效。
  • 同时兼容 CLAUDE.md、.cursorrules 等其他工具的记忆文件格式。

常用的记忆管理命令：

  • /memory：编辑当前目录的项目记忆文件。
  • /memory user：编辑你的用户级记忆文件。
  • /memory init：分析当前项目并自动生成初始记忆内容。
# 在交互模式中编辑当前项目的记忆
> /memory

当你与 AI 对话时，它会自动加载这些记忆，从而提供更贴合你项目实际情况的回答。

第七步：了解订阅与计费（2026 年更新）

重要变化：Rovo Dev 的免费 Beta 已结束，原先基于「每日免费 Token」的额度模型已取消，改为基于积分（credits）的付费订阅。以下为 2026 年的最新情况，最终请以 Atlassian 官方定价 为准。

  • Rovo Dev Standard：约 20 美元 / 开发者 / 月，每位开发者每月包含 2,000 个 Rovo Dev 积分；超出部分按 0.01 美元 / 积分 计费。
  • 没有长期免费档：官方未提供免费层。仅对部分已订阅 Jira Standard / Premium / Enterprise 云版方案、且已在使用 Rovo 的存量客户，可能逐步发放少量每月积分。
  • CLI 需正式付费订阅：Rovo Dev Standard 提供 30 天试用，但 Rovo Dev CLI 在试用期内不可用，需要在正式付费订阅后才能使用（以官方为准）。
  • 积分消耗与模型：不同大语言模型对应不同的「积分倍率」，模型越强消耗越快；可在 CLI 内切换模型。随时用 /usage 查看当前的积分消耗情况。

如果你只是想要一个有免费额度的终端 AI 编程工具，可以改看 Antigravity CLI（agy）（预览期免费）或开源的 opencode（可接免费模型）。注意 Claude Code 同样需要付费订阅，并非免费方案。

参考资料

最近更新: