CCRelay

CCRelay 是一個在本機執行的 AI API 中繼工具，可在 Claude Code、Claude Cowork、Codex 等用戶端與上游模型服務之間完成服務商切換、協定轉換和模型映射。本頁介紹如何將 CoffeeRouter 新增為 CCRelay 的上游服務商，並以 Claude Code 為例完成連線。

準備工作

開始前請確認：

• 已在 CoffeeRouter 控制台的「權杖管理」頁面建立可用權杖。
• 權杖擁有至少一個聊天模型的使用權限，並有可用額度。
• 已安裝 Claude Code；如果只使用 CCRelay 的其他用戶端整合，可按需略過。
• 已安裝 CCRelay。建議從 CCRelay 官方 Releases 下載最新版本。

CCRelay 提供以下安裝方式：

• VS Code / Cursor 擴充套件：下載最新 .vsix，在編輯器中開啟命令面板，執行 Extensions: Install from VSIX...，然後選擇下載的檔案。
• 桌面用戶端：在 Releases 頁面下載與 Windows 或 macOS 及處理器架構相符的安裝程式。

1. 開啟 CCRelay 儀表板

使用 VS Code / Cursor 擴充套件時，可以點擊狀態列中的 CCRelay 圖示，或開啟命令面板並執行 CCRelay: Open Dashboard。使用桌面用戶端時，從系統匣選單選擇 Open Dashboard。

進入 Providers 頁面，然後點擊 Add。

2. 選擇 OpenAI Chat

在新增服務商精靈的「通用端點」區域選擇 OpenAI Chat。不要選擇 OpenAI（完整） 或 Anthropic；本頁設定使用的是 OpenAI Chat Completions 相容介面。

3. 填寫 CoffeeRouter 設定

填寫以下內容：

設定項	填寫內容
顯示名稱	CoffeeRouter
API 金鑰	在 CoffeeRouter「權杖管理」中取得，例如 sk-your-api-key
端點 URL	https://www.coffeerouter.ai/v1
自訂模型清單	建議選擇「是」，並填寫目前權杖允許使用的模型 ID
支援 Claude Cowork / Claude Code / Codex	保持啟用

填寫 API Key 和端點後，CCRelay 會嘗試從 https://www.coffeerouter.ai/v1/models 取得可用模型。啟用自訂模型清單後，可參考左側傳回的模型清單，在右側每行填寫一個需要使用的模型 ID。

模型 ID 必須與 CoffeeRouter 中顯示的名稱完全一致，例如：

claude-sonnet-4-6
gpt-5.4

不要在公開截圖、文件範例或支援工單中填寫真實權杖。

4. 測試並建立 Provider

點擊精靈底部的 測試。測試通過後檢查預覽內容，再點擊 建立。

精靈會為 CoffeeRouter 建立啟用狀態的 Provider，並使用以下關鍵設定：

設定	值	作用
Provider Type	openai_chat	使用 OpenAI Chat Completions 上游格式
Mode	inject	使用 CoffeeRouter 權杖取代用戶端傳入的驗證資訊
Auth Header	authorization	傳送 Authorization: Bearer ...
Base URL	https://www.coffeerouter.ai/v1	與 /chat/completions、/models 拼接

如果啟用了「支援 Claude Cowork / Claude Code / Codex」，精靈還會產生 Claude 與 GPT 模型名稱的映射。建立後可開啟 Provider 的編輯頁面檢查或調整 模型映射（YAML）。

5. 選擇 CoffeeRouter Provider

返回 Providers 頁面，將 CoffeeRouter 設為目前服務商。也可以點擊編輯器狀態列中的 CCRelay 圖示，或執行 CCRelay: Switch Provider 後選擇 CoffeeRouter。

確認 CCRelay 本機服務處於執行狀態。預設監聽位址為 127.0.0.1，預設連接埠為 7575。

6. 設定 Claude Code

開啟 CCRelay 儀表板的 Client configuration 頁面，找到 Claude Code 設定並依頁面提示套用。CCRelay 會將 Claude Code 指向本機 Anthropic 入口：

http://127.0.0.1:7575/anthropic

如果需要手動設定，請編輯 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "ccrelay_apikey_placehold_do_not_need_to_setup_here",
    "ANTHROPIC_BASE_URL": "http://127.0.0.1:7575/anthropic",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1
  }
}

這裡的 ANTHROPIC_AUTH_TOKEN 只是傳給本機 CCRelay 的預留值，不是 CoffeeRouter API Key。真實 CoffeeRouter 權杖應只儲存在 CCRelay Provider 中。

7. 啟動並測試

1. 確認 CCRelay 服務正在執行，目前 Provider 為 CoffeeRouter。
2. 開啟終端機並啟動 Claude Code。
3. 傳送一則簡單訊息，確認能夠正常傳回結果。
4. 如需排查請求，返回 CCRelay 的 Logs 頁面檢視狀態碼、模型映射和上游錯誤。

手動設定參考

如果目前 CCRelay 版本沒有新增精靈，或希望直接維護設定檔，可編輯 ~/.ccrelay/config.yaml：

providers:
  coffeerouter:
    name: "CoffeeRouter"
    baseUrl: "https://www.coffeerouter.ai/v1"
    providerType: "openai_chat"
    mode: "inject"
    apiKey: "sk-your-api-key"
    authHeader: "authorization"
    modelMap:
      - pattern: "claude-opus-*"
        model: "your-coffeerouter-model-id"
      - pattern: "claude-sonnet-*"
        model: "your-coffeerouter-model-id"
      - pattern: "claude-haiku-*"
        model: "your-coffeerouter-model-id"
    enabled: true

defaultProvider: "coffeerouter"

請將 sk-your-api-key 和 your-coffeerouter-model-id 替換為自己的權杖與模型 ID。CCRelay 支援在 apiKey 中使用 ${ENV_VAR} 語法；使用環境變數時，應確認啟動 CCRelay 的程序能夠讀取該變數。

常見問題

安全提示

• ~/.ccrelay/config.yaml 可能包含完整 CoffeeRouter 權杖，請勿上傳、分享或提交至 Git。
• 不要分享帶有權杖的截圖、匯出設定、日誌或終端機輸出；範例統一使用 sk-your-api-key。
• CCRelay 預設僅監聽 127.0.0.1。除非已設定存取控制、防火牆和可信網路，否則不要改為對區域網路或公網監聽。
• 請求日誌可能包含提示詞、回應內容和模型資訊，提交日誌前請先去識別化。

官方資料

• CCRelay 官方網站
• CCRelay GitHub 儲存庫
• CCRelay 最新版本下載
• CCRelay 官方 README：Provider、用戶端與協定轉換