Claude Code와 Codex에게 일을 나눠 맡기는 법

판단은 Claude Code 한 곳에서 하고, 조사는 하위 에이전트, 그림은 Codex에게 맡기는 분업이에요. 역할 파일과 Codex 부르는 명령을 보여 드려요.

1단계부터 보기 · 모두 12단계

한 줄 답

판단과 커밋은 대화창 하나에만 두고, 조사나 그림처럼 되풀이되는 일은 역할 파일로 만든 하위 에이전트와 codex exec에 넘기면 한 창이 모든 일을 떠안지 않아요.

준비물

도구Claude Code, OpenAI Codex CLI. 영상 기획까지 나누려면 Gemini CLI도 써요.
돈각 서비스 구독료예요. 이 사례에서는 구독료 말고 따로 든 돈이 없었지만 요금제마다 달라요.
계정Claude 계정과 ChatGPT 계정
걸리는 시간역할 파일 하나에 10분쯤 걸려요.
난이도중급. 터미널과 설정 파일을 다뤄요.

차례

한 화면에 한 단계씩 넘기며 보세요.

한 쪽에 모두 보기

Claude Code 하나에 조사도 시키고 그림도 그리게 하고 판단까지 맡기면, 대화가 길어질수록 앞에서 정한 것을 잊고 엉뚱한 파일을 열기 시작해요. 이 사이트 운영자는 일을 네 갈래로 나눠 쓰고 있어요. 운영자는 설계를 맡은 대화창 하나에만 말하고, 나머지 배분은 그 창이 알아서 해요.

역할 나누기

역할	누가	맡는 일
설계·검증	메인 Claude Code(가장 좋은 모델)	운영자 말 해석, 순서 짜기, 결과 합치기, 최종 판단, 커밋
조사	하위 에이전트(가벼운 모델)	여러 파일 훑기, 공식 문서 확인, 표 정리
그림	Codex CLI	그림 생성만
영상 기획	Gemini CLI를 부르는 하위 에이전트	장면 구성, 카메라 움직임, 프롬프트 초안

운영자에서 설계 창, 설계 창에서 조사·그림·영상 기획으로 일이 나뉘는 구조도.

맡기지 않는 일도 정해 두었어요. 법적 금지선 판단, 말투 검수, 되돌리기 어려운 변경, 커밋은 메인 창이 직접 해요. 하위 담당은 커밋하지 않아요.

하위 에이전트 만들기

Claude Code는 역할 파일을 하나 두면 그 역할을 맡은 하위 에이전트를 따로 띄워요. 하위 에이전트는 자기만의 대화 맥락과 도구 목록을 가져서, 조사하면서 읽은 수십 개 파일이 메인 창을 채우지 않아요.

~/.claude/agents/ 폴더에 마크다운 파일을 하나 만들어요. 모든 프로젝트에서 쓰려면 이 폴더, 한 프로젝트에서만 쓰려면 그 프로젝트의 .claude/agents/예요.
파일 맨 위에 이름과 설명, 쓸 도구, 모델을 적어요. 메인 창은 이 설명을 읽고 언제 이 역할을 부를지 정해요.
그 아래에 이 역할이 지킬 규칙을 평소 말로 적어요.
도구는 역할에 필요한 만큼만 줘요. 조사 담당에게는 읽기와 검색 도구만 주는 식이에요.

조사 담당 파일은 이런 모양이에요.

마크다운 파일

---
name: researcher
description: 자료 조사와 파일 탐색 담당. 여러 파일을 훑어 사실을 모아 온다. 발행용 문장은 쓰지 않는다.
tools: Read, Grep, Glob, Bash, WebSearch, WebFetch
model: sonnet
---
너는 조사 담당이다. 모르는 것은 추측하지 말고 «확인 못 함»이라고 적는다.
숫자와 날짜에는 출처 경로나 주소를 붙인다. 파일은 읽기만 하고 고치지 않는다.

Codex에게 그림 맡기기

부르는 명령

Codex CLI의 codex exec는 대화 화면 없이 한 번 실행하고 끝나는 명령이에요. 결과가 표준출력으로 나와서 스크립트가 받아 쓰기 쉬워요.

명령 창

cat 프롬프트.txt | codex exec --sandbox workspace-write -c "sandbox_workspace_write.writable_roots=['C:/Users/<내 계정>/.codex']" -

<내 계정>은 윈도우 사용자 이름으로 바꾸세요. -c 뒤의 값은 TOML 문법이라 목록을 작은따옴표 대괄호(['...'])로 써요. Codex가 만든 그림은 .codex 폴더 아래에 저장되는데, 이 폴더를 쓰기 허용 목록(writable_roots)에 넣어 줘야 Codex가 방금 만든 그림을 다시 읽어요(«막혔던 곳»에 적었어요).

써 보니 달랐던 점

써 보면서 알게 된 것이 몇 가지 있어요.

한글 프롬프트를 명령 뒤에 바로 붙이면 윈도우에서 글자가 깨졌어요. 파일로 만들어 넘기고, 끝에 -를 붙여 표준입력에서 읽게 하세요.
두 개를 동시에 돌리면 실패했어요. 반드시 하나가 끝난 뒤 다음을 거세요.
결과 파일은 Codex가 답에 적어 준 경로에서 가져오되, 이번 호출 뒤에 새로 생긴 파일인지 꼭 확인하세요. 답에 첨부 그림 경로를 되풀이해 적는 일이 있었거든요.
그림 폴더를 날짜순으로 뒤져 «가장 최근 파일»을 가져오는 방식은 쓰지 마세요. 다른 창에서 Codex를 쓰고 있으면 남의 결과와 섞여요.

맡긴 뒤에 할 일

하위 담당의 보고는 그대로 믿지 않고 원본과 맞춰 봐요. 이 사이트 글을 준비할 때도 조사 담당 여덟을 동시에 띄웠는데, 처음 돌아온 보고 가운데 여섯이 읽지 못한 파일을 남긴 채였어요. 하나씩 돌려보내 마저 읽게 했고, 정리된 재료와 원본 기록이 다른 곳도 찾아 글에서 바로잡았어요.

서로 엮이지 않은 일은 한 번에 같이 띄우면 시간이 줄어요. 이때도 Codex만은 예외예요. 맡기는 것은 동시에 해도 되지만 실행은 하나씩이에요.

막혔던 곳

Codex 연결이 매번 끊겼어요

처음에는 Claude Code가 MCP로 Codex를 불렀는데, 어느 날부터 세션을 열 때마다 연결이 닫혔다는 오류가 떴어요. 확인해 보니 Codex CLI 0.154.0부터 MCP 서버로 띄우는 명령 자체가 없어졌어요. 9월 23일부터 Bash에서 codex exec를 직접 부르는 방식으로 모두 바꿨어요.

그림 11장 가운데 1장만 맞게 나왔어요

같은 날 --sandbox workspace-write만 붙여 그렸더니, Codex가 방금 만든 그림을 다시 찾지 못한다는 오류를 내고 엉뚱한 그림을 뽑기 시작했어요. 그때 기록은 Codex 설정 파일(~/.codex/config.toml)의 샌드박스 값을 명령이 덮어쓴 탓으로 봤고, 샌드박스 값을 빼서 풀었어요. 그날 시험에서는 writable_roots를 더해도 안 됐다고 적혀 있어요.

Codex를 0.155.1로 올린 뒤에는 위 예시처럼 --sandbox workspace-write와 함께 .codex 폴더를 writable_roots에 넣는 방식이 정상으로 동작했어요. 지금은 이 방식으로 불러요. 버전에 따라 결과가 달랐으니, 쓰는 버전에서 그림 한 장으로 먼저 시험해 보세요.

윈도우에서 Codex의 셸 기능이 늘 실패했어요

이 PC에서는 Codex에게 셸 명령이나 파일 저장을 시키면 매번 권한 오류가 나고 세션이 응답하지 않았어요. 그래서 Codex에게는 그림 생성만 맡기고, 파일을 옮기고 고치는 일은 Claude 쪽이 해요.

근거

Claude Code 공식 문서, Subagents · 2026-10-10 확인. 역할 파일 위치와 이름·설명·도구·모델 칸이 적혀 있어요.
OpenAI Codex 공식 문서, Non-interactive mode · 2026-10-10 확인. codex exec 사용법과 샌드박스 단계가 적혀 있어요.
MCP 서버 명령이 없어진 버전(0.154.0)은 운영자가 쓰던 Codex에서 확인한 값이에요. OpenAI 릴리스 노트에서는 찾지 못했어요.

이 글을 만든 방법

바탕운영자가 실제로 돌린 작업의 기록(작업 일지·설정 파일·오류 기록)
쓴 쪽AI(Claude)가 썼어요
독립 검수2026-10-10에 쓴 AI와 다른 AI가 원본과 대조해 통과시켰어요
사실 확인2026-10-10
고친 기록
- 2026-10-10 위쪽 명령 예시가 아래 «막혔던 곳»의 경고와 어긋났어요. 지금 실제로 쓰는 명령(writable_roots 함께 지정)으로 예시를 바꾸고, 9월 23일의 두 기록(샌드박스 값을 빼서 푼 것, 0.155.1에서 writable_roots로 푼 것)을 모두 적었어요.

발행 2026-10-10