Codex Claude Bridge — Communication skill for Claude Code

Codex Claude Bridge

**让已有的 Codex 与 Claude Code 会话直接协作，让长任务在上下文压缩后接着做。**

Codex Claude Bridge（管理页与命令名称：**Cooperation**）连接 **Codex 桌面 App** 和 **VS Code 中的 Claude Code**。你继续使用熟悉的原生对话界面，为不同会话分配工作；agent 通过 MCP 或 CLI 互相发送任务、评审意见和结果，本地工作台集中展示多个项目的会话、消息和上下文用量。

**OpenCode 通信、上下文显示与自动维护已接入**：新版插件支持软/硬阈值的交付、原生压缩、恢复和条件继续，默认按会话关闭。启用方法、原生验证及并发边界见 [OpenCode 自动维护](docs/OPENCODE-MAINTENANCE.md)。主动创建、加载会话方向仍已取消；状态见 [取消与收尾](docs/SESSION-LIFECYCLE-CANCELLED.md)。安装与通信验收见 [OpenCode 接入](docs/OPENCODE.md)，桌面应用壳仍未验收。

它把 **原生会话通信、跨项目管理、上下文交接与恢复** 放进同一条工作流：从“请另一个 agent 看看这个方案”，到“上下文快满了，保存进度、压缩、恢复并接着协作”。

[快速部署](#快速部署) · [发送第一条消息](#发送第一条消息) · [配置-mcp](#配置-mcp) · [自动上下文维护](#自动上下文维护) · [常见问题](#常见问题)

核心特色

特色	带来的体验
协作发生在已有原生会话中	Codex 留在桌面 App，Claude 留在 VS Code；沿用原任务 ID、已有上下文和客户端模型配置。
会话可以双向通信	把对方地址交给 agent，它就能通过 MCP 或 CLI 发消息；每条消息自动附带真实发送者的名称、ID 和消息编号。
一个工作台管理多个项目	按目录浏览会话，或将跨目录会话组成自定义项目；右侧集中查看成员、设置和通信。
长任务有完整的上下文交接流程	达到阈值后保存交付文档，取得回执，再原生压缩、加载上文、取得恢复回执；原本正在工作的任务才自动继续。
维护期间，协作消息有序等待	每个会话独立持有维护锁与持久队列，恢复后按先后顺序投递；服务重启后仍保留流程与队列。
轻量、本地运行	Node.js 原生模块、SQLite、静态管理页，零 npm 运行依赖；复用原客户端登录，无需为 Bridge 另配模型 API Key。

**项目的核心差异，是把“原生界面里的 agent 协作”和“长任务的上下文续接”一起做好。** 用户决定参与者与分工，agent 负责交换工作成果，Cooperation 负责传递消息、展示状态和执行获准的维护流程。

例如：让 Codex 实现一个功能，让 Claude 审查方案与变更；发现问题后直接发回原 Codex 会话。两端各自保留自己的任务上下文，协作可以跨越一次上下文压缩继续进行。

flowchart LR
    C[Codex 桌面原生会话] <-->|MCP / CLI| B[Cooperation 本地服务]
    B <-->|消息与原生控制| A[Claude Code 原生会话]
    U[用户管理页] -->|选择目录、查看通信、配置阈值| B
    B --- D[持久消息、维护流程与队列]

快速部署

1. 准备环境并获取项目

当前部署与原生验收以 **Windows x64** 为基线。

需要准备	用途
Node.js 22.13 或更新版本	运行本地服务、MCP 与 CLI；本项目已验证 Node.js 25.2.1。
已登录的 Codex 桌面 App	使用已有 Codex 会话及本机发送桥。
VS Code 与已登录的 Claude Code 扩展	使用已有 Claude 会话。
Windows .NET Framework C# 编译器	构建 Claude 接入程序；构建脚本会检查本机是否已有。
Git，或下载后的源码 ZIP	获取项目。

git clone https://github.com/Heisenbear-Rebirth/codex-claude-bridge.git C