1. 装完之后卡在哪ccr code 请求打不通的真实原因Claude Code 和 claude-code-router 都装好了claude --version、ccr --version都能正常打印版本号说明 Node 环境和 npm 全局包没问题。但一执行ccr start再进项目目录跑ccr code请求就是打不通——要么转圈半天没响应要么直接报连接错误。这个现象在刚配好 claude-code-router 的人里非常常见问题几乎都出在同一个地方~/.claude-code-router/config.json里的api_base_url、api_key、models、Router.default还留着xxx占位符或者填了一个根本连不上的地址。claude-code-router 本身不产生模型能力它只做一件事把 Claude Code 发出来的请求按你 config.json 里写的规则转发到某个真实的模型服务上。所以 config.json 里那个api_base_url必须是真实可访问的 API 地址api_key必须是真实有效的 Keymodels和Router.default必须指向这个通道里确实存在的模型名。三者只要有一个对不上ccr code发出去的请求就会在路由层断掉。这篇不重复安装步骤只解决这一步config.json 到底怎么填对。核心链路就一条——Claude Code → claude-code-router 的 config.json → 一个真实可用的 API Base URL。我试过把api_base_url填成带/v1的地址、填成带结尾斜杠的地址结果都是请求打不通后面会具体说这两个坑。2. 先把 Key 和 Base URL 拿到手config.json 里要填两样东西api_base_url和api_key。这两个值需要从一个真实可用的模型服务通道获取。打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 注册账号进控制台创建一个 API Key这个 Key 就是待会填进api_key字段的值。创建 Key 的入口在控制台的 API Keys 页面直接访问 https://taotoken.net/api-keys 就能到。创建完把 Key 复制下来注意它通常只在创建时完整显示一次关掉页面就看不全了先存到安全的地方。Base URL 这一项是固定的https://taotoken.net/api。这里有两个必须注意的点也是后面排障章节要展开的坑注意api_base_url填https://taotoken.net/api不要在后面加/v1也不要加结尾斜杠。claude-code-router 会自己拼接后续路径你多写一段它就会拼出一个不存在的地址请求自然打不通。模型名这一项需要和这个通道里实际可用的模型对齐。你可以在控制台或模型对话页面确认当前通道支持的模型标识把它填进models数组和Router.default。模型名写错同样会导致请求失败报错往往还比较隐晦。3. 可复制的 config.json 配置打开~/.claude-code-router/config.json把 Providers 和 Router 两段按下面这样改。假设你从通道里确认到的模型标识是claude-sonnet-4-20250514以你控制台实际显示的为准配置如下{ PORT: 3456, Providers: [ { name: taotoken, api_base_url: https://taotoken.net/api, api_key: sk-你创建的那把Key, models: [claude-sonnet-4-20250514], transformer: { use: [openrouter] } } ], Router: { default: taotoken,claude-sonnet-4-20250514 } }几个字段逐个说明避免填错name是给这个 Provider 起的名字随便起但Router.default里要引用它所以两边保持一致。这里用taotoken。api_base_url就是https://taotoken.net/api原样填不加/v1、不加结尾斜杠。api_key填你刚创建的那把 Key注意别把前后空格带进去。models是一个数组里面写这个通道里可用的模型标识。如果你有多个可用模型可以都列进去比如[claude-sonnet-4-20250514, claude-opus-4-20250514]。Router.default的格式是Provider名,模型名中间用英文逗号分隔不要有空格。上面配置里就是taotoken,claude-sonnet-4-20250514。这一项决定了ccr code默认把请求路由到哪个模型如果这里还留着xxx请求就没有落点。transformer里的use保持[openrouter]即可这是 claude-code-router 处理请求格式转换用的不用改。改完保存文件。如果你之前已经ccr start过需要先停掉再重启让新配置生效ccr stop ccr start4. 验证请求是否真的通了配置改完进项目目录跑一次看请求能不能正常返回结果cd ~/your_project ccr code进入ccr code的交互界面后随便输入一句让它执行比如让它读一下当前目录的文件列表或者问一个简单问题。如果配置正确你会看到它正常返回结果而不是卡住或报连接错误。如果ccr start之后想先确认路由服务本身起来了可以看它的启动日志正常情况下会打印监听端口默认 3456。ccr code本质上是把 Claude Code 的请求指向本地这个 3456 端口的路由服务再由路由服务按 config.json 转发到https://taotoken.net/api。验证成功的标志很直接ccr code里发出去的内容能拿到模型返回说明整条链路 Claude Code → claude-code-router →https://taotoken.net/api是通的。如果还是不通对照下一节的排查项逐个检查。5. 本篇常见错误排查5.1 api_base_url 多写了 /v1 或结尾斜杠这是最高频的坑。https://taotoken.net/api/v1和https://taotoken.net/api/都会导致请求打不通。claude-code-router 会基于你填的 base url 拼接后续路径你多写一段拼出来的地址就是错的。正确写法只有一种https://taotoken.net/api。5.2 api_key 还是 xxx 或带了空格占位符没替换、Key 复制时前后带了空格或换行都会让鉴权失败。检查方法是把api_key的值单独拿出来看确认它是完整的 Key 字符串首尾没有空白字符。5.3 Router.default 没落到真实模型Router.default如果还是xxx或者格式写成了taotoken/claude-sonnet-4-20250514用了斜杠、taotoken, claude-sonnet-4-20250514逗号后多了空格路由就找不到目标。正确格式是Provider名,模型名英文逗号无空格。5.4 models 里的模型名和通道对不上models数组里写的模型标识必须是通道里实际可用的。写错模型名请求转发过去也会被拒。去控制台确认当前可用的模型标识和models、Router.default里的名字保持一致。5.5 改了配置没重启 ccrconfig.json 是ccr start时读取的改完不重启不生效。改完记得ccr stop再ccr start。5.6 端口被占用默认端口 3456 如果被别的进程占了ccr start可能起不来或行为异常。可以改 config.json 里的PORT换一个或者先确认 3456 没被占用。6. 配通之后Key 和 Base URL 的后续管理这条链路配通之后你手上真正需要维护的只有两样东西一把 API Key 和一个 Base URL。Key 在控制台的 API Keys 页面管理如果怀疑泄露或者想轮换直接在那里重新创建一把然后回到 config.json 把api_key换掉、重启 ccr 即可。Base URL 固定是https://taotoken.net/api除非通道有调整一般不用动。如果你后面要长期用 Claude Code 做编码或者跑 Agent 类的任务可以关注一下 Coding Plan 相关的入口访问 https://taotoken.net/coding-plan 了解。模型对话能力可以在 https://taotoken.net/models 直接体验用来确认某个模型标识是否可用、返回是否符合预期再决定要不要写进 config.json 的models里。接入文档在 https://taotoken.net/doc遇到字段含义不确定的时候可以对照查。回到最开始那个问题api_base_url还填着xxxccr code请求打不通本质就是 config.json 没落到真实通道上。把api_base_url改成https://taotoken.net/api、api_key换成真实 Key、models和Router.default对齐可用模型名保存重启这条链路就通了。