Codex Claude Collab

A Codex skill for coordinating a real-time Codex and Claude Code workflow.

Codex plans the work, delegates implementation to Claude Code Sonnet or Opus, then reviews the diff and verifies the result before responding to the user.

What It Does

• Automatically starts Claude Code when delegation criteria match.
• Uses Claude Code streaming output and transcript capture.
• Defaults local delegated work to bypassPermissions so Claude can edit the shared workspace without per-tool approval prompts.
• Keeps Codex responsible for final review, verification, and user response.
• Provides handoff and follow-up templates for Codex -> Claude -> Codex loops.

Installation

1. Check Requirements

Make sure Claude Code is installed and available on your PATH:

claude --version

If that command is not found, install Claude Code first and make sure the claude command works in your terminal.

2. Install The Skill

Install with npx:

npx github:ashinno/Codex-Claude-Collab

If you already installed with npx, run the same command again to update:

npx github:ashinno/Codex-Claude-Collab

Manual git install

Clone this repo into your Codex skills directory:

mkdir -p "${CODEX_HOME:-$HOME/.codex}/skills"
git clone https://github.com/ashinno/Codex-Claude-Collab.git \
  "${CODEX_HOME:-$HOME/.codex}/skills/codex-claude-collab"

If you already cloned it before, update it instead:

cd "${CODEX_HOME:-$HOME/.codex}/skills/codex-claude-collab"
git pull

3. Verify The Install

Confirm the skill files are present:

ls "${CODEX_HOME:-$HOME/.codex}/skills/codex-claude-collab/SKILL.md"
python3 "${CODEX_HOME:-$HOME/.codex}/skills/codex-claude-collab/scripts/claude_realtime_delegate.py" --help

4. Use It In Codex

Restart Codex if it was already running, then invoke the skill:

Use $codex-claude-collab to coordinate a Codex plan, Claude implementation, and Codex review loop.

Requirements

• Codex with local skills support.
• Claude Code installed and available as claude on PATH.

Safety Boundary

The skill bypasses local Claude Code approval prompts for delegated workspace edits. It still instructs agents not to bypass operating system, account, repository, service authorization, credentials, production access, destructive commands, or explicit user instructions not to use Claude.