Skip to main content
Claude Code 可以通过 Anthropic Messages 兼容接口接入 XRouter。配置后，Claude Code 会把请求发送到 https://api.xrouter.dev/v1/messages。
XRouter API Key 属于敏感凭据。建议写入本机 shell 配置或密钥管理工具，不要写入项目仓库。

​
安装 Claude Code

Terminal
npm install -g @anthropic-ai/claude-code
安装完成后确认命令可用。
Terminal
claude --version

​
配置 XRouter

把以下环境变量加入你的 shell 配置文件，例如 ~/.zshrc、~/.bashrc 或 CI 的 secret 配置。
~/.zshrc
export ANTHROPIC_BASE_URL="https://api.xrouter.dev"
export ANTHROPIC_AUTH_TOKEN="sk-your-api-key"
export ANTHROPIC_MODEL="claude-sonnet-4-5-20250929"
export ANTHROPIC_SMALL_FAST_MODEL="claude-haiku-4-5-20251001"
重新加载配置。
Terminal
source ~/.zshrc
ANTHROPIC_BASE_URL 不需要追加 /v1/messages。Claude Code 会自行拼接 Messages API 路径。

​
启动并验证

进入一个代码仓库后启动 Claude Code。
Terminal
cd path/to/your-project
claude
你可以先让 Claude Code 执行一个只读任务，例如：
Prompt
请阅读当前项目结构，并总结这个仓库的主要模块。不要修改文件。
如果工具能正常返回结果，说明 XRouter 接入已经完成。

​
模型选择

变量用途示例
ANTHROPIC_MODEL主模型，负责大部分代码任务claude-sonnet-4-5-20250929
ANTHROPIC_SMALL_FAST_MODEL轻量模型，用于快速子任务claude-haiku-4-5-20251001
模型名以控制台模型页为准。若你没有看到示例模型，可以改成同类可用 Claude 模型。

​
使用项目级配置

如果你希望只在当前终端会话中启用 XRouter，不写入 shell 配置，可以临时导出变量后启动。
Terminal
ANTHROPIC_BASE_URL="https://api.xrouter.dev" \
ANTHROPIC_AUTH_TOKEN="sk-your-api-key" \
ANTHROPIC_MODEL="claude-sonnet-4-5-20250929" \
claude

​
故障排查

确认 ANTHROPIC_AUTH_TOKEN 是完整 XRouter API Key。你也可以用 curl https://api.xrouter.dev/v1/models -H "x-api-key: sk-..." -H "anthropic-version: 2023-06-01" 验证 Anthropic 格式模型列表。
在 XRouter 控制台复制模型名，并同步修改 ANTHROPIC_MODEL。不同账户、分组或渠道可能看到不同模型。
先用 curl https://api.xrouter.dev/v1/models 验证网络连通性。若公司网络要求代理，请按你的终端环境配置 HTTPS_PROXY。