原文首发于我的博客blog.leeguoo.com/zh/posts/ocs-cross-agent-wake我日常同时开好几个 AI 编码会话一个 Claude Code 写功能一个 Codex 做 review一个 Pi 跑杂活。它们各自都挺能干问题是互相看不见。想让 Codex 看一眼 Claude 刚写的 diff只能我自己复制、切窗口、粘贴再把回复搬回去——人成了两个 AI 之间的剪贴板。Claude Code 和 Codex 其实都有原生的跨会话能力但只在各自产品内部有效到产品边界就停了。所以我写了 ocsOpen Cross-session一个单文件二进制让 Claude Code、Codex、Pi 和终端里的 agent 互相发消息、互相叫醒。不要服务器不要账号数据全在本机~/.ocs。用起来是什么样装好之后对任何一个会话说一句「找个 agent 帮你看看这段」它会自己去找同伴。手动也很简单ocs who # 本机有哪些活着的会话 ocs dm codex-01a06a98 帮我审下这个 diff # 发给 Codex并把它叫醒 ocs rename reviewer # 给当前会话起个好记的名字 ocs send dev 进展如何reviewer # 多方频道 谁就叫醒谁对方收到的不是「文件里多了一行」而是会话里直接冒出一条消息末尾带着一行现成的回复命令[ocs 唤醒] claude-7043ea85 在 #dm-… 提到了你seq 7 帮我审下这个 diff 回复ocs dm claude-7043ea85 your reply 线程ocs read dm-…它照着回复你这边就被叫醒。两个 agent 就这样来回聊你在旁边ocs watch看着就行。0.6跨电脑最新的 0.6 把这件事扩到了局域网。我家里一台 Mac、一台 Windows现在 Mac 上的 Claude 可以直接把「在 Windows 上跑一下构建」交给 Windows 上的 Claude 或 Codex# 机器 A # 机器 B ocs lan up ocs lan up ocs lan pair # 打印配对码 → ocs lan pair 7K2M-9QXD-… ocs dm claude-1a2b3c4dmini 帮我在 Windows 上跑一下构建让陌生机器能往你的 AI 会话里塞话安全必须先想清楚所以这部分是按「局域网里有坏人」来设计的身份只认公钥每台机器一把 Ed25519 密钥IP、机器名、对方自报的名字都只当提示。配对一次没有「首次连接即信任」配对码里带着发码方公钥指纹的前缀连上后先核对对方公钥核对通过才发自己的身份和请求。双向认证、全程加密带签名的 X25519 握手 AES-256-GCM有前向保密。未配对的机器什么都干不了除了兑现一个有效配对码其他请求一律拒绝连帧大小都限制在 1 KiB配对码输错 5 次作废。默认关闭ocs lan up才开。远端发来的消息在本机一律显示成名字你给它起的标签对方改不了。踩过的坑「成功」不等于送到了做消息系统最危险的不是报错而是看起来成功、其实丢了。ocs 里好几条铁律都是这么来的。1. Claude 返回 ok不代表消息进了对话。往 Claude Code 会话注入消息socket 那头会回ok:true。但 Claude 的crossSessionInbound默认是hold消息进待审队列5 分钟没人处理就静默丢弃。所以 ocs 从不拿这个 ok 当「已送达」ocs doctor会检查这一项引导你改成accept。2.codex queue是写存储不是投递。终端里的 Codex 只能用官方的codex queue塞消息但它只是把消息写进 thread 存储——目标会话早就退出了它照样返回成功。ocs 的做法是发之前先证明会话还活着用lsof找持有那个 rollout 文件的进程。后来又发现一些索引类的第三方进程也会持有这些文件于是再加一道身份校验持有者本身或它的祖先进程必须真的是codex否则当作不在线消息留在收件箱里等它上线。3. 结果未知绝不重发。和 ChatGPT Desktop 通信走的是它的私有 IPC。帧已经写出去、却没等到回应时消息可能到了也可能没到。这时候重发最坏情况是对方收到两条同样的指令、干两遍活。ocs 把「结果未知」当成一等状态单独报告退出码 3永远不自动重试让人或上层来判断。4. 序号只有一个真值源。每条消息有一个单调递增的 seq。早期版本把「当前 seq」另存了一份文件结果一次崩溃发生在「日志写完、seq 文件还没更新」之间重启后发出了重复 seq读取端按 seq 去重把后来的消息永久遮蔽了。现在 seq 只从日志本身推导加锁读日志尾这个问题有回归测试钉着。这些坑单拎出来都不难难的是它们在正常测试里全是绿的。安装# macOS / Linux curl -fsSL https://raw.githubusercontent.com/leeguooooo/open-cross-session/main/install.sh | sh# WindowsPowerShell irm https://raw.githubusercontent.com/leeguooooo/open-cross-session/main/install.ps1 | iex安装器会顺带给 Claude Code、Codex、Pi 装上 ocs 的 skill装完跑一次ocs doctor --fix体检。支持 macOS、Linux、WindowsMIT 开源。如果你的场景超出了一个局域网——不同网络、团队协作、跨组织——同样的用法可以平移到 Agent Party支持托管也能私有部署。GitHubleeguooooo/open-cross-session协议与威胁模型docs/lan.md有问题或想法欢迎在 GitHub 提 issue或者在下面留言。作者郭立leeguoo全栈工程师最近在做一系列让 AI agent 真正能干活的工具chrome-use、iphone-use、mail-use 等。
Claude Code 和 Codex 怎么一起用？我写了个工具让它们互相叫醒、互发消息，还能跨电脑
原文首发于我的博客blog.leeguoo.com/zh/posts/ocs-cross-agent-wake我日常同时开好几个 AI 编码会话一个 Claude Code 写功能一个 Codex 做 review一个 Pi 跑杂活。它们各自都挺能干问题是互相看不见。想让 Codex 看一眼 Claude 刚写的 diff只能我自己复制、切窗口、粘贴再把回复搬回去——人成了两个 AI 之间的剪贴板。Claude Code 和 Codex 其实都有原生的跨会话能力但只在各自产品内部有效到产品边界就停了。所以我写了 ocsOpen Cross-session一个单文件二进制让 Claude Code、Codex、Pi 和终端里的 agent 互相发消息、互相叫醒。不要服务器不要账号数据全在本机~/.ocs。用起来是什么样装好之后对任何一个会话说一句「找个 agent 帮你看看这段」它会自己去找同伴。手动也很简单ocs who # 本机有哪些活着的会话 ocs dm codex-01a06a98 帮我审下这个 diff # 发给 Codex并把它叫醒 ocs rename reviewer # 给当前会话起个好记的名字 ocs send dev 进展如何reviewer # 多方频道 谁就叫醒谁对方收到的不是「文件里多了一行」而是会话里直接冒出一条消息末尾带着一行现成的回复命令[ocs 唤醒] claude-7043ea85 在 #dm-… 提到了你seq 7 帮我审下这个 diff 回复ocs dm claude-7043ea85 your reply 线程ocs read dm-…它照着回复你这边就被叫醒。两个 agent 就这样来回聊你在旁边ocs watch看着就行。0.6跨电脑最新的 0.6 把这件事扩到了局域网。我家里一台 Mac、一台 Windows现在 Mac 上的 Claude 可以直接把「在 Windows 上跑一下构建」交给 Windows 上的 Claude 或 Codex# 机器 A # 机器 B ocs lan up ocs lan up ocs lan pair # 打印配对码 → ocs lan pair 7K2M-9QXD-… ocs dm claude-1a2b3c4dmini 帮我在 Windows 上跑一下构建让陌生机器能往你的 AI 会话里塞话安全必须先想清楚所以这部分是按「局域网里有坏人」来设计的身份只认公钥每台机器一把 Ed25519 密钥IP、机器名、对方自报的名字都只当提示。配对一次没有「首次连接即信任」配对码里带着发码方公钥指纹的前缀连上后先核对对方公钥核对通过才发自己的身份和请求。双向认证、全程加密带签名的 X25519 握手 AES-256-GCM有前向保密。未配对的机器什么都干不了除了兑现一个有效配对码其他请求一律拒绝连帧大小都限制在 1 KiB配对码输错 5 次作废。默认关闭ocs lan up才开。远端发来的消息在本机一律显示成名字你给它起的标签对方改不了。踩过的坑「成功」不等于送到了做消息系统最危险的不是报错而是看起来成功、其实丢了。ocs 里好几条铁律都是这么来的。1. Claude 返回 ok不代表消息进了对话。往 Claude Code 会话注入消息socket 那头会回ok:true。但 Claude 的crossSessionInbound默认是hold消息进待审队列5 分钟没人处理就静默丢弃。所以 ocs 从不拿这个 ok 当「已送达」ocs doctor会检查这一项引导你改成accept。2.codex queue是写存储不是投递。终端里的 Codex 只能用官方的codex queue塞消息但它只是把消息写进 thread 存储——目标会话早就退出了它照样返回成功。ocs 的做法是发之前先证明会话还活着用lsof找持有那个 rollout 文件的进程。后来又发现一些索引类的第三方进程也会持有这些文件于是再加一道身份校验持有者本身或它的祖先进程必须真的是codex否则当作不在线消息留在收件箱里等它上线。3. 结果未知绝不重发。和 ChatGPT Desktop 通信走的是它的私有 IPC。帧已经写出去、却没等到回应时消息可能到了也可能没到。这时候重发最坏情况是对方收到两条同样的指令、干两遍活。ocs 把「结果未知」当成一等状态单独报告退出码 3永远不自动重试让人或上层来判断。4. 序号只有一个真值源。每条消息有一个单调递增的 seq。早期版本把「当前 seq」另存了一份文件结果一次崩溃发生在「日志写完、seq 文件还没更新」之间重启后发出了重复 seq读取端按 seq 去重把后来的消息永久遮蔽了。现在 seq 只从日志本身推导加锁读日志尾这个问题有回归测试钉着。这些坑单拎出来都不难难的是它们在正常测试里全是绿的。安装# macOS / Linux curl -fsSL https://raw.githubusercontent.com/leeguooooo/open-cross-session/main/install.sh | sh# WindowsPowerShell irm https://raw.githubusercontent.com/leeguooooo/open-cross-session/main/install.ps1 | iex安装器会顺带给 Claude Code、Codex、Pi 装上 ocs 的 skill装完跑一次ocs doctor --fix体检。支持 macOS、Linux、WindowsMIT 开源。如果你的场景超出了一个局域网——不同网络、团队协作、跨组织——同样的用法可以平移到 Agent Party支持托管也能私有部署。GitHubleeguooooo/open-cross-session协议与威胁模型docs/lan.md有问题或想法欢迎在 GitHub 提 issue或者在下面留言。作者郭立leeguoo全栈工程师最近在做一系列让 AI agent 真正能干活的工具chrome-use、iphone-use、mail-use 等。
