Claude Code 自訂 API 設定

Claude Code 可以透過 TokenHub 的 Anthropic Claude Messages 相容 API 中轉模型請求。本文保留官方安裝方式，並只替換 API key、Base URL 和模型 ID。

本指南使用的 TokenHub endpoint 是 https://us-api.tokenhub.com/v1/messages。

何時使用

適合先在小型倉庫或測試專案中驗證。先讓工具讀檔、解釋程式碼或產生方案，再逐步開啟修改和自動化任務。

安裝或開啟工具

先依照 Claude Code 官方文件 安裝或開啟工具。版本不同時，請以官方文件目前的入口為準。

對於 CLI 工具，先確認可執行檔可用，再加入 TokenHub 憑證：

claude --version

準備 TokenHub 憑證

建立 TokenHub API key，並在 TokenHub 模型列表中選擇一個適合這個工具的模型。

export TOKENHUB_API_KEY="sk-..."

請將金鑰保存在本機 shell、IDE 的密鑰儲存或工具的安全 API key 欄位中，不要提交到程式碼倉庫。

設定 TokenHub 服務商

在工具的模型、供應商、API Keys 或 OpenAI Compatible 設定頁面中填入下列值。

服務商填寫值

設定檔位置

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "model": "claude-sonnet-4",
  "env": {
    "ANTHROPIC_BASE_URL": "__API_BASE_URL__",
    "ANTHROPIC_AUTH_TOKEN": "sk-..."
  }
}

{
  "claudeCode.environmentVariables": [
    {
      "name": "ANTHROPIC_BASE_URL",
      "value": "__API_BASE_URL__"
    },
    {
      "name": "ANTHROPIC_AUTH_TOKEN",
      "value": "sk-..."
    }
  ]
}

如果工具將 chat、edit、apply 和 fast model 分開，第一次測試先全部使用同一個 TokenHub 模型。確認可用後，再依成本、延遲和推理能力拆分。

臨時環境變數只用於排錯

臨時變數適合確認 Key、網路和模型名。驗證通過後，請把同樣的值寫回上方的持久設定。

export TOKENHUB_API_KEY="sk-..."
export ANTHROPIC_BASE_URL="__API_BASE_URL__"
export ANTHROPIC_AUTH_TOKEN="$TOKENHUB_API_KEY"
export ANTHROPIC_MODEL="claude-sonnet-4"

驗證連線

先使用唯讀提示測試，確認模型能讀取上下文且不會改動檔案。成功後再測試編輯、Apply 或 Agent 任務。

閱讀目前專案的 README，請用三句話總結。不要修改任何檔案。

提示成功後，回到 TokenHub 請求記錄確認模型名稱、endpoint、token 用量和計費分組。

常見問題