Delegate tasks to OpenAI Codex CLI to save Claude context.
When to Use Codex
| Use Codex For | Keep in Claude |
|---|---|
| Simple file edits | Complex reasoning |
| Bulk refactoring | Architecture decisions |
| Code generation from specs | Problem analysis |
| Documentation updates | Multi-step workflows |
Prerequisites
npm install -g @openai/codex
Handoff Process
1. Prepare Context
## Task for Codex
**Goal**: [What needs to be done]
**Files**: [Which files to modify]
**Details**: [Specific requirements]
2. Generate Command
# Single file
codex "Update login function in src/auth.ts to add rate limiting"
# Multiple files
codex "Refactor console.log to logger in src/**/*.ts"
3. Provide Instructions
- Why Codex is suitable
- Expected changes
- After completion steps
Example
## Task: Update All Import Statements
**Command:**
codex "Update all imports from 'lodash' to 'lodash-es' in src/**/*.ts"
**Expected:**
- ~15 files modified
- Each import updated
**After:**
1. Run `npm test`
2. Return if issues arise
Benefits
- Token Savings: Simple tasks don't consume Claude context
- Speed: Fast for straightforward edits
- Context Preservation: Keep Claude fresh for complex reasoning