Claude Code

Claude Code 是 Anthropic 官方的命令行编程代理。通过 wrouter，你可以用一把密钥同时调度 Claude 全系与 GPT、Gemini 等模型。

前置要求

项	要求
Claude Code	≥ 1.0.0
Node.js	≥ 18（仅在通过 npm 安装时）
wrouter	一把可用的 sk- 开头 Token，参见 API Token 管理

安装

# 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：

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

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

Windows (PowerShell)

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

新开终端生效。

配置文件方式（跨平台、可版本控制）

编辑 ~/.claude/settings.json：

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

注意：ANTHROPIC_AUTH_TOKEN 而非 ANTHROPIC_API_KEY。后者保留给官方端点登录态。

验证

claude

启动后输入 /status，应看到：

Model:        claude-sonnet-4-5
Endpoint:     https://api.wrouter.io
Status:       ✓ Connected

发起一次测试调用：

> List files in the current directory

期望：Claude Code 调用 LS 工具并返回目录列表。

推荐模型

模型	适用场景	说明
claude-sonnet-4-5	主力日常	速度与质量平衡，推荐设为 ANTHROPIC_MODEL
claude-opus-4-1	复杂重构、深度推理	单价高，建议按需切换
claude-haiku-4-5	摘要、命名、补全	设为 ANTHROPIC_SMALL_FAST_MODEL 可显著降本
gpt-5 / gpt-4o	跨模型对比	通过 /model gpt-5 临时切换

会话中临时切换：

/model claude-opus-4-1
/model gpt-5

进阶：多 Profile 隔离

~/.claude/settings.json 不支持多组凭据。如果你需要在多个 wrouter 账户 / Token 之间切换，建议用 shell wrapper：

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

故障排查

现象	可能原因	处理
401 Unauthorized	Token 错误 / 已禁用 / 未设置	echo $ANTHROPIC_AUTH_TOKEN 核对
Endpoint: https://api.anthropic.com	变量未生效	重开终端；或检查 ~/.claude/settings.json 是否覆盖了 env
Model not found	当前 Token 分组不支持该模型	访问 https://wrouter.io/models 确认
长时间无响应 / 502	上游限流或超时	切到 claude-haiku-4-5；或在控制台日志查上游延迟
/status 显示 Disconnected	网络 / TLS 问题	curl https://api.wrouter.io/v1/models -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" 单独验证

已知限制

• Claude Code 的 Plan Mode、Subagents、Hooks 在切到非 Claude 模型（如 gpt-5）时部分功能可能降级
• /login 命令仅对官方账户生效；wrouter 用户应忽略
• 调用日志显示模型 ID 为原始 Anthropic 名称，与你在 /model 输入的字符串一致