ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

从 config.json 损坏到 CCR 完整恢复:Claude Code Router 配置备份与灾难恢复指南

从 config.json 损坏到 CCR 完整恢复:Claude Code Router 配置备份与灾难恢复指南 从 config.json 损坏到 CCR 完整恢复Claude Code Router 配置备份与灾难恢复指南【免费下载链接】claude-code-routerOne local control plane for every AI agent: route across models, fuse new capabilities, orchestrate tools, and stay fully in control.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-router昨晚十一点一次误删操作把 Claude Code Router 的 config.json 一起带走了——重启 CCR 后提供商列表空了路由规则没了IDE 里的 AI 代理连不上任何模型。CCR 是一个面向所有 AI 代理的本地统一控制面负责跨模型路由、能力融合和工具编排而这些“命脉”全部装在一个 config.json 里。有备份十分钟能恢复服务没有备份至少重打一下午 API 密钥。先排查怎么确认是配置文件的问题恢复之前先排除“不是配置的锅”。CCR 的核心配置在~/.claude-code-router/config.json它相当于整个系统的“总机”Providers、Router、transformers三个字段分别管着提供商信息、路由规则和协议转换逻辑API 密钥也存放在这个文件里。配置路径在 constants.ts 中定义桌面版 App 还会在同目录维护一份 SQLite 数据库附带-wal、-shm辅助文件所以实际操作建议把整个目录都纳入备份。两条命令完成检查ls -l ~/.claude-code-router/config.json # 确认文件还在 python3 -m json.tool ~/.claude-code-router/config.json /dev/null echo OK # 确认 JSON 格式完整第一条看文件是否存在第二条校验格式没有报错就说明结构完好。文件丢了、格式坏了才需要走恢复流程一切正常的话按 troubleshooting 文档 排查其他原因。CCR 配置文件恢复三步把服务拉起来恢复动作本身很简单用备份覆盖、重启服务、校验连接。cp ~/.claude-code-router/backups/config-20260830_030000.json ~/.claude-code-router/config.json ccr restart第一行把某次备份放回原位置第二行重启让新配置生效。重启后别只看界面“变绿”要验证格式和连通性ccr validate-config ccr test-provider deepseek两条都通过路由才算真正回来。如果刚改过路由规则可以对照 routing 文档 逐条核对路由指向。config.json 备份三种方法由轻到重方法一手动复制最可靠的保底备份的本质就是“在安全的位置多存一份文件”cp ~/.claude-code-router/config.json ~/backups/ccc-$(date %Y%m%d-%H%M%S).json文件名带日期和时间恢复时一眼能挑。如果你在~/.claude-code-router/下还放了自定义路由脚本custom-router.js记得一起复制。只靠手动的话“忘了复制”就会漏备份所以再上自动化。方法二定时任务让机器记住备份把三行逻辑放进backup.sh复制当前配置再删掉超出 30 份的旧备份ts$(date %Y%m%d_%H%M%S) cp ~/.claude-code-router/config.json ~/.claude-code-router/backups/config-$ts.json find ~/.claude-code-router/backups -name config-*.json | sort | head -n -30 | xargs rm -f然后注册到 crontabcrontab -e打开后添加一行0 3 * * * /bin/bash ~/.claude-code-router/backup.sh ~/.claude-code-router/backup.log 21这条的意思是每天凌晨 3 点静默执行脚本日志写进backup.log随时能回查历史备份有没有跑成功。方法三Git 版本控制每次改动可追溯把配置交给 Git备份就变成了“变更历史”cd ~/.claude-code-router git init git add config.json git commit -m init CCR config之后每次改动路由规则都提交一次改砸了就用git checkout commit-id -- config.json把文件回退到指定版本不用在备份目录里翻找。 两个习惯让备份真正有用从没恢复过的备份就像从不检查有效期灭火器。建议每月做一次“恢复演练”把最新备份拷到临时目录跑一遍格式校验确认它确实能用。备份里含 API 密钥不能只留在原盘——放一份到移动硬盘或云盘并做加密或收紧权限。桌面版启动后ccr ui也能直接在设置面板导出当前配置不用敲任何命令如果常用终端还可以配置状态线常驻显示系统状态配置一有异常立刻可见最后提醒一句备份本身不是目的“出事时真的能恢复”才是目的。手动命令、cron 那一行、Git 仓库三者随便保住一个都足够让 CCR 从事故里站起来。【免费下载链接】claude-code-routerOne local control plane for every AI agent: route across models, fuse new capabilities, orchestrate tools, and stay fully in control.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-router创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进