坑 2：API Base URL 路径不完整

火山引擎方舟（volcengine ARK）有 Coding Plan 包月套餐，它的完整 API 地址是：

我最初只写到了 /api/coding：

这个错误很隐蔽——CCR 启动时不报错，只有实际请求来了才会抛出 404 或路由错误。直到我用 curl 测试才抓到异常。

坑 3：国内服务配了代理，但代理没开

配置文件里有一行：

这本来是给海外模型（如 OpenRouter、Gemini）准备的。但问题是：

1. 火山引擎是国内服务，根本不需要代理
2. 我的 Clash 软件没启动，7890 端口没人监听
3. CCR 强制所有请求走这个代理端口

结果是每次请求都报 fetch failed，没有任何有用信息。

解决方案：国内服务直接清空代理。

需要再次用代理时再填回来，并确保代理软件正在运行。

坑 4：settings.json 和 CCR 抢方向盘（最容易忽视）

这是最隐蔽的坑，也是最大的问题。

其实 CCR 装完、config.json 修完、代理清掉以后，ccr restart 服务已经能正常启动了。但诡异的是我运行 ccr code 之后，Claude Code 界面里的 /model 命令只能看到 glm-5.1，无法切换模型。

查了一圈发现，~/.claude/settings.json 里有这样一段环境变量覆盖：

这意味着：

• ANTHROPIC_BASE_URL 直接指向火山引擎 → 完全绕过了 CCR
• ANTHROPIC_MODEL 和顶层 model 锁死了模型 → /model 命令无法切换

CCR 的原理是在本地启动一个代理服务器，运行 ccr code 时会自动设置环境变量让 Claude Code 连到本地代理。但如果 settings.json 里的 env 配置优先级更高，就会覆盖 CCR 注入的值。

解决方案：删除 settings.json 里与 ANTHROPIC 相关的 env 变量和 model 字段，让 CCR 接管路由控制权。

坑 5：Warp 终端里无法添加文件、代码片段或图片到上下文

CCR 跑通之后，我习惯性地用 Warp 终端打开 ccr code，准备像以前一样用右键"Attach as context"把代码文件或截图塞进对话框——结果发现功能倒是有，但是点全部无效，点了没一点反应。

原因：Warp 的上下文注入功能（Attach code / Images as context）是基于进程指纹识别实现的。Warp 检测到当前运行的是 claude 命令时，才会激活 Agent 增强型输入框和上下文绑定面板。而你执行的是 ccr code，Warp 只看到一个叫 ccr 的普通 Shell 命令，不会把它当成官方 AI Agent，于是拒绝激活上下文注入通道。

解法 A：用 Alias 欺骗 Warp（最推荐）

核心思路是把 ccr code 伪装成 claude 命令，让 Warp 正确识别。

Windows（PowerShell）：

macOS / Linux（Zsh/Bash）：

这些操作完了后，要把当前Warp终端关闭，在当前目录下重新打开，之后在 Warp 中直接输入 claude 启动，Warp 就能识别到 claude 关键字，解锁上下文注入功能。

解法 B：Ctrl + G 唤起富文本输入框

如果 Alias 方案没生效，可以在 ccr code 会话中按 Ctrl + G，强制拉起 Warp 的 Rich Input Editor（多行富文本输入框），在里面点击附件图标添加代码或图片。

解法 C：用@键盘流注入文件上下文

如果 UI 级绑定彻底被 CCR 阻断，可以放弃鼠标流，改用键盘流：在输入框中键入 @，Warp 会基于当前 Git 仓库弹出文件/目录的快速搜索列表，选择后以文本路径方式注入上下文——这种方式 CCR 完全能理解。

解法B/C没试过，我用解法A就解决了我的问题，Warp的丝滑体验又回来了！

最终配置（可以直接用）

~/.claude-code-router/config.json

~/.claude/settings.json

关键原则就是，settings.json 是 Claude Code 自身的配置，不要在里面写什么 ANTHROPIC_* 环境变量。让 CCR 来管路由，让 settings.json 保持干净。

最终效果

一切就绪后，实际效果是这样的：

Claude Code 以为自己用的是 Opus 4.8，但每一行代码、每一句回答都来自你配置的第三方模型。

这感觉就像给一辆特斯拉换上了比亚迪的电池——仪表盘依然显示"满电"，但真正的动力来源早已不是原厂货。

切换模型也有三种方式（按推荐度排序）：

1. Claude Code 内直接输入：/model volcengine,kimi-k2.6
2. CCR 交互式菜单：另开终端运行 ccr model，选择模型后重启，注意要在warp中操作
3. 编辑配置文件：改 Router.default 字段后 ccr restart

总结：排错心法

爬完这几 个坑，有必要理解一下从 CCR调用大模型 的分层架构或者说工作流：

终端（Warp）→ Claude Code → settings.json 的 env → CCR 本地代理 → Provider API

每一层都可能配置冲突或覆盖，排错的关键是逐层隔离验证：

1. 检查终端是否识别 Agent 进程（Warp 用户注意进程名匹配）
2. 检查 CCR 是否启动：ccr status
3. 检查日志有没有 proxy 注册：看 ~/.claude-code-router/logs/
4. 用 curl 直接测本地代理：curl http://127.0.0.1:3456/v1/messages
5. 检查 settings.json 有没有"越权"的 env 变量
6. 确认 Provider URL 的完整路径
7. 确认 Router 里的 provider 名和上面定义的一致

如果你也在折腾 AI 工具的配置，欢迎转发给需要的人。踩过的坑踩平了，后人就少摔一跤。