Claude Code 接入 TopRouter

本文档将指导您如何配置 Claude Code 以使用 TopRouter API，实现高效的 AI 代码辅助功能。

概述

Claude Code 支持通过环境变量调用 TopRouter API，您可以根据不同的操作系统选择合适的配置方式。

环境变量说明

• ANTHROPIC_MODEL：用于处理复杂任务的主要模型，推荐使用 Claude 系列模型，如 claude-4-sonnet
• ANTHROPIC_SMALL_FAST_MODEL：用于处理简单对话的轻量级模型，如 claude-4-sonnet

模型选择

所有可用的模型名称可以在 TopRouter 官网 的模型列表中查看和复制。

快速开始

步骤 1：获取 TopRouter API Key

1. 访问 TopRouter 平台
2. 登录您的账户
3. 在设置页面中生成或复制您的 API Key

步骤 2：配置环境变量

完成 Claude Code 安装后，您可以通过以下方式配置环境变量：

Mac / Linux

在 ~/.zshrc 或 ~/.bashrc 中加入以下内容：

export ANTHROPIC_AUTH_TOKEN="你的TopRouterAPI密钥"
export ANTHROPIC_BASE_URL="https://api.toprouter.ai/api/anthropic"
export ANTHROPIC_MODEL="tp.claude-sonnet-4-5-20250929"
export ANTHROPIC_SMALL_FAST_MODEL="tp.claude-sonnet-4-5-20250929"
export ANTHROPIC_DEFAULT_SONNET_MODEL="tp.claude-sonnet-4-5-20250929"
export ANTHROPIC_DEFAULT_OPUS_MODEL="tp.claude-sonnet-4-5-20250929"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="tp.claude-sonnet-4-5-20250929"

执行以下命令使配置生效：

source ~/.zshrc  # 或 source ~/.bashrc

---

Windows

方法 1：PowerShell（临时配置）

$env:ANTHROPIC_AUTH_TOKEN="你的TopRouterAPI密钥"
$env:ANTHROPIC_BASE_URL="https://api.toprouter.ai/api/anthropic"
$env:ANTHROPIC_MODEL="tp.claude-sonnet-4-5-20250929"
$env:ANTHROPIC_SMALL_FAST_MODEL="tp.claude-sonnet-4-5-20250929"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="tp.claude-sonnet-4-5-20250929"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="tp.claude-sonnet-4-5-20250929"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="tp.claude-sonnet-4-5-20250929"

注意

此方法仅在当前 PowerShell 会话中生效，关闭窗口后配置失效。

方法 2：PowerShell（永久配置）

需要管理员权限

setx ANTHROPIC_AUTH_TOKEN "你的TopRouterAPI密钥"
setx ANTHROPIC_BASE_URL "https://api.toprouter.ai/api/anthropic"
setx ANTHROPIC_MODEL "tp.claude-sonnet-4-5-20250929"
setx ANTHROPIC_SMALL_FAST_MODEL "tp.claude-sonnet-4-5-20250929"
setx ANTHROPIC_DEFAULT_SONNET_MODEL "tp.claude-sonnet-4-5-20250929"
setx ANTHROPIC_DEFAULT_OPUS_MODEL "tp.claude-sonnet-4-5-20250929"
setx ANTHROPIC_DEFAULT_HAIKU_MODEL "tp.claude-sonnet-4-5-20250929"

---

高级配置

模型切换配置

灵活配置

您可以通过修改 Claude Code 配置文件来切换不同的模型：

• ANTHROPIC_MODEL：主要模型配置
• ANTHROPIC_SMALL_FAST_MODEL：轻量级模型配置

运行 Claude Code 配置脚本后，系统会在 ~/.claude/settings.json 目录下创建默认模型配置文件：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "***",
    "ANTHROPIC_BASE_URL": "https://api.toprouter.ai/api/anthropic",
    "ANTHROPIC_MODEL": "anthropic/claude-3.7-sonnet"
  }
}

您可以手动将 ANTHROPIC_MODEL 和 ANTHROPIC_SMALL_FAST_MODEL 替换为 TopRouter 模型列表 中的任意模型。

常见问题

1. API 密钥无效：请确认您的 API 密钥正确且有效
2. 网络连接问题：检查网络连接和防火墙设置
3. 模型不可用：确认所选模型在 TopRouter 平台可用

如需更多帮助，请访问 TopRouter 官方文档。