原理：

 # 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：

平台	地址	说明
DeepSeek	官网	性价比高，推理能力强
阿里云百炼	百炼平台	通义千问系列，首次注册赠送数百万 Token
英伟达 NIM	build.nvidia.com	免费调用 GLM-4.7、MiniMax 等模型
Google AI Studio	aistudio.google.com	Gemini 系列，免费用户每日限额

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

---

4. 启动中转站 Web 界面

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

 ccr start

然后启动 Web 配置界面：

 ccr ui

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

页面操作配置步骤

4.1 添加 Provider（供应商）

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

2. 按模板填写信息：

字段	示例值（DeepSeek）	示例值（阿里云百炼）
名称	deepseek	qwen
API 完整地址	https://api.deepseek.com/v1/chat/completions	https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions
API 密钥	sk-xxxxxxxx	sk-xxxxxxxx
模型	deepseek-chat	qwen-max

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

4.2 设置路由规则

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

路由项	说明	示例值
default（默认）	日常对话默认模型	deepseek,deepseek-chat
background（后台）	后台轻量任务	deepseek,deepseek-chat
think（思考）	复杂推理、Plan Mode	deepseek,deepseek-reasoner
longContext（长上下文）	长文本处理	deepseek,deepseek-chat

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

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 资源推荐

资源	地址	说明
Anthropic 官方 Skills	https://github.com/anthropics/skills	官方示例和模板
Awesome Claude Skills	https://github.com/ComposioHQ/awesome-claude-skills	社区整理的优质 Skill 合集
JEECG Skills	https://github.com/jeecgboot/skills	低代码生成相关，国内可用
SkillsMP 搜索	https://skillsmp.com	6万+ Skills 的可视化搜索平台

安装方式

方式一：使用 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. 常见问题排查

问题	解决方案
ccr: command not found	检查 Node.js 是否安装、全局 npm 路径是否在 PATH 中，尝试重启终端
Auth conflict 错误	1. 删除 ~/.claude/settings.json 2. 清除环境变量中的 ANTHROPIC_* 变量 3. 重新打开终端
API 调用失败	1. 确认 API Key 正确且未过期 2. 检查网络连接（国外模型需配置代理） 3. 确认模型名称与供应商匹配
配置修改后不生效	必须点击「保存并重启」，或使用 ccr restart
想使用代理	在 ccr UI 的「设置」中配置代理地址，如 http://127.0.0.1:7890
环境变量设置（推荐）	export CLAUDE_CODE_ATTRIBUTION_HEADER=0 —— 对接第三方服务时避免认证头冲突

---

11. 常用命令速查

命令	作用
ccr start	启动 ccr 服务
ccr ui	启动 Web 配置界面
ccr code	启动 Claude Code（带中转）
ccr restart	重启 ccr 服务
ccr stop	停止 ccr 服务
ccr activate	激活环境变量（用于直接 claude 命令）
/model	查看/切换当前模型
/skill	查看已加载的 Skill