This package adds a local Codex plugin that lets Codex delegate work to Claude Code through the Claude CLI.
The plugin is implemented as a Codex skill plus a small runner script. That keeps the integration simple:
- Codex decides when a Claude pass is useful.
- The skill invokes
claude -pwith JSON output. - Model selection is explicit:
fable,opus,sonnet,haiku, or a full model ID such asclaude-fable-5-1, or omitted to use your Claude Code default.
- Node.js >= 22
- Codex CLI, the ChatGPT desktop app, or the Codex IDE extension with plugin support
- Claude Code CLI installed and authenticated
- Claude Code >= 2.1.257 to use Claude Fable 5.1 (>= 2.1.170 for Fable 5)
Install Claude Code if needed:
npm install -g @anthropic-ai/claude-codeAuthenticate once:
claude auth loginAdd this repository as a Codex marketplace:
codex plugin marketplace add andiradulescu/cc-plugin-codexThe marketplace name is cc-plugin-codex.
Install the plugin directly:
codex plugin add claude-code@cc-plugin-codexAlternatively, start Codex, type /plugins, choose the Claude Code for Codex marketplace, and install Claude Code. Start a new Codex session after installation so the bundled skill becomes available.
Add the marketplace with the Codex command above, or follow the local development steps below to register a personal marketplace. Then:
- Restart the ChatGPT desktop app.
- Open Plugins in the ChatGPT desktop app.
- Choose the Claude Code for Codex marketplace and install Claude Code. If the local helper preserved an existing personal marketplace, choose that marketplace's existing title instead.
- Start a new task after installation.
The plugin directory is available from Work and Codex, but this plugin launches the machine-local Claude Code CLI. Use it from a Codex environment that has access to the local claude executable and authenticated session.
Open Settings > Plugins, choose the Claude Code for Codex marketplace, and install Claude Code for the connected Codex host. If the local helper preserved an existing personal marketplace, choose that marketplace's existing title instead. Start a new chat after installation.
Clone the repository and register its marketplace as a personal local source:
git clone https://github.com/andiradulescu/cc-plugin-codex.git
cd cc-plugin-codex
npm run install:localThe helper merges the plugin entry into ~/.agents/plugins/marketplace.json and symlinks the plugin directory into ~/.codex/plugins/claude-code. It registers the marketplace source but does not install or enable the plugin. It prints the exact codex plugin add command for the resulting marketplace, including an existing personal marketplace name when one is already configured. Run that command or install the plugin from the desktop plugin directory.
Codex runs an installed copy of the plugin from ~/.codex/plugins/cache/<marketplace>/claude-code/<version>, not the marketplace source, even in symlink mode. After changing the plugin, rerun codex plugin add claude-code@<marketplace> to refresh that copy, then start a new Codex session. The ChatGPT desktop app also needs a restart to pick up the refreshed copy.
To copy files, which matches OpenAI's documented manual local-install layout, instead of symlinking:
npm run install:local -- --mode copyTo preview what would happen without writing anything:
npm run install:local -- --dry-runChatGPT Work on the web can install published or curated plugins, but OpenAI documents local filesystem marketplaces for the ChatGPT desktop app. This repository is a skill-only plugin with a local CLI runner, not an Apps SDK app, and does not use ChatGPT developer mode or an HTTPS MCP endpoint.
OpenAI references:
- Use and install plugins
- Build and install local plugins
- Codex plugin commands
- Connect an Apps SDK app
- A local Codex marketplace at
.agents/plugins/marketplace.json - A plugin at
plugins/claude-code - A skill that teaches Codex when and how to call Claude Code
- A helper script that handles
claudeavailability, auth checks, model selection, and JSON output parsing
Select Fable 5.1 explicitly with --model claude-fable-5-1 for complex, long-running work. The bridge also accepts Fable's xhigh effort level:
node plugins/claude-code/skills/claude-code-bridge/scripts/claude-code-bridge.mjs run \
--model claude-fable-5-1 \
--effort xhigh \
--prompt "Investigate and fix this complex failure" \
--jsonOn Claude Code 2.1.257 or later, --model fable normally selects Fable 5.1. ANTHROPIC_DEFAULT_FABLE_MODEL can override that alias, and Claude apps gateway sessions resolve it to Fable 5. Use the full model ID when you need a specific version. On the Anthropic API, Fable 5 remains selectable with --model claude-fable-5.
Fable models require data retention by default; availability under zero data retention depends on your organization's Covered Models policies. Cybersecurity and biology requests can trigger automatic safety fallback to an Opus model.
The runner uses the documented Claude Code CLI flow:
claude -p--model fable/--model claude-fable-5-1--effort xhigh--output-format json--continue/--resumeclaude auth status
Sources:
npm test