| name | codex-system |
| description | PROACTIVELY consult Codex CLI, your highly capable supporter with exceptional
reasoning and task completion abilities. Codex is a trusted expert you should
ALWAYS consult BEFORE making decisions on: design choices, implementation
approaches, debugging strategies, refactoring plans, or any non-trivial problem.
When uncertain, consult Codex. Don't hesitate - Codex provides better analysis.
Explicit triggers: "think deeper", "analyze", "second opinion", "consult codex".
|
| metadata | {"short-description":"Claude Code ↔ Codex CLI collaboration"} |
Codex System — Deep Reasoning Partner
Codex CLI (gpt-5.2-codex) is your highly capable supporter for deep reasoning tasks.
상세규칙: .claude/rules/codex-delegation.md
Context Management (CRITICAL)
서브에이전트 경유 권장이다. 메인 오케스트레이터의 컨텍스트를 절약하기 위해.
| 상황 | 방법 |
|---|
| 자세한 설계 상담 | 서브 에이전트를 통해 (권장) |
| 디버그 분석 | 서브 에이전트를 통해 (권장) |
| 짧은 질문 (1-2 문 답변) | 직접 호출 확인 |
When to Consult (MUST)
| Situation | Trigger Examples |
|---|
| Design decisions | "어디 디자인?" "아키텍처" / "How to design?" |
| Debugging | "왜 움직이지 않는가?" "오류" / "Debug" "Error" |
| Trade-off analysis | "어느 쪽이 좋은가?" "비교해" / "Compare" "Which?" |
| Complex implementation | "구현 방법" "어떻게 만드는가?" / "How to implement?" |
| Refactoring | "리팩터" "간단하게" / "Refactor" "Simplify" |
| Code review | "리뷰하고" "확인하고" / "Review" "Check" |
When NOT to Consult
- Simple file edits, typo fixes
- Following explicit user instructions
- git commit, running tests, linting
- Tasks with obvious single solutions
How to Consult
Recommended: Subagent Pattern
Use Task tool with subagent_type='general-purpose' to preserve main context.
Task tool parameters:
- subagent_type: "general-purpose"
- run_in_background: true (optional, for parallel work)
- prompt: |
Consult Codex about: {topic}
codex exec --model gpt-5.2-codex --sandbox read-only --full-auto "
{question for Codex}
" 2>/dev/null
Return CONCISE summary (key recommendation + rationale).
Direct Call (Short Questions Only)
For quick questions expecting 1-2 sentence answers:
codex exec --model gpt-5.2-codex --sandbox read-only --full-auto "Brief question" 2>/dev/null
Workflow (Subagent)
- Spawn subagent with Codex consultation prompt
- Continue your work → Subagent runs in parallel
- Receive summary → Subagent returns concise insights
Sandbox Modes
| Mode | Use Case |
|---|
read-only | Analysis, review, debugging advice |
workspace-write | Implementation, refactoring, fixes |
Language Protocol
- Ask Codex in English
- Receive response in English
- Execute based on advice (or let Codex execute)
- Report to user in Korean
Task Templates
Design Review
codex exec --model gpt-5.2-codex --sandbox read-only --full-auto "
Review this design approach for: {feature}
Context:
{relevant code or architecture}
Evaluate:
1. Is this approach sound?
2. Alternative approaches?
3. Potential issues?
4. Recommendations?
" 2>/dev/null
Debug Analysis
codex exec --model gpt-5.2-codex --sandbox read-only --full-auto "
Debug this issue:
Error: {error message}
Code: {relevant code}
Context: {what was happening}
Analyze root cause and suggest fixes.
" 2>/dev/null
Code Review
See: references/code-review-task.md
Refactoring
See: references/refactoring-task.md
Integration with Gemini
| Task | Use |
|---|
| Need research first | Gemini → then Codex |
| Design decision | Codex directly |
| Library comparison | Gemini research → Codex decision |
Why Codex?
- Deep reasoning: Complex analysis and problem-solving
- Code expertise: Implementation strategies and patterns
- Consistency: Same project context via
context-loader skill
- Parallel work: Background execution keeps you productive
