最近在折腾 claude-code-router ，发现它是一个非常强大的工具，可以帮助我们统一管理和调用各种大模型 API。我把配置过程中的一些经验和踩坑心得整理了一下，希望能帮助到有需要的佬友。
一、 基础安装
首先，需要安装Claude Code和 claude-code-router。打开终端，运行以下命令：
安装 Claude Code 主程序
npm install -g @anthropic-ai/claude-code
安装 claude-code-router
npm install -g @musistudio/claude-code-router
3.启动 UI 界面 ccr ui
二、 网络代理
很多第三方通用 API（如 new-api、公益 API 等）的服务器都在国外，国内直接访问可能会遇到 500 , api_error , internal_error 等网络错误。如果遇到此类问题，可以尝试设置。
请根据你自己梯子进行修改。
三、 API 分类配置教程
claude-code-router 支持多种 API，我们主要看两类。
1. 常见直连 API
这类 API 包括 硅基 (Siliconflow) 、Kimi (Moonshot) 、通义千问 (ModelScope) 、火山引擎 (Volcengine) 等。
官方仓库的 README 已经有非常详细的配置说明，大家直接参考即可，这里不再赘述。
2. 第三方通用 API (以 Gemini 和智谱为例)
Gemini (谷歌)
URL ：需要以
/v1beta/models/结尾。例如，如果你使用gptLoad或类似的中转服务，地址可能如下：
http://localhost:3001/proxy/gemini/v1beta/models/
供应商转换器 (Provider Converter) ：选择
gemini。模型 (Model) ：填写模型名称即可，不需要
models/前缀。例如，模型 ID 是
models/gemini-2.5-pro，那么在模型字段里只填写gemini-2.5-pro。
关于
429 Too Many Requests错误 ： 我在使用 flash 模型时，遇到 429问题，如果有佬知道怎么配置，麻烦解答一二。
智谱
智谱提供了两种连接方式一种是 CC 接口 ，即可以直接在 CC 中 使用的方式，也是官方推荐使用方式。还有一种是OpenAI接口
方式 1 (推荐): CC 兼容接口
URL ：
https://open.bigmodel.cn/api/anthropic/v1/messages
模型 ：如
glm-4或glm-4-air。供应商转换器 ：选择
Anthropic。
方式 2: OpenAI接口
URL ：
https://open.bigmodel.cn/api/paas/v4/chat/completions
模型选择 ：
glm-4。其余选项 ：保持默认即可。
从第二种方式，可见，常见OpenAI接口，都可以如上简单进行配置。
配置切换（邪修）
通过智谱的配置方式，我们可以看出，其实 CCR 其实也可以作为一个 简单的CC 配置切换工具来使用（邪修），非常方便快捷。
我们可以直接在 CC 中配置
"env": {
"ANTHROPIC_AUTH_TOKEN": "key",
"ANTHROPIC_BASE_URL": "http://127.0.0.1:3456"
}
CC环境全走 CCR，然后我们在 CCR 中配置中转商的Claude Code 专用的Anthropic 接口，那么即可在 CCR 中随意切换自如。
需注意的是，Claude Code 专用的Anthropic 接口在配置中，应如：供应商 API/v1/messages
最后
发现很多佬做了CC 环境切换，还有 CCR 的 UI，发现重复造轮子的问题挺多的，但是因为发现确实需要这些功能，别人的东西又不是很满意，自己提 MR，也很麻烦。感谢 AI，重复造轮子试错成本低了很多。
还有就是CCR 目前出的 UI 已经还可以了，很方便。
遇到非流的问题，也就是如retool2API 的接口，返回contains “[object Object]”，没有解决。
另外，也有遇到N 佬公益的claude-4.0-sonnet时而吞回复的问题，感觉是间歇性的，再次感谢 N 佬。
如果各位佬有在使用 CCR 过程中踩坑，遇到的问题也可以一起讨论。
简单贴一下配置。
{
"LOG": false,
"CLAUDE_PATH": "",
"HOST": "127.0.0.1",
"PORT": 3456,
"APIKEY": "key",
"API_TIMEOUT_MS": "600000",
"PROXY_URL": "http://127.0.0.1:7897",
"Transformers": [],
"Providers": [
{
"api_base_url": "https://api.siliconflow.cn/v1/chat/completions",
"api_key": "key",
"models": ["moonshotai/Kimi-K2-Instruct"],
"name": "siliconflow",
"transformer": {
"use": [
[
"maxtoken",
{
"max_tokens": 16384
}
]
]
}
},
{
"api_base_url": "https://api-inference.modelscope.cn/v1/chat/completions",
"api_key": "key",
"models": ["Qwen/Qwen3-Coder-480B-A35B-Instruct"],
"name": "modelscope",
"transformer": {
"use": [
[
"maxtoken",
{
"max_tokens": 65536
},
"enhancetool"
]
]
}
},
{
"name": "volceskimi",
"api_base_url": "https://ark.cn-beijing.volces.com/api/v3/chat/completions",
"api_key": "key",
"models": ["kimi-k2-250711"]
},
{
"name": "nyxar",
"api_base_url": "https://api.nyxar.org/v1/chat/completions",
"api_key": "key",
"models": [
"gemini-2.5-pro",
"claude-4.0-sonnet",
"anthropic/claude-3.7-sonnet",
"anthropic/claude-4-sonnet-20250522"
]
},
{
"name": "bigmodelOpen",
"api_base_url": "https://open.bigmodel.cn/api/paas/v4/chat/completions",
"api_key": "key",
"models": ["glm-4.5"]
},
{
"name": "bigmodelCC",
"api_base_url": "https://open.bigmodel.cn/api/anthropic/v1/messages",
"api_key": "key",
"models": ["glm-4.5"],
"transformer": {
"use": ["Anthropic"]
}
},
{
"name": "geminiC",
"api_base_url": "http://localhost:3001/proxy/gemini/v1beta/models/",
"api_key": "key",
"models": [
"gemini-2.5-flash",
"gemini-2.5-pro",
"gemini-2.5-flash-preview-05-20"
],
"transformer": {
"use": ["gemini"]
}
}
],
"Router": {
"default": "nyxar,claude-4.0-sonnet",
"background": "siliconflow,moonshotai/Kimi-K2-Instruct",
"think": "siliconflow,moonshotai/Kimi-K2-Instruct",
"longContext": "geminiC,gemini-2.5-pro",
"longContextThreshold": 60000,
"webSearch": "geminiC,gemini-2.5-flash"
}
}