設定第一個代理

從新安裝到工作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. 核實

困在這一步? 參見本頁下方的故障排除部分。

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。