Claude Code를 Lead로 쓰면서 이런 생각을 하게 된다.
Codex를 팀원으로 붙이면 더 강해지지 않을까?
처음에는 자연스럽게 MCP를 찾게 된다.
하지만 실제로 필요한 것은 반드시 MCP가 아니다.
외부 CLI를 실행할 수 있는 runner/plugin을 사용하면 Codex를 독립 프로세스로 호출되는 sub-agent처럼 구성할 수 있다.
여기서 설명하는 방식은 Claude Code나 Codex의 “공식 내장 팀 기능”을 뜻하는 것이 아니다. 외부 runner가 codex CLI를 호출하도록 조합한 아키텍처 패턴이다.
핵심은 “Codex가 Claude Code 안에 들어오는가”가 아니라 Claude Code 쪽 workflow가 Codex CLI를 독립 작업자처럼 호출할 수 있는가다.
1. Codex 사용 가능 여부를 MCP 목록에서 찾지 않는다
CLI 기반 runner 구조에서는 확인 순서가 다르다.
Codex CLI 존재
↓
인증 정상
↓
runner 정상
↓
agent definition 존재
↓
실제 호출 성공PowerShell 기준:
Get-Command codex -All
where.exe codex
codex --version여기서 CLI 자체가 없다면 그 다음을 볼 필요가 없다.
2. 실제 실행까지 확인해야 한다
버전이 나온다고 끝이 아니다. CLI는 설치돼 있어도 인증이 깨져 있거나 환경변수가 맞지 않으면 runner에서 호출할 때 실패한다.
여기서 흔한 실수는 맨몸으로 codex를 쳐 보고 화면이 뜨니 됐다고 넘어가는 것이다.
그건 대화형 화면이고, runner가 쓰는 경로가 아니다. runner는 프롬프트 하나를 주고
결과를 받아 오는 비대화형 호출을 한다. 확인해야 할 것도 그 경로다.
codex --help로그인 상태를 조회하는 서브커맨드와 프롬프트 한 번을 비대화형으로 실행하는
서브커맨드가 따로 있다. 이름은 버전에 따라 바뀌므로 설치된 버전의 --help에서 확인해
쓴다. 검증은 그 비대화형 서브커맨드로 해야 의미가 있다.
3. Codex를 “개발자 한 명 더”로 쓰지 않는다
두 모델이 동시에 코드를 쓰면 빨라질 것 같지만, 같은 파일이나 상태를 동시에 고치기 시작하면 충돌 정리에 드는 시간이 더 든다.
역할을 이렇게 두면 그 충돌이 아예 생기지 않는다.
Claude Code → Lead
Codex → Ground-Truth / Adversarial즉 Codex를 쓰기 권한 없는 독립 검증자로 둔다.
4. 역할에 제약을 건다
검증자로 쓸 거라면 정의에 세 가지를 못박는다.
파일을 수정하지 않는다
Lead의 결론을 상속하지 않는다
해결책이 아니라 증거를 먼저 보고한다runner마다 이걸 적는 자리와 키 이름이 다르다. 쓰고 있는 runner의 스키마를 보고 거기에 맞춰 적어야 한다 — 어느 문서에서 본 프론트매터를 그대로 복사하면 조용히 무시된다. 권한 제약이 무시된 채로 도는 것이 이 구조에서 가장 나쁜 실패라, 정의를 넣은 뒤에는 반드시 아래 7절의 확인을 한 번 돌린다.
역할을 어떻게 나눌지 — 파일 기준이 아니라 질문 기준으로 lane을 자르는 방법, Ground-Truth와 Adversarial이 각각 무엇을 묻는지 — 는 이 글의 범위를 넘는다. 그쪽은 멀티에이전트는 역할보다 ‘독립 질문’이 중요하다에 따로 정리해 뒀다. 여기서는 Codex를 그 자리에 실제로 앉히는 방법만 다룬다.
5. 실제 호출로 검증한다
Codex가 “설치돼 있다”가 아니라 실제 팀원으로 동작하는지 확인하려면 read-only 작업을 하나 시킨다.
현재 프로젝트 구조를 읽고
수정하지 말고
주요 구성요소 5개만 요약하라.성공 조건:
[ ] Codex 프로세스 실제 실행
[ ] 결과 반환
[ ] 파일 변경 없음
[ ] Claude가 대신 답하지 않음6. 왜 이 구조가 유용한가
같은 모델 계열만 여러 개 쓰면 Lead의 최초 가설을 같이 따라갈 가능성이 있다. 쓰기 권한이 없으면 그 agent가 할 수 있는 일은 증거를 가져오는 것뿐이라, 역할이 흐려지지도 않는다.
다른 모델을 독립 검증자로 쓰면 완벽한 독립성은 아니더라도 사고 편향을 줄이는 데 도움이 된다.
중요한 것은 모델 이름보다 증거 수집 경로를 분리하는 것이다.
결론
Claude Code에서 Codex를 팀원으로 쓰는 데 MCP가 필수는 아니다.
CLI runner만 있어도 충분하다.
그리고 가장 가치 있는 활용은 단순 코딩 보조가 아니라 쓰기 권한 없는 검증자다.
Lead를 더 빨리 도와주는 agent보다 Lead가 틀렸는지 찾아내는 agent가 복잡한 디버깅에서는 더 유용할 때가 많다.
공식 문서 참고
- OpenAI Codex CLI: https://developers.openai.com/codex/cli/