# 安裝與第一次設定

> 從下載、第一次打開、登入 Claude／ChatGPT／Gemini、設定免費 API key，到選模型、連接 Telegram／iMessage 的完整步驟。

## 1. 準備

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

## 2. 安裝 app

照[下載頁](https://universebot.si/zh-tw/download/)對應你電腦的步驟安裝。

## 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 只能接一台電腦。