国内使用 claude code 中转站方法

原理：

# Claude Code 环境配置与中转站使用教程 ​ ## 原理： ​ ccr ui ──启动──→ 打开浏览器显示 http://127.0.0.1:3456/ui/ （配置界面） ↓ 你在这里配置 API Key、模型等 ↓ 保存配置后，ccr 会在后台运行 API 服务 ↓ ccr code ──启动──→ Claude Code 连接 http://127.0.0.1:3456 （API 地址）

环境准备

1. 安装 Node.js

ccr 需要Node.js >= 18。先检查是否已安装：

node --version npm --version

如果显示类似v18.x.x/v20.x.x或更高版本，说明已安装，继续下一步。 如果未安装，请前往 Node.js 官网 下载安装LTS 版本。

💡验证命令：安装完成后，重新打开终端执行node -v，确认版本号 ≥ 18。

1. 安装 Claude CLI

Claude Code 官方推荐原生安装方式，但 npm 安装也兼容：

# 方式一：官方推荐（Linux/macOS） curl -fsSL https://claude.ai/install.sh | bash ​ # 方式二：npm 安装（跨平台通用） npm install -g @anthropic-ai/claude-code

验证是否安装成功：

claude --version

2. 安装中转翻译官

npm install -g @musistudio/claude-code-router

验证安装：

ccr --version # 或 ccr --help

⚠️ 如果提示ccr: command not found，说明全局 npm bin 目录未加入 PATH。Windows 用户可尝试重启终端；Mac/Linux 用户可检查npm bin -g输出路径是否在 PATH 中。

3. 准备大模型 API 密钥

需要提前获取以下任一平台的 API Key：

🔑推荐优先使用阿里云百炼，首次注册会赠送数百万 Token，国内访问稳定。

4. 启动中转站 Web 界面

首次使用前，先启动 ccr 服务（会自动创建默认配置文件）：

ccr start

然后启动 Web 配置界面：

ccr ui

浏览器会自动打开http://127.0.0.1:3456/ui/

页面操作配置步骤

4.1 添加 Provider（供应商）

1. 点击「添加供应商」按钮

2. 按模板填写信息：

📌模型名称填写规则：按回车确认添加，可添加多个模型供切换使用。

4.2 设置路由规则

在右侧「路由」区域配置：

💡路由格式：供应商名称,模型名称（英文逗号分隔）

4.3 保存并重启

点击「保存并重启」按钮，等待服务重启完成。

⚠️重要：在 UI 界面修改任何配置后，必须点击「保存并重启」才会生效！

5. 配置文件位置（手动编辑备用）

如果不想用 UI，也可以直接编辑配置文件：

• Windows:C:\Users\你的用户名\.claude-code-router\config.json

• Mac/Linux:~/.claude-code-router/config.json

配置模板示例

{ "HOST": "127.0.0.1", "PORT": 3456, "Providers": [ { "name": "deepseek", "api_base_url": "https://api.deepseek.com/v1/chat/completions", "api_key": "sk-你的API密钥", "models": [ "deepseek-chat", "deepseek-reasoner" ] }, { "name": "qwen", "api_base_url": "https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions", "api_key": "sk-你的API密钥", "models": [ "qwen-max", "qwen-plus" ] } ], "Router": { "default": "deepseek,deepseek-chat", "background": "qwen,qwen-plus", "think": "deepseek,deepseek-reasoner", "longContext": "deepseek,deepseek-chat", "longContextThreshold": 60000 } }

6. 重启服务

修改配置后，需要重启 ccr 服务：

ccr restart

7. 开始使用

方式一：使用 ccr code（推荐新手）

ccr code

这会启动 Claude Code，并自动连接到本地 ccr 中转服务。

方式二：使用 ccr activate（推荐长期使用）

如果你习惯直接敲claude命令，可以用激活模式：

# 当前终端会话生效 eval "$(ccr activate)" ​ # 之后直接使用 claude

💡永久生效：将eval "$(ccr activate)"写入~/.bashrc或~/.zshrc（Mac/Linux），或 Windows 的环境变量中。

8. 动态切换模型（使用中）

进入 Claude Code 交互环境后，可随时切换模型：

/model deepseek,deepseek-reasoner

查看当前已加载的模型列表：

/model

9. 配置 Skill（可选，推荐）

此步骤不影响基础使用，但能大幅提升效率，达到 1 + 1 > 2 的效果。

Skill 资源推荐

安装方式

方式一：使用 Claude Code 内置命令安装

/claude-code install https://github.com/mattpocock/skills

方式二：手动解压安装

1. 从 GitHub 仓库下载 ZIP 压缩包并解压

2. 将skill目录下的所有文件复制到以下路径：

C:\Users\lenovo\.claude\skills

注意：lenovo请替换为你的 Windows 用户名。 Mac/Linux 路径为：~/.claude/skills

验证 Skill 是否生效

进入 Claude 交互环境后，输入以下命令查看已加载的 Skill：

/skill

如果列表显示与你安装的 Skill 一致，则说明配置成功。

10. 常见问题排查

11. 常用命令速查