Codex의 서브에이전트(subagent)는 특정 역할에 맞는 별도 컨텍스트를 부여해 메인 대화창의 혼잡을 줄이고 병렬 작업 품질을 끌어올리는 기능이다. Awesome Codex Subagents는 이런 서브에이전트 정의를 10개 카테고리, 136개 이상으로 정리한 큐레이션 저장소로, Codex 공식 문서 방식에 맞춘 .toml 포맷 예제를 바로 가져다 쓸 수 있다는 점이 강점이다. GitHub 스타 4.1k 이상(2026-04 기준).
무엇을 제공하나
- 136개 이상 서브에이전트: 백엔드, 프론트엔드, 보안, 데이터, DevOps, 리서치 등
- 10개 카테고리: Core Development부터 Research & Analysis까지 체계화
- Codex 네이티브 포맷:
.toml기반 정의 파일 - 모델 라우팅 예시: 역할에 따라
gpt-5.4,gpt-5.3-codex-spark등을 지정 - 샌드박스 모드 분리: 리뷰어는
read-only, 개발자는workspace-write
설치 방식
Codex는 서브에이전트를 자동으로 스폰하지 않기 때문에, 저장 위치와 명시적 위임 프롬프트가 중요하다.
| 유형 | 경로 | 적용 범위 | 우선순위 |
|---|---|---|---|
| 프로젝트 전용 | .codex/agents/ | 현재 저장소만 | 높음 |
| 글로벌 | ~/.codex/agents/ | 모든 프로젝트 | 낮음 |
mkdir -p ~/.codex/agents
cp categories/01-core-development/backend-developer.toml ~/.codex/agents/어떤 역할이 있나
대표 카테고리는 다음과 같다.
- Core Development:
backend-developer,frontend-developer,code-mapper - Quality & Security:
reviewer,security-auditor,browser-debugger - Data & AI:
llm-architect,mlops-engineer,prompt-engineer - Meta & Orchestration:
workflow-orchestrator,task-distributor,context-manager - Research & Analysis:
docs-researcher,search-specialist,trend-analyst
왜 유용한가
| 효과 | 설명 |
|---|---|
| 컨텍스트 분리 | 탐색·검증·구현을 서로 다른 창으로 나눠 메인 세션 오염 감소 |
| 병렬화 | 파일 탐색, 문서 검증, 리뷰를 동시에 진행 |
| 역할 일관성 | 팀이 같은 서브에이전트 정의를 공유해 작업 방식 표준화 |
| 비용 최적화 | 무거운 작업과 가벼운 작업에 다른 모델 지정 가능 |
언제 쓰면 좋은가
- 큰 PR 리뷰를 정확도와 속도 모두 챙기고 싶을 때
- 코드 탐색, 문서 검증, 구현 제안을 병렬로 돌리고 싶을 때
- 팀 단위로 Codex 협업 패턴을 표준화하고 싶을 때
라이선스
MIT 라이선스. 다만 수록된 서브에이전트 품질이나 안전성은 개별 검토가 필요하다.
관련 문서
- agent-skills — 에이전트 기능 확장 단위인 스킬 개요
- awesome-agent-skills — 공식 팀 중심의 대규모 스킬 큐레이션
- mini-coding-agent — 코딩 에이전트 내부 구조를 학습할 수 있는 최소 구현체