Codex Claude Bridge — Communication skill for Claude Code
Bridge existing Codex and Claude Code sessions with MCP messaging, automatic context compaction and a multi-project dashboard.
How to install Codex Claude Bridge
This entry records only its repository, not the path inside it, so there is no
exact command to give. Open Heisenbear-Rebirth/codex-claude-bridge and copy the folder into
~/.claude/skills/, or the file into ~/.claude/agents/.
What Codex Claude Bridge does
Bridge existing Codex and Claude Code sessions with MCP messaging, automatic context compaction and a multi-project dashboard.
Alternatives in Communication
- Lark Coding Agent Bridge — Bot that bridges Feishu/Lark messenger with a local Claude Code or Codex CLI 2.4k ★
- ClawSwarm — A smaller, lighter-weight version of OpenClaw, natively multi-agent, compiles to Rust, and built on the Swarms 176 ★
- Pokegents — Pokegents is a local, Pokémon-inspired dashboard that turns Claude Code and Codex sessions into a local team d 95 ★
README
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
Related Skills
Cross Agent MCP
Relay MCP server for live Claude Code and Codex sessions (terminal or VS Code) — cross-agent (Claude <-> Codex
Agent Bridge MCP
Local MCP messaging between Claude Code and Codex sessions on the same machine
Context Injection
Configure and tune automatic context injection for Memory OS. Covers the Icarus pre_llm_call hook flow, 4 sour
Codex Peer Bridge
Local Unix-socket messaging bridge between Codex sessions and Claude Code peers
Agent Peers MCP
Peer discovery + messaging MCP letting multiple Claude Code and Codex CLI sessions coordinate on one machine.
Tincan
Peer messaging between live Claude Code, Codex and opencode sessions on one machine. One binary, run as an MCP
Related Agents
Claude Code Tools
by Prasad Chalasani - Well-crafted toolset for session continuity, featuring skills/commands to avoid compacti
Codex Bridge
把指定工作外包給 gpt-5.5(codex)並忠實回傳其輸出。當需要 gpt-5.5 的批量實作或獨立第二審查視角時使用。這是 plugin 內第三種 codex 路徑:一次性 codex exec CLI 呼叫、輸出
Codex Teammate
Use Codex as a bounded implementation and review teammate through claude-codex-mcp-bridge.