Codex Subagents 사용법: 실행 방법·장단점·AGENTS.md 설정 가이드
Codex Subagents는 하나의 개발 작업을 여러 AI 에이전트에 나누어 맡기고, 메인 에이전트가 결과를 모아 판단하는 기능입니다. 코드 탐색과 리뷰처럼 서로 독립적인 작업에는 유용하지만, 작은 수정까지 무조건 병렬로 처리하면 토큰 사용량과 조정 비용이 늘어날 수 있습니다. 먼저 읽는 핵심 요약 실행: 최신 Codex에서는 Subagents가 기본 활성화되어 있습니다. 채팅에서 역할·작업 범위·결과 형식을 정해 명시적으로 위임하면 됩니다. 장점: 독립적인 작업의 병렬 처리, 메인 대화의 컨텍스트 부담 감소, 별도 관점의 코드 리뷰가 가능합니다. 단점: 전체 토큰 소비 증가, 중복 조사, 파일 충돌, 결과 통합 비용이 생길 수 있습니다. AGENTS.md: “언제 위임할지”와 “어떻게 결과를 검증할지”를 적는 지침 파일입니다. 기능 스위치나 모델 설정 파일은 아닙니다. config.toml: 활성화 여부와 동시 실행 상한 등을 설정합니다. 역할별 동작과 읽기 전용 권한은 사용자 지정 에이전트 TOML에 정의할 수 있습니다. 추천 시작점: 메인 에이전트로 작업하고, 필요할 때만 2~3개 이내의 탐색·리뷰 에이전트를 사용하세요. 이는 운영 권장안이지 제품의 고정 제한은 아닙니다. 이 글은 Codex 서브에이전트 활용에 관한 대화에서 출발해 OpenAI 공식 자료를 대조한 실전 가이드입니다. 단순히 “여러 에이전트를 쓰면 빠르다”는 설명 대신, 실행 방법부터 지침과 설정의 차이, 토큰을 아끼는 분담 기준, 잘못 동작할 때의 점검 순서까지 정리합니다. 목차 Codex Subagents란 무엇인가? 채팅에서 실행하는 방법 장점과 단점, 사용 판단 기준 AGENTS.md 설정과 적용 범위 config.toml과 사용자 지정 에이전트 Django 프로젝트 작업 분담 예시 실행 확인과 문제 해결 자주 묻는 질문 1. Codex Subagents란 무엇인가? Subagent(서브에이전트)는 메인 에이전트가 특정 ...