Claude Code + Hermes + Codex 多设备迁移指南

生成时间2026-07-17适用场景在新电脑上复刻当前开发环境目录迁移清单共享知识库迁移Claude Code 迁移Hermes 迁移Codex 迁移工具迁移一键迁移脚本验证清单1. 迁移清单必须迁移核心项目位置说明共享知识库D:/tools/shared-knowledge/SQLite 数据库 Python 脚本Claude Code 配置~/.claude/settings.json插件、MCP、hooksClaude Code 插件~/.claude/plugins/ECC、addy-agent-skills、last30daysClaude Code 技能~/.claude/skills/codebase-memory、fund-weekly-reviewClaude Code 记忆~/.claude/projects/C--/memory/用户偏好和项目记忆Codex 配置~/.codex/config.tomlMCP 服务器、模型配置Hermes 配置D:/.hermes/工作目录和配置可选迁移工具项目位置说明RTK~/.headroom/bin/rtk.exeToken 优化工具Agent ReachPython 包互联网调研工具Codebase Memory MCPC:/Users/Lenovo/AppData/Local/Programs/codebase-memory-mcp/代码知识图谱HeadroomD:/tools/headroom-venv/MCP 服务器2. 共享知识库迁移方案 A直接复制文件推荐# 在旧电脑上打包cdD:/toolstar-czfshared-knowledge-backup.tar.gz shared-knowledge/# 传输到新电脑后解压cdD:/toolstar-xzfshared-knowledge-backup.tar.gz方案 B使用 Git 同步# 在旧电脑上初始化 GitcdD:/tools/shared-knowledgegitinitgitadd.gitcommit-mInitial commitgitremoteaddoriginyour-private-repogitpush-uorigin main# 在新电脑上克隆cdD:/toolsgitcloneyour-private-reposhared-knowledge方案 C导出/导入数据# 在旧电脑上导出py D:/tools/shared-knowledge/kb.py listknowledge-export.txt# 在新电脑上导入需要编写导入脚本需要复制的文件D:/tools/shared-knowledge/ ├── knowledge.db# SQLite 数据库核心├── knowledge.db-shm# 共享内存文件├── knowledge.db-wal# 预写日志├── engine.py# 数据库引擎├── kb.py# CLI 接口├── mcp_server.py# MCP 服务器├── start_mcp.bat# Windows 启动脚本└── README.md# 说明文档新设备配置# 1. 安装 Python 3.12wingetinstallPython.Python.3.12# 2. 创建目录mkdirD:/tools/shared-knowledge# 3. 复制文件从旧电脑# 4. 测试py D:/tools/shared-knowledge/kb.py stats3. Claude Code 迁移需要复制的目录和文件~/.claude/ ├── settings.json# 主配置├── settings.local.json# 本地配置├── plugins/# 插件目录│ ├── installed_plugins.json# 已安装插件列表│ ├── known_marketplaces.json# 市场配置│ ├── marketplaces/# 插件源码│ │ ├── ECC/ │ │ ├── addy-agent-skills/ │ │ └── last30days-skill/ │ ├── cache/# 插件缓存│ │ ├── ecc/ │ │ └── last30days-skill/ │ └── repos/# 插件仓库│ └── agent-skills/ ├── skills/# 技能目录│ ├── codebase-memory/ │ └── fund-weekly-review/ ├── agents/# Agent 定义├── rules/# 规则文件├── hooks/# 钩子脚本└── projects/C--/memory/# 项目记忆迁移步骤# 1. 在旧电脑上打包cd~tar-czfclaude-backup.tar.gz .claude/# 2. 传输到新电脑# 3. 在新电脑上解压cd~tar-xzfclaude-backup.tar.gz# 4. 安装 Claude Codenpminstall-ganthropic-ai/claude-code# 5. 验证claude--version配置文件说明settings.json 关键配置{env:{ANTHROPIC_BASE_URL:http://127.0.0.1:8788,ANTHROPIC_AUTH_TOKEN:sk-xxx,ANTHROPIC_MODEL:mimo-v2.5-pro},enabledPlugins:{eccecc:true,agent-skillsaddy-agent-skills:true,last30dayslast30days-skill:true},mcpServers:{headroom:{command:D:\\tools\\headroom-venv\\Scripts\\headroom.exe,args:[mcp,serve,--proxy-url,http://127.0.0.1:8788]}}}4. Hermes 迁移需要复制的目录D:/.hermes/ ├── .env# 环境变量含 API Key├── config/# 配置文件├── skills/# 技能定义└──...迁移步骤# 1. 在旧电脑上打包cdD:/tar-czfhermes-backup.tar.gz .hermes/# 2. 传输到新电脑# 3. 在新电脑上解压cdD:/tar-xzfhermes-backup.tar.gz# 4. 安装 Hermes如果有安装脚本# 按照 Hermes 文档安装5. Codex 迁移需要复制的文件~/.codex/ ├── config.toml# 主配置├── plugins/# 插件├── skills/# 技能└── memories/# 记忆迁移步骤# 1. 在旧电脑上打包cd~tar-czfcodex-backup.tar.gz .codex/# 2. 传输到新电脑# 3. 在新电脑上解压cd~tar-xzfcodex-backup.tar.gz# 4. 安装 Codex 桌面应用# 从 OpenAI 官网下载安装# 5. 验证配置cat~/.codex/config.toml关键配置[model_providers.custom] name JulyCode base_url https://julyapi.com wire_api responses requires_openai_auth true [mcp_servers.shared-knowledge] command py args [D:/tools/shared-knowledge/mcp_server.py] startup_timeout_sec 106. 工具迁移RTK (Rust Token Killer)# 复制二进制文件cp~/.headroom/bin/rtk.exe新电脑:/Users/用户名/.headroom/bin/# 或者重新安装# 从 GitHub 下载最新版本Agent Reach# 在新电脑上安装pipinstallagent-reach# 配置agent-reach setup# 验证agent-reach doctor--jsonCodebase Memory MCP# 下载最新版本# https://github.com/DeusData/codebase-memory-mcp/releases# 解压到C:/Users/用户名/AppData/Local/Programs/codebase-memory-mcp/# 安装codebase-memory-mcpinstall-y# 验证codebase-memory-mcp--versionHeadroom# 创建虚拟环境python-mvenv D:/tools/headroom-venv# 安装 HeadroomD:/tools/headroom-venv/Scripts/pipinstallheadroom# 配置# 按照 Headroom 文档配置7. 一键迁移脚本旧电脑导出脚本创建export-all.batWindowsecho off echo 开始导出所有配置和数据 REM 创建备份目录 mkdir backup REM 1. 共享知识库 echo [1/6] 导出共享知识库... tar -czf backup/shared-knowledge.tar.gz -C D:/tools shared-knowledge REM 2. Claude Code 配置 echo [2/6] 导出 Claude Code 配置... tar -czf backup/claude-config.tar.gz -C %USERPROFILE% .claude REM 3. Codex 配置 echo [3/6] 导出 Codex 配置... tar -czf backup/codex-config.tar.gz -C %USERPROFILE% .codex REM 4. Hermes 配置 echo [4/6] 导出 Hermes 配置... tar -czf backup/hermes-config.tar.gz -C D:/ .hermes REM 5. RTK 工具 echo [5/6] 导出 RTK 工具... mkdir backup\headroom copy %USERPROFILE%\.headroom\bin\rtk.exe backup\headroom\ REM 6. Agent Reach 技能 echo [6/6] 导出 Agent Reach 技能... tar -czf backup/agent-reach-skills.tar.gz -C %USERPROFILE%/.agents skills echo 导出完成备份文件在 backup/ 目录 dir backup pause新电脑导入脚本创建import-all.batWindowsecho off echo 开始导入所有配置和数据 REM 检查备份文件 if not exist backup ( echo 错误未找到 backup 目录 pause exit /b 1 ) REM 1. 共享知识库 echo [1/6] 导入共享知识库... mkdir D:\tools 2nul tar -xzf backup/shared-knowledge.tar.gz -C D:/tools REM 2. Claude Code 配置 echo [2/6] 导入 Claude Code 配置... tar -xzf backup/claude-config.tar.gz -C %USERPROFILE% REM 3. Codex 配置 echo [3/6] 导入 Codex 配置... tar -xzf backup/codex-config.tar.gz -C %USERPROFILE% REM 4. Hermes 配置 echo [4/6] 导入 Hermes 配置... tar -xzf backup/hermes-config.tar.gz -C D:/ REM 5. RTK 工具 echo [5/6] 导入 RTK 工具... mkdir %USERPROFILE%\.headroom\bin 2nul copy backup\headroom\rtk.exe %USERPROFILE%\.headroom\bin\ REM 6. Agent Reach 技能 echo [6/6] 导入 Agent Reach 技能... tar -xzf backup/agent-reach-skills.tar.gz -C %USERPROFILE%/.agents echo 导入完成请按照验证清单检查 pause8. 验证清单共享知识库# 测试 CLIpy D:/tools/shared-knowledge/kb.py stats# 预期输出{total_facts: 21, ...}# 测试 MCP 服务器echo{jsonrpc:2.0,id:1,method:tools/list,params:{}}|py D:/tools/shared-knowledge/mcp_server.py# 预期输出5 个工具列表Claude Code# 检查版本claude--version# 检查插件claude plugins list# 检查 MCP 服务器claude mcp listCodex# 检查配置cat~/.codex/config.toml# 测试 MCP 服务器在 Codex 对话中# 输入列出共享知识库中的所有内容工具# RTK~/.headroom/bin/rtk.exe--version# 预期rtk 0.28.2# Agent Reachagent-reach--version# 预期Agent Reach v1.5.0# Codebase Memory MCPcodebase-memory-mcp--version# 预期codebase-memory-mcp 0.8.1常见问题Q1: 知识库数据丢失原因SQLite 数据库文件可能没有正确复制解决确保复制了knowledge.db、knowledge.db-shm、knowledge.db-wal三个文件Q2: MCP 服务器连接失败原因Python 路径或脚本路径不正确解决检查py命令是否可用检查mcp_server.py路径是否正确手动测试echo {} | py D:/tools/shared-knowledge/mcp_server.pyQ3: 插件未加载原因插件缓存或配置文件路径不匹配解决检查~/.claude/plugins/installed_plugins.json检查~/.claude/settings.json中的enabledPlugins重新安装插件claude plugin install nameQ4: 环境变量不生效原因新电脑的用户名或路径不同解决更新配置文件中的路径将C:/Users/Lenovo/替换为新用户名附录完整文件清单必须复制的文件文件位置大小knowledge.dbD:/tools/shared-knowledge/~60KBmcp_server.pyD:/tools/shared-knowledge/~8KBsettings.json~/.claude/~2KBconfig.toml~/.codex/~3KBinstalled_plugins.json~/.claude/plugins/~1KB必须复制的目录目录位置说明shared-knowledgeD:/tools/知识库完整目录.claude~/Claude Code 配置.codex~/Codex 配置.hermesD:/Hermes 配置.agents~/Agent Reach 技能