검증 리포트
Codex 고급 활용 핸드북의 링크·정합성 검증
이 문서는 Codex 고급 활용 핸드북의 내부 정합성과 외부 링크 유효성을 검증한 결과입니다.
검증 기준일
2026년 5월 10일(KST) 기준으로 검증을 수행했습니다.
검증 방법론
검증 범위
- 내부 정합성: 챕터 간 용어·모델명·커맨드 통일, meta.json 구조 정합
- 공식 문서 교차검증: 공식 Changelog, Models 페이지, Slash Commands 페이지, CLI Features 페이지, Subagents 문서, Skills 문서, App/Chrome 문서, GitHub Releases(0.99.0~0.130.0)와 본문 사실 관계 대조
- 링크 유효성: 핵심 공식 링크를
curl -L기반 HTTP 상태 코드로 검증
검증 결과 요약
| 항목 | 결과 |
|---|---|
| 구조/용어 일관성 | 이상 없음 |
| 공식 문서 교차검증 | 이상 없음 (아래 세부 내역 참조) |
| 코드 블록/경로 | 이상 없음 |
| 공식 링크 유효성 | 핵심 링크 정상(40개 중 38개 HTTP 200, MCP endpoint 2개는 405) |
공식 문서 교차검증 세부 내역
모델 정보
| 항목 | 핸드북 | 공식 문서 | 일치 |
|---|---|---|---|
| 기본 추천 모델 | GPT-5.5 | Models 페이지 "For most tasks in Codex, start with gpt-5.5" | O |
| API-key/미가용 fallback | GPT-5.4 | Models 페이지 "continue using gpt-5.4 if gpt-5.5 is not yet available" | O |
| 가벼운 coding/subagent | GPT-5.4-mini | Models 페이지 "faster, lower-cost option for lighter coding tasks or subagents" | O |
| Codex Cloud 지원 coding model | GPT-5.3-Codex | Models 페이지 Codex Cloud 지원 | O |
| 빠른 Pro research preview | GPT-5.3-Codex-Spark | Models 페이지 research preview 설명 | O |
| 잘못된 5.5 family 제거 | 반영 | gpt-5.5-codex, gpt-5.5-mini, gpt-5.5-nano 미등재 | O |
CLI 버전/기능
| 항목 | 핸드북 | 공식 문서 | 일치 |
|---|---|---|---|
| 최신 CLI 버전 | 0.130.0 | Changelog 2026-05-08 | O |
| 최신 안정 버전 | 0.130.0 | 0.130.0 (Changelog 2026-05-08) | O |
| 직접 설치 스크립트 | macOS/Linux | GitHub release asset (Changelog) | O |
@plugin 멘션 | 지원 | 0.112.0 release | O |
| Fast 기본화 | 기본 on | 0.111.0 release | O |
/plugins + /title | 반영 | 0.117.0 release / changelog | O |
codex exec prompt+stdin | 반영 | 0.118.0 release | O |
codex exec-server | 실험 기능으로 반영 | 0.119.0 release | O |
/resume ID/name 점프 | 반영 | 0.119.0 release | O |
Ctrl+O 최신 응답 복사 | 반영 | 0.119.0 release | O |
/status stale quota 갱신 | 반영 | 0.119.0 release | O |
| custom status line의 thread title | 반영 | 0.120.0 release | O |
SessionStart /clear source | 반영 | 0.120.0 release | O |
Ctrl+R reverse search | 반영 | Changelog 2026-04-15 | O |
| memory mode/reset/deletion | 반영 | Changelog 2026-04-15 | O |
queued slash command + ! 입력 | 반영 | Changelog 2026-04-20 | O |
| deny-read glob policy | 반영 | config reference + Changelog 2026-04-20 | O |
--ignore-user-config / --ignore-rules | 반영 | Changelog 2026-04-20 | O |
| tool discovery 기본화 | 반영 | Changelog 2026-04-20 | O |
| GPT-5.5 모델 정리 | 반영 | Models 문서 2026-05-10 검증 | O |
/mcp verbose | 반영 | Changelog 2026-04-22 | O |
| built-in browser use | 반영 | Changelog 2026-04-22 | O |
Alt+, reasoning quick cycle | 반영 | Changelog 2026-04-23 | O |
| automatic approval review | 반영 | Changelog 2026-04-23 | O |
| hooks stable | 반영 | Changelog 2026-04-23 | O |
| remote plugin marketplace list/read | 반영 | Changelog 2026-04-23 | O |
| permission state round-trip | 반영 | Changelog 2026-04-24 | O |
| remote plugin install/marketplace upgrade | 반영 | Changelog 2026-04-24 | O |
codex exec --json reasoning token usage | 반영 | Changelog 2026-04-24 | O |
| request_permissions | 런타임 권한 요청 | 0.113.0 release | O |
| named permission profiles | 분리형 정책 언어 | config reference [permissions.<name>] | O |
| hooks 엔진 | SessionStart/Stop | 0.114.0 release (experimental) | O |
| code mode | 격리 코딩 워크플로우 | 0.114.0 release (experimental) | O |
| plugin marketplace | 검색/설치/삭제 | 0.113.0 release | O |
| healthz/readyz | 앱 서버 헬스체크 | 0.114.0 release | O |
| steering/resume | 반영 | 0.99.0~0.107.0 releases | O |
| Realtime V2 background progress | 반영 | 0.120.0 release | O |
persisted /goal workflow | 반영 | Changelog 2026-04-30 + slash commands | O |
configurable /keymap | 반영 | Changelog 2026-04-30~05-07 + slash commands | O |
/side 공식 명령 등재 | 반영 | slash commands 문서 2026-05-10 검증 | O |
/stop 공식 명령 등재 | 반영 | slash commands 문서 2026-05-10 검증 | O |
codex remote-control | 반영 | Changelog 2026-05-08 | O |
| plugin sharing/bundled hooks | 반영 | Changelog 2026-05-07~05-08 + Plugins 문서 | O |
멀티에이전트
| 항목 | 핸드북 | 공식 문서 | 일치 |
|---|---|---|---|
| 상태 | 기본 활성화로 갱신 | Subagents 문서 "enabled by default" | O |
| 역할 | default/worker/explorer | 공식 문서 일치 | O |
| spawn_agents_on_csv | 배치 처리+진행률 | PR #10935 / Changelog | O |
| max_threads/max_depth | 설정 가능 | multi-agent 문서 일치 | O |
| child-thread approval | 반영 | 0.105.0~0.110.0 releases | O |
| fork/steer/resume | 반영 | 0.99.0~0.107.0 releases | O |
Skills 체계
| 항목 | 핸드북 | 공식 문서 | 일치 |
|---|---|---|---|
| 필수 파일 | SKILL.md | Skills 문서 일치 | O |
| Progressive disclosure | 메타데이터만 우선 로드 | Skills 문서 일치 | O |
| 위치 계층 | CWD→부모→루트→사용자→관리자→내장 | Skills 문서 일치 | O |
| openai.yaml | 선택적 UI/의존성 메타 | Skills 문서 일치 | O |
| plugin 연계 | @plugin/plugin catalog 반영 | 0.110.0~0.112.0 | O |
메모리/권한 흐름
| 항목 | 핸드북 | 공식 근거 | 일치 |
|---|---|---|---|
| memory reset | codex debug clear-memories 반영 | 0.107.0 release | O |
| stale fact guardrails | 반영 | 0.110.0 release | O |
| unified permissions | 반영 | 0.102.0 release | O |
| structured network approvals | 반영 | 0.102.0 release | O |
| symlinked writable roots 수정 | 반영 | 0.119.0/0.120.0 release | O |
Codex App
| 항목 | 핸드북 | 공식 문서 | 일치 |
|---|---|---|---|
| 플랫폼 | macOS + Windows (2026-03-04) | Changelog 일치 | O |
| 워크트리 지원 | 내장 | App 문서 일치 | O |
| 자동화/인박스 | 지원 | App 문서 일치 | O |
| App 26.312 테마 | 베이스 테마/색상/폰트/공유 | Changelog 2026-03-12 일치 | O |
| App 26.312 자동화 | 로컬/워크트리 선택, 모델/추론 지정 | Changelog 2026-03-12 일치 | O |
| App 26.305 수정 | 원격 연결, Windows 터미널 | Changelog 2026-03-05 일치 | O |
| App 26.415 in-app browser | 반영 | App features + Changelog 2026-04-16 | O |
| App 26.415 chats / task sidebar / artifact viewer | 반영 | App features + Changelog 2026-04-16 | O |
| App 26.415 SSH remote alpha | 반영 | Remote connections + Changelog 2026-04-16 | O |
| App 26.423 diff reviewer comments | 반영 | Changelog 2026-04-23 | O |
| App 26.423 browser cookies + browser use | 반영 | Changelog 2026-04-23 + App features | O |
| App 26.423 images/slides/Figma | 반영 | Changelog 2026-04-23 | O |
| App 26.423 continue-from-notification | 반영 | Changelog 2026-04-23 | O |
| Codex for Chrome | 반영 | Changelog 2026-05-07 + Chrome extension docs | O |
8차 검증 (2026-05-10)
v0.128.0~v0.130.0, Codex for Chrome, 최신 Models/Slash Commands 문서 반영에 대한 내부 교차검증 결과.
검증 항목
| # | 항목 | 검증 결과 | 근거 |
|---|---|---|---|
| 1 | 최신 안정 버전 0.130.0 | 확인 | Changelog Codex CLI 0.130.0 (2026-05-08) |
| 2 | /goal, /keymap, /side, /stop 공식 slash docs 등재 | 확인 | slash commands 문서 (2026-05-10 검증) |
| 3 | /hooks, /vim preview 취급 | 확인 | Changelog Codex CLI 0.129.0, slash commands 표 미등재 |
| 4 | codex remote-control | 확인 | Changelog Codex CLI 0.130.0 |
| 5 | plugin sharing/link metadata/discoverability controls | 확인 | Changelog Codex CLI 0.129.0~0.130.0 + Plugins 문서 |
| 6 | Chrome 확장 보안 기준 | 확인 | Codex Chrome extension 문서 |
| 7 | --full-auto deprecated | 확인 | Non-interactive mode 문서 |
| 8 | GPT-5.5 모델 목록 재검증 | 확인 | Codex Models 문서 |
| 9 | Subagents 기본 활성화 | 확인 | Subagents 문서 |
| 10 | app-server large thread pagination view | 확인 | Changelog Codex CLI 0.130.0 |
7차 검증 (2026-04-26)
v0.123.0~v0.125.0, GPT-5.5, App 26.423 반영에 대한 내부 교차검증 결과. 2026-05-10 재검증에서 모델 세부 명칭은 최신 Models 문서 기준으로 보정했습니다.
검증 항목
| # | 항목 | 검증 결과 | 근거 |
|---|---|---|---|
| 1 | 최신 안정 버전 0.125.0 | 확인 | Changelog Codex CLI 0.125.0 (2026-04-24) |
| 2 | GPT-5.5 기본 추천 | 확인 | Models 페이지 2026-05-10 재검증 |
| 3 | GPT-5.4 fallback + GPT-5.4-mini + GPT-5.3-Codex-Spark | 확인 | Models 페이지 2026-05-10 재검증 |
| 4 | /mcp verbose | 확인 | Changelog Codex CLI 0.123.0 (2026-04-22) |
| 5 | built-in browser use | 확인 | Changelog Codex CLI 0.123.0 |
| 6 | Alt+, reasoning quick cycle | 확인 | Changelog Codex CLI 0.124.0 (2026-04-23) |
| 7 | automatic approval review | 확인 | Changelog Codex CLI 0.124.0 + App 26.423 |
| 8 | hooks stable | 확인 | Changelog Codex CLI 0.124.0 |
| 9 | remote plugin marketplace list/read | 확인 | Changelog Codex CLI 0.124.0 |
| 10 | permission state round-trip + remote plugin install/upgrade | 확인 | Changelog Codex CLI 0.125.0 |
| 11 | codex exec --json reasoning token usage | 확인 | Changelog Codex CLI 0.125.0 |
| 12 | App 26.423 browser cookies / reviewer comments / slides / Figma | 확인 | Changelog Codex App 26.423 (2026-04-23) |
5차 검증 (2026-04-15)
v0.119.0~v0.120.0 및 2026-04-14 모델 가용성 정리 완료 반영에 대한 내부 교차검증 결과.
검증 항목
| # | 항목 | 검증 결과 | 근거 |
|---|---|---|---|
| 1 | 최신 안정 버전 0.120.0 | 확인 | GitHub release rust-v0.120.0 (2026-04-11) |
| 2 | /resume session ID/name 직접 점프 | 확인 | v0.119.0 릴리즈 노트 |
| 3 | Ctrl+O 최신 응답 복사 + /copy 보강 | 확인 | v0.119.0 릴리즈 노트 |
| 4 | /status stale quota 갱신 | 확인 | v0.119.0 릴리즈 노트 |
| 5 | richer MCP support + /mcp 경량화 | 확인 | v0.119.0 릴리즈 노트 |
| 6 | codex exec-server 실험 기능 | 확인 | v0.119.0 릴리즈 노트 |
| 7 | Realtime V2 background progress + queued follow-up | 확인 | v0.120.0 릴리즈 노트 |
| 8 | custom status line의 renamed thread title | 확인 | v0.120.0 릴리즈 노트 |
| 9 | SessionStart hook의 /clear source 구분 | 확인 | v0.120.0 릴리즈 노트 |
| 10 | ChatGPT 로그인 레거시 모델 제거 완료 | 확인 | Changelog 2026-04-07 + 2026-04-14 기준 적용 |
6차 검증 (2026-04-22)
v0.121.0~v0.122.0 및 App 26.415 반영에 대한 내부 교차검증 결과.
검증 항목
| # | 항목 | 검증 결과 | 근거 |
|---|---|---|---|
| 1 | 최신 안정 버전 0.122.0 | 확인 | Changelog Codex CLI 0.122.0 (2026-04-20) |
| 2 | Ctrl+R reverse search + slash command local recall | 확인 | Changelog Codex CLI 0.121.0 (2026-04-15) |
| 3 | memory mode/reset/deletion | 확인 | Changelog Codex CLI 0.121.0 + config reference |
| 4 | queued input의 slash command + ! shell prompt | 확인 | Changelog Codex CLI 0.122.0 (2026-04-20) |
| 5 | deny-read glob policy + glob_scan_max_depth | 확인 | config reference permissions.<name>.filesystem |
| 6 | --ignore-user-config, --ignore-rules | 확인 | Changelog Codex CLI 0.122.0 |
| 7 | tool discovery / image generation 기본화 | 확인 | Changelog Codex CLI 0.122.0 |
| 8 | App 26.415 in-app browser / task sidebar / artifact viewer | 확인 | Changelog 26.415 + App features |
| 9 | thread automations | 확인 | Changelog 26.415 + App automations |
| 10 | SSH remote connections alpha | 확인 | Changelog 26.415 + Remote connections 문서 |
| 11 | /side는 공식 slash docs 미등재 | 확인 | slash commands 페이지 검색 결과와 changelog 비교 |
링크 유효성 확인 목록
아래 링크들은 curl -L로 HTTP 상태와 최종 도착 URL을 확인했습니다.
405로 확인된 링크 2개
https://developers.openai.com/mcp, https://mcp.figma.com/mcp는 문서 페이지가 아니라 MCP
transport endpoint라서 일반 GET 검증에서는 HTTP 405가 반환되었습니다. 링크 자체가 깨진 것이
아니라, 브라우저형 접근을 허용하지 않는 엔드포인트로 해석했습니다.
업데이트 내역
공식 변경사항 반영 기록은 별도 문서에서 관리합니다.
- 업데이트 내역:
/books/codex-advanced/updates
검증 한계
범위 안내
본 리포트는 링크 유효성, 공식 문서와의 사실 관계 교차검증, 문서 내부 정합성을 검증했습니다. 공식 문서의 모든 세부 사항을 100% 검증한 것은 아니며, 공식 문서가 업데이트되면 핸드북과 차이가 발생할 수 있습니다.