Claude Code 串接 BazaarLink：設定教學

Claude Code 可以透過更換 base URL 與 API key 使用 BazaarLink。以下路徑會連到 BazaarLink 相容 Anthropic 的 Messages endpoint。

1. 設定環境變數

啟動 Claude Code 前先匯出這些變數。ANTHROPIC_AUTH_TOKEN 會作為 Authorization token 傳送；請留在 shell 環境，不要提交。

1
2
3
4
5
export ANTHROPIC_BASE_URL="https://api.bazaarlink.ai/v1"
export ANTHROPIC_AUTH_TOKEN="your-bazaarlink-api-key"
export ANTHROPIC_MODEL="openai/gpt-5.6-luna"
export ANTHROPIC_SMALL_FAST_MODEL="anthropic/claude-haiku-4.5"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

2. 改用 settings.json 設定

如果你偏好持久的 Claude Code 設定，請把相同值放進使用者 settings 檔案。只在自己的機器上把 placeholder 換成真正的 BazaarLink 金鑰。

1
2
3
4
5
6
7
8
9
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.bazaarlink.ai/v1",
    "ANTHROPIC_AUTH_TOKEN": "your-bazaarlink-api-key",
    "ANTHROPIC_MODEL": "openai/gpt-5.6-luna",
    "ANTHROPIC_SMALL_FAST_MODEL": "anthropic/claude-haiku-4.5",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  }
}

3. 驗證請求路徑

開始較長的 Claude Code 工作階段前，先執行這個小型 Messages 請求。回應中的 model 與 stop reason 表示設定的 base URL 和金鑰已抵達 BazaarLink；接著在 BazaarLink Logs 頁面確認請求。

1
2
3
4
5
6
7
8
curl -sS "$ANTHROPIC_BASE_URL/messages"   -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN"   -H "anthropic-version: 2023-06-01"   -H "content-type: application/json"   -d '{
    "model": "openai/gpt-5.6-luna",
    "max_tokens": 32,
    "messages": [{"role": "user", "content": "Reply with OK"}]
  }' | jq '{id, model, stop_reason}'

# After Claude Code runs, confirm the same request in:
# https://bazaarlink.ai/logs

4. 常見錯誤

401 Unauthorized

症狀：Claude Code 或 curl 檢查回報驗證錯誤。原因：ANTHROPIC_AUTH_TOKEN 遺漏、拼錯，或修改後沒有重新啟動 shell。修正：填入 BazaarLink API key，確認請求送出 Authorization: Bearer，並從同一個 shell 啟動 Claude Code。

404 model_not_found

症狀：請求已抵達 gateway，但選用的模型被拒絕。原因：ANTHROPIC_MODEL 或 ANTHROPIC_SMALL_FAST_MODEL 不是目前 /models 回應中的完整 ID。修正：取得 https://api.bazaarlink.ai/v1/models，逐字複製 ID，包含 provider 前綴與標點。

Base URL 缺少 /v1

症狀：請求回傳 route 404，或流量仍送往 Anthropic 而不是 BazaarLink。原因：值缺少 /v1、重複包含 /messages，或指向其他 host。修正：將 ANTHROPIC_BASE_URL 設為 https://api.bazaarlink.ai/v1；Claude Code 會附加 /messages。

5. 選擇模型

請以即時 /models endpoint 作為真實來源。以下是 brief 中的三個有效範例；將完整的 provider/model ID 複製到 ANTHROPIC_MODEL 或 ANTHROPIC_SMALL_FAST_MODEL。

1
2
3
openai/gpt-5.6-luna
anthropic/claude-haiku-4.5
deepseek/deepseek-v4.1-flash