코덱스(Codex)란?
코덱스는 OpenAI가 만든 클라우드 기반 소프트웨어 엔지니어링 에이전트입니다.
단순히 코드를 생성하는 도구가 아니라, 기능 작성, 버그 수정, 풀 리퀘스트 제안 등
여러 작업을 동시에 자율적으로 수행할 수 있습니다.
특히 하위 에이전트(Sub-agent)를 조합해서 역할을 나눠 개발하는 방식이 핵심입니다.
핵심 원칙: 기능 단위로 쪼개기
전체를 한 번에 만들려고 하면 에이전트가 꼬입니다.
기능 하나씩 완성하는 방식이 훨씬 안정적입니다.
예를 들어 앱을 만든다면 이렇게 나눕니다.
- 인증 (로그인/회원가입)
- 게시판
- 실종 신고
- 알림
그리고 기능 하나를 이 순서로 완벽하게 끝냅니다.
API → DB → Backend → Flutter → 테스트
로그인이 완전히 끝난 후에 게시판으로 넘어갑니다.
에이전트 조합 전략
기본 원칙: 적게, 역할 나눠서
설계 1개 + 구현 1~2개 + 검증 1개
이 구성이 기본입니다. 역할이 겹치면 오히려 비효율적입니다.
인증 기능 기준 추천 조합
- api-designer — API 설계 담당
- typescript-pro — 구현 담당
- code-reviewer — 검증 담당
3개면 충분합니다.
5개 조합은 언제?
Flutter + Backend + DB를 동시에 붙일 때처럼
전체 시스템을 구성할 때만 사용합니다.
평소엔 3개로도 충분합니다.
절대 지켜야 할 규칙
- 에이전트 5개 이상 쓰지 않는다
- 역할이 겹치는 에이전트는 넣지 않는다
- 필요 없는 에이전트는 과감히 제외한다
한 줄 정리
에이전트는 많이 쓰는 게 아니라, 단계별로 필요한 만큼만 씁니다.
역할을 정확하게 나누고, 계획을 구체적으로 세울수록 결과물 퀄리티가 올라간다는 걸
공부하면서 느꼈습니다.
직접 써보기 전에 이 전략부터 머릿속에 넣어두면 훨씬 수월하게 시작할 수 있습니다.
