Awesome Codex Subagents: OpenAI Codex 플랫폼을 위한 136개 전문화 AI 서브에이전트 컬렉션

9bow · 4월 18, 2026, 9:30오전

Awesome Codex Subagents 프로젝트 소개

하나의 AI 에이전트에게 모든 것을 맡기는 방식에는 한계가 있습니다. 범용 AI 에이전트는 백엔드 개발, 보안 감사, 인프라 관리, 데이터 분석 등 각기 다른 전문 지식을 요구하는 태스크를 동등한 품질로 수행하기 어렵습니다. VoltAgent가 공개한 Awesome Codex Subagents는 이러한 전문화의 필요성에 응답하는 프로젝트입니다. OpenAI Codex 플랫폼을 위한 136개 이상의 전문화된 AI 서브에이전트(subagent)를 TOML 설정 파일 형식으로 제공하며, 10개의 기능 카테고리로 체계적으로 분류되어 있습니다. 2026년 4월 기준 GitHub에서 4,000개 이상의 스타를 기록하고 있습니다.

Codex의 서브에이전트 시스템은 에이전트를 특정 역할에 특화시켜 독립적인 컨텍스트 윈도우에서 실행하는 방식을 사용합니다. 서브에이전트는 메인 대화의 컨텍스트를 오염시키지 않으며, 각자의 전문 지식 영역에 집중하여 더 깊이 있는 결과를 도출합니다. Awesome Codex Subagents는 이 시스템을 최대한 활용할 수 있도록, 다양한 개발 역할에 맞게 정교하게 튜닝된 136개 이상의 서브에이전트 설정을 제공합니다.

10개 카테고리와 주요 서브에이전트들

Awesome Codex Subagents의 136개 서브에이전트는 10개의 기능 카테고리로 분류되어 있으며, 각 카테고리는 소프트웨어 개발의 특정 영역을 담당합니다.

핵심 개발(Core Development): 백엔드, 프론트엔드, 풀스택 및 특화 역할을 포함하는 12개 에이전트. 각 에이전트는 특정 스택이나 아키텍처 패턴에 맞게 최적화되어 있습니다.

언어 전문가(Language Specialists): Python, TypeScript, Rust, Go, Java, C++ 등 27개 프로그래밍 언어 및 프레임워크 전문 에이전트. 언어별 관용구(idiom)와 모범 사례를 깊이 이해하는 전문 에이전트가 언어 특화 코드 품질을 높여줍니다.

인프라 & DevOps(Infrastructure & DevOps): DevOps, 클라우드(AWS/GCP/Azure), Kubernetes, 인프라 as 코드(IaC) 전문가를 포함하는 16개 에이전트. 운영 환경에 직접 영향을 주는 작업에서 특히 중요합니다.

품질 & 보안(Quality & Security): 테스팅, 감사, 컴플라이언스 역할을 담당하는 16개 에이전트. 보안 취약점 분석과 코드 품질 검토에 특화되어 있습니다.

데이터 & AI(Data & AI): ML 엔지니어, 데이터 사이언티스트, 분석 전문가를 포함하는 12개 에이전트. 데이터 파이프라인 설계부터 모델 최적화까지를 담당합니다.

개발자 경험(Developer Experience): 도구 개선, 리팩토링, 문서화를 담당하는 13개 에이전트. 코드베이스의 장기적인 유지보수성을 높이는 역할을 합니다.

특화 도메인(Specialized Domains): 블록체인, 핀테크, 게임 개발 전문 에이전트를 포함하는 12개 에이전트. 산업별 특수 요구사항을 이해하는 전문가 역할을 수행합니다.

비즈니스 & 제품(Business & Product): 프로덕트 매니저(PM), 비즈니스 애널리스트, 기술 작가(technical writer) 역할의 11개 에이전트. 순수 기술 이외의 영역에서도 에이전트의 활용을 확장합니다.

메타 & 오케스트레이션(Meta & Orchestration): 멀티 에이전트 조율과 워크플로우 관리를 담당하는 12개 에이전트. 다른 서브에이전트들을 지휘하는 오케스트레이터 역할을 포함합니다.

리서치 & 분석(Research & Analysis): 시장 조사, 경쟁사 분석 전문가를 포함하는 7개 에이전트.

서브에이전트의 기술적 구조

각 서브에이전트는 TOML 형식의 설정 파일로 정의되며, 세 가지 핵심 속성을 가집니다. 모델 라우팅(Model Routing): 심층 추론이 필요한 에이전트는 gpt-5.4에, 빠른 합성(fast synthesis)이 필요한 에이전트는 gpt-5.3-codex-spark에 할당됩니다. 작업의 성격에 따라 적절한 모델을 자동으로 선택하여 비용과 성능을 최적화합니다. 샌드박스 모드(Sandbox Mode): 리뷰어와 분석가는 read-only 모드로, 개발자와 구현 에이전트는 workspace-write 모드로 설정됩니다. 이를 통해 각 에이전트가 필요한 최소 권한만을 갖습니다. 독립적 컨텍스트 윈도우: 각 서브에이전트는 독립적인 컨텍스트에서 실행되어 메인 대화를 오염시키지 않으며, 크로스-컨텍스트 오염을 방지합니다.

설치 및 사용 방법

서브에이전트 설치는 TOML 설정 파일을 지정된 디렉토리에 복사하는 방식으로 이루어집니다. 글로벌 설치는 모든 프로젝트에서 접근 가능하고, 프로젝트 레벨 설치는 해당 프로젝트에서만 유효합니다. 동일한 이름의 에이전트가 존재할 경우 프로젝트 레벨이 글로벌 설정을 오버라이드합니다.

# 글로벌 설치 (모든 프로젝트에서 접근 가능)
cp agents/security-auditor.toml ~/.codex/agents/

# 또는 프로젝트별 설치 (해당 프로젝트에서만 유효)
mkdir -p .codex/agents/
cp agents/security-auditor.toml .codex/agents/

# 전체 설치 (136개 에이전트 모두 글로벌 설치)
cp agents/*.toml ~/.codex/agents/

서브에이전트를 사용하려면 Codex 프롬프트에서 명시적으로 위임해야 합니다. Codex는 서브에이전트를 자동으로 스폰하지 않으므로, "보안 감사를 security-auditor에게 위임해줘"와 같이 명시적으로 요청해야 합니다. 팀 전체가 동일한 서브에이전트 설정을 공유하면, 모든 팀원의 AI 에이전트가 일관된 기준과 방식으로 작업합니다.

라이선스

Awesome Codex Subagents는 MIT 라이선스로 공개되어 있습니다.

Awesome Codex Subagents 프로젝트 GitHub 저장소

더 읽어보기

이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다.

파이토치 한국 사용자 모임이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일로 보내드립니다! (기본은 Weekly지만 Daily로 변경도 가능합니다.)

아래쪽에 좋아요를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~