20+ 款 CLI Agent 安装与配置指南

本指南提供 Warpai 原生深度集成的 20+ 款命令行 AI 编码 Agent 在 macOS、Windows 与 Linux 环境下的安装命令、账号鉴权步骤与运行说明。

---

快速参考索引表

---

1. Anthropic Claude Code (claude)

• 安装：
  • macOS / Linux：npm install -g @anthropic-ai/claude-code
  • Windows：npm install -g @anthropic-ai/claude-code
• 鉴权：在终端运行 claude 并完成浏览器 OAuth 网页授权。
• 在 Warpai 中运行：在任意终端标签页直接输入 claude 即可，左侧面板自动点亮 Claude 图标并跟踪其执行/空闲状态。

---

2. OpenAI Codex (codex)

• 安装：
  • macOS / Linux：npm i -g @openai/codex
  • Windows：npm i -g @openai/codex
• 鉴权：运行 codex login 或配置环境变量 export OPENAI_API_KEY="sk-..."。
• 在 Warpai 中运行：直接输入 codex。

---

3. Google Gemini CLI (gemini)

• 安装：npm install -g @google/gemini-cli
• 鉴权：运行 gemini auth login 或配置 export GEMINI_API_KEY="AIzaSy..."。
• 在 Warpai 中运行：输入 gemini。

---

4. Cursor Agent CLI (cursor-agent)

• 安装：
  • macOS：打开 Cursor 桌面端 > 按 Cmd+Shift+P > 选择 Install 'cursor' command in PATH。
  • Windows：将 %LOCALAPPDATA%\Programs\cursor\resources\app\bin 添加到系统 %PATH% 中。
• 鉴权：自动继承本地 Cursor 桌面会话凭据。
• 在 Warpai 中运行：输入 cursor-agent。

---

5. Google Antigravity (agy)

• 安装：
  • macOS / Linux：curl -fsSL https://antigravity.google/install.sh | bash
  • Windows：scoop install agy
• 鉴权：运行 agy login 完成鉴权。
• 在 Warpai 中运行：输入 agy，左侧协作面板底部实时捕获并展示其模型额度与窗口重置倒计时。

---

6. DeepSeek Harness (dsh-tui)

• 安装：
  • macOS / Linux：pip install --upgrade deepseek-harness
  • Windows：pip install --upgrade deepseek-harness
• 鉴权：设置环境变量 export DEEPSEEK_API_KEY="sk-..."（Windows PowerShell 下为 $env:DEEPSEEK_API_KEY="..."）。
• 在 Warpai 中运行：在任意终端窗格输入 dsh-tui。

---

7. Qoder 与 QoderCN (qoder, qodercn)

• 国际版：curl -fsSL https://install.qoder.com/install.sh | bash
• 国内专版 (QoderCN)：curl -fsSL https://install.qoder.cn/install.sh | bash
• 鉴权：qoder login 或 qodercn login。
• 在 Warpai 中运行：Warpai 将其识别为独立客户端，在设置中提供独立开关。

---

8. Mistral Vibe (vibe)

• 安装：pip install --upgrade mistral-vibe
• 鉴权：export MISTRAL_API_KEY="your-key"
• 在 Warpai 中运行：输入 vibe。

---

9. Block Goose (goose)

• 安装：从官方 GitHub Releases 获取对应系统的预编译包。
• 在 Warpai 中运行：输入 goose session 开启交互。

---

10. 更多已适配的命令行 Agent (10-20)

• Hermes Agent (hermes)：pip install hermes-agent → export OPENAI_API_KEY="..." → 运行 hermes。
• xAI Grok Build (grok)：npm i -g @xai/grok-cli → 运行 grok login → 运行 grok。
• GitHub Copilot CLI (copilot)：gh extension install github/gh-copilot → gh auth login → 运行 copilot。
• Pi CLI (pi)：npm i -g @pi-dev/cli → pi login → 运行 pi。
• oh-my-pi (omp)：npm i -g oh-my-pi → omp auth → 运行 omp。
• OpenCode CLI (opencode)：pip install opencode-cli → opencode auth → 运行 opencode。
• Amp / Amplified (amp)：npm i -g @ampt/cli → amp login → 运行 amp。
• Auggie AI Agent (auggie)：pip install auggie-agent → auggie login → 运行 auggie。
• Droid Coding Agent (droid)：npm i -g @droid-ai/cli → droid auth → 运行 droid。
• Trae CLI (trae)：通过 Trae IDE 安装包内置提取并直接调用。