Splitting Work Between Claude Code and Codex on One Mac: Claude Designs, Codex Implements

개요

Claude Code와 Codex CLI를 단일 Mac 환경에서 협업시켜, Claude는 코드 설계 및 계획을 담당하고 Codex는 반복적인 코드 구현 및 테스트 생성을 수행하는 작업 분할 전략을 설명합니다.

주요 내용

* 작업 분할 원칙: 모델의 지능이 필요한 설계, 코드베이스 조사, 계획, 검토는 Claude가 담당하고, 보일러플레이트 코드 작성, 대규모 반복 작업, 테스트 생성 등 정해진 내용을 대량 생산하는 작업은 Codex CLI로 위임합니다.
* 위임의 한계: 매우 어렵거나 복잡한 설계 판단이 필요한 코드는 컨텍스트를 유지하는 메인 세션(Claude)에서 직접 작성하는 것이 더 빠르고 정확하므로, 모든 작업을 위임하지 않습니다.
* Codex CLI 호출 방식: codex-cli를 비상호작용적인 헤드리스(headless) 실행 방식으로 호출하며, timeout으로 무한 대기 방지, </dev/null>로 표준 입력을 닫아 대기 방지, --skip-git-repo-check 옵션으로 Git 저장소 외부 실행 시 발생하는 오류를 방지합니다.
* PATH 문제: Codex CLI가 nvm 아래 설치되어 일반 셸에서는 작동하나, launchd나 cron과 같은 최소 PATH 환경에서는 command not found 오류가 발생할 수 있어 전체 경로를 명시해야 합니다.
* 위임 흐름: 요구사항 수신 및 설계/계획 수립(Claude) → 구현 난이도 판단 후 위임 또는 직접 구현 → Codex CLI를 통한 구현 → Codex CLI를 통한 코드 검토 순으로 진행됩니다.
* 상태 전달: 장기 위임 시 작업 내용, 인계 사항, 상태 등 휘발성 대화 컨텍스트를 파일로 저장하여 재개 및 검증을 용이하게 합니다.
* 고질병: </dev/null> 누락으로 인한 Codex 대기, nvm PATH 문제, Git 저장소 외부 실행 시 오류, 모든 작업 위임으로 인한 컨텍스트 손실, 동일 모델의 작성 및 검토로 인한 소프트 리뷰 등의 문제점을 해결합니다.

시사점

이 전략은 AI 모델의 강점을 활용하여 작업의 효율성과 품질을 높일 수 있으며, 모델의 지능과 처리량이라는 측면에서 각 작업에 최적화된 AI를 선택적으로 활용하는 방안을 제시합니다.