在 Claude Code 裡使用

安裝 CLI、把 ANTHROPIC_BASE_URL 指向 OLETOKEN、指定模型;含 VS Code 外掛與常見錯誤處理。

Claude Code 是 Anthropic 的程式開發代理(CLI 加上 VS Code 擴充套件),使用 Anthropic Messages 協議。把它指向 OLETOKEN,就會使用你的 OLETOKEN 金鑰與模型額度——不需要 Anthropic 帳戶。

開始之前

  1. 你已建立 API 金鑰並保存完整金鑰。
  2. 你已從模型市場挑選一個 Claude 模型 ID(例如 claude-sonnet-5)。
  3. 已安裝 Node.js 與 npm。

設定

設定放在 ~/.claude/settings.json 的 env 區塊。CLI 與 VS Code 擴充套件共用這份檔案,設定一次兩邊都適用——而且比在 shell 匯出環境變數更可靠,因為 VS Code 不一定會繼承你的 shell 環境:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://<your-base-url>",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-5"
  }
}
變數含義
ANTHROPIC_BASE_URL只填主機位址,不要加 /v1——CLI 會自己接上 /v1/messages,多寫會回 404
ANTHROPIC_AUTH_TOKEN你的 OLETOKEN 金鑰,以 Authorization: Bearer 送出
ANTHROPIC_MODEL預設模型 ID
ANTHROPIC_DEFAULT_HAIKU_MODEL輕量任務(產生標題等)使用的模型;指向同一個模型可避免閘道上沒有 haiku 模型時出現 404

安裝並啟動:

npm i -g @anthropic-ai/claude-code
claude

API 金鑰頁上的**「快速介接」**彈窗提供同一份設定指令碼下載,金鑰、模型與 Base URL 都已填好。

也可以用環境變數

如果你不想動 settings.json,可以在 shell 設定檔(macOS 通常是 ~/.zshrc,Linux 是 ~/.bashrc)匯出同樣的變數,再重新開啟終端機:

export ANTHROPIC_BASE_URL="https://<your-base-url>"
export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY"
export ANTHROPIC_MODEL="claude-sonnet-5"

兩者都設定時,以 ~/.claude/settings.json 的 env 區塊為準。

疑難排解

現象原因與處理
401金鑰錯誤或已停用;確認它是 OLETOKEN 金鑰,且放在 ANTHROPIC_AUTH_TOKEN
404ANTHROPIC_BASE_URL 帶了 /v1(或更長的路徑)——只保留主機位址
找不到模型(Model not found)ANTHROPIC_MODEL 不是本站上架的模型;請從模型市場複製 ID
餘額不足(Insufficient balance)先儲值
想臨時切換模型在 session 中執行 /model

為每個用途各準備一把金鑰(一把給 CLI、一把給編輯器)並設定消費上限,這樣即使外洩,損失也只限於該把金鑰的額度。