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 訂閱帳號，自訂地址會蓋過訂閱；想切返官方，移除上面嘅設定就得。

了解更多