Claude Code 接入

本指南介绍如何将 Claude Code 配置为使用 TopRouter API，通过 TopRouter 调用 Claude 模型。

前置条件

• 已安装 Claude Code CLI
• 已注册 TopRouter 账号并获取 API Key
• 已完成 充值

配置步骤

方式一：环境变量配置（推荐）

在终端中设置环境变量：

export ANTHROPIC_BASE_URL="https://toprouter.cc"
export ANTHROPIC_API_KEY="your-api-key"

💡 持久化配置

将上述命令添加到 Shell 配置文件中，使其永久生效：

Bash 用户（~/.bashrc 或 ~/.bash_profile）：

echo 'export ANTHROPIC_BASE_URL="https://toprouter.cc"' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY="your-api-key"' >> ~/.bashrc
source ~/.bashrc

Zsh 用户（~/.zshrc）：

echo 'export ANTHROPIC_BASE_URL="https://toprouter.cc"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="your-api-key"' >> ~/.zshrc
source ~/.zshrc

方式二：每次启动时设置

如果不想全局配置，也可以在启动 Claude Code 时临时设置：

ANTHROPIC_BASE_URL="https://toprouter.cc" ANTHROPIC_API_KEY="your-api-key" claude

验证配置

配置完成后，启动 Claude Code 即可使用：

claude

如果配置正确，Claude Code 将通过 TopRouter API 与 Claude 模型通信。

模型选择

Claude Code 默认使用 Claude Sonnet 模型。通过 TopRouter，您可以使用以下 Claude 模型：

模型	模型 ID	说明
Claude 4.8 Opus	anthropic/claude-4.8-opus	最强性能
Claude 4.6 Sonnet	anthropic/claude-4.6-sonnet	性能与速度均衡
Claude Sonnet 3.5	anthropic/claude-4.6-sonnet	上一代旗舰
Claude Haiku 3.5	anthropic/claude-4.5-haiku	快速，低成本

常见问题

连接失败？

1. 确认 ANTHROPIC_BASE_URL 设置正确为 https://toprouter.cc（注意不含 /v1 后缀）
2. 确认 API Key 有效且有足够余额
3. 检查网络连接是否正常

如何切换模型？

Claude Code 的模型切换通过其自身的配置进行，请参考 Claude Code 文档。

与直接使用 Anthropic API 有什么区别？

通过 TopRouter 调用 Claude 模型，在功能上与直接使用 Anthropic API 完全一致。TopRouter 作为中间代理，提供统一的计费和管理。

⚠️ 注意

ANTHROPIC_BASE_URL 应设置为 https://toprouter.cc，不要加 /v1 后缀。Claude Code 会自动拼接路径。