본문으로 바로가기
리옵트 핸드북
리옵트 핸드북
Codex 고급 활용

기본 세팅

Ch1. 설치/로그인Ch2. config.toml 설계메모리 운영

안전 & 운영

Ch3. 승인/샌드박스 전략Ch4. 보안 가이드

워크플로우

Ch5. 슬래시 커맨드 운영Ch6. 프롬프트/스킬 설계Ch7. exec/자동화스레드 라이프사이클Ch8. Cloud TasksCh9. 멀티에이전트

확장 & IDE

Ch10. Codex App/IDECh11. MCP 연동Ch12. 모델/추론 전략Ch13. 거버넌스/롤아웃

검증

검증 리포트업데이트 내역
핸드북›Codex 고급 활용›검증 리포트
한국어KOEnglishEN

검증 리포트

Codex 고급 활용 핸드북의 링크·정합성 검증

2026-10-23 재검증 · Codex CLI 0.163.0

확인 항목결과
공식 릴리스·npm 채널0.163.0; latest=0.163.0, alpha=0.164.0-alpha.12
공식 표 대조57 / 29행 (slash / CLI overview)
사용법 반영설정 검색·즉시 steering·leader·Daybreak·resume 권한·GPT-5.5 종료
검증 범위공식 원문·명령 공통 데이터·한영 문서의 정적 검증; 설치본의 새 기능 실행은 하지 않음

상세 변경과 공식 근거. 이전 검증은 아래 당시 기준으로 보존합니다.

2026-10-10 검증

Codex CLI 0.162.1(10월 9일) 기준입니다. npm latest=0.162.1, alpha=0.163.0-alpha.5를 2026-10-10 KST에 확인했습니다. GitHub 릴리스 원문·PR 설명·Developer Commands·config reference·non-interactive 문서·Models 문서·번들 모델 카탈로그를 대조했고, 설치된 CLI로 새 기능을 실행해 보지는 않았습니다. 공식 Changelog 페이지는 ChatGPT·Codex 통합 changelog로 개편되어 Codex CLI 버전 번호를 싣지 않으므로, 이번부터 CLI 버전은 GitHub 릴리스와 npm으로 추적합니다.

항목핸드북 반영 값근거결과
stable 릴리스0.161.0(10-07)·0.162.0(10-08)·0.162.1(10-09)GitHub 릴리스 rust-v0.161.0~rust-v0.162.1O
npm dist-tagslatest=0.162.1, alpha=0.163.0-alpha.5npm view @openai/codex dist-tagsO
공식 Changelog 구조통합 changelog로 개편, Codex CLI 버전 번호 없음learn.chatgpt.com/docs/changelog구조 변경 기록
공식 명령 표10-07 대조 이후 키·값 변동 없음Developer CommandsO
번들 기본 모델0.159.1~0.162.1 GPT-6.1 Solcodex-rs/models-manager/models.json의 gpt-6.1-sol priority 1O (소스 대조)
Bedrock 카탈로그 기본 모델GPT-6.1 Sol. 0.159.1이 Mantle·Runtime 카탈로그에 backport했고 0.161.0 릴리스 노트가 다시 명시릴리스 rust-v0.159.1(#49342)·rust-v0.161.0(#49339)릴리스로 확인
Bedrock multi-agent V2·Ultra reasoning·GovCloud0.161.0. 호환 모델 한정, GovCloud는 Bedrock Mantle릴리스 노트, PR #49345·#49813릴리스로 확인
GPT-5.5 종료2026-10-14 변동 없음Models 문서O
GPT-6.1 Sol 속도Standard·Fast. Ultrafast는 Pro $500과 대상 Enterprise·Edu 플랜Models 문서O
Daybreak opt-in--enable cli_daybreak·features.cli_daybreak(0.161.0), 꺼졌을 때 숨겨지는 범위와 routing 요건릴리스 노트, PR #51207릴리스로 확인
--cyber-access-program·cyberAccessProgram0.161.0, 값 standard·daybreak_blue·daybreak_red릴리스 노트, PR #49939. 공식 non-interactive 문서에는 없음릴리스로 확인
권한 동작 수정escalation 쓰기 범위, background task 권한, 실행 시 권한 유지(0.161.0)릴리스 노트, PR #49353·#49880·#49809릴리스로 확인
tui.mouse_scroll_speed0.162.0, 양수 배율, 기본은 휠 이벤트당 1행릴리스 노트, PR #50209릴리스로 확인
custom provider capabilitymodel_providers.<id>.capabilities의 external_web_access·remote_compaction(0.162.0)릴리스 노트, PR #50459릴리스로 확인
서명된 PowerShell installer0.162.0릴리스 노트, PR #51158릴리스로 확인
config reference위 신규 키 미등재learn.chatgpt.com/docs/config-file/config-reference미확인

2026-10-07 검증

Codex CLI 0.160.1(10월 5일) 기준입니다. npm latest=0.160.1, alpha=0.162.0-alpha.18을 2026-10-07 KST에 확인했습니다. 공식 릴리스 원문·PR 설명·Models 문서·API 모델 페이지·번들 모델 카탈로그를 대조했고, 설치된 CLI로 새 기능을 실행해 보지는 않았습니다.

항목핸드북 반영 값근거결과
stable 릴리스0.158.0(09-28)·0.159.0(09-29)·0.159.1(09-29)·0.159.2(09-29)·0.159.3(09-30)·0.160.0(10-01)·0.160.1(10-05)GitHub 릴리스 rust-v0.158.0~rust-v0.160.1, 공식 ChangelogO
npm dist-tagslatest=0.160.1, alpha=0.162.0-alpha.18npm view @openai/codex dist-tagsO
GPT-6.1 Sol 출시2026-09-29 배포 시작, Plus·Pro·Business·Enterprise·Edu 대상(Free·Go 제외), Enterprise·Edu는 관리자 활성화, Standard·Fast 지원Changelog 2026-09-29 항목, Models 문서O
GPT-6.1 Sol API 사양1,050,000 컨텍스트·128K 출력, $2 / $0.10 / $10(캐시 쓰기 $2.50), 기준일 2026-04-30, effort low~max 기본 medium(none·minimal 미지원)developers.openai.com/api/docs/models/gpt-6.1-solO
번들 기본 모델0.159.1부터 GPT-6.1 Sol(그전은 Astra)릴리스 rust-v0.159.1. codex-rs/models-manager/models.json@rust-v0.159.0은 Astra priority 1, rust-v0.159.1·rust-v0.160.1은 GPT-6.1 Sol priority 1·Astra 2O (소스 대조)
GPT-6.1 Sol 최소 CLI공식 문서에 명시 없음. 번들 카탈로그의 minimal_client_version은 0.153.0이고 번들 수록은 0.159.1부터Models 문서, 같은 카탈로그공식 문서 미확인
기존 모델 지위GPT-6 Sol·Luna와 GPT-5.6 계열 계속 제공. GPT-5.6·GPT-5.5의 전환 안내 대상은 여전히 GPT-6 Sol·Luna. GPT-5.4는 번들 카탈로그에서 제거(0.158.0)Models 문서, 같은 카탈로그의 upgrade 필드, PR #47932O (소스 대조)
GPT-5.5 종료2026-10-14 변동 없음. 대체 안내는 유료 GPT-6 Sol·Free/Go GPT-6 Luna 그대로Models 문서O
--model·/model 공식 표예시가 gpt-6.1-sol·gpt-6-luna로 바뀌고 명령·옵션 구성은 동일Developer CommandsO
tui.copy_on_select·tui.right_click_paste0.158.0 추가, 허용값과 auto 기본 동작릴리스 노트, PR #47639·#48118·#48469릴리스로 확인
instant_interrupt·write_stdin_approvalopt-in feature flag(0.159.0), stable·기본 활성(0.158.0)릴리스 노트, PR #48135·#48141·#47799릴리스로 확인
tui.prompt_suggestions·plugin-creator0.159.0에서 제거릴리스 노트, PR #48621·#48604릴리스로 확인
MCP OAuth client secretcodex mcp add --oauth-client-secret, oauth.client_secret(0.158.0)릴리스 노트, PR #47891. 공식 codex mcp add 표에는 --oauth-client-id만 있음불일치 기록
.aws 보호·projectless 세션·Guardian opt-in0.159.0·0.160.0릴리스 노트, PR #48176·#49160·#49036·#49057릴리스로 확인
config reference위 신규 키 미등재. model 예시는 gpt-6.1-sollearn.chatgpt.com/docs/config-file/config-reference미확인

2026-09-26 검증

Codex CLI 0.157.1(9월 26일) 기준입니다. npm latest=0.157.1, alpha=0.159.0-alpha.4를 2026-09-26 KST에 확인했습니다. 공식 릴리스 원문·Models 문서·API 모델 페이지·번들 모델 카탈로그를 대조했고, 설치된 CLI로 새 기능을 실행해 보지는 않았습니다.

항목핸드북 반영 값근거결과
stable 릴리스0.155.0(09-17)·0.155.1(09-18)·0.156.0(09-22)·0.156.1(09-23)·0.157.0(09-25)·0.157.1(09-26)GitHub 릴리스 rust-v0.155.0~rust-v0.157.1, 공식 ChangelogO
npm dist-tagslatest=0.157.1, alpha=0.159.0-alpha.4npm view @openai/codex dist-tagsO
GPT-6 Sol·Luna 출시2026-09-22 배포 시작, Work·Codex 전용(Chat 제외), Enterprise·Edu는 관리자 활성화Changelog 2026-09-22 항목, Models 문서O
Sol·Luna picker 노출CLI 0.156.1, Bedrock·전환 안내 0.157.0릴리스 rust-v0.156.1·rust-v0.157.0O
GPT-6 Sol API 사양1,050,000 컨텍스트·128K 출력, $2 / $0.20 / $10, 기준일 2026-04-20, effort none~max 기본 mediumdevelopers.openai.com/api/docs/models/gpt-6-solO
GPT-6 Luna API 사양1,050,000 컨텍스트·128K 출력, $0.10 / $0.01 / $0.50, 기준일 2026-05-18developers.openai.com/api/docs/models/gpt-6-lunaO
Codex 시작 effort 권장Sol Medium, Luna High(Max까지, Ultra 미지원), Astra Light(low)Models 문서 "Pick a reasoning effort"O
번들 기본 모델GPT-6 Astra 유지codex-rs/models-manager/models.json@rust-v0.157.1에서 Astra priority 1O (소스 대조)
GPT-5.6 전환 안내Sol·Terra → GPT-6 Sol, Luna → GPT-6 Luna같은 카탈로그의 upgrade 필드O (소스 대조)
GPT-5.5 종료ChatGPT 로그인 Codex에서 2026-10-14, API 유지, 대체는 유료 GPT-6 Sol·Free/Go GPT-6 LunaChangelog 2026-09-14 공지, Models 문서O
GPT-5.3-Codex-Spark2026-09-14 종료Changelog 2026-09-14O
worktree·background serverworktree 기본 활성화(0.156.0), 자동 background server(0.157.0), --no-daemon·/daemon릴리스 노트O
/voice·/tui·/usage0.155.0 실험 → 0.156.0 기본, fullscreen transcript 기본(0.157.0), 사용량 대시보드릴리스 노트 (공식 slash 표에는 아직 없음)릴리스로 확인
personalityTUI 선택 제거, friendly·pragmatic 더 이상 스타일 미적용0.156.0 릴리스(#44935, #45809). 공식 slash 표에는 /personality가 남아 있음불일치 기록
config reference새 voice·daemon 키 미등재learn.chatgpt.com/docs/config-file/config-reference미확인
구 URL 이전developers.openai.com/codex/* 링크를 리다이렉트 대상별로 교체curl -sIL 최종 URL·상태 코드O

2026-09-12 검증

Codex CLI 0.154.0(9월 9일)을 기준으로 갱신했습니다. npm latest=0.154.0, alpha=0.155.0-alpha.3.10을 2026-09-12 KST에 확인했습니다.

  • 세션: 실험적 --worktree·/worktree로 새 세션과 fork의 격리 checkout을 만들고 재개할 수 있습니다. 작업 중 질문에 선택지나 직접 입력으로 답하는 UI도 추가됐습니다.
  • 확장·승인: 설치·업데이트한 plugin의 tools·skills·hooks가 기존 세션에 반영됩니다. MCP OAuth 갱신 실패는 재인증으로 이어지며 거절된 tool 호출을 자동 재실행하지 않습니다. resume/fork의 권한 보존과 새 사용자 지시 이후 오래된 자동 승인 폐기도 보강됐습니다.
  • 호환성: codex mcp-server와 독립 codex-mcp-server는 제거됐습니다. 외부 MCP 연결용 codex mcp는 유지됩니다. 통합은 experimental codex app-server 이전을 검토하되 공식적으로 production workload를 지원하지 않는다는 경계를 확인하세요.
  • 입력·출력: /copy는 서식과 status 출력을 지원하고 Vim R replace mode가 추가됐습니다. Windows는 공유 background server와 daemon 관리가 보강됐습니다.

근거: 공식 Changelog, npm dist-tags.

이번 검증은 공식 릴리스 원문과 npm 배포 채널의 대조입니다. 설치된 CLI 실행이나 신규 기능의 실서비스 검증을 뜻하지 않습니다. 아래 표는 이전 날짜의 검증 기록이며 현재 배포 채널은 위 값을 우선합니다.

이 문서는 Codex 고급 활용 핸드북의 내부 정합성과 외부 링크 유효성을 검증한 결과입니다.

검증 기준일

2026년 9월 5일(KST) 기준으로 검증을 수행했습니다.

2026-09-05 최신 기준

npm latest=0.153.4, alpha=0.154.0-alpha.3와 로컬 CLI 0.153.4를 확인했습니다. GPT-6 Astra 사양은 공식 API models 페이지와 소개 문서로, Codex 도입 순서(0.153.0~0.153.4)는 GitHub 릴리스 노트와 공식 changelog로 교차검증했습니다.

2026-09-05 교차검증 항목

공식 문서 URL 이전 (2026-09-05 확인)

Codex 공식 문서가 developers.openai.com/codex/*에서 learn.chatgpt.com/docs/*로 이전됐습니다. 기존 링크는 308 영구 리다이렉트로 정상 도달하므로 끊긴 링크는 아니지만, 경로 구조가 균일하게 바뀌지 않았습니다(/codex/models → /docs/models, /codex/cli → /docs/codex/cli, /codex/config-reference → /docs/config-file/config-reference). 일괄 치환은 잘못된 URL을 만들 수 있어 이번 회차에서는 새로 쓴 문단의 출처만 새 도메인으로 적었습니다. 두 Codex 핸드북에 남은 구 URL 479건(고유 49개)은 다음 회차에 경로별로 확인하며 옮깁니다.

항목핸드북공식 근거일치
GPT-6 Astra 출시일2026-09-03GPT-6 Astra 소개 문서O
Astra model IDgpt-6-astraAPI models 페이지O
Astra 컨텍스트/출력1,050,000 / 128,000 토큰API models 페이지O
Astra 단가입력 $10 · 캐시 입력 $1 · 출력 $50 per 1MAPI models 페이지O
Astra 지식 기준일2026-04-30API models 페이지O
Astra reasoning effortlow·medium·high·xhigh·maxAPI models 페이지O
Astra 최소 CLI 버전0.153.0 이상릴리스 노트 0.153.xO
Astra 기본값 전환0.153.4에서 모델 미지정 시 bundled 기본값릴리스 노트 0.153.4O
Astra Bedrock picker0.153.3에서 Mantle·Runtime 추가공식 changelogO
Astra 보안 등급Preparedness Framework 사이버보안 Critical 첫 모델GPT-6 Astra 소개 문서O
planning tool 기본값0.152.0부터 비활성화, tools.update_plan.enabled로 활성화릴리스 노트 0.152.0O
tui.auto_recap0.153.0 추가릴리스 노트 0.153.0O
features.context_management.experimental_mode0.153.0 기본 비활성화 실험 기능릴리스 노트 0.153.0O
MCP output_token_limit·이름 규칙0.152.0 추가릴리스 노트 0.152.0O
Guardian 이력 보존0.153.0에서 compaction·재시작·fork를 넘어 보존릴리스 노트 0.153.0O
GPT-5.4/mini 종료2026-08-31 종료(완료)공식 models 페이지O

검증 방법론

검증 범위

  • 내부 정합성: 챕터 간 용어·모델명·커맨드 통일, meta.json 구조 정합
  • 공식 문서 교차검증: 공식 Changelog, Models 페이지, Slash Commands 페이지, CLI Reference/Features 페이지, Subagents 문서, Skills 문서, App/Chrome 문서, GitHub Releases(0.99.00.153.4)와 본문 사실 관계 대조. 2026-08-20에는 /export와 0.147.00.148.0 변경, 모델 종료 일정을 추가 대조
  • 링크 유효성: 핵심 공식 링크를 curl -L 기반 HTTP 상태 코드로 검증

검증 결과 요약

항목결과
구조/용어 일관성이상 없음
공식 문서 교차검증이상 없음 (아래 세부 내역 참조)
코드 블록/경로이상 없음
공식 링크 유효성핵심 링크 정상(40개 중 38개 HTTP 200, MCP endpoint 2개는 405)

공식 문서 교차검증 세부 내역

모델 정보

항목핸드북공식 문서일치
최상위 모델GPT-6 Astra (gpt-6-astra)Models 페이지 recommended 목록 + API modelsO
GPT-5.6 계열 최상위GPT-5.6 SolModels 페이지 most capable GPT-5.6 modelO
일상 개발 모델GPT-5.6 TerraModels 페이지 balanced everyday modelO
명확한 반복 작업GPT-5.6 LunaModels 페이지 fast and affordable modelO
reasoning/Powerlow~max, Ultra 자동 위임, Max 단일 작업 심화Models 페이지O
2026-08-31 종료(완료)ChatGPT 로그인 GPT-5.4·GPT-5.4 miniModels 페이지 retirement noticeO
이전 세대GPT-5.5Models 페이지 previous-generation modelsO
빠른 Pro research previewGPT-5.3-Codex-SparkModels 페이지 research preview 설명O
deprecated ChatGPT sign-in 모델GPT-5.2, GPT-5.3-Codex 제거Models 페이지 Deprecated Codex modelsO
Codex Cloud 모델 설정사용자가 기본 모델 변경 불가Models 페이지 "Currently, you can't change the default model for Codex cloud tasks"O
잘못된 5.5 family 제거반영gpt-5.5-codex, gpt-5.5-mini, gpt-5.5-nano 미등재O

CLI 버전/기능

항목핸드북공식 문서일치
최신 CLI 버전0.153.4Codex changelog + npm latest dist-tagO
최신 사용자 영향 기능 기준0.153.4Codex CLI 0.151.0~0.153.4 release notesO
agents/queue/task messaging반영Codex CLI 0.149.0~0.150.0 changelogO
/cd·/pwd·/cwd·/copy반영Codex CLI 0.149.0~0.150.0 changelogO
Interrupt hooks/security반영Codex CLI 0.150.0 changelogO
/export반영Codex CLI 0.148.0 changelogO
exec fork/archive restore반영Codex CLI 0.148.0 changelogO
portable plugins/MCP protocol반영Codex CLI 0.147.0 changelogO
built-in Bedrock/hooks반영Codex CLI 0.148.0 changelog + config referenceO
thread history/lifecycle반영paginated history, naming, pin, side switching, paginated forkO
확장 /import반영Cursor·Claude Code settings/MCP/plugins/sessions/commands/memoriesO
Agent Plugins/marketplaces반영manifest, workspace publish, Bedrock·Claude Code sourcesO
proxy·MCP/App refresh반영auth/plugin/MCP/remote/WebSocket/redirect 및 live refreshO
직접 설치 스크립트macOS/LinuxGitHub release asset (Changelog)O
@plugin 멘션지원0.112.0 releaseO
Fast 기본화기본 on0.111.0 releaseO
/plugins + /title반영0.117.0 release / changelogO
codex exec prompt+stdin반영0.118.0 releaseO
codex exec-server실험 기능으로 반영0.119.0 releaseO
/resume ID/name 점프반영0.119.0 releaseO
Ctrl+O 최신 응답 복사반영0.119.0 releaseO
/status stale quota 갱신반영0.119.0 releaseO
custom status line의 thread title반영0.120.0 releaseO
SessionStart /clear source반영0.120.0 releaseO
Ctrl+R reverse search반영Changelog 2026-04-15O
memory mode/reset/deletion반영Changelog 2026-04-15O
queued slash command + ! 입력반영Changelog 2026-04-20O
deny-read glob policy반영config reference + Changelog 2026-04-20O
--ignore-user-config / --ignore-rules반영Changelog 2026-04-20O
tool discovery 기본화반영Changelog 2026-04-20O
GPT-5.5 모델 정리반영Models 문서 2026-05-21 검증O
/mcp verbose반영Changelog 2026-04-22O
built-in browser use반영Changelog 2026-04-22O
Alt+, reasoning quick cycle반영Changelog 2026-04-23O
automatic approval review반영Changelog 2026-04-23O
hooks stable반영Changelog 2026-04-23O
remote plugin marketplace list/read반영Changelog 2026-04-23O
permission state round-trip반영Changelog 2026-04-24O
remote plugin install/marketplace upgrade반영Changelog 2026-04-24O
codex exec --json reasoning token usage반영Changelog 2026-04-24O
request_permissions런타임 권한 요청0.113.0 releaseO
named permission profiles분리형 정책 언어config reference [permissions.<name>]O
hooks 엔진SessionStart/Stop0.114.0 release (experimental)O
code mode격리 코딩 워크플로우0.114.0 release (experimental)O
plugin marketplace검색/설치/삭제0.113.0 releaseO
healthz/readyz앱 서버 헬스체크0.114.0 releaseO
steering/resume반영0.99.0~0.107.0 releasesO
Realtime V2 background progress반영0.120.0 releaseO
persisted /goal workflow반영Changelog 2026-04-30 + slash commandsO
configurable /keymap반영Changelog 2026-04-30~05-07 + slash commandsO
/side 공식 명령 등재반영slash commands 문서 2026-05-10 검증O
/stop 공식 명령 등재반영slash commands 문서 2026-05-10 검증O
/approve, /ide, /memories, /raw, /skills, /theme, /vim 공식 명령 등재반영slash commands 문서 2026-05-21 검증O
codex remote-control반영Changelog 2026-05-08O
codex doctor반영Changelog 2026-05-18O
codex exec resume --output-schema반영Changelog 2026-05-20O
plugin sharing/bundled hooks반영Changelog 2026-05-07~05-08 + Plugins 문서O
/goal 기본 활성화 + permission profile inheritance반영GitHub release rust-v0.133.0O
local conversation search + --profile 파일 기반 migration반영GitHub release rust-v0.134.0O
/permissions named permission profiles 표시반영GitHub release rust-v0.135.0 + Permissions 문서O
/archive / codex archive / codex unarchive반영GitHub release rust-v0.136.0O
codex app-server --stdio + thread archive events반영App Server 문서 + GitHub release rust-v0.136.0O
cloud-managed config bundle + monthly credit limits반영Managed configuration 문서 + GitHub release rust-v0.137.0O
remote-control pairing/grants RPC반영GitHub release rust-v0.137.0O
codex plugin list --json반영GitHub release rust-v0.137.0O
Multi-agent v2 runtime metadata반영GitHub release rust-v0.137.0O
/app Desktop handoff반영Changelog Codex CLI 0.138.0O
plugin add/remove/marketplace --json + marketplaceSource반영CLI reference codex plugin, codex plugin marketplaceO
code mode standalone web search반영Changelog Codex CLI 0.139.0O
MCP input schema oneOf/allOf 보존반영Changelog Codex CLI 0.139.0O
codex doctor editor/pager diagnostics반영Changelog Codex CLI 0.139.0O
app-server account token usage + ChatGPT v2 access token반영Changelog Codex CLI 0.138.0O
codex debug app-server send-message-v2 복구반영Changelog Codex CLI 0.139.0O
reasoning effort fallback shortcuts반영Changelog Codex CLI 0.138.0O
image file path exposure / referenced path image edits반영Changelog Codex CLI 0.138.0~0.139.0O
resume/fork --last prompt 처리 + cloud-managed requirement 보존반영Changelog Codex CLI 0.139.0O
codex sandbox -P + effective sandbox mode반영CLI reference + Changelog Codex CLI 0.139.0O
/delete / codex delete / app-server thread/delete반영Slash commands + Changelog Codex CLI 0.140.0O
/import Claude Code setup/project files/recent chats반영Slash commands + Changelog Codex CLI 0.140.0O
/usage token activity / rate-limit reset반영Slash commands + Changelog Codex CLI 0.142.0O
rollout token budgets반영Changelog Codex CLI 0.142.0O
indexed web-search mode반영Changelog Codex CLI 0.142.0O
scheduled UTC reminders + current time handling반영Changelog Codex CLI 0.142.0O
multi-agent delegation modes반영Changelog Codex CLI 0.142.0O

멀티에이전트

항목핸드북공식 문서일치
상태기본 활성화로 갱신Subagents 문서 "enabled by default"O
역할default/worker/explorer공식 문서 일치O
spawn_agents_on_csv배치 처리+진행률PR #10935 / ChangelogO
max_threads/max_depth설정 가능multi-agent 문서 일치O
child-thread approval반영0.105.0~0.110.0 releasesO
fork/steer/resume반영0.99.0~0.107.0 releasesO
runtime metadata반영rust-v0.137.0 releaseO

Skills 체계

항목핸드북공식 문서일치
필수 파일SKILL.mdSkills 문서 일치O
Progressive disclosure메타데이터만 우선 로드Skills 문서 일치O
위치 계층CWD→부모→루트→사용자→관리자→내장Skills 문서 일치O
openai.yaml선택적 UI/의존성 메타Skills 문서 일치O
plugin 연계@plugin/plugin catalog 반영0.110.0~0.112.0O

메모리/권한 흐름

항목핸드북공식 근거일치
memory resetcodex debug clear-memories 반영0.107.0 releaseO
stale fact guardrails반영0.110.0 releaseO
unified permissions반영0.102.0 releaseO
structured network approvals반영0.102.0 releaseO
symlinked writable roots 수정반영0.119.0/0.120.0 releaseO

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-16O
App 26.415 chats / task sidebar / artifact viewer반영App features + Changelog 2026-04-16O
App 26.415 SSH remote alpha반영Remote connections + Changelog 2026-04-16O
App 26.423 diff reviewer comments반영Changelog 2026-04-23O
App 26.423 browser cookies + browser use반영Changelog 2026-04-23 + App featuresO
App 26.423 images/slides/Figma반영Changelog 2026-04-23O
App 26.423 continue-from-notification반영Changelog 2026-04-23O
Codex for Chrome반영Changelog 2026-05-07 + Chrome extension docsO
App 26.608 remote/MCP/Computer Use반영Changelog 2026-06-09~2026-06-11O

14차 검증 (2026-07-10)

Codex CLI 0.143.0~0.144.0, GitHub Releases, 공식 Codex 문서, npm dist-tag 재검증 결과.

번호검증 항목결과근거
1최신 stable/latest 0.144.0확인GitHub release rust-v0.144.0 + npm latest=0.144.0
2remote plugin 기본 활성화/npm source/version확인release rust-v0.143.0
3system proxy와 remote-control pair확인release rust-v0.143.0
4MCP tool search/session/interactive auth확인releases rust-v0.143.0~0.144.0
5app approval writes와 reset-credit 선택확인release rust-v0.144.0
6Bedrock GPT-5.6 Sol/Terra/Luna + max확인release rust-v0.143.0
7compaction/Windows/TUI/connector 안정성확인release rust-v0.144.0

13차 검증 (2026-07-01)

Codex CLI 0.142.5, GitHub Releases, slash command inventory, npm dist-tag 재검증 결과.

검증 항목

#항목검증 결과근거
1최신 stable/latest 버전 0.142.5확인GitHub release rust-v0.142.5 (2026-07-01) + npm latest dist-tag
20.142.5 trace-log bug fix확인Responses WebSocket request payload 전체가 trace log에 기록되지 않도록 수정
3npm alpha 채널 0.143.0-alpha.31확인npm alpha dist-tag
4기능 운영 기준 0.142.0 유지확인/usage, rollout token budgets, indexed web-search mode 등은 0.142.0 근거

12차 검증 (2026-06-25)

v0.140.0~v0.142.0, 공식 Codex changelog, slash command inventory, npm dist-tag 재검증 결과.

검증 항목

#항목검증 결과근거
1최신 stable/latest 버전 0.142.0확인Codex changelog Codex CLI 0.142.0 (2026-06-22) + npm latest dist-tag
2/delete, codex delete <SESSION>, app-server thread/delete확인Slash commands + Codex changelog Codex CLI 0.140.0
3/import Claude Code setup/project files/recent chats확인Slash commands + Codex changelog Codex CLI 0.140.0
4`/usage dailyweeklycumulative` + earned reset
5plugin organization확인Codex changelog Codex CLI 0.140.0
6rollout token budgets확인Codex changelog Codex CLI 0.142.0
7indexed web-search mode확인Codex changelog Codex CLI 0.142.0
8scheduled UTC reminders + current time handling확인Codex changelog Codex CLI 0.142.0
9multi-agent delegation modes확인Codex changelog Codex CLI 0.142.0
10app-server/exec/MCP disconnect 복구확인Codex changelog Codex CLI 0.142.0

11차 검증 (2026-06-12)

v0.138.0~v0.139.0, 최신 Codex changelog, CLI reference, Models, slash command inventory 재검증 결과.

검증 항목

#항목검증 결과근거
1최신 안정 버전 0.139.0확인Codex changelog Codex CLI 0.139.0 (2026-06-09)
2/app Desktop handoff확인Codex changelog Codex CLI 0.138.0
3/archive 공식 slash table 등재확인Slash commands 문서 (2026-06-12 검증)
4plugin add/remove/marketplace --json, list --available --json, marketplaceSource확인CLI reference codex plugin, codex plugin marketplace
5code mode standalone web search확인Codex changelog Codex CLI 0.139.0
6MCP schema oneOf/allOf 보존 + large schema compaction확인Codex changelog Codex CLI 0.139.0
7codex doctor editor/pager environment diagnostics확인Codex changelog Codex CLI 0.139.0
8app-server account token usage + ChatGPT v2 personal access token확인Codex changelog Codex CLI 0.138.0
9codex debug app-server send-message-v2 복구확인Codex changelog Codex CLI 0.139.0
10reasoning effort fallback shortcuts + model-defined effort ordering확인Codex changelog Codex CLI 0.138.0
11local image path exposure + referenced-path image edits확인Codex changelog Codex CLI 0.138.0~0.139.0
12resume/fork --last, MCP startup warning scoping, cloud-managed requirement 보존확인Codex changelog Codex CLI 0.139.0
13codex sandbox -P, effective sandbox modes, network proxy enforcement확인CLI reference + Codex changelog Codex CLI 0.139.0
14App 26.608 remote/MCP/Computer Use 운영 포인트확인Codex changelog 2026-06-09~2026-06-11

10차 검증 (2026-06-08)

v0.133.0~v0.137.0, 최신 Codex manual, GitHub Releases, slash command inventory 재검증 결과.

검증 항목

#항목검증 결과근거
1최신 안정 버전 0.137.0확인GitHub release rust-v0.137.0 (2026-06-04)
2gpt-5.3-codex ChatGPT sign-in deprecated확인Codex Models 문서 (2026-06-08)
3/goal 기본 활성화와 전용 storage/progress tracking확인GitHub release rust-v0.133.0
4--profile 파일 기반 migration확인Codex Advanced Configuration + GitHub release rust-v0.134.0
5MCP per-server environment targeting / readOnlyHint 병렬 실행확인GitHub release rust-v0.134.0
6/permissions named permission profiles 표시확인GitHub release rust-v0.135.0 + Permissions 문서
7/archive, codex archive, codex unarchive확인GitHub release rust-v0.136.0
8codex app-server --stdio와 thread archive/unarchive events확인Codex App Server 문서 + GitHub release rust-v0.136.0
9Cloud-managed config bundle, monthly credit limits, EDU workspace 적용확인Managed configuration 문서 + GitHub release rust-v0.137.0
10Remote-control pairing/grants RPC확인GitHub release rust-v0.137.0
11codex plugin list --json, hosted web/image tools, Multi-agent v2 runtime metadata확인GitHub release rust-v0.137.0

9차 검증 (2026-05-21)

v0.131.0~v0.132.0, 최신 Models/Slash Commands 문서, Python SDK/remote-control 변경 반영에 대한 내부 교차검증 결과.

검증 항목

#항목검증 결과근거
1최신 안정 버전 0.132.0확인Changelog Codex CLI 0.132.0 (2026-05-20)
2Python SDK first-class auth + richer TurnResult확인Changelog Codex CLI 0.132.0
3codex exec resume --output-schema확인Changelog Codex CLI 0.132.0
4codex doctor diagnostics확인Changelog Codex CLI 0.131.0
5unified @ picker(files/directories/plugins/skills)확인Changelog Codex CLI 0.131.0
6plugin marketplace CLI / version-aware sharing / share checkout확인Changelog Codex CLI 0.131.0
7/approve, /ide, /memories, /raw, /skills, /theme, /vim 공식 slash docs 등재확인slash commands 문서 (2026-05-21 검증)
8gpt-5.5 API-key 인증 지원확인Codex Models 문서
9ChatGPT mobile app에서 Mac Codex app remote access확인Changelog Work with Codex from anywhere (2026-05-14)
10goal continuation guardrail + image fidelity preservation확인Changelog Codex CLI 0.132.0

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 표 미등재
4codex remote-control확인Changelog Codex CLI 0.130.0
5plugin sharing/link metadata/discoverability controls확인Changelog Codex CLI 0.129.0~0.130.0 + Plugins 문서
6Chrome 확장 보안 기준확인Codex Chrome extension 문서
7--full-auto deprecated확인Non-interactive mode 문서
8GPT-5.5 모델 목록 재검증확인Codex Models 문서
9Subagents 기본 활성화확인Subagents 문서
10app-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)
2GPT-5.5 기본 추천확인Models 페이지 2026-05-10 재검증
3GPT-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)
5built-in browser use확인Changelog Codex CLI 0.123.0
6Alt+, reasoning quick cycle확인Changelog Codex CLI 0.124.0 (2026-04-23)
7automatic approval review확인Changelog Codex CLI 0.124.0 + App 26.423
8hooks stable확인Changelog Codex CLI 0.124.0
9remote plugin marketplace list/read확인Changelog Codex CLI 0.124.0
10permission state round-trip + remote plugin install/upgrade확인Changelog Codex CLI 0.125.0
11codex exec --json reasoning token usage확인Changelog Codex CLI 0.125.0
12App 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 릴리즈 노트
3Ctrl+O 최신 응답 복사 + /copy 보강확인v0.119.0 릴리즈 노트
4/status stale quota 갱신확인v0.119.0 릴리즈 노트
5richer MCP support + /mcp 경량화확인v0.119.0 릴리즈 노트
6codex exec-server 실험 기능확인v0.119.0 릴리즈 노트
7Realtime V2 background progress + queued follow-up확인v0.120.0 릴리즈 노트
8custom status line의 renamed thread title확인v0.120.0 릴리즈 노트
9SessionStart hook의 /clear source 구분확인v0.120.0 릴리즈 노트
10ChatGPT 로그인 레거시 모델 제거 완료확인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)
2Ctrl+R reverse search + slash command local recall확인Changelog Codex CLI 0.121.0 (2026-04-15)
3memory mode/reset/deletion확인Changelog Codex CLI 0.121.0 + config reference
4queued input의 slash command + ! shell prompt확인Changelog Codex CLI 0.122.0 (2026-04-20)
5deny-read glob policy + glob_scan_max_depth확인config reference permissions.<name>.filesystem
6--ignore-user-config, --ignore-rules확인Changelog Codex CLI 0.122.0
7tool discovery / image generation 기본화확인Changelog Codex CLI 0.122.0
8App 26.415 in-app browser / task sidebar / artifact viewer확인Changelog 26.415 + App features
9thread automations확인Changelog 26.415 + App automations
10SSH 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가 반환되었습니다. 링크 자체가 깨진 것이 아니라, 브라우저형 접근을 허용하지 않는 엔드포인트로 해석했습니다.

항목링크HTTP최종 URL
Codex 문서 홈https://learn.chatgpt.com/docs200https://learn.chatgpt.com/docs
Codex Apphttps://learn.chatgpt.com/docs/app200https://learn.chatgpt.com/docs/app
Codex CLIhttps://learn.chatgpt.com/docs/codex/cli200https://learn.chatgpt.com/docs/codex/cli
CLI 기능https://learn.chatgpt.com/docs/codex/cli200https://learn.chatgpt.com/docs/codex/cli
Slash Commandshttps://learn.chatgpt.com/docs/developer-commands?surface=cli200https://learn.chatgpt.com/docs/developer-commands?surface=cli
Codex Cloudhttps://learn.chatgpt.com/docs/cloud200https://learn.chatgpt.com/docs/cloud
Customizationhttps://learn.chatgpt.com/docs/customization/overview200https://learn.chatgpt.com/docs/customization/overview
Changeloghttps://learn.chatgpt.com/docs/changelog200https://learn.chatgpt.com/docs/changelog
config 기본https://learn.chatgpt.com/docs/config-file/config-basic200https://learn.chatgpt.com/docs/config-file/config-basic
config 고급https://learn.chatgpt.com/docs/config-file/config-advanced200https://learn.chatgpt.com/docs/config-file/config-advanced
config 레퍼런스https://learn.chatgpt.com/docs/config-file/config-reference200https://learn.chatgpt.com/docs/config-file/config-reference
config 예시https://learn.chatgpt.com/docs/config-file/config-sample200https://learn.chatgpt.com/docs/config-file/config-sample
Feature Maturityhttps://learn.chatgpt.com/docs/feature-maturity200https://learn.chatgpt.com/docs/feature-maturity
GitHub Actionhttps://learn.chatgpt.com/docs/github-action200https://learn.chatgpt.com/docs/github-action
AGENTS.md 가이드https://learn.chatgpt.com/docs/agent-configuration/agents-md200https://learn.chatgpt.com/docs/agent-configuration/agents-md
Agents SDKhttps://learn.chatgpt.com/docs/mcp-server200https://learn.chatgpt.com/docs/mcp-server
Non-interactivehttps://learn.chatgpt.com/docs/non-interactive-mode200https://learn.chatgpt.com/docs/non-interactive-mode
보안https://learn.chatgpt.com/docs/security200https://learn.chatgpt.com/docs/security
MCPhttps://learn.chatgpt.com/docs/extend/mcp?surface=cli200https://learn.chatgpt.com/docs/extend/mcp?surface=cli
OpenAI MCP 서버https://developers.openai.com/mcp405https://developers.openai.com/mcp
Modelshttps://learn.chatgpt.com/docs/models200https://learn.chatgpt.com/docs/models
Multi-agenthttps://learn.chatgpt.com/docs/agent-configuration/subagents200https://learn.chatgpt.com/docs/agent-configuration/subagents
Promptinghttps://learn.chatgpt.com/docs/prompting200https://learn.chatgpt.com/docs/prompting
Pricinghttps://learn.chatgpt.com/docs/pricing200https://learn.chatgpt.com/docs/pricing
Ruleshttps://learn.chatgpt.com/docs/agent-configuration/rules200https://learn.chatgpt.com/docs/agent-configuration/rules
Codex SDKhttps://learn.chatgpt.com/docs/codex-sdk200https://learn.chatgpt.com/docs/codex-sdk
Skillshttps://learn.chatgpt.com/docs/build-skills200https://learn.chatgpt.com/docs/build-skills
Team Confighttps://learn.chatgpt.com/docs/enterprise/admin-setup#team-config200https://learn.chatgpt.com/docs/enterprise/admin-setup#team-config
Open Sourcehttps://learn.chatgpt.com/docs/open-source200https://learn.chatgpt.com/docs/open-source
Windowshttps://learn.chatgpt.com/docs/windows/windows-sandbox200https://learn.chatgpt.com/docs/windows/windows-sandbox
IDE 개요https://learn.chatgpt.com/docs/codex/ide200https://learn.chatgpt.com/docs/codex/ide
IDE 설정https://learn.chatgpt.com/docs/developer-settings?surface=ide200https://learn.chatgpt.com/docs/developer-settings?surface=ide
IDE 기능https://learn.chatgpt.com/docs/codex/ide200https://learn.chatgpt.com/docs/codex/ide
GitHub 통합https://learn.chatgpt.com/docs/third-party/github200https://learn.chatgpt.com/docs/third-party/github
Slack 통합https://learn.chatgpt.com/docs/third-party/slack200https://learn.chatgpt.com/docs/third-party/slack
Linear 통합https://learn.chatgpt.com/docs/third-party/linear200https://learn.chatgpt.com/docs/third-party/linear
GitHub Releaseshttps://github.com/openai/codex/releases200https://github.com/openai/codex/releases
Figma MCPhttps://mcp.figma.com/mcp405https://mcp.figma.com/mcp

업데이트 내역

공식 변경사항 반영 기록은 별도 문서에서 관리합니다.

  • 업데이트 내역: /books/codex-advanced/updates

검증 한계

범위 안내

본 리포트는 링크 유효성, 공식 문서와의 사실 관계 교차검증, 문서 내부 정합성을 검증했습니다. 공식 문서의 모든 세부 사항을 100% 검증한 것은 아니며, 공식 문서가 업데이트되면 핸드북과 차이가 발생할 수 있습니다.

관련 문서

업데이트 내역

Codex 고급 활용 핸드북 변경 로그

이전 검증 기록

Codex 명령어 마스터 · Codex CLI: 이전 검증의 기준 버전·날짜·발견 사항을 당시 기록 그대로 보존하고 현재 검증 범위로 연결합니다.

Ch13. 거버넌스/롤아웃

read-only→workspace-write→CI→Cloud/MCP 단계적 롤아웃, requirements.toml 강제·SQLite 감사 로그·cloud-managed config·GPT-6 모델 거버넌스로 팀 도입을 통제하는 운영 원칙

검증 리포트

Claude Code 고급 활용 · Claude Code 고급 활용 핸드북의 용어·링크·예제 정합성 검증 결과

릴리스 반영 이력

Codex 명령어 마스터 · Codex CLI: 날짜별 릴리스 반영 내역과 핸드북 업데이트 결정을 현재 사용법과 구분해 보존합니다.

On this page

2026-10-23 재검증 · Codex CLI 0.163.02026-10-10 검증2026-10-07 검증2026-09-26 검증2026-09-12 검증2026-09-05 교차검증 항목검증 방법론검증 범위검증 결과 요약공식 문서 교차검증 세부 내역모델 정보CLI 버전/기능멀티에이전트Skills 체계메모리/권한 흐름Codex App14차 검증 (2026-07-10)13차 검증 (2026-07-01)검증 항목12차 검증 (2026-06-25)검증 항목11차 검증 (2026-06-12)검증 항목10차 검증 (2026-06-08)검증 항목9차 검증 (2026-05-21)검증 항목8차 검증 (2026-05-10)검증 항목7차 검증 (2026-04-26)검증 항목5차 검증 (2026-04-15)검증 항목6차 검증 (2026-04-22)검증 항목링크 유효성 확인 목록업데이트 내역검증 한계