在 Claude Code 裡使用
安裝 CLI、把 ANTHROPIC_BASE_URL 指向 OLETOKEN、指定模型;含 VS Code 外掛與常見錯誤處理。
Claude Code 是 Anthropic 的程式開發代理(CLI 加上 VS Code 擴充套件),使用 Anthropic Messages 協議。把它指向 OLETOKEN,就會使用你的 OLETOKEN 金鑰與模型額度——不需要 Anthropic 帳戶。
開始之前
設定
設定放在 ~/.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 |
| 404 | ANTHROPIC_BASE_URL 帶了 /v1(或更長的路徑)——只保留主機位址 |
| 找不到模型(Model not found) | ANTHROPIC_MODEL 不是本站上架的模型;請從模型市場複製 ID |
| 餘額不足(Insufficient balance) | 先儲值 |
| 想臨時切換模型 | 在 session 中執行 /model |
為每個用途各準備一把金鑰(一把給 CLI、一把給編輯器)並設定消費上限,這樣即使外洩,損失也只限於該把金鑰的額度。

