claude-code-migration

Python 工具集 + Claude Code Skills，把 Claude Code / Chat / Cowork 的本地数据迁到 Hermes / OpenCode / Cursor / Windsurf / neuDrive Hub

---

背景

Claude 账号风控收紧，担心积累的 CLAUDE.md / 对话 / 项目 / 自定义 agents / 技能丢失？

这个仓库提供两种等效的使用方式：

1. Python 包（推荐）— pip install 后用 ccm CLI，跑得起测试、可集成进 CI
2. Claude Code Skills — 在 Claude Code 里直接 /claude-full-migration，适合无 Python 环境场景

工具目标

SOURCES (Claude.ai 官方)          MIGRATION (2 条路线)         TARGETS (4 个 Agent 框架)
──────────────────────────        ──────────────────────       ──────────────────────────
💬 Chat          ──────────▶      🔱 neuDrive Hub   ───────▶   🔱 Hermes Agent (Nous Research)
👥 Cowork        ──────────▶         (对话归档主场)              ◇ OpenCode (sst/opencode)
💻 Claude Code   ──┬──────▶       ⚙ claude-code-migration ──▶   ✎ Cursor
                   │ (可选经 Hub)     (本项目·Cowork+Code)        ⚡ Windsurf
                   └──────────▶

Python 包（推荐）

安装

git clone https://github.com/fxp/claude-code-migration
cd claude-code-migration
python3 -m venv .venv && source .venv/bin/activate
pip install -e .

CLI 入口：ccm 或 claude-code-migration。

快速使用

# 1. 扫描一个项目（只读，输出摘要）
ccm scan --project /path/to/your-project

# 2. 迁移到某个目标（产物默认在 ./ccm-output/<target>-target/）
ccm migrate --project /path/to/your-project \
            --target hermes \
            --out ./ccm-output

# 3. 多目标并行（一份 scan 生成 4 套配置）
ccm migrate --project /path/to/your-project \
            --target hermes,opencode,cursor,windsurf \
            --out ./ccm-output

# 4. 含 Claude.ai / Cowork ZIP 导出（从 Settings → Privacy → Export data 拿到）
ccm migrate --project /path/to/your-project \
            --cowork-zip ~/Downloads/claude-data-export.zip \
            --target hermes,opencode \
            --out ./ccm-output

# 5. 推送到 neuDrive Hub (agi-bar/neuDrive)
ccm push-hub --scan ./ccm-output/scan.json \
             --token $NEUDRIVE_TOKEN \
             --api-base https://www.neudrive.ai

安全默认

⚠️ 默认 不动你的真实项目目录。所有产物包括那些"本应放到项目根"的文件（.cursor/rules/, .windsurfrules, AGENTS.md, .hermes.md）都被 staging 到 <out>/<target>-target/<project-name>/ 下。

确认无误后复制过去，或用 --in-place 让工具直接写入项目（仅在干净 git 分支上使用）。

架构

src/claude_code_migration/
├── scanner.py              Claude Code 数据扫描（47 种类型）
├── secrets.py              API Key / Bearer token 检测
├── cowork.py               Claude.ai ZIP 解析（2026 schema）
├── hub.py                  neuDrive HTTP 客户端（调 API，不拷代码）
├── __main__.py             CLI
└── adapters/
    ├── base.py             Adapter 抽象类 + AGENTS.md 合成器
    ├── hermes.py           config.yaml + memories/ + state.db SQLite FTS5
    ├── opencode.py         opencode.json + mcp 本地/远程 + skills
    ├── cursor.py           .cursor/rules/*.mdc + .cursor/mcp.json
    └── windsurf.py         .windsurfrules + .windsurf/rules/ + mcp_config.json

测试

pip install pytest
pytest tests/            # 18 个测试全部通过

• test_e2e.py (7 tests)：format-level 验证，每个 adapter 产物符合目标 schema
• test_e2e_live.py (11 tests)：真实子进程执行，例如实际跑 opencode models 验证迁移的 config 被 OpenCode 识别

目标框架支持矩阵

目标	项目上下文	MCP	记忆/技能	会话恢复	已验证
Hermes Agent	CLAUDE.md 原生 + .hermes.md	config.yaml custom_providers	~/.hermes/memories/ + skills/cc-*	✅ SQLite FTS5 state.db	✅
OpenCode	AGENTS.md + CLAUDE.md 原生	opencode.json mcp (local/remote)	.opencode/agents + cc-* skills	opencode export/import	✅ 真机验证
Cursor	AGENTS.md + .cursor/rules/*.mdc	.cursor/mcp.json	rules 系统	❌ 无会话恢复	✅ schema
Windsurf	.windsurfrules + .windsurf/rules/	mcp_config.json (serverUrl)	rules 系统	❌ 无会话恢复	✅ schema
neuDrive Hub	/memory/profile/*	/agent/vault/	/conversations/{platform}/	hermes --resume via MCP	✅

BigModel GLM-5（推荐配置）

• 注册：https://open.bigmodel.cn/ （新账号送 2000 万 tokens 免费额度）
• API key 管理：https://open.bigmodel.cn/usercenter/proj-mgmt/apikeys
• 适配器自动生成对应 provider 配置：

# Hermes (config.yaml)
model: { provider: custom, model_name: glm-5 }
custom_providers:
  bigmodel:
    base_url: https://open.bigmodel.cn/api/paas/v4
    api_key: ${OPENAI_API_KEY}

// OpenCode (opencode.json)
{
  "model": "bigmodel/glm-5",
  "provider": {
    "bigmodel": {
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "baseURL": "https://open.bigmodel.cn/api/paas/v4",
        "apiKey": "{env:GLM_API_KEY}"
      }
    }
  }
}

Claude Code Skills（备选）

如果不想装 Python，skills 版本提供同等能力（通过 Claude Code 内驱动）：

mkdir -p ~/.claude/skills
cp -r skills/* ~/.claude/skills/

然后在 Claude Code 里：

/claude-full-migration      # meta-skill，编排 4 个子 skill
/code-migration             # 多目标泛化
/hermes-migration           # Hermes 专用
/chat-migration             # Claude.ai 官方 ZIP 解析
/cowork-migration           # 团队 workspace
/neudrive-sync              # 推送到 neuDrive Hub

验证过的真实项目

在两个数据特征不同的项目上做过真实端到端测试：

OpenClaw Course（CLAUDE.md+memory+skills+sessions 场景）

• 5 memory files, 4 sessions, 18 subagents, 48 global skills, 1 MCP Bearer token
• Hermes: SQLite state.db imported 5 sessions + 133 messages, FTS5 "OpenClaw" 25 hits
• OpenCode: 55 files including all skills with cc- prefix

IdeaToProd（hooks+.mcp.json+env+launch 场景）

• 1 session (106 messages), Linear MCP via .mcp.json, PostToolUse hooks
• OpenCode 真实运行：opencode models 输出含 bigmodel/glm-5，opencode mcp list 显示 cc-web-search-prime 和 cc-proj-linear 都被加载

安全

1. 密钥不明文：所有 MCP headers 中的 Bearer token 在输出里都替换为各目标的 env 引用（${OPENAI_API_KEY} / {env:VAR} / ${env:VAR}）
2. 测试断言：test_all_targets_zero_plaintext_secrets 扫描每个 adapter 的每个输出文件，断言无 secret 值泄漏
3. 项目不被污染：默认 staging 模式，需要 --in-place 显式才写真实项目

参考链接

• neuDrive: https://github.com/agi-bar/neuDrive
• Hermes Agent: https://github.com/nousresearch/hermes-agent
• OpenCode: https://github.com/sst/opencode
• Claude Code 文档: https://code.claude.com/docs/en/overview

License

MIT