CC-Hub

使用 CC-Hub 管理和切換 CoffeeRouter 的 Claude Code 服務商、模型、全域與專案設定。

接入規則

CoffeeRouter 透過 Anthropic Messages 相容介面連接 Claude Code，CC-Hub 中應填寫：

設定項填寫內容
Provider IDcoffeerouter
Provider NameCoffeeRouter
Base URLhttps://www.coffeerouter.ai
API KeyCoffeeRouter 權杖，例如 sk-your-api-key
Models目前權杖允許使用的完整 Claude 模型 ID

建議只加入目前權杖明確支援的 Claude / Anthropic 相容聊天模型。其他模型只有在確認 CoffeeRouter 的 Anthropic Messages 相容呼叫可用後再加入。

準備工作

開始前請確認：

  • 已安裝 Node.js 和 npm。
  • 已安裝 Claude Code，並且至少執行過一次。
  • 已登入 CoffeeRouter，在「權杖管理」頁面建立可用權杖。
  • 已確認權杖允許使用的準確模型 ID；CC-Hub 不會自動取得 CoffeeRouter 模型清單。

1. 安裝並首次執行 CC-Hub

在 PowerShell、Windows Terminal 或 macOS/Linux 終端中執行：

npm install -g cc-hub
cc-hub

如果不想全域安裝，也可以直接執行：

npx cc-hub

首次執行後，CC-Hub 會建立設定檔：

~/.cc-hub/config.json

Windows 中 ~ 通常代表 C:\Users\您的使用者名稱。

安裝並首次執行 CC-Hub

2. 新增 CoffeeRouter Provider

關閉 CC-Hub，使用文字編輯器開啟 ~/.cc-hub/config.json，加入 CoffeeRouter Provider。該檔案支援 JSON5 註解和尾隨逗號。

{
  "providers": [
    {
      "id": "coffeerouter",
      "name": "CoffeeRouter",
      "baseUrl": "https://www.coffeerouter.ai",
      "apiKey": "sk-your-api-key",
      "models": [
        "your-claude-sonnet-model-id",
        "your-claude-opus-model-id"
      ]
    }
  ]
}

請把範例中的 sk-your-api-key 替換為 CoffeeRouter 權杖，並把模型 ID 替換為權杖管理頁顯示的準確名稱。範例名稱不代表目前權杖一定可用。

編輯 CoffeeRouter Provider 設定

3. 選擇並啟用模型

儲存設定後重新執行：

cc-hub

在終端介面中：

  1. 使用 ↑、↓ 選擇 CoffeeRouter 下的模型。
  2. 按 Enter 啟用模型。
  3. 看到切換成功提示後退出 CC-Hub。

CC-Hub 會把 Base URL、API Key 和模型 ID 寫入目前選取的 Claude Code 設定範圍。重新啟動 Claude Code 後，新設定才會用於新的工作階段。

選擇並啟用 CoffeeRouter 模型

4. 選擇全域或專案設定

按 Tab 可以在 Global 和 Local 範圍之間切換：

範圍CC-Hub 寫入位置適用情境
Global~/.claude/settings.json作為目前使用者的預設 Claude Code 設定
Local目前目錄下的 .claude/settings.local.json僅為某個專案覆寫全域設定

使用 Local 前，應先在終端進入目標專案目錄再啟動 cc-hub。Claude Code 的專案設定可能覆寫全域設定；如果切換後未生效，請確認 CC-Hub 目前範圍和啟動目錄。

切換 Global 與 Local 設定範圍

5. 按情境對應模型

在 CC-Hub 中按 s 開啟情境對應。可以分別為以下用途指定模型：

  • Opus
  • Sonnet
  • Haiku
  • Subagent

使用方向鍵選擇情境和模型，按 Enter 儲存，按 Esc 取消。CC-Hub 會分別寫入 ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL 和 CLAUDE_CODE_SUBAGENT_MODEL。

設定情境模型對應

CC-Hub 會修改什麼

啟用模型後，CC-Hub 會在選定範圍的 Claude Code 設定中寫入類似以下內容：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-your-api-key",
    "ANTHROPIC_BASE_URL": "https://www.coffeerouter.ai",
    "ANTHROPIC_MODEL": "your-claude-model-id"
  }
}

如果原設定使用 ANTHROPIC_API_KEY，CC-Hub 會盡量沿用該驗證欄位；沒有既有欄位時，預設使用 ANTHROPIC_AUTH_TOKEN。寫入前建議備份已有 Claude Code 設定，尤其是檔案中還包含其他自訂設定時。

安全提示

常見問題

為什麼 Base URL 不帶 /v1？

CC-Hub 把該地址寫入 ANTHROPIC_BASE_URL，Claude Code 會自行請求 Anthropic Messages 路徑。填寫站點根地址可以避免形成重複的 /v1/v1/messages。

啟動後為什麼沒有 CoffeeRouter 或模型？

CC-Hub 不會自動取得服務商和模型。請檢查 ~/.cc-hub/config.json 的 JSON5 格式、Provider 欄位和模型陣列，儲存後重新啟動 CC-Hub。

切換成功後 Claude Code 為什麼仍使用舊模型？

完全退出並重新開啟 Claude Code，然後確認 CC-Hub 目前選擇的是 Global 還是 Local。Local 設定會按專案生效，並可能覆寫 Global 設定。

為什麼出現 401 或驗證失敗？

檢查權杖是否複製完整、是否啟用、是否過期或額度不足，並確認 IP 白名單等限制允許目前裝置存取。還應檢查系統或 Claude 設定中是否殘留互相衝突的 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_API_KEY。

為什麼出現 404 或 /v1/v1/messages？

將 baseUrl 改為 https://www.coffeerouter.ai，刪除末尾的 /v1、/messages 和多餘的斜線，然後重新選擇模型並重新啟動 Claude Code。

如何撤銷或更換權杖？

先在 CoffeeRouter 控制台撤銷舊權杖，再更新 ~/.cc-hub/config.json 中的 apiKey 並重新啟用模型。CC-Hub 中按 d 只會從它的設定中刪除模型，不會撤銷 CoffeeRouter 權杖。

官方資料