Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Claude Code Bridge Inspect /path/to/repo for concurrency bugs with Claude Sonnet, read-only."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Claude Code Bridge is a local, permission-aware MCP server and Codex plugin that lets Codex delegate coding and repository work to an installed Claude Code CLI. It supports explicit model and effort selection, inspect/write access, resumable sessions, attachment to existing cloud Code sessions when the account supports them, and durable synchronous or asynchronous jobs.
The bridge itself runs entirely on your computer. It does not host an MCP service, send data to Noodle Cloud, automate the Claude.ai website, or provide access to ordinary Claude.ai chats. Claude Code still communicates with Anthropic or your configured provider: prompts, repository content Claude reads, tool interactions, session metadata, and generated output may leave your computer under that provider's terms and account settings.
This is an independent, unofficial open-source project. It is not affiliated with, endorsed by, or sponsored by OpenAI or Anthropic. Codex, GPT, Claude, and Claude Code are trademarks of their respective owners.
Seven focused MCP tools for health, task launch, status, paginated results, continuation, cancellation, and forgetting bridge data.
inspect access by default with Read,Glob,Grep and plan permissions; write uses Claude Code's acceptEdits permission mode and never bypasses its permission system.
Explicit model aliases or full Claude model IDs and effort levels from low through max.
New local, explicitly resumed, and explicitly cloud-attached sessions—never an unsafe “continue most recent” operation. Create cloud sessions interactively in Claude Code before attaching them.
Private local state, two-job concurrency, 32 MiB raw-output limits, timeouts, cancellation, orphan recovery, and seven-day terminal-job retention.
Self-contained Node.js bundles for macOS, Linux, and WSL2.
Related MCP server: claude-code
Node.js 20.19 or newer
Claude Code CLI 2.1.0 or newer, installed and authenticated
macOS, Linux, or WSL2; native Windows is not supported in v0.1.x
A Git worktree for write-mode tasks
Add this Git-backed marketplace and install the plugin:
codex plugin marketplace add https://github.com/Cyruskraad/codex-claude-mcp
codex plugin add codex-claude-mcp@codex-claude-bridgeStart a new Codex task after installation, then ask Codex to run claude_health. Release ZIP and generic stdio installation options are in Installation.
Ask Codex:
Use Claude Code Bridge to inspect
/absolute/path/to/repofor concurrency bugs. Use Sonnet with high effort. Do not modify files.
Codex should check health first and call claude_task with access: "inspect". For longer jobs it can poll claude_job_status and page through claude_job_result.
The production runtime is authored in src/ and bundled to the plugin's dist/ directory. Noodle Seed is retained only for local authoring validation; no link, deployment, hosted configuration, or directory submission is part of this project.
npm ci
npm run typecheck
npm run lint
npm run test:coverage
npm run validate:allSee Contributing for the test and release workflow.
MIT © 2026 Cyruskraad.
This server cannot be deployed
Source-checked CLI guides and model-aware planning for Claude Code, Codex, and Grok Build.
No-data MCP handoff for local Claude Code to Codex harness moves. $49 lifetime.
Build and supervise fleets of agents from Claude Code, Codex or Cursor. Connects over OAuth.
Persistent memory for Claude Code and Cursor. Stop re-explaining your project every session.
