Claude Code Router 配置备份与灾难恢复3 层备份守住路由规则【免费下载链接】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-routerClaude Code Router下称 CCR是本地模型网关让 Claude Code、Codex 等多个 AI Agent 共用一套提供商与路由配置。它的所有提供商、路由规则和 API 密钥基本都集中在~/.claude-code-router下的一个config.json里所以配置备份与灾难恢复的重点只有一个给这个文件做快照并定期演练恢复。三类最常见的配置事故误删、故障、迁移动手前先对齐风险。日常使用 CCR 时配置出问题的场景基本就三种误删文件清理目录或重装依赖时删掉配置目录路由规则和提供商参数全丢重新配置要花数小时。系统/磁盘故障~/.claude-code-router随系统一起消失所有 Agent 指向的本地端点直接不可用。更换设备迁移换新电脑或重装系统前没导出配置新机器上得逐个提供商重新填 key、重配路由。三种场景的共同点手里有一份完整备份事故就是十分钟的事没有就是半天起步。先搞清备什么CCR 配置资产清单 备份前先把要备的东西列清楚。CCR 的资产集中在一个目录下Windows 在AppData中对应位置对照下面的表逐项确认文件作用是否必备默认位置config.json主配置提供商、路由规则、密钥必备~/.claude-code-router/config.sqlite新版存储的账户与运行状态建议同上自定义路由脚本高阶路由逻辑如自行编写可选同上请求日志排查问题的运行记录可选~/.claude-code-router/app-data/用 Docker 部署的用户配置存放在挂载卷里备份对象是同一个挂载目录。文件清单和字段的详细说明见 配置文件文档。第 1 层一条命令完成 CCR config.json 备份 ️最小配置只做一件事把主配置复制到一个配置目录之外的安全位置比如~/ccr-backups。cd ~/.claude-code-router mkdir -p ~/ccr-backups cp config.json ~/ccr-backups/config-$(date %Y%m%d-%H%M%S).json第一条进入配置目录第二条创建独立备份目录第三条复制出带时间戳的快照。三条命令就是一份可用的快照。注意备份文件里含明文 API 密钥不要放进公开仓库、不要上传网盘共享目录放在外置盘或加密目录更稳妥。这一层适合今天就要防手滑的场景。第 2 层让备份自动跑起来推荐⏱️手动备份靠记性忘了等于没备。更可靠的做法是定时任务 短脚本脚本只负责复制和清理定时任务负责每天固定时间执行。脚本模板保存在任意位置如~/bin/ccr-backup.sh#!/bin/bash BACKUP_DIR~/ccr-backups mkdir -p $BACKUP_DIR SRC~/.claude-code-router/config.json [ -f $SRC ] || { echo config.json not found $BACKUP_DIR/backup.log; exit 1; } cp $SRC $BACKUP_DIR/config-$(date %Y%m%d-%H%M%S).json ls -t $BACKUP_DIR/config-*.json | tail -n 31 | xargs -r rm -f echo $(date %F %T) ok $BACKUP_DIR/backup.log然后在 crontab 里加一行每天凌晨 3 点执行crontab -e编辑0 3 * * * /bin/bash ~/bin/ccr-backup.sh模板里有两个关键项值得说明保留份数tail -n 31表示只留最近 30 份。份数太少会滚掉几天前的好版本太多则占满磁盘。按你的改动频率调整即可。日志落盘最后一行把每次执行结果写进backup.log。出问题回看那天到底有没有备份成功一分钟就有答案。第 3 层用 Git 管理配置文件改动可追溯进阶自动备份解决防丢Git 解决改坏了怎么回滚。在配置目录执行git init每次改完路由规则提交一次出问题就git log找到上一次可用提交git checkout commit -- config.json还原。多环境使用开发/生产各一套提供商和密钥时思路类似维护两份配置文件或两个仓库按环境各自加载避免开发环境的 key 误流到生产。用 Git 管理前确保密钥文件不会推送到远端。恢复演练30 分钟验证备份可恢复 没演练过的备份约等于没有。每月抽半小时做一次三步验证校验文件格式把最新备份复制出来确认可正常解析在文本编辑器打开检查 JSON 结构或临时替换后看界面能否正常加载。从备份还原停掉服务ccr stop把备份文件复制回~/.claude-code-router/。重启后验证路由执行ccr start启动服务打开管理界面发一条测试请求在日志里确认请求命中了预期的提供商和模型。三步全部通过这份备份才算真的可用。任何一步卡住当场修别留到真出事故那天。紧急恢复速查卡出问题时照做即可事故发生时不需要思考按顺序执行ccr stop—— 停止服务避免读到半截配置。将最新备份复制回~/.claude-code-router/config.json—— 还原主配置。如有自定义路由脚本一并复制回去 —— 还原脚本。ccr start—— 重新启动服务。打开日志页发一条测试请求确认路由正常 —— 验证恢复。仍无法恢复时先看 故障排查文档再核对 CLI 参考 中ccr start/ccr stop的参数与状态说明。备份的价值不在备份本身而在于恢复真的可用快照要放在配置目录之外自动任务要留日志Git 提交要勤演练要按月做。更多部署形态如 Docker 部署指南和路由细节建议直接通读项目文档把这套恢复流程固化成自己的操作手册。【免费下载链接】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），仅供参考