GetCheapAI

在 Claude Code 中使用 API 中轉站

透過環境變數或 settings.json 將 Claude Code 指向自訂 API 位址。

3 分鐘閱讀

Claude Code 支援把請求傳送到自訂的 API 位址，只需設定對應的環境變數或寫入設定檔。本文介紹如何把 Claude Code 指向一個相容 Anthropic 介面的 API 中轉站。

準備資訊

在開始前，從你使用的 API 平台取得以下資訊：

  • API 位址（Base URL）：平台提供的介面根位址
  • API 金鑰（Key）：用於驗證的權杖
  • 模型名稱：平台支援、且你打算使用的模型識別碼

方法一：環境變數

在終端機中設定以下環境變數（可寫入 ~/.zshrc 或 ~/.bashrc 以便長期生效）：

export ANTHROPIC_BASE_URL="https://example.com"   # 替換為平台提供的 API 位址
export ANTHROPIC_AUTH_TOKEN="your-key"            # 替換為你的 API 金鑰
export ANTHROPIC_MODEL="your-model-name"          # 替換為平台支援的模型名稱

設定後重新開啟終端機，再執行 claude 即可生效。

方法二：settings.json

也可以寫入 Claude Code 的設定檔 ~/.claude/settings.json（全域），或專案內的 .claude/settings.json：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://example.com",
    "ANTHROPIC_AUTH_TOKEN": "your-key",
    "ANTHROPIC_MODEL": "your-model-name"
  }
}

當設定中包含金鑰時，建議使用不納入版本控制的 .claude/settings.local.json。

常見問題

  • 出現 404：部分服務對結尾斜線敏感，可嘗試為 API 位址加上或去掉末尾的 /。
  • 模型名稱不符：Claude Code 不會自動轉換模型名稱，請設定為平台能識別的名稱。
  • 圖形介面不生效：從 Dock 或捷徑啟動的圖形介面應用程式，不會讀取在終端機裡設定的環境變數。
  • 與訂閱衝突：若同時登入了 Claude 訂閱帳號，自訂位址會覆蓋訂閱；如需切回官方，移除上述設定即可。

了解更多