기본 패턴
toml
model = "gpt-5.4"
approval_policy = "on-request"
sandbox_mode = "workspace-write"
web_search = "cached"
model_reasoning_effort = "high"
personality = "friendly"
[profiles.review]
model_reasoning_effort = "high"
web_search = "disabled"설명
- 사용자 공통 설정은
~/.codex/config.toml에 두고, 저장소별 설정은.codex/config.toml에 둡니다. - 같은 키가 여러 곳에 있으면 CLI 플래그와
--config가 가장 우선이고, 그다음 프로필, 프로젝트 설정, 사용자 설정 순으로 적용됩니다. - 자주 손보는 항목은
model,approval_policy,sandbox_mode,web_search,model_reasoning_effort,personality입니다. - 개인 취향은 사용자 설정에 두고, 팀이 공유해야 하는 값은 프로젝트 설정에 두는 편이 충돌이 적습니다.
- 같은 작업을 자주 반복한다면
[profiles.<name>]로 리뷰용, 실험용, 안전 모드 같은 프로필을 나누는 방식이 편합니다.
짧은 예제
text
설정 분리 예시
- ~/.codex/config.toml: 내가 기본으로 선호하는 모델, 말투, 웹 검색 방식
- repo/.codex/config.toml: 이 저장소에서만 허용할 샌드박스와 명령 규칙
- codex --profile review: 특정 작업에서만 더 엄격한 설정 사용빠른 정리
| 위치 또는 방식 | 역할 |
|---|---|
~/.codex/config.toml | 사용자 공통 기본값 |
.codex/config.toml | 저장소 또는 하위 디렉터리 전용 설정 |
--profile <name> | 미리 정의한 설정 묶음 적용 |
--config key=value | 일회성 오버라이드 |
| CLI 플래그 | 최종 우선순위가 가장 높음 |
주의할 점
개인 취향과 팀 규칙을 한 파일에 몰아넣으면 설정 의도가 흐려집니다. 사용자 파일은 "내 기본값", 프로젝트 파일은 "이 저장소 규칙"이라는 기준으로 나누면 유지가 쉬워집니다.
참고 링크
2 sources