Codex 기능 지도와 중급·고급 학습 순서
처음에는 설치와 첫 수정만 익히면 충분합니다. 여러 작업을 동시에 맡기거나 팀에서 반복 실행하기 시작하면 저장소 지침만으로는 해결되지 않는 문제가 생깁니다. 대화를 다시 여는 방법, 실행 환경의 격리, 외부 도구의 권한, 실패를 판별하는 출력 형식까지 따로 알아야 합니다.
이 시리즈는 공식 문서를 참고해 작성한 비공식 한국어 가이드입니다. 공식 목차를 그대로 번역한 문서 모음은 아닙니다. 다음 기능군을 실제 작업 순서에 맞춰 묶었으며 제품 기능의 실제 실행은 미검증입니다.
어떤 순서로 읽을까
| 지금 하려는 일 | 시작할 글 | 이어서 읽을 글 |
|---|---|---|
| 터미널 작업을 이어가기 | 세션 재개·분기 | 설정 우선순위, 모델·속도 |
| 에디터나 앱에서 수정하기 | IDE, 데스크톱 앱 | worktree, Cloud |
| 나만의 반복 작업 만들기 | 스킬 | 플러그인, MCP, 기억·가져오기 |
| 긴 작업을 나눠 맡기기 | 목표 | 서브에이전트, 훅, 실행 정책 |
| 프로그램에서 호출하기 | 비대화형 실행 | SDK, App Server, 연동·CI |
| 팀과 운영에 도입하기 | 원격·모바일, 조직 관리 | 게이트웨이, 보안 점검, 보안 CI |
| 화면·사이트까지 다루기 | 브라우저·미디어 | Sites, 플랫폼 운영 |
아직 첫 작업 전이라면 설치부터 기존 입문 8편을 먼저 읽습니다. 중급·고급은 더 강한 권한을 주는 단계가 아니라, 실행 조건과 결과를 더 세밀하게 관리하는 단계입니다.
공식 문서를 어디까지 다뤘나
2026-11-08 확인한 공식 인덱스는 208개 링크 행을 포함합니다. 같은 URL의 제목 별칭과 Windows 중복 항목이 있고 ChatGPT 공통 문서도 섞여 있습니다. 이 숫자는 Codex 기능 208개나 한국어 설명 208편을 뜻하지 않습니다.
저장소의 scripts/codex-doc-inventory.json은 공식 URL별로 연결 글과 섹션, 다음 분류를 기록합니다.
- 설명: 핵심 작업의 절차와 예시를 제공합니다. 원문의 모든 설정값을 옮겼다는 뜻은 아닙니다.
- 개요: 기능 선택과 안전 경계를 설명합니다. 세부 도입은 공식 절차를 따라야 합니다.
- 참조: 공식 링크와 용도를 안내합니다. 설명 완료로 세지 않습니다.
- 관련 없음: 이번 Codex 기술 학습 범위가 아닌 항목이며 이유를 남깁니다.
- 보류: 관련 있지만 검수나 작성을 끝내지 못한 항목입니다. 접근 실패도 숨기지 않습니다.
API·설정 전체 참조, 기업별 도입, 보안 스캔의 개별 옵션은 이 시리즈의 설명을 넘어서는 부분이 있습니다. 공식 문서를 확인하지 않고 예제의 값을 운영 환경에 복사하지 마세요.
현재 기능과 이전 기능 구분
공식 인덱스에는 현재 Cloud와 Codex Cloud (Legacy)가 함께 있습니다. MCP 도구에 연결하는 기능과 제거된 Codex MCP server도 다른 항목입니다. 옛 Custom Prompts를 재사용하는 작업은 현재 스킬 문서를 먼저 봅니다. 이름이 남아 있다는 이유만으로 신규 설치 경로라고 판단하면 안 됩니다.
앱·웹·CLI·IDE의 지원 범위도 같지 않습니다. 예를 들어 CLI의 명령을 앱 설정명으로 바꾸거나, 앱의 브라우저 기능을 IDE 기본 기능으로 가정하지 않습니다. 각 글의 적용 범위와 공식 원문의 표면 선택을 함께 확인합니다.
새 기능을 놓치지 않는 갱신 방법
편집자는 pnpm guides:check-inventory로 공식 목차의 새 URL·삭제·제목 변경을 확인하고, pnpm guides:check-sources --series codex로 등록 원문의 변경을 대조합니다. pnpm guides:coverage는 연결된 글·섹션·출처의 정합성을 오프라인 검사합니다. 실행 방법은 저장소의 docs/study/guide-source-verification.md와 /update-codex-guide에 있습니다.
이 명령은 번역·설명 작성·실행 검증을 대신하지 않습니다. 기준 해시가 같아도 이미 부족한 설명은 남을 수 있습니다. 자동 정기 실행이나 무검수 발행은 등록되어 있지 않습니다. 실제 갱신 때 원문과 한국어 내용을 대조한 글만 검수일을 바꿉니다.
공식 한국어 도움말: ChatGPT 플랜과 Codex에서 계정별 이용 안내를 확인할 수 있습니다. 이 글은 해당 도움말의 공식 번역이 아니며 계정 조건과 요금은 공식 안내를 우선합니다.
추가 공식 참조
다음은 관련 세부 기능과 전체 참조 문서입니다. 아래 항목은 원문 전체를 한국어로 설명하거나 실행 검증한 범위가 아닙니다. 적용 조건과 정확한 옵션은 공식 원문을 확인하세요.