cc-plugin-codex

English | 中文

cc-plugin-codex is a local Codex plugin that lets Codex call the Claude Code CLI installed on your machine through a stdio MCP server.

Install

Run these commands from this repository root:

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

Start a new Codex thread after installing or updating the plugin.

Recommended runtime: uv.

Fallback runtime: Python 3.11+ with pip. If uv is not on PATH, the plugin creates a virtual environment under the Codex plugin data directory and installs its runtime dependencies there. If neither uv nor Python 3.11+ with pip is available, the MCP server exits with a message explaining what is missing.

How to use it

Use natural language in Codex. You do not usually need to name MCP tools or pass arguments by hand.

Examples:

• Ask Claude to review without edits: Ask Claude Code to inspect this repo without editing files.
• Ask Claude to edit files: Ask Claude Code to fix the failing tests.
• Continue the same Claude conversation: Ask Claude to continue and check the last change.
• Start a fresh Claude conversation: Ask Claude Code to start a new conversation and review this module.
• Run a long task in the background: Ask Claude Code to work on this in the background.

Default behavior

• workspace_path: the current Git repository.
• model: claude-fable-5.
• effort: high.
• write: true for claude_task and claude_fix.
• Read-only questions use claude_ask, which runs Claude Code in plan mode and disables edit tools.
• Claude conversations resume within the same Codex session.
• A fresh Claude conversation starts only when you ask for one or set new_conversation=true.
• Foreground tasks time out after 900 seconds.
• Background tasks can be checked with claude_status and read with claude_result.
• When Claude reports high context use or high spending for a task, Codex will tell you to start a fresh Claude conversation next time.

What you can change

You can ask Codex to adjust these when calling Claude Code:

• workspace_path: use another absolute repository path.
• model: use another Claude model name.
• effort: use another reasoning effort.
• write: set false when Claude must not edit files.
• background: set true for long tasks.
• max_budget_usd: stop a Claude task at a budget cap.
• timeout_seconds: change the task timeout.
• new_conversation: set true to avoid resuming the latest Claude conversation.
• resume_session_id: continue a specific Claude session.

Tools

• claude_setup: check whether Claude Code is installed and authenticated.
• claude_ask: ask a read-only question.
• claude_fix: ask Claude Code to edit files.
• claude_continue: continue the latest Claude session recorded in this Codex session.
• claude_task: advanced Claude Code task runner.
• claude_status: show running and recent Claude Code jobs.
• claude_result: read a completed, failed, or cancelled job.
• claude_cancel: cancel a running background job.