安裝與第一次設定

1. 準備

  • 一台 Mac（macOS 13 以上）或 Linux（x64）電腦。
  • 至少一個 AI 帳號：Claude 付費訂閱、ChatGPT 付費訂閱，或 Google 帳號。也可以全部都有，每個 agent 各自選。
  • 選用：想多開幾個 agent 又怕額度不夠，可以另外申請 OpenRouter 這類服務的免費 API key，給比較不重要的 agent 用。免費方案可能會拿對話內容訓練模型，機密的事別交給它。
  • 選用：Google Chrome（要讓 agent 操作網頁才需要）。

2. 安裝 app

照下載頁對應你電腦的步驟安裝。

3. 第一次打開：開始畫面

app 會先檢查這台電腦的環境：

  • AI 工具：只要裝你有帳號的那一家。沒裝的話按「複製」拿安裝指令，貼到終端機執行，裝好後回到 app 按「重新檢查」。
    • Claude：裝好後在終端機打 claude，啟動後再打 /login，照瀏覽器指示登入一次。
    • Codex（ChatGPT）：裝好後在開始畫面按「登入 ChatGPT」。如果出現 400 Bad Request: Invalid request，先在同一個瀏覽器打開 chatgpt.com 登入一次，再回 app 按一次。
    • Gemini：裝好後在終端機打 gemini，選「Login with Google」，照瀏覽器指示登入一次。
  • Chrome、沙箱：照畫面提示處理，沒有也能先用。
  • 都好了就按「開始使用」。之後想再看這個畫面（例如後來才裝了另一家），到左下角設定 → 最上面的「AI 工具與登入」。

4. 認識總管

第一次打開會有一個預設的總管（英文介面叫 Coordinator）。直接跟它說你要做什麼。需要的話它會建立隊員，或把工作交給現有的隊員。

5. 替 agent 選模型

在 agent 的「進階設定 → 模型」選 Adapter，再按快選按鈕或直接輸入模型名稱：

  • Claude：haiku（最省）、sonnet、opus（最強、最貴）。
  • Gemini：auto、pro、flash、flash-lite。
  • Codex：按鈕是向 Codex 查到的、你的帳號能用的模型清單。

6. 使用自己申請的 API key（選用）

在 agent 的「進階設定 → 模型」，Adapter 選 openai-compatible，填 Base URL（OpenRouter 是 https://openrouter.ai/api/v1）、API key 和模型名稱。這種 agent 只能聊天和找隊友，不能讀寫檔案。

7. 設定權限與上網

在 agent 的工具設定裡選權限檔位（僅對話／讀取工作區／讀寫工作區／完整權限），需要的話再打開「允許上網搜尋」。這些只有你能在畫面上改。

8. 用手機跟總管對話（選用）

Telegram

  1. 在 Telegram 搜尋 @BotFather，傳 /newbot，照它問的取名字，最後會拿到一串 bot token。這串等於 bot 的密碼，不要給別人。
  2. 在 app 左下角設定 →「通訊軟體」，在 Telegram 欄貼上 token →「儲存憑證」→ 打開「啟用」。
  3. 按「產生配對碼」，把畫面上的 6 位數字（10 分鐘內有效）傳給你的 bot。畫面顯示「已配對」就完成。

iMessage（iPhone，經由第三方服務 Photon）

  1. 到 Photon（photon.codes）註冊、建一個專案，記下 Project ID 和 Project Secret。
  2. 在 Photon 專案的 Users 頁把你的 iPhone 門號加進去，你會收到一個要傳訊息的 iMessage 號碼。
  3. 在 app 的設定 →「通訊軟體」，在 iMessage 欄貼上專案 ID 和密鑰 →「儲存憑證」→「啟用」→「產生配對碼」。
  4. 用 iPhone 把 6 位數字傳給那個號碼，畫面顯示「已配對」就完成。只收 iMessage（藍色泡泡），不收簡訊。

不想用了：設定 →「通訊軟體」→「解除配對」；整個不用就「清除憑證」。同一個 Telegram bot 只能接一台電腦。