Claude Code

兩個環境變數 — ANTHROPIC_BASE_URL 與 ANTHROPIC_AUTH_TOKEN — 無需變更安裝方式，即可讓 Claude Code 改用隨用隨付。

# One terminal session
export ANTHROPIC_BASE_URL=https://api.kunavo.com   # origin, no /v1
export ANTHROPIC_AUTH_TOKEN=sk-kn-...

# Pin models Kunavo serves. Claude Code's default and its opus/sonnet aliases
# follow Anthropic's newest models; the sonnet alias asks for Sonnet 5.5,
# which Kunavo does not serve — unpinned, /model sonnet 404s.
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

claude

逐步操作

1. 在 /app/keys 建立金鑰並複製——金鑰只會顯示一次。
2. 在工作階段中匯出上述變數，或將它們保存於 ~/.claude/settings.json 的 env 區塊中：{"env":{"ANTHROPIC_BASE_URL":"https://api.kunavo.com","ANTHROPIC_AUTH_TOKEN":"sk-kn-...","ANTHROPIC_MODEL":"claude-sonnet-5","ANTHROPIC_DEFAULT_OPUS_MODEL":"claude-opus-5-5","ANTHROPIC_DEFAULT_SONNET_MODEL":"claude-sonnet-5","ANTHROPIC_DEFAULT_HAIKU_MODEL":"claude-haiku-4-5"}}。Anthropic 的文件明確指出，憑證不應放在專案的 .claude/settings.json 中，因為該檔案會被提交至版本庫。
3. 執行 claude 並開啟 Status 分頁。若有一行顯示 Auth token，即表示閘道憑證已啟用；若 Login method 那一行顯示 claude.ai 帳戶，則表示未能讀取該變數。
4. VS Code 擴充功能所需的變數應設在 VS Code 自身使用者設定中的 claudeCode.environmentVariables——擴充功能會在啟動前檢查憑證，因此 ~/.claude/settings.json 雖會傳到啟動的程序，卻不會傳到該檢查程序。

已於 2026年10月3日 根據 Anthropic 的「將 Claude Code 連線至 LLM 閘道」 進行確認。第三方設定會變動；如果這裡的欄位名稱不再與你看到的內容相符，應以該頁面為準，而不是本頁。

除錯用戶端前先驗證

一個請求就能判斷失敗原因是端點、金鑰還是設定檔。如果這裡回傳 JSON，則相同的基礎 URL 與金鑰在 Claude Code 中也能運作。

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/messages \
  -H "Authorization: Bearer sk-kn-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":16,"messages":[{"role":"user","content":"ping"}]}'

欄位中應填入哪個模型 ID

每個文字模型都能以模型 ID 存取——即時清單位於 GET /v1/models，帶有價格的目錄位於模型頁面。費率是每 1M 權杖的美元價格，輸入／輸出。