Codex Claude Bridge
Bidirectional bridge between Claude Code and OpenAI Codex CLI. Built on Claude Code Channels. Two AI agents, one conversation, real-time web UI.
What is Codex Claude Bridge?
Codex Claude Bridge is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to bidirectional bridge between claude code and openai codex cli. built on claude code channels. two ai agents, one conversation, real-time web ui.
Bidirectional bridge between Claude Code and OpenAI Codex CLI. Built on Claude Code Channels. Two AI agents, one conversation, real-time web UI.
This server falls under the Coding Agents category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Bidirectional bridge between Claude Code and OpenAI Codex CL
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx codex-claude-bridgeConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Codex Claude Bridge
Codex Claude Bridge creates a bidirectional communication channel between Claude Code and OpenAI's Codex CLI, enabling the two AI agents to collaborate in the same conversation thread. Built on Claude Code Channels, it routes messages between the two agents through a lightweight local bridge server that exposes MCP tools on both sides, while also serving a real-time web UI at localhost:8788 where you can watch the two agents deliberate in a shared conversation. It is designed for developers who want to pit or combine different AI coding assistants on the same problem.
Prerequisites
- Bun runtime installed (bun.sh) — the project uses bun install and bun run
- Claude Code installed and authenticated
- OpenAI Codex CLI installed and authenticated with an OpenAI API key
- Git to clone the repository
Clone the repository
Clone the Codex Claude Bridge source and enter the project directory.
git clone https://github.com/abhishekgahlot2/codex-claude-bridge.git
cd codex-claude-bridgeInstall dependencies with Bun
Install all project dependencies using Bun.
bun installStart the bridge server
Start the bridge server. It listens on port 8788 by default and exposes MCP endpoints for both Claude Code and Codex CLI.
bun run startOpen the web UI
Open the real-time conversation dashboard in your browser to watch both agents communicate.
open http://localhost:8788Configure Claude Code to use the bridge MCP server
Add the bridge as an MCP server in Claude Code so it gains the send_to_codex tool.
{
"mcpServers": {
"codex-claude-bridge": {
"command": "bun",
"args": ["run", "start"],
"cwd": "/path/to/codex-claude-bridge",
"env": {
"CODEX_BRIDGE_PORT": "8788",
"CODEX_BRIDGE_URL": "http://localhost:8788"
}
}
}
}Initiate a cross-agent conversation from Codex
From Codex CLI, start a prompt that uses the bridge. Codex will send messages to Claude and wait for replies using the blocking tool mechanism.
codex "Use the Claude bridge to discuss whether we should use Redis or Memcached for caching. Keep going until you both agree."Codex Claude Bridge Examples
Client configuration
Claude Code MCP config for the Codex Claude Bridge server.
{
"mcpServers": {
"codex-claude-bridge": {
"command": "bun",
"args": ["run", "start"],
"cwd": "/path/to/codex-claude-bridge",
"env": {
"CODEX_BRIDGE_PORT": "8788",
"CODEX_BRIDGE_URL": "http://localhost:8788"
}
}
}
}Prompts to try
Example prompts that exercise the Claude-Codex bidirectional bridge.
- "Send a message to Codex asking it to propose a folder structure for a new microservices project."
- "Tell Codex about the bug I just found in the auth module and ask for its opinion on the fix."
- "Use the Claude bridge to debate with Codex: should we use TypeScript or Python for this service?"
- "Check if there are any pending messages from Codex and summarize them."Troubleshooting Codex Claude Bridge
Bridge server fails to start — 'bun: command not found'
Install Bun from https://bun.sh by running: curl -fsSL https://bun.sh/install | bash. Then open a new terminal session so the PATH update takes effect.
Codex cannot reach the bridge at localhost:8788
Verify the bridge server is running ('bun run start' should show a listening message). Check CODEX_BRIDGE_URL is set correctly. If you changed the port via CODEX_BRIDGE_PORT, ensure CODEX_BRIDGE_URL reflects the same port.
Messages from Codex never arrive in Claude Code
The send_to_codex and check_claude_messages tools must be registered in both clients. Confirm Claude Code's MCP config has the bridge server and that it started successfully. Reload the Claude Code MCP server list if needed.
Frequently Asked Questions about Codex Claude Bridge
What is Codex Claude Bridge?
Codex Claude Bridge is a Model Context Protocol (MCP) server that bidirectional bridge between claude code and openai codex cli. built on claude code channels. two ai agents, one conversation, real-time web ui. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Codex Claude Bridge?
Follow the installation instructions on the Codex Claude Bridge GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Codex Claude Bridge?
Codex Claude Bridge works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Codex Claude Bridge free to use?
Yes, Codex Claude Bridge is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Codex Claude Bridge Alternatives — Similar Coding Agents Servers
Looking for alternatives to Codex Claude Bridge? Here are other popular coding agents servers you can use with Claude, Cursor, and VS Code.
Dify
★ 142.2kProduction-ready platform for agentic workflow development.
Ruflo
★ 54.0k🌊 The leading agent orchestration platform for Claude. Deploy intelligent multi-agent swarms, coordinate autonomous workflows, and build conversational AI systems. Features enterprise-grade architecture, self-learning swarm intelligence, RAG integrat
Goose
★ 45.7kan open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM
Antigravity Awesome Skills
★ 38.3kInstallable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.
AgentScope
★ 25.5kBuild and run agents you can see, understand and trust.
Serena
★ 24.5kA coding agent toolkit that provides IDE-like semantic code retrieval and editing tools, enabling LLMs to efficiently navigate and modify codebases using symbol-level operations instead of basic file reading and string replacements.
Browse More Coding Agents MCP Servers
Explore all coding agents servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Codex Claude Bridge in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Codex Claude Bridge?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.