Claude Code Router 配置备份完全指南：3 步存档 + 一键回滚

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-router凌晨三点你手一抖把~/.claude-code-router/config.json里的路由规则改花了保存的瞬间 gateway 直接报错之前精心调过的 Provider、API key 和 fallback 顺序全没了。翻车之后你才意识到这份配置从来没留过底。Claude Code Router下称 CCR把路由、密钥、Provider 全压在一个目录里一旦丢了恢复起来比重装还麻烦。读完这份指南你能在 3 步之内给配置打好快照配一条 cron 让它自己每天备份出问题时几分钟回滚到能用的状态。先把家底摸清你的配置到底存在哪备份之前得先知道要备什么。CCR 的核心状态都集中在用户主目录的.claude-code-router/下理解这几个文件的关系后面操作才不会漏。核心文件都在这个目录文件作用备份优先级config.jsonProvider、路由规则、API key 的主配置最高config.sqlite应用设置与持久化的密钥快照高logs/运行日志排障用中app-data/请求日志、用量、上下文归档等数据库按需主配置路径Linux / macOS 在~/.claude-code-router/config.jsonWindows 在%APPDATA%/claude-code-router/config.json。配置长什么样config.json是标准 JSON几个关键字段决定你的路由行为备份时重点盯这几块{ LOG: true, APIKEY: your-secret-key, Providers: [ { name: deepseek, api_base_url: https://api.deepseek.com/chat/completions } ], Router: { default: [deepseek:deepseek-chat] }, transformers: [] }Providers定义了所有接入的模型商Router决定不同场景走哪条模型链APIKEY是网关鉴权密钥——这三样丢了CCR 基本就瘫了。三步手动备份不写脚本也能存档第一次备份不用搞复杂几条cp命令就能把整套配置拷到安全的地方适合不熟悉脚本的人。复制主配置并打上时间戳进目录、建按日期命名的备份夹、把config.json连同自定义脚本一起复制过去cd ~/.claude-code-router mkdir -p backups/$(date %Y%m%d) cp config.json backups/$(date %Y%m%d)/config-$(date %H%M%S).json # 如果有自定义路由脚本一并带走 [ -f custom-router.js ] cp custom-router.js backups/$(date %Y%m%d)/ ls -lh backups/$(date %Y%m%d)/提示CCR 的 UI 界面里也能导出当前配置启动ccr ui后在设置面板找到导出入口即可适合不想碰命令行的场景。备份文件放哪里才安全配置里带着明文 API key别把它裸奔在本地拷一份到移动硬盘或网盘做到异地留存含密钥的备份建议加密后再存隔段时间抽一个备份文件确认内容能正常读出来把备份交给定时任务一份脚本 一条 crontab手动备份容易忘。把流程写成一个脚本再挂一条 cron每天自动跑备份就成了不需要操心的事。备份脚本长这样在配置目录下建一个脚本带时间戳存档、自动清理过期备份#!/bin/bash # CCR 配置自动备份脚本 BACKUP_DIR$HOME/.claude-code-router/backups KEEP_BACKUPS30 mkdir -p $BACKUP_DIR TIMESTAMP$(date %Y%m%d_%H%M%S) cp $HOME/.claude-code-router/config.json $BACKUP_DIR/config-$TIMESTAMP.json [ -f $HOME/.claude-code-router/custom-router.js ] \ cp $HOME/.claude-code-router/custom-router.js $BACKUP_DIR/custom-router-$TIMESTAMP.js # 只保留最近 30 份旧的清掉 find $BACKUP_DIR -name config-*.json | sort | head -n -$KEEP_BACKUPS | xargs rm -f echo Backup done: $BACKUP_DIR/config-$TIMESTAMP.jsonchmod x ~/.claude-code-router/backup-script.sh ~/.claude-code-router/backup-script.sh # 先手动跑一遍验证挂上 cron 让它每天自动跑编辑定时任务加一行让脚本每天凌晨 3 点执行输出重定向到日志方便回查crontab -e # 追加这一行 0 3 * * * ~/.claude-code-router/backup-script.sh ~/.claude-code-router/backup-log.txt 21 crontab -l # 确认已生效注意先确认系统 cron 服务在运行systemd 环境下可用sudo systemctl status cron检查。翻车后怎么救三个恢复场景备份的价值只有在能拉回来的时候才成立。下面按最常见的三种翻车情况各给一条恢复路径。配置损坏从备份里挑一个拉回来先列出历史备份选时间戳最新且确认没被污染的覆盖回主配置再重启让改动生效ls -lt ~/.claude-code-router/backups/*/*.json cp ~/.claude-code-router/backups/20251005/config-153022.json ~/.claude-code-router/config.json ccr restart换新设备把整套家当搬过去换机器不是只拷一个config.json那么简单把整个目录打包迁移更稳旧设备按前面步骤打一份完整备份通过 U 盘或网盘传到新设备新设备装好 CCR 但先别启动服务解压恢复确保目录结构完整mkdir -p ~/.claude-code-router cp /path/to/backup/config.json ~/.claude-code-router/ ccr start密钥丢了备份里没有就去官方渠道重置API key 丢失分两种备份里有的直接从备份文件里对应 Provider 的api_key字段提出来填回备份里没有的走提供商官方后台重置再更新配置{ Providers: [ { name: deepseek, api_base_url: https://api.deepseek.com/chat/completions, api_key: 新的API密钥 } ] }再上一道保险版本控制 多环境 自检单靠文件备份还不够把配置纳入版本管理能让每次改动都可追溯、可回滚。用 Git 给配置上版本把配置目录初始化为仓库每次改完就提交出问题直接回滚到某个历史版本cd ~/.claude-code-router git init git add config.json custom-router.js git commit -m Initial commit of CCR config # 改完后 git add config.json git commit -m Update router rules for long context # 需要回滚 git log # 找到目标提交 git checkout commit-id config.json多环境配置怎么切开发、测试、生产用不同配置时复制出变体文件再用环境变量指定加载哪一个cp config.json config.prod.json cp config.json config.dev.json CCR_CONFIGconfig.dev.json ccr start需要按环境动态路由的就在自定义路由脚本里读环境变量做分支判断。恢复完记得自检别急着关终端恢复后按这个顺序过一遍确认真的活过来了检查配置格式ccr validate-config验证基础路由ccr test-route default确认特定模型连通ccr test-provider deepseek一张清单收尾把这几条养成习惯CCR 的配置就有了兜底定期备份至少每周一次完整快照多版本保留留多个时间点的备份别押注单份异地存储备份放到不同物理位置定期演练每月做一次真实恢复测试流程留痕把备份与恢复步骤写下来团队谁都能上手能自动就自动脚本 cron 替代手动备份的终点不是那份文件本身而是灾难来临时它真的能被拉回来。【免费下载链接】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），仅供参考