设置第一个代理

从新安装到工作AI代理。大多数初学者失手的两个部分位于顶端:AgentsRoom如何与AI CLI相接，如何签入。

AgentsRoom 如何工作（请先阅读）

AgentsRoom 是驾驶舱。AI CLI（Claude Code、Codex、OpenCode、Antigravity、Aider、Grok Build、Mistral Vibe、Kimi Code）是引擎。您通过各自的命令登录引擎一次，然后 AgentsRoom 以可视化方式驱动它们。AgentsRoom 从不存储或查看您的令牌、API 密钥或 ChatGPT 密码：这些信息保存在每个 CLI 自己的安全存储中。

设计上，AgentsRoom 内没有“登录 ChatGPT”或“登录 Anthropic”按钮。登录在您在下面第 0 步中安装的 CLI 中。

在你开始之前

✓Windows 10 及以上、macOS 14 及以上（Sonoma），或较新的 64 位 Linux 发行版
✓
至少安装一个 AI 编码 CLI（Claude、Codex、OpenCode、Antigravity CLI、Aider、Grok Build、Mistral Vibe 或 Kimi Code）
npm install -g @anthropic-ai/claude-code
✓您选择的提供商的有效订阅或 API 密钥

第0步:安装并签名到您的AI引擎

选择一个提供商开始（您可以稍后添加更多）。对于每一个：安装 CLI，运行一次以登录，验证其工作。然后跳到第 1 步。

点击一个提供者来扩展其设置步骤 .

Claude (Anthropic)建议首次使用

与

Claude Pro、Claude Max 或 Anthropic API 密钥。

1. 安装

npm install -g @anthropic-ai/claude-code

2. 签入

在任何终端中运行 claude 一次。浏览器窗口打开，使用您的 Anthropic 帐户登录。

3. 核实

运行上面的安装命令，然后在终端中单独运行 CLI 的名称（例如，输入“claude”并按回车）。您应该会看到一个欢迎提示。输入“hello”并按回车：如果您得到答案，您就可以在 AgentsRoom 中使用它了。

Codex (OpenAI / ChatGPT)使用您的 ChatGPT 帐户

与

ChatGPT Plus、Pro、Team 或 Enterprise，或 OpenAI API 密钥。

1. 安装

npm install -g @openai/codex

2. 签入

在任何终端中运行 codex 一次。浏览器窗口打开。使用您的 ChatGPT 帐户登录，与您在 chatgpt.com 上使用的相同。

3. 核实

Antigravity (Google)提供免费层

与

一个Google账户（浏览器登录）。提供慷慨的免费层。

1. 安装

curl -fsSL https://antigravity.google/cli/install.sh | bash

2. 签入

在任意终端运行一次antigravity。浏览器窗口会打开以进行Google登录。

3. 核实

OpenCode带上自己的供货商

与

您配置的任何提供商：Anthropic、OpenAI、OpenRouter 等。

1. 安装

curl -fsSL https://opencode.ai/install | bash

2. 签入

运行 Opencode 认证登录并跟踪提示以添加提供者密钥 .

3. 核实

Aider电力用户

与

任何通过API key(Anthropic,OpenAI,DeepSeek等)提供商。

1. 安装

python -m pip install -U --upgrade-strategy only-if-needed aider-chat

2. 签入

没有登录命令。将您的 API 密钥设置为 shell 配置文件中的环境变量，例如：export ANTHROPIC_API_KEY=sk-...

3. 核实

Grok Build (xAI)256K 上下文

与

一个 xAI 账户（浏览器登录）或用于无头模式的 Grok API key。

1. 安装

curl -fsSL https://x.ai/cli/install.sh | bash

2. 签入

在任意终端中运行一次 grok。会打开一个浏览器窗口进行 xAI 登录。如需无头模式，请改为设置 GROK_CODE_XAI_API_KEY 环境变量。

3. 核实

Mistral Vibe欧洲模型

与

一个 Mistral 账户（Pro 或 Team）或 Mistral API key。

1. 安装

curl -LsSf https://astral.sh/uv/install.sh | sh; . "$HOME/.local/bin/env" 2>/dev/null; uv tool install mistral-vibe

2. 签入

运行一次 vibe --setup 以保存你的 Mistral API key，然后运行 vibe 启动。配置保存在 ~/.vibe/config.toml 中。

3. 核实

Kimi (Moonshot AI)最高 1M 上下文

与

一个 Kimi 账号（浏览器登录）或 Moonshot AI 开放平台的 API 密钥。

1. 安装

curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash

2. 签入

在任意终端运行一次 kimi，然后输入 /login 使用 Kimi 账号登录。配置保存在 ~/.kimi-code。

3. 核实

Amp (Sourcegraph)只有模式，没有模型

与

一个 Amp 账号（浏览器登录）或一个 AMP_API_KEY 令牌。

1. 安装

curl -fsSL https://ampcode.com/install.sh | bash

2. 签入

在任意终端运行一次 amp login 即可登录。设置保存在 ~/.config/amp。

3. 核实

oh-my-pi60+ 后端

与

你已经在付费的服务：它可以登录 Anthropic、OpenAI、Google、xAI、Z.ai、DeepSeek 等，也接受普通的 API 密钥。

1. 安装

curl -fsSL https://omp.sh/install | sh

2. 签入

运行一次 omp，然后用 /login 连接一个提供商。配置保存在 ~/.omp。

3. 核实

Freebuff无需密钥

与

无需订阅。该服务免费，靠回合之间显示的文字广告维持运营。

1. 安装

npm install -g freebuff

2. 签入

在你的项目中运行 freebuff。如果想绑定 Codebuff 账号，可以使用 freebuff login 命令。

3. 核实

困在这一步? 参见本页下方的故障排除部分。

1个

下载并安装 AgentsRoom

下载适用于您操作系统的安装程序：macOS 上的 .dmg、Windows 上的 .exe，或 Linux 上的 AppImage。打开它，按照安装步骤操作，然后启动 AgentsRoom。

Tip: AgentsRoom 自动检查更新。当有新版本可用时，您将收到通知。

2个

创建您的第一个工程

点击侧边栏中的 + 按钮，选择你机器上的任意文件夹，你的 AI 代理就会在这里工作。为项目命名，并把它分配到一个区域。

Tip: 每个项目对应一个真实的文件夹。代理会在该目录下运行你所选提供商的 CLI，就和你在终端里手动运行一样。

3个

添加您的第一个代理

在您的项目中，点击添加代理。选择一个角色（Fullstack 是一个不错的开始），然后选择一个提供商（您在第 0 步中设置的引擎），然后选择一个模型（推荐使用 Sonnet for Claude）。可选地编写初始提示并点击启动。终端打开并为您运行 CLI。

Tip: 如果终端外观为空或显示登录屏幕，则从第0步起的CLI尚未签名。打开正则终端，运行 Claude 或 codex (或您的提供者的命令)一次，完成登录，然后回来。

页:1

看着它工作

终端会实时显示输出：读取的每一个文件，做出的每一处修改。状态也会随之变化：思考中、编码中、已完成。任务结束时你会收到桌面通知。

Tip: 你可以同时启动多个代理，每个代理都有自己的终端，各自独立工作。

页:1

自定义您的设置

直接从AgentsRoom编辑CLAUDE.md，为代理提供更好的上下文。更改模型，调整权限，配置钩子。添加更多具有不同角色或提供者的代理。

Tip: Opus 用于架构。Sonnet 用于开发。Haiku 用于快速任务，如测试。

提示和诡计

1.使用 Opus 进行架构决策，Sonnet 用于日常编码，Haiku 用于快速任务

2.按地区(工作、个人、边项目)分列的集体项目

3.从 AgentsRoom 编辑 CLAUDE.md 以为代理提供更好的项目上下文

4.启用桌面通知，以便在代理工作时您可以多任务处理

5.从每个项目一个代理开始，随你舒服多加一个

解决问题

我的代理终端看起来是空的或者卡住了

大多数情况下是因为 CLI 尚未登录。打开您的终端（macOS 上的 Terminal、Windows 上的 PowerShell 或 Windows Terminal、Linux 上您所用的终端模拟器），单独运行 CLI 的命令（claude、codex、antigravity、opencode），在浏览器中完成登录，然后返回 AgentsRoom 并重新启动该代理。AgentsRoom 没有自己的登录界面：身份验证由 CLI 处理。

命令未找到 : claude (或 codex, antigravity等)

CLI 未安装，或您的 shell PATH 未识别它。重新运行上面第 0 步中的安装命令。如果您使用 nvm，请使用您日常使用的 Node 版本安装 CLI，否则在 AgentsRoom 启动时二进制文件将不在 PATH 中。

我在AgentsRoom中看不到登录ChatGPT或Claude的按钮

这是设计使然。AgentsRoom是一个基于CLI的用户界面，从不直接处理您的凭据。登录是在CLI内部完成的（在终端中运行claude或codex），然后AgentsRoom使用该会话。这使得AgentsRoom比拦截您的令牌的工具更安全。

代理一直停在“思考中”

检查您的订阅或API密钥是否对所选提供商有效。尝试直接在终端中运行CLI以查看真实的错误消息：Claude或OpenAI有时会静默限制或过期会话。

没有在侧边栏显示工程

确保在创建项目时选择了有效的文件夹。文件夹必须存在于磁盘上。如果项目已添加但尚未可见，请重新启动AgentsRoom。

我安装了CLI，但AgentsRoom仍然说"没有找到命令"

AgentsRoom继承自您的登录shell的PATH，而不是您的交互式终端。完全退出AgentsRoom，打开一个新的终端，验证CLI是否可以从新的shell会话中调用（which claude），然后重新启动AgentsRoom。