WRouter

繁體中文

English

繁體中文

English

主題

Claude Code ​

Claude Code 是 Anthropic 官方的命令列程式設計代理。通過 WRouter，你可以用一把金鑰同時排程 Claude 全系與 GPT、Gemini 等模型。

前置要求 ​

項要求
Claude Code≥ 1.0.0
Node.js≥ 18（僅在通過 npm 安裝時）
WRouter一把可用的 sk- 開頭 Token，參見 API Token 管理

安裝 ​

bash
# macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash

# 或通過 npm
npm i -g @anthropic-ai/claude-code

# 驗證
claude --version

配置 ​

Claude Code 通過 4 個環境變數與 WRouter 聯通：

變數必填作用
ANTHROPIC_BASE_URL✓WRouter 的 Anthropic 相容端點
ANTHROPIC_AUTH_TOKEN✓WRouter 的 sk- Token
ANTHROPIC_MODEL預設對話模型
ANTHROPIC_SMALL_FAST_MODEL小任務/補全使用的次級模型

macOS / Linux (zsh / bash) ​

加入 ~/.zshrc 或 ~/.bashrc：

bash
export ANTHROPIC_BASE_URL="https://wrouter.ai"
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
export ANTHROPIC_MODEL="claude-sonnet-4-6"
export ANTHROPIC_SMALL_FAST_MODEL="claude-haiku-4-5"

執行 source ~/.zshrc 立即生效。

Windows (PowerShell) ​

powershell
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://wrouter.ai", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-xxxx...", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-4-6", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_SMALL_FAST_MODEL", "claude-haiku-4-5", "User")

新開終端生效。

配置檔案方式（跨平臺、可版本控制） ​

編輯 ~/.claude/settings.json：

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://wrouter.ai",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxx...",
    "ANTHROPIC_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_SMALL_FAST_MODEL": "claude-haiku-4-5"
  }
}

注意：ANTHROPIC_AUTH_TOKEN 而非 ANTHROPIC_API_KEY。後者保留給官方端點登入態。

驗證 ​

bash
claude

啟動後輸入 /status，應看到：

Model:        claude-sonnet-4-6
Endpoint:     https://wrouter.ai
Status:       ✓ Connected

發起一次測試呼叫：

> List files in the current directory

期望：Claude Code 呼叫 LS 工具並返回目錄列表。

推薦模型 ​

模型適用場景說明
claude-sonnet-4-6主力日常速度與質量平衡，推薦設為 ANTHROPIC_MODEL
claude-fable-5最難問題、旗艦質量Anthropic 最新頂級模型
claude-opus-4-8複雜重構、深度推理單價高，建議按需切換
claude-haiku-4-5摘要、命名、補全設為 ANTHROPIC_SMALL_FAST_MODEL 可顯著降本
gpt-5.5 / gpt-5.4跨模型對比通過 /model gpt-5.5 臨時切換

會話中臨時切換：

/model claude-opus-4-8
/model gpt-5.5

進階：多 Profile 隔離 ​

~/.claude/settings.json 不支援多組憑據。如果你需要在多個 WRouter 賬戶 / Token 之間切換，建議用 shell wrapper：

bash
# ~/.zshrc
claude-prod() {
  ANTHROPIC_AUTH_TOKEN="sk-prod-xxx" claude "$@"
}
claude-dev() {
  ANTHROPIC_AUTH_TOKEN="sk-dev-xxx" claude "$@"
}

故障排查 ​

現象可能原因處理
401 UnauthorizedToken 錯誤 / 已停用 / 未設定echo $ANTHROPIC_AUTH_TOKEN 核對
Endpoint: https://api.anthropic.com變數未生效重開終端；或檢查 ~/.claude/settings.json 是否覆蓋了 env
Model not found當前 Token 分組不支援該模型訪問 https://wrouter.ai/models 確認
長時間無響應 / 502上游限流或超時切到 claude-haiku-4-5；或在控制台日誌查上游延遲
/status 顯示 Disconnected網路 / TLS 問題curl https://wrouter.ai/v1/models -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" 單獨驗證

已知限制 ​

  • Claude Code 的 Plan Mode、Subagents、Hooks 在切到非 Claude 模型（如 gpt-5.5）時部分功能可能降級
  • /login 命令僅對官方賬戶生效；WRouter 使用者應忽略
  • 呼叫日誌顯示模型 ID 為原始 Anthropic 名稱，與你在 /model 輸入的字串一致