Install Codex Subagent 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.
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"parisbs-codex-subagent-mcp": {
"command": "npx",
"args": [
"-y",
"codex-subagent-mcp@0.5.0"
],
"env": {
"CODEX_SUBAGENT_DEFAULT_MODEL": "",
"CODEX_SUBAGENT_DEFAULT_EFFORT": "",
"CODEX_SUBAGENT_ALLOWED_MODELS": "",
"CODEX_SUBAGENT_DEFAULT_SANDBOX": "",
"CODEX_SUBAGENT_MAX_SANDBOX": "",
"CODEX_SUBAGENT_MAX_EFFORT": "",
"CODEX_SUBAGENT_MCP_SERVERS": "",
"CODEX_SUBAGENT_PLUGINS": "",
"CODEX_SUBAGENT_APPS": "",
"CODEX_BIN": ""
}
}
}
}