라이프스타일
config.toml 설정
config.toml은 설정 값을, AGENTS.md는 작업 지침을 다룹니다. 사용자 설정 외에 신뢰하는 프로젝트에 .codex/config.toml을 둘 수 있습니다. 인자와 조직 정책도 있으므로 파일 하나만으로 적용 값을 판단하지 않습니다.
읽는 데 약 12분 · 실습 25 분

이 글의 목차
Codex 학습 목차로 돌아가기Codex 학습 센터: 전체 튜토리얼 목차설치와 첫 작업부터 MD 지침과 고급 연동까지 60개 강의, 열 개 단원을 계획합니다. 수준, 환경, 목표, 명령으로 다음 글을 찾고 미게시 항목의 상태를 확인할 수 있습니다.전체 글 읽기
목표와 준비
AGENTS.mdAGENTS.md 프로젝트 규칙AGENTS.md는 작업 시작 전 프로젝트 지침을 제공하는 파일입니다. 전역 지침과 프로젝트 루트부터 현재 작업 폴더까지의 규칙이 연결됩니다. 같은 위치에서는 AGENTS.override.md가 우선합니다. 실제로 무엇을 읽었는지 검증해야 합니다.전체 글 읽기는 지침이고 config.toml은 클라이언트 설정입니다. 일반 Markdown에 모델명을 써도 기본 설정은 바뀌지 않습니다. TOML에 주석 표시 없이 설명을 쓰면 파싱이 실패할 수 있습니다. 영향이 작은 한 항목으로 위치/검증/복구를 익힌 뒤 필요한 설정을 추가합니다.
사용자 설정과 프로젝트 설정 구분
사용자 설정은 기본 홈의 .codex/config.toml이며 기존 CODEX_HOME이 있으면 경로를 확인합니다. 프로젝트 설정은 저장소 안의 같은 경로이고 신뢰된 프로젝트에서 로드됩니다. 이름은 같지만 범위는 다릅니다. 실습은 프로젝트 파일만 만들며 인증 이동/전역 설정/시스템 환경 변수 변경은 필요 없습니다.
| 환경 | 사용자 기본 위치 | 실습 위치 |
|---|---|---|
| Windows | 사용자 폴더 내 .codex/config.toml | codex-config-lab/.codex/config.toml |
| macOS | ~/.codex/config.toml | 같은 상대 경로 |
| Linux/WSL | Linux 사용자의 ~/.codex/config.toml | 해당 환경의 실습 경로 |
| IDE | 톱니바퀴 → Codex Settings → Open config.toml | 실제 열린 경로 확인 |
1단계: 시작 상태 기록
새 codex-config-lab의 note.txt에 다음 한 줄을 저장합니다. PowerShell의 Get-Location 또는 macOS/Linux의 pwd로 위치를 확인하고 새 실습에서 git init으로 루트를 정합니다. 설정 파일은 아직 만들지 않습니다. 같은 이름의 다른 프로젝트가 있으면 초기화하지 말고 새 위치를 씁니다.
CONFIG-LAB-01
셸에서 codex --cd .로 시작하고 신뢰 안내가 방금 만든 실습인지 확인합니다. 내부에서 다음 슬래시 명령을 각각 실행합니다. 셸 명령이 아닙니다. /debug-config로 층/활성 상태, /status로 작업 환경을 보고 필요한 정보만 기록하며 비공개 진단 전문은 공개하지 않습니다.
/debug-config
/status
/debug-config가 없으면 / 목록을 확인한 뒤 /exit로 셸에 돌아가 codex --version을 기록합니다. 설치한 공식 방식으로 업데이트하고 CLI를 다시 시작해 확인합니다. 같은 이름의 셸 명령을 지어내지 않습니다. 버전/조직 환경의 진단이 부족하면 유효값을 미확인으로 남기고 모델 성공 선언만 믿지 않습니다. 기준 기록 후 /exit로 종료합니다.
2단계: 복원 가능한 설정 하나 추가
프로젝트 안에 .codex/config.toml을 만들고 루트 바로 아래나 .txt가 아닌지 확인합니다. 기존 파일이면 알아볼 수 있는 곳에 백업하고 원래 값을 기록한 뒤 같은 최상위 키를 수정하며 중복 추가하지 않습니다. 새 파일이면 다음 전체 예시를 씁니다.
# Practice setting: disable the built-in web search tool.
web_search = "disabled"
키/값 철자, 일반 따옴표, # 주석을 지킵니다. 최상위 키이므로 [features] 등 아래에 무조건 붙이지 않습니다. 테이블 헤더는 뒤 키의 소속을 바꿉니다. 사이트 바깥 백틱도 넣지 말고 UTF-8 텍스트로 저장해 재확인합니다.
3단계: 재시작 후 유효 출처 확인
실습 루트에서 --search/-c/--profile 없이 새로 시작하고 /debug-config의 프로젝트 층/활성을 확인합니다. 미신뢰로 생략되면 출처 확인 후 정상 신뢰 절차를 따릅니다. 진단은 낮은 우선순위부터 표시할 수 있으므로 첫 행을 승자로 보지 말고 라벨/상태를 읽습니다.
유효 설정/사용 가능 도구 정보와 파일을 비교하고 다음 로컬 읽기를 요청합니다. CONFIG-LAB-01과 검색 없음이 예상되며 유효값이 표시되면 disabled인지 확인합니다. 한 번 검색하지 않은 것만으로 설정 성공이 입증되지는 않으므로 층 진단 근거도 남깁니다.
Read note.txt from this practice project and report its exact line. Do not edit files, browse websites or call external services. If you cannot verify an effective setting from available diagnostics, say so rather than inferring it from the file alone.
이 설정은 내장 검색 도구를 끄며 모든 통신 차단은 아닙니다. 셸/브라우저/MCP/외부 서비스에는 별도 권한과 설정이 있습니다. 권한과 샌드박스권한, 샌드박스, 네트워크와 키샌드박스는 기술적인 접근 범위를, 승인 정책은 질문 시점을 제어합니다. 질문이 없다는 것과 무제한 실행이 가능하다는 것은 다릅니다.전체 글 읽기를 참고하고 증명을 위해 다른 도구로 우회 통신하지 않습니다.
검색하지 않았다는 관찰이 뜻하는 세 가지 상태
사례: A는 파일의 disabled만 보았고, B는 신뢰되지 않아 프로젝트 계층을 건너뛰었다는 진단도 보았으며, C는 계층 활성화와 실제 적용 값 disabled를 확인했습니다. 셋 다 검색하지 않았어도 A의 적용 값은 미상, B는 로드 문제, C는 해당 설정의 진단 근거가 있는 상태입니다. C도 모든 네트워크 도구가 차단되었다고 할 수는 없습니다. 파일 내용, 로드 상태, 적용 값, 이번 동작을 따로 기록하고 근거가 없는 칸은 미확인으로 남기세요.
4단계: 복원 및 결과 기록
CLI 종료 후 새 파일이면 프로젝트 설정 폴더 밖으로 백업 이동합니다. 기존 파일이면 web_search 원래 값만 복원하거나 추가 키만 제거하고 다른 설정은 보존합니다. 재시작 후 덮어쓰기가 사라지고 note.txt가 그대로인지 확인합니다. 복원값은 남은 층에 따라 달라지며 추측한 기본값과 같다고 단정하지 않습니다.
File changed: codex-config-lab/.codex/config.toml
Original state: record whether the file/key existed.
Requested change: web_search = disabled
Loaded layer: record observed path and enabled/skipped state.
Effective value: record verified value, or unverified.
Local read: record actual note.txt result.
Restoration: record the restored file/key state and fresh-session check.
문제 해결과 다음 단계
시작 실패는 지목된 TOML/줄의 따옴표, 중복 키, 테이블 소속을 확인합니다. 값이 안 바뀌면 경로/신뢰/시작 옵션/가까운 층을 봅니다. IDE와 CLI 차이는 OS/사용자/경로, 특히 별개인 Windows/WSL 홈을 비교하고 재설치 전에 출처를 진단합니다.
강제 요구는 일반 기본값과 달라 프로젝트 키로 금지값을 허용할 수 없습니다. 모델/추론은 선택 강의모델, 추론 수준과 속도 선택모델 선택과 추론 수준은 별개입니다. 같은 작은 과제에서 품질을 비교하고 필요할 때 추론을 높입니다. 이름만 보고 판단하지 말고 현재 계정에 표시되는 옵션을 사용하세요.전체 글 읽기를 참고하고 설정 묶음 복사로 인증/공급자를 바꾸지 않습니다. 시작/활성/복원과 미확인을 기록하고 설정 문제 해결설정 우선순위와 진단적용되지 않거나 충돌하는 설정의 출처를 찾고 한 항목씩 변경해 복원 가능한 기록을 남깁니다.전체 글 읽기로 이어 갑니다. 문법이 맞아도 모든 클라이언트의 로드 증거는 아닙니다.
Codex 학습 목차로 돌아가기Codex 학습 센터: 전체 튜토리얼 목차설치와 첫 작업부터 MD 지침과 고급 연동까지 60개 강의, 열 개 단원을 계획합니다. 수준, 환경, 목표, 명령으로 다음 글을 찾고 미게시 항목의 상태를 확인할 수 있습니다.전체 글 읽기
자세한 설명 보기
User config to Project config to CLI override
이 정리가 도움이 되셨나요? 필요한 분께 공유해 보세요
같은 주제의 글
라이프스타일
Codex 학습 센터: 전체 튜토리얼 목차
설치와 첫 작업부터 MD 지침과 고급 연동까지 60개 강의, 열 개 단원을 계획합니다. 수준, 환경, 목표, 명령으로 다음 글을 찾고 미게시 항목의 상태를 확인할 수 있습니다.
라이프스타일
Worktree와 작업 격리
Worktree는 하나의 Git 저장소에 다른 브랜치의 작업 폴더를 만듭니다. 파일이 분리되어도 DB, 포트와 외부 서비스는 공유될 수 있습니다.
라이프스타일
실습: 작은 웹사이트 만들기
brief.md에서 Small Steps 할 일 사이트를 계획하고 추가·완료·삭제·필터·로컬 저장을 구현합니다. HTML·CSS·데이터 함수·화면 이벤트·시험을 분리하고 Node와 브라우저로 검증한 뒤 재시작·복원 인계 기록을 남깁니다.
이 글을 인용한 글
출처
- Config basics확인일:
- CLI configuration diagnostics확인일:
- Web search확인일:
위에 기재된 참고 자료와 확인일 기준 정보를 바탕으로 정리했습니다. 요금, 시간표, 기능, 이용 약관은 바뀔 수 있으므로 여행, 예약 또는 구매 전에 해당 공식 사이트에서 최신 정보를 확인해 주세요.