Requires Node.js 22+. In Windows PowerShell, use instead of . Run the same command to update; reconnect MCP servers if their settings or installation paths changed.
Connect Claude, Codex, and Antigravity through MCP, with native Desktop handoffs and bridge-owned Antigravity CLI sessions.
2026-11-16
स्टार
—
टूल
—
अपटाइम
—
npm.cmd
npm
On macOS or Linux you can install with Homebrew instead, which brings its own Node.js:
brew install buidangminh23/tap/codex-mcp-bridge
Update with brew upgrade codex-mcp-bridge. The installers record Homebrew's stable opt paths, so registrations keep working after an upgrade and running bridges reload the new version. Keep one install channel: whichever of npm or Homebrew comes first on PATH provides the commands.
Install and sign in to Codex Desktop and Claude Desktop. Save the project in Codex Desktop and open the same directory in Claude Desktop's Code tab. Have the Codex and Claude Code CLIs available.
If the Codex CLI is missing, run winget install --id OpenAI.Codex --exact, open a new terminal, then run codex.exe login.
Claude Desktop and Claude Code have separate MCP registrations. If claude --version is unavailable, install Claude Code first. For a new registration, replace the example project path below with the actual directory. Preserve custom settings if codex-bridge is already registered.
and end the command with -- "$node_bin" "$bridge_root/src/mcp-supervisor.mjs" index.mjs.
Separate multiple allowed directories with ; on Windows or : on macOS/Linux.
Native relay pipe forwarding
On Windows and macOS, codex-native-relay-install adds this to the relay's entry in ~/.codex/config.toml (or $CODEX_HOME/config.toml) and keeps its other settings:
If you register the relay by hand, add the same line and append the variable name if env_vars already exists. Only the name is saved, never the temporary pipe path. Restart Codex Desktop after active work finishes so it relaunches the relay.
Linux / WSL (Bash)
Use Node.js 22+ and signed-in Codex and Claude Code CLIs under the same Linux user. This mode uses a local app-server; native Desktop integration requires Windows or macOS.
Replace $HOME/YourProject with the actual project directory. WSL and Windows use separate paths and registrations.
Verify the installation
Reconnect the affected MCP servers in the actual client tasks; Claude Code provides /mcp. Run these MCP tools inside the apps:
Client
Tool
Claude Code
codex_bridge_status
Codex
claude_bridge_status
Codex Desktop
native_relay_status
Send a short message and confirm its reply in both directions. Registration alone does not prove delivery.
Use
Claude → Codex: “Send this review to my Codex task in this project and wait for its reply.”
Codex → Claude: “Send this result to my Claude Desktop Code session in this project.”
Codex → Codex on another computer: configure an SSH project mapping, then use remote_codex to list, read or message an existing Desktop task. Different Codex accounts on the two computers are supported. See remote Codex setup.
New work: “Create a new Codex conversation for this feature and send the brief there.”
Continue unfinished work with its original threadId. For an authorized new Desktop task, use delegate_to_codex or start_codex_thread with a fresh UUID requestId; retain that ID on retries. If a send times out, use wait_codex_reply with the original deliveryId before retrying the message.
Open Codex Bridge to connect ChatGPT to a selected project on a Windows or macOS computer. After installing the package and native relay above, pair the connector:
In PowerShell use codex-sites-connector.cmd and a Windows path such as C:\Projects\YourProject. Open the printed pairing URL, sign in, and select Connect this computer. Keep Codex Desktop and the connector running; use codex-sites-connector to reconnect later.
The MCP endpoint is https://codex-mcp-bridge.buidangminh23.chatgpt.site/mcp. Plugin availability follows OpenAI's Sites access rules; a public directory listing is not claimed.
The service is operated by Bui Dang Minh on OpenAI Sites. It stores a Site-scoped account ID, connector ID and token hash, timestamps, tool arguments (including prompts), and returned Desktop results. The operator can access these records. Local credentials and receipts stay in ~/.codex/sites-bridge.
Dispatch expires after two minutes; operation history remains stored. Disconnecting revokes the connector and cancels queued work, but does not erase history or stop dispatched tasks. For deletion requests, contact the operator through the repository's support link without posting private content publicly. The hosted Worker implements no advertising or analytics collection.
Troubleshooting
Command missing: open a new terminal and check Node.js 22+ and the global npm directory (or Homebrew's bin) on PATH.
PowerShell blocks scripts: use npm.cmd, installer .cmd launchers, and codex.exe.
No sessions or wrong project: open the intended Claude Code session and use the exact project directory saved in Codex Desktop.
Relay unavailable: Codex Desktop runs the relay only while a task has its MCP servers loaded. On macOS the bridge opens the destination task (or your project's latest Codex task) in the background to start it; otherwise open a regular project task and send it a turn. If it still fails, check pipe forwarding and run native_relay_status in that task.
Timeout or unconfirmed send: inspect the original task or receipt before sending again.
Usage reporting is off by default. Manage it with codex-mcp-bridge telemetry enable, telemetry status, or telemetry disable. Reports contain a random installation ID, UTC day, version, and OS; no chat content, paths, account identity, or credentials. DO_NOT_TRACK=1 or CODEX_BRIDGE_TELEMETRY=0 disables reporting. Disabling removes the local ID; submitted records expire after 90 days during ingestion.
अभी टूल सूची नहीं है। रिमोट सर्वर को पहले हेल्थ चेक के बाद सूची मिलती है।
FAQ
सवाल
@minhspark/codex MCP Bridge कैसे इंस्टॉल करें?
इस पेज पर Cursor, Claude Desktop, Claude Code या VS Code के लिए stdio कॉन्फ़िग कॉपी करें। यह पब्लिशर का इंस्टॉल इस्तेमाल करता है, PlugMCP प्रॉक्सी नहीं।
क्या @minhspark/codex MCP Bridge के लिए API key चाहिए?
इस रिकॉर्ड में कोई ज़रूरी एनवायरनमेंट वेरिएबल दर्ज नहीं है।
@minhspark/codex MCP Bridge कौन सा ट्रांसपोर्ट इस्तेमाल करता है?
@minhspark/codex MCP Bridge stdio पर लोकल चलता है।
@minhspark/codex MCP Bridge की पिछली जाँच कब हुई थी?
पिछली जाँच 2026-11-16 को हुई। Connect Claude, Codex, and Antigravity through MCP, with native Desktop handoffs and bridge-owned Antigravity CLI sessions.