Skip to content

Latest commit

 

History

History

README.md

Claude Code for Codex

This plugin exposes a local stdio MCP server so Codex can call the installed Claude Code CLI.

Runtime

The launcher uses uv when it is available. Without uv, it uses Python 3.11+ with pip, creates a virtual environment in the plugin data directory, installs runtime dependencies from pyproject.toml, and starts the MCP server from the plugin source tree.

Tools

  • claude_setup: check whether claude is installed and authenticated. Defaults to the current repository.
  • claude_ask: ask a read-only question. Defaults to model=claude-fable-5 and effort=high.
  • claude_fix: ask Claude Code to edit files. Defaults to the current repository and the latest Claude session from this Codex session.
  • claude_continue: explicitly continue the latest Claude session recorded in this Codex session.
  • claude_task: run an advanced Claude Code task. Defaults to the current repository, write=true, model=claude-fable-5, effort=high, and the latest Claude session from this Codex session.
  • 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.

Set new_conversation=true when Claude should start without the latest Claude session. Use claude_ask when Claude should not edit files.

Local checks

uv sync --project plugins/claude-code
uv run --project plugins/claude-code python -m pytest