[확인 필요].0.1 이 가이드를 읽는 법
기능 목록은 시작 편을 주지 않습니다. 원문은 그 목록을 레벨 순으로 다시 깔아 두었습니다. 답이 “아니오”인 첫 문항이 시작할 편입니다.
L0부터 L4까지가 본선입니다. L6은 L2 이후 역할이 관리자면 갈라져 나가고, L5는 L3 이후 자동화가 필요할 때 갈라집니다.
문서 수는 원문이 재는 명령을 함께 둡니다. 2026년 8월 11일 실행값은 138입니다.
curl -s https://developers.openai.com/codex/llms.txt \
| grep -o 'https://[^)]*' | sed 's/?.*//' | sort -u \
| grep -v 'llms-full.txt' | grep -v 'codex-manual.md' | wc -l인용 주소 규칙: 원문 각주는 learn.chatgpt.com/docs/<페이지>를 씁니다.
라벨 셋 — 공식 · 관행 · 실전
- 공식 — 문단 끝에 근거 문서 링크가 있습니다.
- 관행 — 각주가 있으면 공식 쿡북이나 openai/codex 레포 같은 외부 출처로 확인한 것이고, 각주가 없으면 이 가이드가 공식 사실에서 끌어낸 판단입니다. 후자는 참고 기준입니다.
- 실전 — 같은 명령을 다시 돌려 재현합니다.
0.2 역할별 3트랙
| 역할 | 경로 | 왜 이 순서 |
|---|---|---|
| 혼자 쓰는 개발자 | L0 → L1 → L2 → L3 | 손놀림이 붙기 전에 확장을 배우면 도구만 쌓이고 생산성은 안 오릅니다 |
| 팀 리드 | 위 경로 + L4 → L5 | 여러 작업을 굴리고 리뷰·보안을 CI에 거는 것이 팀 단위의 실제 레버리지입니다 |
| 조직 관리자 | L2 → L6 (필요하면 L5) | 통제 설계에는 승인·샌드박스·설정 계층의 이해가 선행돼야 합니다. L0·L1은 나중에 봐도 됩니다 |
관리자 트랙에서 L2를 건너뛰면 L6의 관리형 요구사항이 무엇을 제약하는지 읽히지 않습니다.
코덱스는 ChatGPT Free·Go·Plus·Pro·Business·Edu·Enterprise에 포함됩니다. 별도 구독이 아닙니다. 클라우드는 ChatGPT 로그인 전용입니다. 원문.
0.3 6문항 자기진단
답이 “아니오”인 첫 문항이 시작할 편입니다. 정직하게 답하려면 확인하는 명령을 함께 돌립니다. 원문: 0.3절.
| # | 문항 | 확인법 | 아니오면 |
|---|---|---|---|
| 1 | 코덱스를 깔고 로그인했고, 첫 세션에서 파일 하나를 고쳐 커밋해 봤다 | codex login status | L0 시작 |
| 2 | 슬래시 명령 다섯 개 이상을 쓰임에 따라 골라 쓴다 | /를 눌러 목록을 보고 아는 것을 셉니다 | L1 일상 운전 |
| 3 | 작업하는 저장소에 AGENTS.md가 있고 내가 그 내용을 정했다 | codex --ask-for-approval never "Summarize the current instructions." | L2 맥락과 통제 |
| 4 | 승인 정책과 샌드박스 모드를 설계해서 정했다(눌러서 쌓인 것이 아니라) | /status와 /debug-config | L2 맥락과 통제 |
| 5 | 반복 작업 하나를 스킬이나 훅으로 도구화했다 | /skills와 /hooks | L3 확장 |
| 6 | 작업을 로컬·워크트리·클라우드로 갈라 돌려 봤다 | 데스크톱 앱 새 채팅의 환경 선택기 | L4 오케스트레이션 |
4번 문항이 실제로 자기 착각을 잡습니다. 설정 파일이 있다고 설계된 것은 아닙니다. 승인 프롬프트에서 “항상 허용”을 눌러 규칙이 쌓인 상태와, 무엇을 허용하고 무엇을 막을지 설계한 상태는 다릅니다. 전자는 ~/.codex/rules/default.rules가 승인 버튼의 흔적으로 채워져 있고 forbidden 규칙이 하나도 없는 모습으로 나타납니다.
0.4 표면 선택 요약
공식: 코덱스는 한 엔진을 여러 입구에서 씁니다. 입구가 달라도 AGENTS.md · config.toml · 스킬 · 플러그인 · MCP · 승인 정책은 공유됩니다.
| 표면 | 한 줄 |
|---|---|
| 코덱스 CLI | 터미널 대화형 세션과 스크립트 진입점. 문서가 가장 촘촘합니다 |
| IDE 확장 | 열린 파일·선택 영역을 그대로 맥락으로 |
| 데스크톱 앱 | 여러 채팅·프로젝트·워크트리를 한 화면에서 |
| 클라우드 | ChatGPT 로그인 전용 |
처음이면 CLI로 시작하세요. 에디터면 IDE 확장, 병렬이면 데스크톱 앱입니다.
채팅 하나에 하나. 프로젝트 전체를 몰아넣지 마세요. 같은 문제면 같은 채팅, 갈리면 /fork 또는 /new. 승인과 샌드박스는 다른 축입니다.
L0–L6 한 줄 — 원문의 그 편으로
| 레벨 | 한 줄 | 마치면 | 원문 |
|---|---|---|---|
| L0 시작 | 깔고 켜서 첫 한 건을 끝낸다 | 자기 표면에서 세션을 열고 파일 하나를 고쳐 커밋한다 | 1부 |
| L1 운전 | 매일 쓰는 손놀림 | 실무 한 건을 탐색부터 커밋·리뷰까지 혼자 끝낸다 | 2부 |
| L2 통제 | 무엇을 알려주고 무엇을 막을지 | 새 저장소의 AGENTS.md·승인·샌드박스·설정을 30분 안에 세팅한다 | 3부 |
| L3 확장 | 없는 기능을 내가 만든다 | 반복 작업을 스킬로, 검사를 훅으로, 외부 데이터를 MCP로 붙인다 | 4부 |
| L4 병렬 | 하나가 아니라 여러 개를 동시에 | 한 작업을 여러 환경으로 쪼개 돌리고 격리·추적·회수까지 설계한다 | 5부 |
| L5 자동화 | 사람 없이 돌린다 | 코덱스를 파이프라인 부품으로 호출하고 보안 스캔을 CI에 건다 | 6부 |
| L6 조직 | 나 한 명이 아니라 팀과 회사 | 조직 표준 설정·계측·컴플라이언스·도입 계획을 문서로 낸다 | 7부 |
부록이 하는 일
- A. 한 장 치트시트
- B. 용어집
- C. 표면 대조표
- D. 트러블슈팅
- E. 프롬프트 모음
- F. 안티패턴 목록
- G. 갱신 추적
- H. 학습 로드맵
- I. 클로드코드에서 넘어오기
- J. 이 가이드가 다루지 않는 문서
전량 목차와 각 장의 본문은 원문에 있습니다.
안 되면
| 증상 | 먼저 볼 것 |
|---|---|
| 명령 못 찾음 | 터미널을 새로 연다. 원문 3.7 |
| 로그인 멈춤 | 기기 코드 또는 1455. 원문 3.5 |
| 설정이 안 먹음 | /debug-config |
| 쌓인 허용 | forbidden이 0건이면 설계가 아님. 원문 0.3 4번 |
지금 할 일: 원문 0.3절을 열고 문항 6개를 셉니다. 그 편의 완료 기준만 수행합니다.