설정
설정은 Codex가 팀의 작업 방식에 맞게 동작하도록 만드는 과정입니다.
Codex의 설정은 몇 가지 계층이 함께 작동하는 방식으로 이루어집니다.
- 프로젝트 지침(
AGENTS.md): 지속적으로 적용되는 작업 지시입니다. - 메모리: 이전 작업에서 학습한 유용한 맥락입니다.
- 스킬: 반복 가능한 워크플로와 도메인 지식을 담는 단위입니다.
- MCP: 외부 도구와 공유 시스템에 접근하기 위한 연결 방식입니다.
- 서브에이전트: 전문화된 하위 에이전트에게 작업을 위임하는 방식입니다.
이 계층들은 서로 경쟁하는 기능이 아니라 상호 보완하는 기능입니다. AGENTS.md는 Codex의 행동 방식을 잡아 주고, 메모리는 로컬 맥락을 다음 작업으로 이어 줍니다. 스킬은 반복 가능한 절차를 패키지로 만들고, MCP는 로컬 작업 공간 밖의 시스템을 Codex와 연결합니다.
AGENTS.md
AGENTS.md는 Codex가 작업을 시작하기 전에 읽는 지속적인 지침 파일입니다. 빌드와 테스트 명령, 코드 작성 규칙, 리뷰 기준처럼 항상 적용되어야 하는 내용을 여기에 둡니다. 개인 선호는 ~/.codex/AGENTS.md에, 팀과 저장소 규칙은 저장소의 AGENTS.md에 두는 것이 좋습니다.
작성 방법, 계층화, 문제 해결은 AGENTS.md를 참고하면 됩니다.
스킬
스킬은 반복 가능한 워크플로와 도메인 지식을 Codex가 재사용할 수 있는 단위로 묶는 방법입니다. 릴리스 절차, 리뷰 루틴, 문서 업데이트처럼 여러 작업에서 같은 절차를 반복할 때 특히 유용합니다.
작성 방법, 저장 위치, 호출 방식은 스킬을 참고하면 됩니다.
MCP
MCP(Model Context Protocol)는 Codex를 외부 도구와 컨텍스트 제공자에 연결하는 표준 방식입니다. Figma, Linear, GitHub, 내부 지식 저장소처럼 팀이 의존하는 원격 시스템과 연결할 때 특히 유용합니다.
Codex가 로컬 저장소 밖에 있는 기능을 사용해야 할 때 MCP를 사용합니다. 예를 들어 이슈 트래커, 디자인 도구, 브라우저, 공유 문서 시스템 같은 것이 여기에 해당합니다.
MCP는 다음과 같이 이해할 수 있습니다.
- Host: Codex입니다.
- Client: Codex 안의 MCP 연결입니다.
- Server: 외부 도구 또는 컨텍스트 제공자입니다.
MCP 서버는 다음 항목을 제공할 수 있습니다.
- Tools: 실행 가능한 작업입니다.
- Resources: 읽을 수 있는 데이터입니다.
- Prompts: 재사용 가능한 프롬프트 템플릿입니다.
이 구분은 신뢰 범위와 기능 범위를 이해하는 데 도움이 됩니다. 어떤 서버는 주로 컨텍스트를 제공하고, 어떤 서버는 강력한 실행 작업을 노출할 수 있습니다.
실제로 MCP는 스킬과 함께 사용할 때 가장 유용한 경우가 많습니다.
- 스킬은 워크플로를 정의하고 사용할 MCP 도구를 지정합니다.
- MCP는 그 워크플로가 외부 시스템에 접근할 수 있게 해 줍니다.
자세한 내용은 MCP를 참고하면 됩니다.
서브에이전트
서로 다른 역할을 가진 에이전트를 만들고, 각 에이전트가 도구를 다르게 사용하도록 지시할 수 있습니다. 예를 들어 한 에이전트는 특정 테스트 명령과 설정을 실행하고, 다른 에이전트는 디버깅을 위해 MCP 서버에서 프로덕션 로그를 가져오도록 구성할 수 있습니다. 각 서브에이전트는 자기 역할에 집중하고, 그 작업에 맞는 도구를 사용합니다.
자세한 내용은 서브에이전트 개념을 참고하면 됩니다.
다음 단계
다음 순서로 구성하는 것이 좋습니다.