ccx Skill 技能

技能简介

ccx 是一款面向 Claude Code 与 Codex 双端用户的 macOS 上下文交接技能，它把一个 Claude Code 会话与一个 Codex 线程关联起来，双向同步消息、工具调用、任务清单与 git status。额度用完或者一边卡住时，点一下菜单栏的 ⇄ 图标，另一边就能带着完整上下文接着干；解决之后回到原来的对话说一句「继续」，进展会自动带回来。项目 MIT 协议开源，完全在本机运行，不需要注册账号，也没有服务器。

核心能力

1. 双向上下文同步：用户消息与回复、压缩后的工具调用与输出、最新任务清单（Claude 的待办或 Codex 的计划）、对面是否停在某一步中间、未完成的目标指令、粘贴过的图片路径以及 git status 都会一并带过去。
2. 菜单栏一键切换：按项目列出两边的会话，未关联显示空心圆点，已关联显示对勾，有新进展未同步显示刷新标记；界面支持中英文切换。
3. 额度提前提醒：Claude 或 Codex 的 5 小时额度用到 90% 与用完时各通知一次，菜单顶部直接给出一键把最新会话切到另一边继续的入口。
4. 斜杠命令双向搬运：Claude 侧提供 /from-codex 与 /to-codex，Codex 侧提供 $from-claude 与 $to-claude，也可以直接说「从 Claude 把某某会话导入接着干」，甚至贴一张截图让它认。
5. 命令行工具齐全：ccx doctor 体检、ccx setup 修复、ccx repair 修复历史、ccx usage 查看额度、ccx update 手动更新。
6. 成本可控：每条进展只送一次，没有新内容时再点只会提示已同步；遇到超长会话会先列出「完整导入约二十一万字符」与「新开关联对话约两万五千字符」两个数字由你选。
7. 本地优先：同步完全在本机完成，Codex 数据只经由它自己的接口读写，除安装与检查更新外不访问任何服务器，也不收集数据。

安装配置

1. 最省事的做法：把安装说明粘贴给 Claude Code 或 Codex，让它代为执行 curl -fsSL https://raw.githubusercontent.com/AaronWong1999/ccx/main/install.sh | sh，随后运行 ~/.local/bin/ccx doctor 查看体检结果。
2. 也可以自己在终端执行同一条安装命令。脚本会检查系统版本、两个桌面端与苹果命令行工具，两个桌面端都没装会直接停下、不做任何改动。
3. 环境要求：macOS 13 或更高版本，并安装 Claude 桌面版与/或 Codex 桌面版（它使用这两个应用自带的命令行工具）。
4. 权限说明：Codex 要求手动批准第三方 hook，安装脚本只批准 ccx 自己的那一个；整个过程不会索要密码、管理员权限或辅助功能权限。

使用步骤

1. 在 Claude Code 里正常干活，让它推进到一个自然的停顿点。
2. 看到额度提醒或卡住时，点菜单栏 ⇄ 选择对应项目与会话，或输入 /to-codex。
3. 在 Codex 侧接着干，进度会自动写回配对记录。
4. 需要立刻同步时，用 /from-codex（Claude 侧）或 $from-claude（Codex 侧）手动拉取一次。
5. 问题解决后回到原来的 Claude 对话，发送任意内容（比如「继续」），Codex 的进展会自动带回来。

工作原理

一个 Claude 会话与一个 Codex 线程组成一对，配对关系与双方「已经投递到哪一条」的游标保存在本机目录下的 pairs.json 文件中。你在任一侧发消息时，插件的提示钩子会把对面新增的进展追加到这条消息里，并同步推进游标，避免同一批记录被反复转发。技能与 MCP 工具在两侧各自注册：Claude 侧读取本地会话日志，Codex 侧走它自己的应用服务端接口读取与导入线程。同步内容是作为上下文交给模型的，不会变成新的聊天气泡；首次交接超长会话时保留最近约六万字符与全部提问，其余内容模型可以用 read_session 按需补读。它不绕过任何额度限制，只是在你自己的两个订阅之间搬运任务。

适用场景

• Claude 额度用完，把手上没做完的任务切到 Codex 继续；
• 一边在某个问题上打转，换个模型交叉验证一下；
• 两个 agent 接力完成同一个长任务，中途来回切换；
• 想让 Claude 和 Codex 对同一份改动互相当「第二双眼睛」。

适用人群

同时订阅了 Claude 与 ChatGPT/Codex、在 macOS 上用桌面端写代码的开发者，以及需要频繁在两个模型之间切换的 AI 编程重度用户。

官方链接

源码与完整文档：https://github.com/AaronWong1999/ccx （MIT 协议，Python 实现，作者 AaronWong1999）