Skip to content

About

Use Claude Code from Codex to review code or delegate tasks. Opposite of openai/codex-plugin-cc.

Resources

Stars

4 stars

Watchers

0 watching

Forks

Latest commit

 

History

65 Commits

Folders and files

Repository files navigation

Claude Code plugin for Codex

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 -p with JSON output.
  • Model selection is explicit: fable, opus, sonnet, haiku, or a full model ID such as claude-fable-5-1, or omitted to use your Claude Code default.

Prerequisites

  • 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

Set up Claude Code

Install Claude Code if needed:

npm install -g @anthropic-ai/claude-code

Authenticate once:

claude auth login

Add the plugin marketplace

Add this repository as a Codex marketplace:

codex plugin marketplace add andiradulescu/cc-plugin-codex

The marketplace name is cc-plugin-codex.

Codex CLI

Install the plugin directly:

codex plugin add claude-code@cc-plugin-codex

Alternatively, 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.

ChatGPT desktop app

Add the marketplace with the Codex command above, or follow the local development steps below to register a personal marketplace. Then:

  1. Restart the ChatGPT desktop app.
  2. Open Plugins in the ChatGPT desktop app.
  3. 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.
  4. 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.

Codex IDE extension

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.

Local development

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:local

The 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 copy

To preview what would happen without writing anything:

npm run install:local -- --dry-run

Surface limits

ChatGPT 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:

What is included

  • 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 claude availability, auth checks, model selection, and JSON output parsing

Claude Fable

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" \
  --json

On 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.

Claude Code integration surface

The runner uses the documented Claude Code CLI flow:

  • claude -p
  • --model fable / --model claude-fable-5-1
  • --effort xhigh
  • --output-format json
  • --continue / --resume
  • claude auth status

Sources:

Test

npm test

About

Use Claude Code from Codex to review code or delegate tasks. Opposite of openai/codex-plugin-cc.

Resources

Stars

4 stars

Watchers

0 watching

Forks

Contributors

Languages