Claude Code

Claude Code 是 Anthropic 官方 CLI 工具，要求 Anthropic Messages API 协议（不是 OpenAI）。PrimeRouter 同时兼容这两种协议，给 Claude Code 用要走 /v1/messages（Claude Code 会自动追加路径）。

在配置前请先准备好 PrimeRouter API Key（参考 通用准备）。

安装

# 全平台（需 Node 18+）
npm install -g @anthropic-ai/claude-code
# 验证
claude --version

配置环境变量

CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 会关闭遥测、错误上报、更新检查等非必要请求，建议一并设置。

macOS / Linux（当前 shell 临时生效）

export ANTHROPIC_BASE_URL=https://primerouter.ai
export ANTHROPIC_AUTH_TOKEN=sk-你的primerouter-key
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

claude

macOS / Linux（写入 shell rc 持久化）

# zsh 用户
cat >> ~/.zshrc <<'EOF'
export ANTHROPIC_BASE_URL="https://primerouter.ai"
export ANTHROPIC_AUTH_TOKEN="sk-你的primerouter-key"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
EOF
source ~/.zshrc

# bash 用户把 ~/.zshrc 换成 ~/.bashrc 即可

Windows PowerShell（临时生效）

$env:ANTHROPIC_BASE_URL  = "https://primerouter.ai"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的primerouter-key"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = "1"

claude

Windows PowerShell（写入 Profile 持久化）

notepad $PROFILE
# 在文件末尾追加：
# $env:ANTHROPIC_BASE_URL  = "https://primerouter.ai"
# $env:ANTHROPIC_AUTH_TOKEN = "sk-你的primerouter-key"
# $env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = "1"
# 保存后重启 PowerShell

Windows CMD（临时生效）

set ANTHROPIC_BASE_URL=https://primerouter.ai
set ANTHROPIC_AUTH_TOKEN=sk-你的primerouter-key
set CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

claude

Windows 系统环境变量（永久生效）

:: 管理员 PowerShell 中执行
setx ANTHROPIC_BASE_URL  "https://primerouter.ai"
setx ANTHROPIC_AUTH_TOKEN "sk-你的primerouter-key"
setx CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC "1"
:: 然后到 控制面板 → 系统 → 高级 → 环境变量 删除 ANTHROPIC_API_KEY

启动

claude
# 在 Claude Code 内可用 /model 切换模型
# 或在启动时指定：claude --model claude-opus-4-7

注意点

两个常见坑

• ANTHROPIC_BASE_URL 不要带 /v1 后缀，Claude Code 会自动追加 /v1/messages
• 必须先 unset / Remove-Item 掉 ANTHROPIC_API_KEY，否则 Claude Code 会优先用它去 Anthropic 官方而绕过 PrimeRouter

推荐模型

场景	Model ID
默认	claude-sonnet-4-6
复杂任务的稳定档	claude-opus-4-6
复杂重构 / Plan 模式	claude-opus-4-7