Codex 서브에이전트와 병렬 작업 분담
여러 파일을 읽는 조사나 서로 다른 관점의 검토는 나눠 맡기기 좋습니다. 반면 같은 파일을 순서대로 고쳐야 하는 작업을 동시에 맡기면 충돌과 중복이 늘어날 수 있습니다. 위임 전에 산출물과 파일 소유 범위를 분명히 합니다.
공식 문서를 참고한 비공식 한국어 가이드입니다. 에이전트 생성·병렬 AI 호출은 실행하지 않았습니다. 위임은 추가 모델 사용량을 만들 수 있으며 읽기 전용이라는 말만으로 OS 수준의 격리가 생기지 않습니다.
독립 작업만 나누기
예를 들어 주 에이전트는 수정과 테스트를 맡고, 별도 에이전트는 관련 호출부의 영향만 조사하게 할 수 있습니다. 같은 조사를 주 에이전트가 다시 수행하면 분담의 이점이 줄어듭니다.
보조 에이전트는 검색 입력의 호출부와 관련 테스트를 조사해 줘.
파일을 수정하거나 명령·외부 요청을 실행하지 마.
산출물은 영향 받는 경로, 현재 확인된 동작, 미확인 가정이다.
주 에이전트는 결과를 받아 수정 범위를 결정하고 최종 검증을 맡는다.
결과 보고를 그대로 정답으로 채택하지 않습니다. 최종 변경과 검증의 책임은 이를 통합하는 쪽에 남습니다. 별도 파일을 고칠 때는 worktree와 통합 순서도 고려합니다.
로컬 에이전트 정의
현재 로컬 Codex는 서브에이전트가 기본 활성화되어 있고 명시 요청이나 적용되는 지침/스킬로 위임할 수 있습니다. CLI /subagents에서 thread를 확인합니다. 사용자 정의 파일은 ~/.codex/agents/*.toml 또는 프로젝트 .codex/agents/*.toml입니다.
name = "impact-reader"
description = "변경 관련 호출부와 테스트 영향을 조사한다"
developer_instructions = "코드는 수정하지 않는다. 확인한 파일과 미확인 가정을 구분해 보고한다."
필수 필드 구조를 보여 주는 합성 예시입니다. 이 지침은 에이전트에게 쓰기를 하지 말라고 요청할 뿐 독립 read-only sandbox를 만들지 않습니다. 민감한 저장소에서는 실제 접근 제한을 별도로 확인합니다.
상속과 동시 실행 한도
공통 설정은 [agents]의 enabled, max_concurrent_threads_per_session, default_subagent_model, default_subagent_reasoning_effort 등을 확인합니다. 예전 agents.max_threads는 legacy alias로 구분합니다. 더 많은 thread가 항상 빠르거나 정확하지 않으므로 작은 병렬 수부터 검토합니다.
서브에이전트는 부모의 권한·provider·MCP를 상속합니다. agent 파일의 sandbox_mode, approval_policy, model_provider, mcp_servers를 바꿔 권한을 재설정할 수 있다고 안내하면 안 됩니다. 부모에서 거부된 작업을 다른 에이전트에게 부탁하는 방식도 피합니다.
웹과 완료 판정
Web Work의 에이전트 목록은 로컬과 다릅니다. 개별 stop/steer를 제공하지 않는 읽기 전용 목록과 Ultra의 선제적 위임을 로컬 /subagents와 동일한 조작으로 설명하지 않습니다.
보고서가 도착하면 범위, 증거, 실패/미검증을 먼저 확인합니다. 한 에이전트의 ‘통과’를 전체 작업의 성공으로 확대하지 마세요. 병렬 수정 후 통합 테스트를 다시 실행하고 누락된 검토가 있으면 남깁니다. 자동 이벤트 실행은 훅, 프로그램의 명시적 실행 제어는 SDK를 봅니다.
공식 한국어 도움말: ChatGPT 플랜과 Codex에서 계정별 이용 안내를 확인할 수 있습니다. 이 글은 해당 도움말의 공식 번역이 아니며 계정 조건과 요금은 공식 안내를 우선합니다.