codex-claude-subagent
Enables Codex to delegate tasks to interactive Claude Code sessions as role-controlled subagents for exploration, code review, and implementation, using the existing Claude Code installation on macOS.
README
Codex–Claude Subagent
An MCP plugin for the Codex desktop app and Codex CLI that uses interactive Claude Code sessions as role-controlled subagents for exploration, code review, and implementation.
Sessions remain observable and resumable from Codex. The plugin does not use
the Claude API, claude -p, API-key billing, or nested agents.
It uses the Claude Code installation already available on your Mac and does not
install Claude Code for you.
Install
You need macOS, Node.js 20 or newer, Python 3, a plugin-enabled Codex desktop
app or Codex CLI, and Claude Code already signed in with an active claude.ai
subscription.
Codex desktop app from a ZIP
The easiest way to install the plugin in the Codex desktop app is:
- Download the distribution ZIP from the latest GitHub Release
- Double-click the downloaded release ZIP file to extract it.
- Open the extracted folder and double-click
Install.commandto install the plugin.
If macOS blocks the installer the first time, right-click Install.command,
choose Open, and confirm.
Codex CLI from GitHub
For Codex CLI, add the GitHub marketplace and install the plugin:
codex plugin marketplace add zetsubo-dev/codex-claude-subagent
codex plugin add codex-claude-subagent@codex-claude-subagent
Quick start
After installation, start a new Codex conversation. No additional command or special plugin syntax is required. Describe the task in natural language and mention Claude when you want Codex to delegate it to Claude Code.
Examples:
Ask Claude to review this change.Have Claude investigate the cause of this test failure.Ask Claude to implement this fix.
Choose the Claude model and effort
Specify the model and reasoning effort in the same request when needed:
Ask Claude Sonnet to review this change with medium effort.Investigate this issue with Claude Opus using high effort.
The requested model and effort are passed through to Claude Code. If you omit either value, Claude Code uses its own default.
If this plugin is useful to you, please consider giving the repository a star. It helps others discover the project and supports further development.
License
This project is released under the MIT License.
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.
E2B
Using MCP to run code via e2b.