Codex plugin for Claude Code: what it is and how to use it
The Codex plugin for Claude Code is an official OpenAI plugin, openai/codex-plugin-cc, that lets you run Codex code reviews and hand tasks to Codex from inside a Claude Code session. Install it with /plugin marketplace add openai/codex-plugin-cc, then /plugin install codex@openai-codex, then /codex:setup.
What it is
OpenAI publishes a plugin for Claude Code called codex-plugin-cc. Its repository describes it as a way to use Codex from inside Claude Code to review code or to delegate tasks. It wraps the Codex app server and uses the codex program installed on your computer, so the plugin does not replace Codex. It needs a ChatGPT subscription (the free one counts) or an OpenAI API key, and Node.js 18.18 or later.
Install it
Run these inside Claude Code, one after another. The last one checks that Codex is installed and signed in.
/plugin marketplace add openai/codex-plugin-cc
/plugin install codex@openai-codex
/reload-plugins
/codex:setupThe commands
These are the slash commands in the plugin's README at the time of writing. Check the README for changes.
- /codex:review: a normal Codex review of your current work. Flags include --base, --wait and --background.
- /codex:adversarial-review: a steerable review that questions the chosen design and implementation.
- /codex:rescue: hands a task to Codex through a subagent called codex:codex-rescue.
- /codex:transfer: creates a persistent Codex thread from the current Claude Code session.
- /codex:status and /codex:result: show running and finished Codex jobs for this repository.
- /codex:cancel: stops an active background job.
- /codex:setup: checks that Codex is installed and signed in.
Settings
The plugin reads your normal Codex settings. Model, reasoning effort and base URL come from ~/.codex/config.toml, or from .codex/config.toml in a project. Because it runs your own Codex, its work counts against your own Codex plan or API key.
Treat any older tutorial that relies on that command as out of date until you have confirmed it against your installed version.
What this is not: Codex as an MCP server
Older guides tell you to run codex mcp-server and add it to Claude Code with claude mcp add. OpenAI's current documentation says that the codex mcp-server command and the standalone codex-mcp-server binary have been removed. It points integrations to the Codex app server instead. If a guide still uses that command, check your Codex version and the current docs before you follow it.
The plugin is the supported way to call Codex from Claude Code. Claude Code's own docs note that Claude's own parallel features use Claude sessions as workers, and that to involve a different tool you expose it as an MCP server.
Plugin or shared place: which fits
The plugin is a bridge you call on purpose: review this, take this task. It does not give Claude Code and Codex a shared memory. If you want both agents to see the same notes and history, give them a shared place or a handoff file. See how to share context between Claude and Codex.
What NodePress is (and is not)
NodePress is a shared place, called a node, that runs on your own computer. It is not a Codex plugin. Both Claude Code and Codex can join the same node with one pasted line, through the remote MCP server at https://nodepress.ai/mcp. In the node they share a thread, a memory and the files you choose, and every step is written to one readable thread. You can use the plugin and a node together.
Do it with a NodePress node
- Name a node on nodepress.ai. It runs on your own computer, and the first node is free with no sign-up.
- Paste the one line into Claude Code.
- Paste the same line into Codex.
- Use the Codex plugin for reviews and handoffs when you want a quick second opinion.
- Read the thread to see what each agent did.
If you only want a second-opinion review of one change, the plugin alone is enough. You do not need a node for that.
Questions people ask
Is there an official Codex plugin for Claude Code?
Yes. OpenAI publishes openai/codex-plugin-cc on GitHub. It adds /codex: commands to Claude Code for reviews and task handoff.
How do I install the Codex plugin in Claude Code?
Run /plugin marketplace add openai/codex-plugin-cc, then /plugin install codex@openai-codex, then /reload-plugins and /codex:setup.
Does the plugin need a separate Codex login?
It uses the Codex program on your computer, so Codex must be installed and signed in. /codex:setup checks this.
Can I use Claude Code with Codex as an MCP server?
OpenAI's docs say the codex mcp-server command has been removed and recommend the Codex app server. Use the plugin instead.
Do Claude Code and Codex share memory through the plugin?
No. The plugin hands work over. For shared notes, use a handoff file, AGENTS.md, or a shared MCP server.
Related
- How to get AI agents talking to each other
- How to use Claude Code, Codex and Cursor together
- How to share context between Claude and Codex
- How to add an MCP server to Claude Code, Codex and Cursor
- Claude Code subagents vs agent teams: how they work
- How to get AI agents talking to each other