原理# 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.jsccr 需要Node.js 18。先检查是否已安装node --version npm --version如果显示类似v18.x.x/v20.x.x或更高版本说明已安装继续下一步。 如果未安装请前往 Node.js 官网 下载安装LTS 版本。验证命令安装完成后重新打开终端执行node -v确认版本号 ≥ 18。1. 安装 Claude CLIClaude Code 官方推荐原生安装方式但 npm 安装也兼容# 方式一官方推荐Linux/macOS curl -fsSL https://claude.ai/install.sh | bash ​ # 方式二npm 安装跨平台通用 npm install -g anthropic-ai/claude-code验证是否安装成功claude --version2. 安装中转翻译官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英伟达 NIMbuild.nvidia.com免费调用 GLM-4.7、MiniMax 等模型Google AI Studioaistudio.google.comGemini 系列免费用户每日限额推荐优先使用阿里云百炼首次注册会赠送数百万 Token国内访问稳定。4. 启动中转站 Web 界面首次使用前先启动 ccr 服务会自动创建默认配置文件ccr start然后启动 Web 配置界面ccr ui浏览器会自动打开http://127.0.0.1:3456/ui/页面操作配置步骤4.1 添加 Provider供应商点击「添加供应商」按钮按模板填写信息字段示例值DeepSeek示例值阿里云百炼名称deepseekqwenAPI 完整地址https://api.deepseek.com/v1/chat/completionshttps://dashscope.aliyuncs.com/compatible-mode/v1/chat/completionsAPI 密钥sk-xxxxxxxxsk-xxxxxxxx模型deepseek-chatqwen-max模型名称填写规则按回车确认添加可添加多个模型供切换使用。4.2 设置路由规则在右侧「路由」区域配置路由项说明示例值default默认日常对话默认模型deepseek,deepseek-chatbackground后台后台轻量任务deepseek,deepseek-chatthink思考复杂推理、Plan Modedeepseek,deepseek-reasonerlongContext长上下文长文本处理deepseek,deepseek-chat路由格式供应商名称,模型名称英文逗号分隔4.3 保存并重启点击「保存并重启」按钮等待服务重启完成。⚠️重要在 UI 界面修改任何配置后必须点击「保存并重启」才会生效5. 配置文件位置手动编辑备用如果不想用 UI也可以直接编辑配置文件Windows:C:\Users\你的用户名\.claude-code-router\config.jsonMac/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 restart7. 开始使用方式一使用 ccr code推荐新手ccr code这会启动 Claude Code并自动连接到本地 ccr 中转服务。方式二使用 ccr activate推荐长期使用如果你习惯直接敲claude命令可以用激活模式# 当前终端会话生效 eval $(ccr activate) ​ # 之后直接使用 claude永久生效将eval $(ccr activate)写入~/.bashrc或~/.zshrcMac/Linux或 Windows 的环境变量中。8. 动态切换模型使用中进入 Claude Code 交互环境后可随时切换模型/model deepseek,deepseek-reasoner查看当前已加载的模型列表/model9. 配置 Skill可选推荐此步骤不影响基础使用但能大幅提升效率达到 1 1 2 的效果。Skill 资源推荐资源地址说明Anthropic 官方 Skillshttps://github.com/anthropics/skills官方示例和模板Awesome Claude Skillshttps://github.com/ComposioHQ/awesome-claude-skills社区整理的优质 Skill 合集JEECG Skillshttps://github.com/jeecgboot/skills低代码生成相关国内可用SkillsMP 搜索https://skillsmp.com6万 Skills 的可视化搜索平台安装方式方式一使用 Claude Code 内置命令安装/claude-code install https://github.com/mattpocock/skills方式二手动解压安装从 GitHub 仓库下载 ZIP 压缩包并解压将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.json2. 清除环境变量中的ANTHROPIC_*变量 3. 重新打开终端API 调用失败1. 确认 API Key 正确且未过期 2. 检查网络连接国外模型需配置代理 3. 确认模型名称与供应商匹配配置修改后不生效必须点击「保存并重启」或使用ccr restart想使用代理在 ccr UI 的「设置」中配置代理地址如http://127.0.0.1:7890环境变量设置推荐export CLAUDE_CODE_ATTRIBUTION_HEADER0—— 对接第三方服务时避免认证头冲突11. 常用命令速查命令作用ccr start启动 ccr 服务ccr ui启动 Web 配置界面ccr code启动 Claude Code带中转ccr restart重启 ccr 服务ccr stop停止 ccr 服务ccr activate激活环境变量用于直接claude命令/model查看/切换当前模型/skill查看已加载的 Skill