Local Codex Delegation
Invoke the local OpenAI Codex CLI as a non-interactive sub-agent to generate, refactor, or review code from Claude Code.
Dev & CodingIntermediate★ 1,323⑂ 212AI score 8/10Last updated: Aug 8, 2026
What it does
- Runs your locally installed Codex CLI in non-interactive
codex execmode to offload coding work. - Wraps calls with
scripts/codex_wrapper.py, returning structured JSON (success, exit code, elapsed time, final message). - Auto-detects the Codex binary across desktop app, npm global, Homebrew, and
which codex. - Forces ChatGPT Pro OAuth from
~/.codex/auth.jsonand explicitly forbids API keys, avoiding pay-per-use charges. - Lets you pick sandbox level (read-only / workspace-write / danger-full-access), model, and timeout.
Who it's for
- Developers with a ChatGPT Pro subscription who want to split work between Claude Code and Codex.
- Teams automating pre-commit review of uncommitted diffs.
- Anyone offloading long code-generation runs to a separate agent.
Examples
- "Review the uncommitted changes in this repo with codex" →
codex_wrapper.py review /path/to/repo gpt-5.5 true 300. - "Have codex write a Python fibonacci function" →
execmode with workspace-write sandbox. - "Check codex status" →
codex_wrapper.py statusto verify CLI path and OAuth health.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/daymade/claude-code-skills/HEAD/local-codex/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the local-codex folder from the GitHub repo daymade/claude-code-skills into my ~/.claude/skills/local-codex/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/daymade/claude-code-skills.git /tmp/ccs && mkdir -p ~/.claude/skills && cp -r /tmp/ccs/local-codex ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal.
- Clone the repo:
git clone https://github.com/daymade/claude-code-skills.git - Create the skills folder:
mkdir -p ~/.claude/skills - Copy the skill:
cp -r claude-code-skills/local-codex ~/.claude/skills/ - Install Codex CLI (e.g.
npm i -g @openai/codexor the Codex desktop app). - Run
codex loginand finish the browser OAuth flow. Do NOT setOPENAI_API_KEY. - Verify Python 3 is available:
python3 --version - Restart Claude Code and try "use codex to review my code" to trigger the skill.
View source on GitHub ↗License: MIT