Install guide · Claude Desktop
Install codex-bridge for Claude Desktop
Claude Desktop reads mcpServers from claude_desktop_config.json. Restart the app after saving.
Open ~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows, or ~/.config/Claude/claude_desktop_config.json on Linux.
Paste the JSON config below.
Replace placeholder secrets, then restart the client if it does not reload on its own.
{ "mcpServers": { "xallindrome-labs-codex-bridge": { "command": "npx", "args": [ "-y", "@xallindrome-labs/codex-bridge@0.1.0" ], "env": { "CODEX_BIN": "", "CODEX_BRIDGE_HOME": "", "CODEX_BRIDGE_IDLE_TIMEOUT_MS": "", "CODEX_BRIDGE_PLAN_MODEL": "", "CODEX_BRIDGE_PLAN_EFFORT": "", "CODEX_BRIDGE_IMAGE_MODEL": ""
Where the config lives
| System | Path |
|---|---|
| macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Windows | %APPDATA%\Claude\claude_desktop_config.json |
| Linux | ~/.config/Claude/claude_desktop_config.json |