Claude Code 转 Codex

中文 | English

把同一台电脑上的 Claude Code 项目、对话和关键上下文交给 Codex，并按原项目生成可继续工作的独立任务。

这不是聊天记录的 1:1 同步，而是一次可检查的工作交接（Handoff）。

开始使用

先安装并登录 Codex，然后把下面这段话发给 Codex：

请安装并使用这个 Skill：
https://github.com/CalebYcj/claude-codex-handoff

我要把这台电脑上的 Claude Code 项目和对话接手到 Codex。
请先让我选择 Automatic handoff（自动接手）或 Claude-assisted handoff（Claude 协助接手），不要合并不同 Session，也不要覆盖 Codex 原有数据。

Codex 会提供两个入口。

Automatic handoff（自动接手，推荐）

Codex 只读检查本机 Claude Code 数据，列出找到的项目和 Session。你选择需要的内容后，Codex 自动完成：

1. 按真实项目路径整理对话。
2. 每条 Claude Session 生成一条独立 Codex 任务。
3. 在 Codex 中打开对应项目。
4. 检查项目、任务、路径和敏感文件排除结果。

这条路线不需要重新调用 Claude，也不会额外消耗 Claude Token。

Claude-assisted handoff（Claude 协助接手，备用）

如果 Codex 找不到 Claude 历史或无法判断项目归属，它会生成一段短 Prompt。你只需：

1. 把 Prompt 复制给本机 Claude Code。
2. 让 Claude 返回项目目录、Session ID 和本地历史文件地址。
3. 把 Claude 的回复交回 Codex。

Codex 随后读取这些文件并完成接手。这个入口不要求 Codex 操控 Claude 界面，也不要求安装 Claude CLI。

可以接手

• 本机 ~/.claude/projects 中的 Claude Code JSONL Session。
• 每条 Session 的用户/Claude 文本、工具名称和相关文件路径摘要。
• 当前项目文件；需要跨电脑时再使用导出工具复制。
• 用户明确选择的 ~/.claude/skills，目标端仍需检查兼容性。

项目归属以 JSONL 中真实的 cwd 为准，不以 Claude 的存储文件夹名称或对话标题猜测。

目前边界

• 第一版只支持同一台电脑上的 Claude Code → Codex。
• 不支持 Claude 网页端或只存在云端的历史。
• 不会复刻 Claude 原生聊天气泡、模型思考状态或运行中的工具进程。
• 不修改 Codex 的登录状态、SQLite、session_index.jsonl 或整个 ~/.codex。
• .env、登录信息、私钥、浏览器数据、.git、node_modules 和虚拟环境默认排除。
• 自定义文件名中的秘密无法仅靠过滤器绝对识别，分享导出包前仍应检查。

已验证

当前公开基线在 Windows 上使用两个真实 Claude Code 项目、四条独立 Session 验证：Codex 中出现两个项目，每个项目下保留两条独立接手任务，原有 Codex 数据未被替换。

For AI Agents（给 AI Agent）

以 SKILL.md 为执行真源。先提供 Automatic handoff 和 Claude-assisted handoff 两个入口；默认只读盘点并等待用户选择。按 JSONL cwd 归属项目，一条 Session 对应一条 Codex 任务，不要修改 Codex 数据库、登录状态或现有任务。

安装

最简单的方式是把仓库链接直接交给 Codex。也可以把整个仓库放到：

• Windows：%USERPROFILE%\.codex\skills\claude-codex-handoff
• macOS：~/.codex/skills/claude-codex-handoff

普通用户不需要手动运行脚本。需要审计或开发时，请阅读 SKILL.md、验收标准 和 项目注册说明。

License

MIT