설정과 AGENTS.md

매번 프로젝트 규칙을 설명하는 대신, Codex가 자동으로 읽는 문서에 적어 두면 일관된 결과를 얻을 수 있습니다. 그 표준이 AGENTS.md입니다.

학습 목표

• AGENTS.md의 역할과 위치를 이해한다.
• 어떤 내용을 적어 두면 좋은지 안다.
• 설정으로 기본 동작을 조정하는 흐름을 안다.

AGENTS.md란

AGENTS.md는 에이전트형 코딩 도구에 프로젝트의 맥락과 규칙을 알려 주기 위한 마크다운 문서입니다. 프로젝트 루트에 두면 Codex가 작업 시 참고합니다. 코드 스타일, 자주 쓰는 명령, 구조 설명 등을 담습니다.

# 프로젝트 가이드

## 코드 스타일
- TypeScript strict 모드
- 들여쓰기 2칸, 세미콜론 사용

## 명령
- 개발: npm run dev
- 테스트: npm test
- 빌드: npm run build

## 규칙
- 외부 라이브러리 추가는 먼저 제안하고 승인받을 것
- 커밋 메시지는 한국어로 작성

자주 틀리거나 매번 반복해 설명하던 내용을 적어 두면 효과가 큽니다.

설정 파일

Codex는 사용자 홈 디렉터리의 설정 폴더(예: ~/.codex/)에서 기본 동작을 읽습니다. 여기서 기본 모델, 승인 정책, 샌드박스 수준 같은 기본값을 지정할 수 있습니다. 이렇게 두면 매번 옵션을 붙이지 않아도 원하는 기본 동작으로 시작됩니다.

프로젝트 vs 개인 설정

• 프로젝트 규칙: 저장소의 AGENTS.md — 팀과 공유(git 커밋)
• 개인 기본값: 홈 디렉터리 설정 — 모든 프로젝트에 공통 적용

프로젝트별로 달라지는 규칙은 AGENTS.md에, 개인 취향(기본 모드 등)은 개인 설정에 두는 식으로 구분합니다.

설정 파일 경로와 형식은 버전에 따라 다를 수 있습니다. 정확한 키와 위치는 공식 문서를 확인하세요.

요약

AGENTS.md는 프로젝트 규칙·맥락을 적어 두는 문서로, Codex가 작업 시 자동으로 참고합니다. 코드 스타일·명령·규칙을 담아 두고, 개인 기본값은 설정 파일로 지정하면 매번 설명하지 않아도 일관된 결과를 얻습니다.