업데이트 내역

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.

반영 위치: index, setup, verification, 관련 명령·운영 챕터의 한·영판. 아래 기록은 이전 검증 시점의 이력입니다.

이 문서는 핸드북 내용 업데이트와 **근거(공식 문서/Changelog)**를 추적합니다. "최근 기능 변화 → 핸드북 반영"의 연결성을 보장하기 위한 운영용 로그입니다.

최종 업데이트

2026년 9월 12일(KST) 기준

운영 원칙

근거 기반: Codex Changelog/공식 문서 변경을 확인한 뒤 반영
영향 범위 명시: 어떤 챕터에 어떤 변경을 반영했는지 기록
기능/운영 분리: 제품 기능 변화(외부)와 핸드북 구조 변경(내부)을 구분

최근 업데이트

2026-09-05 (CLI 0.151.0~0.153.4 + GPT-6 Astra)

CLI 기준: npm latest=0.153.4, alpha=0.154.0-alpha.3, 로컬 CLI 0.153.4로 교차 확인
GPT-6 Astra(2026-09-03 출시): gpt-6-astra를 최상위 모델로 반영. CLI 0.153.0 이상 필요, 0.153.4부터 모델 미지정 세션의 bundled 기본값. 1,050,000 토큰 컨텍스트, 128K 출력, API 입력 $10·캐시 입력 $1·출력 $50/1M, 지식 기준일 2026-04-30, reasoning low~max
Astra 도입 순서: 0.153.0 지원 추가 → 0.153.1 기본값·picker 변경 없이 API 설정 경로 추가 → 0.153.3 Bedrock Mantle·Runtime picker 등재 → 0.153.4 bundled picker 노출 수정과 기본값 전환
Astra 보안 경계: Preparedness Framework 사이버보안 Critical 등급 첫 모델. 승인·샌드박스·자동 승인 범위를 먼저 좁히도록 모델 챕터와 index에 경고 추가
설정 기본값 변경: 0.152.0부터 planning tool 기본 비활성화(tools.update_plan.enabled). tui.auto_recap, tui.disable_paste_burst, features.context_management.experimental_mode, MCP output_token_limit, MCP 이름 규칙 완화, optional MCP grace, app-server thread/shellCommand 타임아웃을 config 챕터에 추가
Guardian·권한: Guardian 리뷰 이력이 compaction·재시작·fork를 넘어 보존되고, Full Access는 확인만 필요한 동작에서 Guardian 리뷰를 건너뜁니다(0.153.0)
모델 종료 반영: GPT-5.4·GPT-5.4 mini의 ChatGPT 로그인 종료(2026-08-31)를 예정에서 완료로 변경
반영한 챕터: index, models, config, updates, verification와 Codex 명령어 마스터 한·영판

2026-08-28 (CLI 0.149.0~0.150.1)

CLI 기준: npm latest=0.150.1, alpha=0.151.0-alpha.6; image-aware remote compaction patch까지 반영
task·세션: codex agents, codex queue, task @ 멘션, 자동 task title·/rename 제안, /cd·/pwd·/cwd 반영
TUI·hooks: /copy whole-response/code-block/blockquote picker, clickable Markdown links, permission-mode shortcut, Vim . repeat, Interrupt hooks 반영
보안·안정성: untrusted project AGENTS.md 차단, managed deny-read 지속, diagnostic credential redaction, MCP bearer/startup, Windows Unicode, Unix shutdown, Bedrock compaction/multi-agent 수정 반영
전환: codex mcp-server deprecation과 codex app-server 이전 기준을 MCP 문서에 추가

2026-08-20 (CLI 0.147.0~0.148.0)

CLI 기준: npm latest=0.148.0, alpha=0.149.0-alpha.4; /export, codex exec fork, resume picker archive/restore, startup prompt drafting, 예상 credit/cost 반영
확장·프로토콜: portable Agent Plugins, --approve-for-me, Cursor skill/conversation import, MCP 2026-07-28 opt-in, built-in Amazon Bedrock Runtime provider, async/MCP hooks 반영
모델: 기본 추천을 GPT-5.6 Sol + medium으로 전환하고 Terra/Luna 역할, Ultra/Max 차이, GPT-5.4·mini의 2026-08-31 ChatGPT 로그인 종료 반영
보안·호환성: codex exec --full-auto 제거, secrets/bearer redaction, OAuth/reconnect, plugin isolation, fail-closed network/sandbox, resume state 수정 반영
반영 챕터: index, models, config, governance, multi-agent, exec, approvals, security, mcp, slash-commands, thread-lifecycle, verification와 Command Master 한·영판

2026-08-03 (공식 slash inventory 재검증)

확인 결과와 반영 내용

정식 배포 기준은 그대로 CLI 0.146.0이며 npm latest=0.146.0, alpha=0.147.0-alpha.4, 로컬 CLI 0.146.0을 재확인
최신 공식 slash reference에서 /copy, /rename, /pets(/pet), Windows 전용 /setup-default-sandbox, /app의 등재를 확인
/agent의 /subagents, /side의 /btw 별칭을 확인하고 운영 표와 Command Master에 동기화
index.mdx, slash-commands.mdx, verification.mdx와 Codex Command Master 한·영판을 2026-08-03 기준으로 갱신

2026-08-01 (CLI 0.145.0~0.146.0)

반영한 공식 변경(요약)

CLI 0.145.0 — paginated thread history와 이름·검색·subagent·memory 지원, Cursor/Claude Code 전반으로 확장된 /import, Amazon Bedrock login/custom endpoint, audio input/tool output, 안정화된 Multi-agent V2, secure inline visualization link
CLI 0.146.0 — named /new·/clear, thread pinning·side switching, paginated/ephemeral fork, Agent Plugin manifest/workspace publish와 추가 marketplace, remote Code Mode host, custom-provider standalone web search, executor-provided skills, proxy·MCP/App refresh 보강
안정성 — replay/import/fork의 메시지·final·error·timestamp·approval 보존, terminal/Windows 수정, skill catalog truncation warning

핸드북 반영 위치

setup, thread-lifecycle, multi-agent, slash-commands, config, mcp, verification

2026-07-10 (CLI 0.143.0~0.144.0)

반영한 공식 변경(요약)

CLI 0.144.0 — usage-limit reset credit의 유형·만료·선택, app approval writes 모드, MCP interactive auth 기본화, runtime-provided app-server auth/hosted redirect, global pnpm install 감지, Ultra+고 multi-agent concurrency 사용량 경고
CLI 0.143.0 — remote plugin 기본 활성화, npm marketplace source와 local/remote version 표시, macOS/Windows system proxy(PAC/WPAD), codex remote-control pair, MCP tool search 기본화와 ChatGPT-hosted MCP session auth, Bedrock GPT-5.6 Sol/Terra/Luna 및 max effort, app-server environment/descendant/fork-through-turn API
안정성·보안 — retired model을 참조하는 compaction 재개 시 현재 모델로 재시도, Intel macOS Code Mode, Windows writable-root 삭제/managed runtime, terminal control sequence sanitization, connector auth refresh, proxy/CA-aware Responses WebSocket, review branch picker/auto-review 개선
npm 교차 확인 — @openai/codex latest=0.144.0, alpha=0.145.0-alpha.1

영향 챕터

index.mdx·setup.mdx — 최신 설치 기준을 0.144.0으로 갱신
mcp.mdx·exec.mdx — tool search/auth, system proxy, remote-control pair 반영
security.mdx·governance.mdx — app approval writes, terminal/sandbox/auth 보강 반영
models.mdx — Bedrock GPT-5.6 variant와 max effort 구분
verification.mdx — 0.143.0~0.144.0 및 npm dist-tag 교차검증 추가

2026-07-01 (CLI 0.142.5 patch + npm dist-tag 재검증)

반영한 공식 변경(요약)

CLI 0.142.5 — GitHub latest release와 npm latest가 0.142.5로 상향. Responses WebSocket request payload 전체가 trace log에 기록되지 않도록 막는 bug fix
dist-tag 교차 확인 — @openai/codex npm latest는 0.142.5, alpha는 0.143.0-alpha.31로 확인. 팀 문서 기준은 stable/latest를 우선하고, alpha는 실험 채널로만 기록
기능 기준 분리 — /usage, rollout token budgets, indexed web-search mode, scheduled UTC reminders/current-time handling, multi-agent delegation modes의 운영 기준은 사용자 영향 기능 변경이 있는 0.142.0 항목을 유지하고, 0.142.5는 로그/추적 데이터 보호 기준에 반영

영향 챕터

index.mdx — 최신 stable/latest 표기를 0.142.5로 갱신하고 0.142.5 trace-log bug fix 메모 추가
setup.mdx — 현재 설치/검증 기준을 0.142.5로 상향하고 0.142.x 팀 표준 설명 추가
security.mdx — trace log에 request payload 전체가 남지 않도록 하는 0.142.5 보안/프라이버시 패치를 로그 운영 기준에 추가
verification.mdx — 최신 CLI/stable/latest와 npm dist-tag를 2026-07-01 기준으로 갱신
Command Master 책 — index, updates, verification, 책장 요약을 같은 기준으로 동기화

근거 링크(공식/공개)

2026-06-25 (CLI 0.140.0~0.142.0 + `/delete`/`/import`/`/usage` + rollout budget 재검증)

반영한 공식 변경(요약)

CLI 0.142.0 — /usage token activity/rate-limit reset, rollout token budgets, indexed web-search mode, scheduled UTC reminders/current-time handling, multi-agent delegation modes, app-server/exec/MCP disconnect 복구
CLI 0.141.0 — TUI/app-server 안정성 보강, Linux suspend/resume 후 foreground 복귀, 장시간 연결 복구 확인
CLI 0.140.0 — /delete, codex delete <SESSION>, app-server thread/delete, /import Claude Code setup/project files/recent chats import, plugin organization 개선
dist-tag 교차 확인 — @openai/codex npm latest는 0.142.0, alpha는 0.143.0-alpha.14로 확인. 팀 문서 기준은 stable/latest를 우선

영향 챕터

index.mdx — 최신 기준 버전을 0.142.0으로 갱신하고 0.140.0~0.142.0 하이라이트 추가
Ch5. 슬래시 커맨드 운영 — /delete, /import, /usage 운영 기준을 command-master와 연결
스레드 라이프사이클 — deletion/archive 보존 정책 분리, scheduled reminder 시간대 기준 추가
Ch7. exec/자동화 — indexed web search, disconnect recovery, current-time handling 반영
Ch9. 멀티에이전트 — delegation modes와 parent/child handoff 기준 추가
Ch13. 거버넌스/롤아웃 — rollout token budget과 /usage 점검 루틴 추가
verification.mdx — 기준일, 최신 버전, 12차 검증 항목 추가

근거 링크(공식)

2026-06-12 (CLI 0.138.0~0.139.0 + `/app` + plugin/app-server 재검증)

반영한 공식 변경(요약)

CLI 0.139.0 — code mode standalone web search, MCP tool input schema의 oneOf/allOf 보존과 큰 schema compaction 개선, codex doctor editor/pager environment 리포트, plugin marketplace source/cached catalog 보강, resume/fork --last prompt 처리, MCP startup warning scoping, image edit referenced path 처리, cloud-managed requirement 보존, sandbox approval/proxy enforcement, OpenAI Codex cloud environment용 exec agent provider, plugin marketplace install/upgrade 흐름, codex debug app-server send-message-v2 복구
CLI 0.138.0 — /app Desktop handoff, 로컬 이미지 첨부/생성 파일 path 노출, reasoning effort fallback shortcuts와 model-defined effort ordering, app-server account token usage, ChatGPT v2 personal access token, plugin add/remove/marketplace --json, codex plugin list --available --json, marketplace source JSON
Slash commands 재검증 — /archive는 공식 slash commands 표에 등재된 상태로 보정, /app은 0.138.0 changelog 기반 release-tracked command로 command-master에 추가
Models 문서 재검증 — gpt-5.5 기본 추천, gpt-5.2/gpt-5.3-codex deprecated, Cloud task 기본 모델 변경 불가 제약 유지
Codex App 26.608 계열 — remote connection, Composer thinking mode selector, active MCP server 표시, mobile UX, Computer Use rendering/responsiveness 보강

영향 챕터

index.mdx — 최신 기준 버전을 0.139.0으로 갱신하고 0.138.0~0.139.0 하이라이트 추가
Ch1. 설치/로그인 — 최신 안정 버전, /app vs codex app, App 26.608 운영 기준 추가
Ch2. config.toml 설계 — plugin JSON 감사, sandbox -P, effective sandbox mode, network proxy enforcement 반영
Ch7. exec/자동화 — code mode web search, app-server token usage, ChatGPT v2 token, send-message-v2, cloud exec provider, 이미지 path 자동화 추가
Ch10. Codex App/IDE — CLI thread handoff와 App 26.608 remote/MCP/Computer Use 운영 기준 추가
Ch11. MCP 연동 — schema preservation, MCP startup warning scoping, plugin marketplace JSON/source/upgrade 감사 포인트 추가
Ch12. 모델/추론 전략 — reasoning effort fallback shortcuts와 image path 인식 보강 반영
Ch13. 거버넌스/롤아웃 — plugin inventory JSON, app-server debug smoke test, Desktop handoff 체크리스트 추가
verification.mdx — 기준일, 최신 버전, 11차 검증 항목 추가

근거 링크(공식)

2026-06-08 (CLI 0.133.0~0.137.0 + `/archive` + app-server/managed config 재검증)

반영한 공식 변경(요약)

CLI 0.137.0 — F13-F24 keybindings, searchable menu paste, reasoning-only status/title item, monthly credit limits, cloud-managed config bundles(EDU 포함), remote-control pairing/grant RPC, codex plugin list --json, hosted web/image tools, Multi-agent v2 runtime metadata
CLI 0.136.0 — /archive, codex archive, codex unarchive, clickable OSC 8 links, codex app-server --stdio, richer MCP server status, remote execution CODEX_API_KEY registration, remote-control short-lived server tokens, Windows sandbox setup alpha
CLI 0.135.0 — richer codex doctor, remote /status connection/server version, Vim mode 보강, /permissions named permission profiles 표시, Python SDK Sandbox presets, non-interactive installer mode
CLI 0.134.0 — local conversation history search, --profile 파일 기반 migration, MCP per-server environment targeting/OAuth options, readOnlyHint 기반 read-only MCP tool 병렬 실행, extension/hook context 확장
CLI 0.133.0 — /goal 기본 활성화, permission profile list/inheritance/managed requirements/runtime refresh, plugin discovery marketplace-aware list/installed versions/remote collection, extension lifecycle events 확장
Models 문서 재검증 — gpt-5.5 추천 기본값 유지, gpt-5.3-codex는 ChatGPT 로그인 기준 deprecated로 정리, Codex cloud tasks는 사용자가 기본 모델을 직접 변경할 수 없다는 제약 반영

영향 챕터

index.mdx — 최신 기준 버전을 0.137.0으로 갱신하고 0.133.0~0.137.0 하이라이트 추가
Ch1. 설치/로그인 — latest stable, app archive/remote-control grant 운영 기준 보강
Ch2. config.toml 설계 — --profile migration, cloud-managed requirements, 최신 permission profile syntax 보정
Ch5. 슬래시 커맨드 운영 — /archive release-tracked command와 0.133.0~0.137.0 운영 포인트 추가
Ch7. exec/자동화 — CODEX_API_KEY 스코프, codex app-server --stdio, remote-control grant/runbook 보강
스레드 라이프사이클 — archive/unarchive 운영 모델과 app-server event 노출 기준 추가
Ch9. 멀티에이전트 — Multi-agent v2 runtime metadata와 spawned child listener 안정화 반영
Ch11. MCP 연동 — per-server environment targeting, readOnlyHint, richer MCP status, plugin JSON inventory 반영
Ch13. 거버넌스/롤아웃 — cloud-managed config bundle, monthly credit limit, remote-control grant, plugin inventory JSON 정책 반영
Ch12. 모델/추론 전략 — deprecated gpt-5.3-codex 정리와 Cloud task 모델 정책 분리 추가
verification.mdx — 기준일, 최신 버전, 10차 검증 항목 갱신

근거 링크(공식)

2026-05-21 (CLI 0.131.0~0.132.0 + 최신 slash inventory + 모델 문서 재검증)

반영한 공식 변경(요약)

CLI 0.132.0 — Python SDK first-class auth, plain string input, richer TurnResult, codex exec resume --output-schema, original-resolution image fidelity, goal continuation guardrail
CLI 0.131.0 — data-driven service-tier commands, blended token usage, effective workspace roots, unified @ picker(files/directories/plugins/skills), plugin marketplace CLI commands, version-aware sharing, share checkout, remote-control daemon/runtime APIs, codex doctor
Work with Codex from anywhere — ChatGPT mobile app에서 Mac의 Codex app에 연결해 같은 projects/files/credentials/plugins/skills/configuration 사용, Hooks GA, Codex access tokens, Enterprise admin setup 문서 보강
Slash commands 재검증 — /approve, /ide, /memories, /raw, /skills, /theme, /vim 공식 표 등재 확인
모델 문서 재검증 — gpt-5.5가 ChatGPT 로그인과 API-key 인증 모두에서 Codex CLI/SDK·App/IDE에 지원되는 것으로 갱신

영향 챕터

index.mdx — 최신 기준 버전을 0.132.0 / GPT-5.5 / Python SDK / 최신 slash inventory로 갱신
Ch1. 설치/로그인 — 최신 안정 버전과 모바일 remote access 운영 기준 추가
Ch2. config.toml 설계 — gpt-5.5 API-key 인증 지원 기준으로 모델 기본값 설명 보정
Ch5. 슬래시 커맨드 운영 — 신규 공식 명령 /approve, /ide, /memories, /raw, /skills, /theme, /vim 반영
Ch7. exec/자동화 — codex exec resume --output-schema, Python SDK auth/turn API, remote-control daemon 운영 포인트 추가
Ch9. 멀티에이전트 — service-tier/subagent 운영 보강 반영
Ch11. MCP 연동 — plugin marketplace CLI, version-aware sharing, unified @ picker, MCP OAuth callback ids 반영
Ch12. 모델/추론 전략 — API-key 인증 기준 보정
Ch13. 거버넌스/롤아웃 — GPT-5.5 기본 정책 보정
verification.mdx — 기준일, 최신 버전, 모델/API-key, slash inventory 검증 항목 갱신

근거 링크(공식)

2026-05-10 (CLI 0.128.0~0.130.0 + Codex for Chrome + 모델 문서 재검증)

반영한 공식 변경(요약)

CLI 0.130.0 — plugin details의 bundled hooks 표시, plugin sharing link metadata/discoverability controls, codex remote-control, large thread pagination views, Bedrock aws login profiles, selected-environment 기반 view_image, live app-server config refresh
Codex for Chrome — 로그인된 Chrome 상태가 필요한 웹사이트 작업을 tab group 기반으로 병렬 수행하되, 새 host 승인·allowlist/blocklist·browser history 접근을 별도 통제
CLI 0.129.0 — modal Vim composer(/vim), /keymap, workspace-aware /diff, /hooks browser, plugin workspace sharing/share access controls/source filtering/remote bundle sync
CLI 0.128.0 — persisted /goal workflows, codex update, configurable TUI keymaps, plan-mode nudges, action-required terminal titles, active-turn /statusline·/title, permission profile 확장, external agent session import, MultiAgentV2 설정 명시화
모델 문서 재검증 — 공식 Codex Models 기준 추천 목록을 gpt-5.5, gpt-5.4, gpt-5.4-mini, gpt-5.3-codex, gpt-5.3-codex-spark로 정리하고, 잘못 들어간 gpt-5.5-codex/gpt-5.5-mini/gpt-5.5-nano 참조를 제거

영향 챕터

index.mdx — 최신 기준 버전을 0.130.0 / GPT-5.5 / Chrome 확장으로 갱신
Ch1. 설치/로그인 — 최신 안정 버전과 Chrome 확장 운영 기준 추가
Ch2. config.toml 설계 — gpt-5.5 기본값, plugin sharing, keymap 운영 보강
Ch5. 슬래시 커맨드 운영 — /goal, /keymap, /side, /stop 최신 공식 목록 반영
Ch7. exec/자동화 — --full-auto deprecated 안내와 codex remote-control 운영 포인트 추가
스레드 라이프사이클 — persisted /goal, large thread pagination view 반영
Ch10. Codex App/IDE — Codex for Chrome 보안/운영 기준 추가
Ch11. MCP 연동 — plugin sharing/source filtering/bundled hooks 운영 기준 추가
Ch12. 모델/추론 전략 — 공식 모델 목록 기준으로 재작성
verification.mdx — 기준일, 최신 버전, 신규 명령과 모델 검증 항목 갱신

근거 링크(공식)

2026-04-26 (CLI 0.123.0~0.125.0 + GPT-5.5 + App 26.423 반영)

반영한 공식 변경(요약)

CLI 0.125.0 — app-server integrations의 Unix socket 지원, thread/resume/fork cursor-based pagination, multiple environment name persistence, remote plugin install + marketplace upgrade, permission profile round-trip 정합성 개선, codex exec --json reasoning token usage 추가
CLI 0.124.0 — Alt+, reasoning quick cycle, approval 전 subagent review 자동 실행, remote plugin marketplace list/read, stable hooks, Amazon Bedrock support, /permissions side-conversation 유지, /statusline·/title normalization
CLI 0.123.0 — GPT-5.5 계열 가용성, /mcp verbose, built-in browser use, current/archived thread를 구분하는 resume hinting, plain # heading-only context lookup
GPT-5.5 모델 문서 갱신 — 이후 2026-05-10 재검증 기준으로 gpt-5.5가 대부분의 작업에 대한 기본 추천이며, gpt-5.4는 fallback, gpt-5.4-mini와 gpt-5.3-codex-spark는 보조/빠른 반복용으로 정리
Codex App 26.423 — diff reviewer comments, browser cookies, browser use, direct images to thread, continue-from-notification, slides generate/edit, Figma integration, browser on popout windows

영향 챕터

index.mdx — 최신 기준 버전을 0.125.0 / GPT-5.5 / App 26.423으로 갱신
Ch1. 설치/로그인 — 최신 안정 버전, App 26.423 운영 포인트 추가
Ch3. 승인/샌드박스 전략 — automatic approval review, permission state round-trip 보강
Ch5. 슬래시 커맨드 운영 — /mcp verbose, Alt+,, /permissions 정합성 메모 추가
Ch7. exec/자동화 — codex exec --json reasoning token usage, hooks stable 반영
스레드 라이프사이클 — resume hinting, cursor pagination, multi-environment persistence 반영
Ch10. Codex App/IDE — App 26.423 브라우저/리뷰 워크플로우 추가
Ch11. MCP 연동 — /mcp verbose, remote marketplace, remote plugin install/upgrade 반영
Ch12. 모델/추론 전략 — GPT-5.5 중심으로 전면 개편
verification.mdx — 기준일, 최신 버전, 0.123.0~0.125.0 및 App 26.423 검증 항목 갱신

근거 링크(공식)

2026-04-22 (CLI 0.121.0~0.122.0 + App 26.415 반영)

반영한 공식 변경(요약)

CLI 0.122.0 — standalone install self-contained 정리, codex app의 Windows/Intel Mac 데스크톱 열기/설치 개선, queued input에서 slash command와 ! shell prompt 지원, Plan Mode fresh-context 구현 시작, deny-read glob 정책/managed deny-read requirements/platform sandbox enforcement, 격리 codex exec용 --ignore-user-config/--ignore-rules, tool discovery + image generation 기본 활성화, large-file patching 보강
CLI 0.121.0 — codex marketplace add(GitHub/git URL/로컬 디렉토리/direct marketplace.json), Ctrl+R reverse search와 slash command local recall, memory mode/reset/deletion과 extension cleanup, MCP Apps tool call/namespaced registration/parallel-call opt-in/sandbox-state metadata
Codex App 26.415 — in-app browser, computer use, 프로젝트 없이 시작하는 chats, thread automations, task sidebar, context-aware suggestions, PR sidebar workflow, artifact viewer, memories, SSH remote connections alpha, multiple terminals, multi-window, Intel Mac support, new plugins

영향 챕터

index.mdx — 최신 기준 버전을 0.122.0 / App 26.415로 갱신하고 하이라이트 추가
Ch1. 설치/로그인 — 최신 안정 버전, reverse search, chats/in-app browser/task sidebar, Intel Mac support 반영
Ch2. config.toml 설계 — deny-read 정책, 격리 exec 플래그, tool discovery 기본화, marketplace source 운영 추가
메모리 운영 — memory mode/reset/deletion과 config 기준 운영 키 보강
Ch4. 보안 가이드 — deny-read, trusted workspace, logout token revoke, Windows sandbox grant 축소 반영
Ch5. 슬래시 커맨드 운영 — queued slash command, Ctrl+R, /side의 changelog-only 상태 반영
Ch7. exec/자동화 — large-file patching, 격리 exec 운영 포인트 추가
스레드 라이프사이클 — running thread에 대한 queued input 개입 모델 보강
Ch10. Codex App/IDE — App 26.415 작업공간 확장 항목 추가
Ch11. MCP 연동 — namespaced MCP registration, marketplace source 확장 반영
verification.mdx — 기준일, 최신 버전, 0.121.0~0.122.0 및 App 26.415 검증 항목 갱신

근거 링크(공식)

2026-04-15 (CLI 0.119.0~0.120.0 + ChatGPT 로그인 모델 정리 완료 반영)

반영한 공식 변경(요약)

CLI 0.120.0 — Realtime V2 background agent progress 스트리밍, active response 중 follow-up response queue, TUI hook activity 구분 표시, custom TUI status line의 renamed thread title, code-mode tool declaration의 MCP outputSchema 반영, SessionStart hook의 /clear source 구분
CLI 0.119.0 — Realtime voice sessions의 v2 WebRTC 기본화, MCP Apps/custom MCP servers의 resource read / tool-call metadata / custom-server tool search / server-driven elicitation / file upload 확장, remote/app-server의 egress websocket transport / remote --cd forwarding / sandbox-aware filesystem APIs / 실험적 codex exec-server, Ctrl+O 최신 응답 복사, /resume의 session ID/name 직접 점프, 더 유연한 TUI notifications, stale quota를 갱신하는 /status, 더 가벼워진 /mcp
모델 가용성 정리 완료 (2026-04-14) — ChatGPT 로그인 경로에서 gpt-5.2-codex, gpt-5.1-codex-mini, gpt-5.1-codex-max, gpt-5.1-codex, gpt-5.1, gpt-5 제거 완료

영향 챕터

index.mdx — 최신 기준 버전을 0.120.0으로 갱신하고 0.119.0~0.120.0 하이라이트 추가
Ch1. 설치/로그인 — 최신 안정 버전과 운영 최소 기준을 0.120.0으로 상향
Ch5. 슬래시 커맨드 운영 — /copy, /resume, /status, /statusline의 최신 동작 반영
Ch7. exec/자동화 — 실험적 codex exec-server, code mode의 MCP outputSchema 반영 추가
스레드 라이프사이클 — /resume 직접 점프와 Realtime V2 background progress 반영
Ch11. MCP 연동 — richer MCP support와 /mcp 경량화, cleanup 안정화 추가
verification.mdx — 기준일, 최신 버전, 0.119.0~0.120.0 검증 항목 갱신

근거 링크(공식)

2026-04-08 (CLI 0.117.0~0.118.0 + 모델 가용성 반영)

반영한 공식 변경(요약)

CLI 0.118.0 — Windows 샌드박스 proxy-only 네트워크를 OS 레벨 egress rules로 강제, app-server 클라이언트의 ChatGPT device-code 로그인 시작 안정화, codex exec prompt+stdin workflow 지원, custom model provider의 short-lived bearer token 동적 갱신, 프로젝트 로컬 .codex 첫 생성 보호, Linux bwrap 탐색 복구, app-server TUI의 /copy·/resume <name>·/agent 회귀 수정, MCP startup 경고 표시 복구
CLI 0.117.0 — product-scoped plugin sync, /plugins 브라우저, /title terminal-title picker, path-based sub-agent address(/root/agent_a), structured inter-agent messaging/agent listing, app-server TUI prompt history recall, view_image image URL 반환 및 이미지 히스토리 재개, app-server TUI 기본화
모델 가용성 업데이트 (2026-04-07) — ChatGPT 로그인 사용자의 model picker에서 gpt-5.2-codex, gpt-5.1*, gpt-5 계열이 단계적으로 제거되고 gpt-5.4, gpt-5.4-mini, gpt-5.3-codex, gpt-5.2 중심으로 정리

영향 챕터

index.mdx — 하이라이트와 기준 버전을 0.118.0 기준으로 갱신
Ch1. 설치/로그인 — 최신 안정 버전, app-server TUI 기본화, device-code 로그인 설명 갱신
Ch3. 승인/샌드박스 전략 — .codex 첫 생성 보호, Windows proxy-only egress, bwrap 탐색 복구 반영
Ch5. 슬래시 커맨드 운영 — /plugins, /title, /approvals alias 상태 반영, /skills·/theme 제거
Ch6. 프롬프트/스킬 설계 — plugins first-class workflow, /plugins 운영 포인트 추가
Ch7. exec/자동화 — codex exec prompt+stdin workflow 추가
Ch9. 멀티에이전트 — path-based agent address, structured inter-agent messaging 추가
Ch10. Codex App/IDE — app-server TUI 기본화, prompt history recall, /title 반영
Ch12. 모델/추론 전략 — ChatGPT 로그인 모델 가용성 정리, gpt-5.4-mini 추가
verification.mdx — 기준일, 최신 버전, 모델 가용성 검증 항목 갱신

근거 링크(공식)

2026-03-25 (CLI 0.116.0 반영)

반영한 공식 변경(요약)

CLI 0.116.0 — ChatGPT device-code 로그인(App-server TUI 온보딩 시 디바이스 코드 인증 + 기존 토큰 갱신), userpromptsubmit 훅(프롬프트 실행 전 차단/보강), 플러그인 설치 프롬프트(누락 플러그인 제안, suggestion allowlist, 원격 동기화), Realtime 세션에 최근 스레드 컨텍스트 포함(오디오 자기중단 감소), WebSocket prewarm 첫 턴 지연 수정(타임아웃 후 폴백), 원격 resume/fork 대화 히스토리 복원, Linux 샌드박스 시작 안정성 개선(심볼릭 링크, AppArmor, 시스템 bwrap 우선), 에이전트 작업 finalization 레이스 수정

영향 챕터

index.mdx — 하이라이트를 0.116.0 기준으로 갱신, updatedAt 갱신
Ch1. 설치/로그인 — ChatGPT device-code 로그인 추가
Ch3. 승인/샌드박스 전략 — Linux 샌드박스 안정성 개선 추가
Ch5. 슬래시 커맨드 운영 — userpromptsubmit 훅 추가
Ch6. 프롬프트/스킬 설계 — 플러그인 설치 프롬프트 추가
스레드 라이프사이클 — Realtime 컨텍스트, 원격 resume/fork 복원 추가

근거 링크(공식)

2026-03-17 (CLI 0.115.0 반영)

반영한 공식 변경(요약)

CLI 0.115.0 — view_image 풀해상도 이미지 검사(모델이 detail: 'original'로 원본 해상도 요청 가능), JS REPL에 codex.cwd/codex.homeDir 노출 및 셀 간 persistent tool references, 실시간 WebSocket 전용 transcription 모드 및 v2 handoff 지원, app-server filesystem RPCs(file/read, file/write, file/copy) + 새 Python SDK, Smart Approvals guardian subagent(다중 인터페이스에서 일관된 승인 라우팅), App integrations Responses API tool-search with fallback, wait_agent 도구 이름 변경(기존 wait에서 변경)

영향 챕터

index.mdx — 하이라이트를 0.115.0 기준으로 갱신, updatedAt 갱신
Ch3. 승인/샌드박스 전략 — Smart Approvals guardian subagent 섹션 추가
Ch7. exec/자동화 — App-server filesystem RPCs, Python SDK, view_image 추가
Ch9. 멀티에이전트 — guardian subagent, wait_agent 이름 변경, monitor 역할 표 갱신
Ch11. MCP 연동 — App integrations Responses API tool-search 추가

근거 링크(공식)

2026-03-13 (GPT-5.4 & App 26.312 반영)

반영한 공식 변경(요약)

GPT-5.4 기본 모델 전환 (2026-03-05) — 코딩+추론+도구 사용+에이전틱 워크플로우 통합 플래그십 모델. 네이티브 컴퓨터 사용, 1.05M 토큰 컨텍스트(922K input/128K output), 47% 토큰 효율 개선, 강화된 도구 탐색(tool search). gpt-5.3-codex 코딩 역량 계승. 새 기본 추천 모델
Codex Windows 앱 출시 (2026-03-04) — 네이티브 에이전트 샌드박스, PowerShell 지원, 크로스 플랫폼 세션 동기화, 모든 ChatGPT 플랜 지원
Codex Security 리서치 프리뷰 (2026-03-06) — GPT-5.4 기반 보안 스캐닝. 1.2M 커밋 스캔, 오탐 50% 감소, 과잉 심각도 90% 감소, 노이즈 84% 감소. Enterprise/Business/Edu 대상
Codex for Open Source (2026-03-07) — 1K+ 스타 OSS 메인테이너에게 6개월 무료 ChatGPT Pro
Promptfoo 인수 (2026-03-09) — AI 보안/평가 스타트업, Fortune 500 25%+ 사용. Frontier 플랫폼 통합 예정
GPT-5.1 모델 퇴역 (2026-03-11) — ChatGPT에서 GPT-5.3/5.4 변형으로 자동 마이그레이션
GPT-5.3-Codex-Spark Cerebras 실행: 1,000+ 토큰/초, 플래그십 대비 15배 빠름. OpenAI 첫 Nvidia 외부 프로덕션 배포
AGENTS.md 60K+ 프로젝트 채택: Linux Foundation 산하 Agentic AI Foundation이 표준 관리
Analytics API/Compliance API: 프로그래매틱 리포팅, 감사 로그(eDiscovery/DLP/SIEM), 셀프서브 대시보드
Codex App 26.312 (2026-03-12) — 테마 커스터마이징(베이스 테마, 색상, 폰트, 공유), 자동화 개편(로컬/워크트리 실행 선택, 커스텀 추론 수준/모델, 템플릿)
Codex App 26.305 (2026-03-05) — 원격 연결 개선, Windows 통합 터미널 복사/붙여넣기 수정, 보관된 고정 스레드 버그 수정

영향 챕터

index.mdx — GPT-5.4, Windows 앱, Codex Security 하이라이트 추가, updatedAt 갱신
Ch1. 설치/로그인 — Windows 앱 출시, 플랫폼 제한 해제, 자동화/테마 추가
Ch2. config.toml 설계 — 모델 예시를 gpt-5.4로 갱신
Ch4. 보안 가이드 — Codex Security 리서치 프리뷰, Promptfoo 인수 추가
Ch6. 프롬프트/스킬 설계 — AGENTS.md 60K+ 채택 통계 추가
Ch9. 멀티에이전트 — GPT-5.4 에이전틱 강화, App 자동화 개편 추가
Ch10. Codex App/IDE — Windows 앱 출시, App 26.312 테마/자동화 상세, App 26.305 수정 사항 추가
Ch12. 모델/추론 전략 — GPT-5.4 상세 수치, Spark Cerebras, GPT-5.1 퇴역, 비교표/운영 가이드 전면 갱신
Ch13. 거버넌스/롤아웃 — GPT-5.4 전환 운영, Codex for OSS, Enterprise API, AGENTS.md 생태계 추가
verification.mdx — GPT-5.4 모델 검증, Windows 앱, App 검증 항목 추가

근거 링크(공식)

2026-03-13

반영한 공식 변경(요약)

CLI 0.114.0 — 실험적 code mode(격리 코딩 워크플로우), hooks 엔진(SessionStart/Stop 이벤트), healthz/readyz 헬스체크 엔드포인트, 번들 시스템 스킬 비활성화 스위치, handoff 시 실시간 transcript 전달, $ 멘션 피커 개선(Skills/Apps/Plugins 라벨), Linux tmux 크래시 수정, 영구 권한/apply_patch 승인 수정
CLI 0.113.0 — request_permissions 런타임 권한 요청 도구(TUI 승인 렌더링), permission-profile 분리형 설정 언어(파일시스템/네트워크 정책 분리), 플러그인 마켓플레이스(검색/메타데이터/인증 검사/삭제), app-server exec 스트리밍(stdin/stdout/stderr, TTY/PTY), 웹 검색 도구 상세 설정, 이미지 생성 CWD 저장, SQLite 감사 로깅, 네트워크 프록시 하드닝(글로벌 와일드카드 거부), trust bootstrap 수정, winget 퍼블리싱

영향 챕터

index.mdx — 하이라이트를 0.114.0 기준으로 갱신
Ch1. 설치/로그인 — 최신 버전 0.114.0, winget 설치, tmux 이슈, healthz/readyz 추가
Ch2. config.toml 설계 — permission-profile 설정 언어, 번들 스킬 비활성화, 웹 검색 도구 설정 추가
Ch3. 승인/샌드박스 전략 — request_permissions 도구, permission-profile 분리 정책, 네트워크 프록시 하드닝, 영구 권한 수정 추가
Ch4. 보안 가이드 — 네트워크 프록시 하드닝, trust bootstrap, SQLite 감사 로깅 추가
Ch5. 슬래시 커맨드 운영 — $ 멘션 피커 개선, hooks 엔진 추가
Ch6. 프롬프트/스킬 설계 — 플러그인 마켓플레이스, 번들 스킬 비활성화 추가
Ch7. exec/자동화 — app-server exec 스트리밍, code mode, hooks 엔진 추가
Ch8. Cloud Tasks — 인증 에러 복구, healthz/readyz 엔드포인트 추가
Ch9. 멀티에이전트 — handoff transcript, hooks 엔진 자동화 추가
스레드 라이프사이클 — 재오픈 스레드 상태 복원, handoff transcript 추가
Ch10. Codex App/IDE — $ 멘션 피커, healthz/readyz, handoff transcript, 앱 세션 수정 추가
Ch11. MCP 연동 — 플러그인 마켓플레이스, 인증 검사, 삭제 엔드포인트 추가
Ch13. 거버넌스/롤아웃 — hooks 엔진, SQLite 로깅, winget 퍼블리싱 추가
verification.mdx — 기준일 갱신, 0.113.0~0.114.0 검증 항목 추가

근거 링크(공식)

2026-03-09

반영한 공식 변경(요약)

CLI 0.112.0 — @plugin 멘션, model picker 카탈로그 갱신, zsh-fork skill 실행의 per-turn sandbox merge
CLI 0.111.0 — Fast mode 기본화, 세션 시작 시 enabled plugins 컨텍스트 주입, structured MCP elicitation, 이미지 워크플로우/웹 검색 메타데이터 보강
CLI 0.110.0 — plugin system, /agent 기반 멀티에이전트 활성화, child-thread approval, 닉네임/role handoff, /fast 토글
CLI 0.107.0 — thread fork to sub-agent, multimodal custom tool outputs, model availability metadata, thread/resume의 approval/input 복원, MCP OAuth oauth_resource
CLI 0.105.0 — 추가 sandbox permission 요청, 프롬프트 타입별 auto-reject, child-thread approval 가시화, spawn_agents_on_csv 개선
CLI 0.102.0 — unified permissions flow, structured network approvals, customizable multi-agent roles, model/rerouted
CLI 0.99.0 — active turn steering API, requirements.toml의 web search/network constraints, required MCP fail-fast

핸드북 구조 변경

memories.mdx, thread-lifecycle.mdx 신규 추가
기존 장에 steering / plugins / MCP 운영 / 모델 선택 메타데이터 / 승인 고도화를 흡수
index.mdx 하이라이트를 0.112.0 기준으로 전면 갱신
updates.mdx에 0.99.0~0.112.0 릴리즈 기반 변경을 누적 기록

영향 챕터

index.mdx — 최신 하이라이트 전면 갱신
meta.json — 메모리/스레드 라이프사이클 페이지 추가
memories.mdx — memory 설정, stale fact 방지, reset 전략 신규 추가
thread-lifecycle.mdx — start/resume/fork/steer 운영 패턴 신규 추가
Ch2. config.toml 설계 — plugin/requirements/network constraint 운영 포인트 추가
Ch3. 승인/샌드박스 전략 — unified permissions, structured network approvals, resume/sub-agent approval 반영
Ch5. 슬래시 커맨드 운영 — /fast와 Fast mode 기본화 반영
Ch6. 프롬프트/스킬 설계 — plugin system, @plugin 멘션 운영 패턴 추가
Ch9. 멀티에이전트 — steering/fork/resume_agent/child-thread approval 흐름 보강
Ch10. Codex App/IDE — steering/resume API와 Fast/Standard 운영 포인트 보강
Ch11. MCP 연동 — fail-fast required MCP, structured elicitation, OAuth resource, plugin 기반 MCP 번들링 추가
Ch12. 모델/추론 전략 — model availability/reroute/picker 개선 포인트 추가
Ch13. 거버넌스/롤아웃 — plugin catalog, steering 감사 로그, network/search 강제 반영
Ch4. 보안 가이드 — sandbox/network hardening 항목 추가
verification.mdx — 기준일, 최신 버전, 링크 검증 수 갱신

근거 링크(공식)

2026-03-01

반영한 공식 변경(요약)

gpt-5.3-codex 기본 모델 전환 (SWE-Bench Pro 56.8%, 25% 빠른 속도, 최소 토큰 사용)
gpt-5.3-codex-spark 출시 (Pro 전용, 텍스트 전용 실시간 코딩 모델)
CLI 0.106.0 릴리즈 — 직접 설치 스크립트(macOS/Linux), js_repl experimental 승격, diff 기반 메모리 관리, zsh-fork 샌드박스 우회 취약점 패치, ~1M자 입력 크기 제한
CLI 0.105.0 기능 — TUI 구문 하이라이팅(/theme), 음성 입력(실험적), spawn_agents_on_csv 배치 처리, /copy·/clear·Ctrl-L 추가, 승인 프롬프트 타입별 자동 거부
멀티에이전트 정식 문서화 — 에이전트 역할(default/worker/explorer/monitor), /agent 커맨드, max_threads/max_depth 설정, CSV 배치 처리
Codex App macOS 데스크톱 정식 출시 — 워크트리 지원, 스레드별 터미널, 자동화/인박스, Plan Mode
Skills 체계 확장 — progressive disclosure, agents/openai.yaml 메타데이터, $skill-installer, 위치 계층 문서화
새 슬래시 커맨드 — /personality, /theme, /ps, /debug-config, /statusline, /agent, /apps, /experimental, /copy, /clear
Agents SDK 연동 — Codex를 MCP 서버로 실행해 멀티에이전트 파이프라인 구축
AGENTS.md 탐색 순서 공식 문서화 — override 파일 우선, 디렉토리 순회 방식

핸드북 구조 변경

Ch9. 멀티에이전트 신규 추가 (기존 Ch9~~Ch12 → Ch10~~Ch13으로 번호 조정)
Ch6 제목 변경: "프롬프트 설계" → "프롬프트/스킬 설계"
Ch9(구) 제목 변경: "IDE 확장" → "Codex App/IDE" (데스크톱 앱 내용 통합)
index.mdx 전면 업데이트: 최근 업데이트 하이라이트, 목차, 구성도 갱신

영향 챕터

index.mdx — 전면 업데이트
meta.json — 멀티에이전트 챕터 추가, 순서 조정
Ch1. 설치/로그인 — 직접 설치 스크립트, Codex App 섹션 강화, 버전 갱신
Ch2. config.toml 설계 — Feature Flags 섹션, /debug-config, 모델명 업데이트
Ch3. 승인/샌드박스 전략 — 승인 고도화(프롬프트 타입별 거부), /permissions 반영
Ch4. 보안 가이드 — zsh-fork 취약점 패치, 입력 크기 제한, 멀티에이전트 보안
Ch5. 슬래시 커맨드 운영 — 11개 신규 커맨드 추가, TUI 기능 설명
Ch6. 프롬프트/스킬 설계 — Skills 체계 전면 정리, AGENTS.md 탐색 순서, 음성 입력
Ch7. exec/자동화 — exec resume, Codex as MCP Server(Agents SDK)
Ch8. Cloud Tasks — GitHub @codex 통합, Cloud 보안 원칙
Ch9. 멀티에이전트 — 신규 챕터
Ch10. Codex App/IDE — 데스크톱 앱 통합, 워크트리, 고급 팁 추가
Ch11. MCP 연동 — Skills 의존성 선언, App MCP 단축키
Ch12. 모델/추론 전략 — gpt-5.3-codex/Spark 전면 교체, 비교표
Ch13. 거버넌스/롤아웃 — 롤아웃 표 수정, Agents SDK, 보안 패치 운영
verification.mdx — 교차검증 방법론 추가, 36개 링크 검증

근거 링크(공식)

2026-02-05

반영한 공식 변경(요약)

Codex app(데스크톱) 소개 + CLI에서 codex app <path>로 실행하는 흐름 반영
CLI Plan mode 기본 활성화 + /plan 명령/UX 보강 사항 반영
Team Config(공용 config/rules/skills) 소개 및 레이어 설명 반영
Custom prompts deprecated -> Skills 중심 운영 전환, /skill UI, /permissions 커맨드 반영
Models 문서 기준 추천 모델/기본값 업데이트(gpt-5.2-codex, gpt-5.1-codex-mini 등) 반영
@codex 기반 GitHub/Slack/Linear 통합 + Codex SDK/관리자 도구 문서 링크 보강
IDE 기능(Cloud delegation, 이미지 드래그&드롭) 최신 문서 링크 반영

영향 챕터

index.mdx
Ch1. 설치/로그인
Ch2. config.toml 설계
Ch5. 슬래시 커맨드 운영
Ch6. 프롬프트 설계
Ch9. IDE 확장
Ch10. MCP 연동
Ch11. 모델/추론 전략
Ch12. 거버넌스/롤아웃
verification.mdx

근거 링크(공식)

업데이트 기록 템플릿

아래 형식을 그대로 복사해 새 기록을 추가하세요.

### YYYY-MM-DD

**반영한 공식 변경(요약)**

- ...

**영향 챕터**

- ChX. ...

**근거 링크(공식)**

- https://developers.openai.com/codex/changelog

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.

반영 위치: index, setup, verification, 관련 명령·운영 챕터의 한·영판. 아래 기록은 이전 검증 시점의 이력입니다.

최종 업데이트

2026년 9월 12일(KST) 기준

운영 원칙

근거 기반: Codex Changelog/공식 문서 변경을 확인한 뒤 반영
영향 범위 명시: 어떤 챕터에 어떤 변경을 반영했는지 기록
기능/운영 분리: 제품 기능 변화(외부)와 핸드북 구조 변경(내부)을 구분

최근 업데이트

2026-09-05 (CLI 0.151.0~0.153.4 + GPT-6 Astra)

CLI 기준: npm latest=0.153.4, alpha=0.154.0-alpha.3, 로컬 CLI 0.153.4로 교차 확인
GPT-6 Astra(2026-09-03 출시): gpt-6-astra를 최상위 모델로 반영. CLI 0.153.0 이상 필요, 0.153.4부터 모델 미지정 세션의 bundled 기본값. 1,050,000 토큰 컨텍스트, 128K 출력, API 입력 $10·캐시 입력 $1·출력 $50/1M, 지식 기준일 2026-04-30, reasoning low~max
Astra 도입 순서: 0.153.0 지원 추가 → 0.153.1 기본값·picker 변경 없이 API 설정 경로 추가 → 0.153.3 Bedrock Mantle·Runtime picker 등재 → 0.153.4 bundled picker 노출 수정과 기본값 전환
Astra 보안 경계: Preparedness Framework 사이버보안 Critical 등급 첫 모델. 승인·샌드박스·자동 승인 범위를 먼저 좁히도록 모델 챕터와 index에 경고 추가
설정 기본값 변경: 0.152.0부터 planning tool 기본 비활성화(tools.update_plan.enabled). tui.auto_recap, tui.disable_paste_burst, features.context_management.experimental_mode, MCP output_token_limit, MCP 이름 규칙 완화, optional MCP grace, app-server thread/shellCommand 타임아웃을 config 챕터에 추가
Guardian·권한: Guardian 리뷰 이력이 compaction·재시작·fork를 넘어 보존되고, Full Access는 확인만 필요한 동작에서 Guardian 리뷰를 건너뜁니다(0.153.0)
모델 종료 반영: GPT-5.4·GPT-5.4 mini의 ChatGPT 로그인 종료(2026-08-31)를 예정에서 완료로 변경
반영한 챕터: index, models, config, updates, verification와 Codex 명령어 마스터 한·영판

2026-08-28 (CLI 0.149.0~0.150.1)

CLI 기준: npm latest=0.150.1, alpha=0.151.0-alpha.6; image-aware remote compaction patch까지 반영
task·세션: codex agents, codex queue, task @ 멘션, 자동 task title·/rename 제안, /cd·/pwd·/cwd 반영
TUI·hooks: /copy whole-response/code-block/blockquote picker, clickable Markdown links, permission-mode shortcut, Vim . repeat, Interrupt hooks 반영
보안·안정성: untrusted project AGENTS.md 차단, managed deny-read 지속, diagnostic credential redaction, MCP bearer/startup, Windows Unicode, Unix shutdown, Bedrock compaction/multi-agent 수정 반영
전환: codex mcp-server deprecation과 codex app-server 이전 기준을 MCP 문서에 추가

2026-08-20 (CLI 0.147.0~0.148.0)

CLI 기준: npm latest=0.148.0, alpha=0.149.0-alpha.4; /export, codex exec fork, resume picker archive/restore, startup prompt drafting, 예상 credit/cost 반영
확장·프로토콜: portable Agent Plugins, --approve-for-me, Cursor skill/conversation import, MCP 2026-07-28 opt-in, built-in Amazon Bedrock Runtime provider, async/MCP hooks 반영
모델: 기본 추천을 GPT-5.6 Sol + medium으로 전환하고 Terra/Luna 역할, Ultra/Max 차이, GPT-5.4·mini의 2026-08-31 ChatGPT 로그인 종료 반영
보안·호환성: codex exec --full-auto 제거, secrets/bearer redaction, OAuth/reconnect, plugin isolation, fail-closed network/sandbox, resume state 수정 반영
반영 챕터: index, models, config, governance, multi-agent, exec, approvals, security, mcp, slash-commands, thread-lifecycle, verification와 Command Master 한·영판

2026-08-03 (공식 slash inventory 재검증)

확인 결과와 반영 내용

정식 배포 기준은 그대로 CLI 0.146.0이며 npm latest=0.146.0, alpha=0.147.0-alpha.4, 로컬 CLI 0.146.0을 재확인
최신 공식 slash reference에서 /copy, /rename, /pets(/pet), Windows 전용 /setup-default-sandbox, /app의 등재를 확인
/agent의 /subagents, /side의 /btw 별칭을 확인하고 운영 표와 Command Master에 동기화
index.mdx, slash-commands.mdx, verification.mdx와 Codex Command Master 한·영판을 2026-08-03 기준으로 갱신

2026-08-01 (CLI 0.145.0~0.146.0)

반영한 공식 변경(요약)

CLI 0.145.0 — paginated thread history와 이름·검색·subagent·memory 지원, Cursor/Claude Code 전반으로 확장된 /import, Amazon Bedrock login/custom endpoint, audio input/tool output, 안정화된 Multi-agent V2, secure inline visualization link
CLI 0.146.0 — named /new·/clear, thread pinning·side switching, paginated/ephemeral fork, Agent Plugin manifest/workspace publish와 추가 marketplace, remote Code Mode host, custom-provider standalone web search, executor-provided skills, proxy·MCP/App refresh 보강
안정성 — replay/import/fork의 메시지·final·error·timestamp·approval 보존, terminal/Windows 수정, skill catalog truncation warning

핸드북 반영 위치

setup, thread-lifecycle, multi-agent, slash-commands, config, mcp, verification

2026-07-10 (CLI 0.143.0~0.144.0)

반영한 공식 변경(요약)

CLI 0.144.0 — usage-limit reset credit의 유형·만료·선택, app approval writes 모드, MCP interactive auth 기본화, runtime-provided app-server auth/hosted redirect, global pnpm install 감지, Ultra+고 multi-agent concurrency 사용량 경고
CLI 0.143.0 — remote plugin 기본 활성화, npm marketplace source와 local/remote version 표시, macOS/Windows system proxy(PAC/WPAD), codex remote-control pair, MCP tool search 기본화와 ChatGPT-hosted MCP session auth, Bedrock GPT-5.6 Sol/Terra/Luna 및 max effort, app-server environment/descendant/fork-through-turn API
안정성·보안 — retired model을 참조하는 compaction 재개 시 현재 모델로 재시도, Intel macOS Code Mode, Windows writable-root 삭제/managed runtime, terminal control sequence sanitization, connector auth refresh, proxy/CA-aware Responses WebSocket, review branch picker/auto-review 개선
npm 교차 확인 — @openai/codex latest=0.144.0, alpha=0.145.0-alpha.1

영향 챕터

index.mdx·setup.mdx — 최신 설치 기준을 0.144.0으로 갱신
mcp.mdx·exec.mdx — tool search/auth, system proxy, remote-control pair 반영
security.mdx·governance.mdx — app approval writes, terminal/sandbox/auth 보강 반영
models.mdx — Bedrock GPT-5.6 variant와 max effort 구분
verification.mdx — 0.143.0~0.144.0 및 npm dist-tag 교차검증 추가

2026-07-01 (CLI 0.142.5 patch + npm dist-tag 재검증)

반영한 공식 변경(요약)

CLI 0.142.5 — GitHub latest release와 npm latest가 0.142.5로 상향. Responses WebSocket request payload 전체가 trace log에 기록되지 않도록 막는 bug fix
dist-tag 교차 확인 — @openai/codex npm latest는 0.142.5, alpha는 0.143.0-alpha.31로 확인. 팀 문서 기준은 stable/latest를 우선하고, alpha는 실험 채널로만 기록
기능 기준 분리 — /usage, rollout token budgets, indexed web-search mode, scheduled UTC reminders/current-time handling, multi-agent delegation modes의 운영 기준은 사용자 영향 기능 변경이 있는 0.142.0 항목을 유지하고, 0.142.5는 로그/추적 데이터 보호 기준에 반영

영향 챕터

index.mdx — 최신 stable/latest 표기를 0.142.5로 갱신하고 0.142.5 trace-log bug fix 메모 추가
setup.mdx — 현재 설치/검증 기준을 0.142.5로 상향하고 0.142.x 팀 표준 설명 추가
security.mdx — trace log에 request payload 전체가 남지 않도록 하는 0.142.5 보안/프라이버시 패치를 로그 운영 기준에 추가
verification.mdx — 최신 CLI/stable/latest와 npm dist-tag를 2026-07-01 기준으로 갱신
Command Master 책 — index, updates, verification, 책장 요약을 같은 기준으로 동기화

근거 링크(공식/공개)

2026-06-25 (CLI 0.140.0~0.142.0 + `/delete`/`/import`/`/usage` + rollout budget 재검증)

반영한 공식 변경(요약)

CLI 0.142.0 — /usage token activity/rate-limit reset, rollout token budgets, indexed web-search mode, scheduled UTC reminders/current-time handling, multi-agent delegation modes, app-server/exec/MCP disconnect 복구
CLI 0.141.0 — TUI/app-server 안정성 보강, Linux suspend/resume 후 foreground 복귀, 장시간 연결 복구 확인
CLI 0.140.0 — /delete, codex delete <SESSION>, app-server thread/delete, /import Claude Code setup/project files/recent chats import, plugin organization 개선
dist-tag 교차 확인 — @openai/codex npm latest는 0.142.0, alpha는 0.143.0-alpha.14로 확인. 팀 문서 기준은 stable/latest를 우선

영향 챕터

index.mdx — 최신 기준 버전을 0.142.0으로 갱신하고 0.140.0~0.142.0 하이라이트 추가
Ch5. 슬래시 커맨드 운영 — /delete, /import, /usage 운영 기준을 command-master와 연결
스레드 라이프사이클 — deletion/archive 보존 정책 분리, scheduled reminder 시간대 기준 추가
Ch7. exec/자동화 — indexed web search, disconnect recovery, current-time handling 반영
Ch9. 멀티에이전트 — delegation modes와 parent/child handoff 기준 추가
Ch13. 거버넌스/롤아웃 — rollout token budget과 /usage 점검 루틴 추가
verification.mdx — 기준일, 최신 버전, 12차 검증 항목 추가

근거 링크(공식)

2026-06-12 (CLI 0.138.0~0.139.0 + `/app` + plugin/app-server 재검증)

반영한 공식 변경(요약)

CLI 0.139.0 — code mode standalone web search, MCP tool input schema의 oneOf/allOf 보존과 큰 schema compaction 개선, codex doctor editor/pager environment 리포트, plugin marketplace source/cached catalog 보강, resume/fork --last prompt 처리, MCP startup warning scoping, image edit referenced path 처리, cloud-managed requirement 보존, sandbox approval/proxy enforcement, OpenAI Codex cloud environment용 exec agent provider, plugin marketplace install/upgrade 흐름, codex debug app-server send-message-v2 복구
CLI 0.138.0 — /app Desktop handoff, 로컬 이미지 첨부/생성 파일 path 노출, reasoning effort fallback shortcuts와 model-defined effort ordering, app-server account token usage, ChatGPT v2 personal access token, plugin add/remove/marketplace --json, codex plugin list --available --json, marketplace source JSON
Slash commands 재검증 — /archive는 공식 slash commands 표에 등재된 상태로 보정, /app은 0.138.0 changelog 기반 release-tracked command로 command-master에 추가
Models 문서 재검증 — gpt-5.5 기본 추천, gpt-5.2/gpt-5.3-codex deprecated, Cloud task 기본 모델 변경 불가 제약 유지
Codex App 26.608 계열 — remote connection, Composer thinking mode selector, active MCP server 표시, mobile UX, Computer Use rendering/responsiveness 보강

영향 챕터

index.mdx — 최신 기준 버전을 0.139.0으로 갱신하고 0.138.0~0.139.0 하이라이트 추가
Ch1. 설치/로그인 — 최신 안정 버전, /app vs codex app, App 26.608 운영 기준 추가
Ch2. config.toml 설계 — plugin JSON 감사, sandbox -P, effective sandbox mode, network proxy enforcement 반영
Ch7. exec/자동화 — code mode web search, app-server token usage, ChatGPT v2 token, send-message-v2, cloud exec provider, 이미지 path 자동화 추가
Ch10. Codex App/IDE — CLI thread handoff와 App 26.608 remote/MCP/Computer Use 운영 기준 추가
Ch11. MCP 연동 — schema preservation, MCP startup warning scoping, plugin marketplace JSON/source/upgrade 감사 포인트 추가
Ch12. 모델/추론 전략 — reasoning effort fallback shortcuts와 image path 인식 보강 반영
Ch13. 거버넌스/롤아웃 — plugin inventory JSON, app-server debug smoke test, Desktop handoff 체크리스트 추가
verification.mdx — 기준일, 최신 버전, 11차 검증 항목 추가

근거 링크(공식)

2026-06-08 (CLI 0.133.0~0.137.0 + `/archive` + app-server/managed config 재검증)

반영한 공식 변경(요약)

CLI 0.137.0 — F13-F24 keybindings, searchable menu paste, reasoning-only status/title item, monthly credit limits, cloud-managed config bundles(EDU 포함), remote-control pairing/grant RPC, codex plugin list --json, hosted web/image tools, Multi-agent v2 runtime metadata
CLI 0.136.0 — /archive, codex archive, codex unarchive, clickable OSC 8 links, codex app-server --stdio, richer MCP server status, remote execution CODEX_API_KEY registration, remote-control short-lived server tokens, Windows sandbox setup alpha
CLI 0.135.0 — richer codex doctor, remote /status connection/server version, Vim mode 보강, /permissions named permission profiles 표시, Python SDK Sandbox presets, non-interactive installer mode
CLI 0.134.0 — local conversation history search, --profile 파일 기반 migration, MCP per-server environment targeting/OAuth options, readOnlyHint 기반 read-only MCP tool 병렬 실행, extension/hook context 확장
CLI 0.133.0 — /goal 기본 활성화, permission profile list/inheritance/managed requirements/runtime refresh, plugin discovery marketplace-aware list/installed versions/remote collection, extension lifecycle events 확장
Models 문서 재검증 — gpt-5.5 추천 기본값 유지, gpt-5.3-codex는 ChatGPT 로그인 기준 deprecated로 정리, Codex cloud tasks는 사용자가 기본 모델을 직접 변경할 수 없다는 제약 반영

영향 챕터

index.mdx — 최신 기준 버전을 0.137.0으로 갱신하고 0.133.0~0.137.0 하이라이트 추가
Ch1. 설치/로그인 — latest stable, app archive/remote-control grant 운영 기준 보강
Ch2. config.toml 설계 — --profile migration, cloud-managed requirements, 최신 permission profile syntax 보정
Ch5. 슬래시 커맨드 운영 — /archive release-tracked command와 0.133.0~0.137.0 운영 포인트 추가
Ch7. exec/자동화 — CODEX_API_KEY 스코프, codex app-server --stdio, remote-control grant/runbook 보강
스레드 라이프사이클 — archive/unarchive 운영 모델과 app-server event 노출 기준 추가
Ch9. 멀티에이전트 — Multi-agent v2 runtime metadata와 spawned child listener 안정화 반영
Ch11. MCP 연동 — per-server environment targeting, readOnlyHint, richer MCP status, plugin JSON inventory 반영
Ch13. 거버넌스/롤아웃 — cloud-managed config bundle, monthly credit limit, remote-control grant, plugin inventory JSON 정책 반영
Ch12. 모델/추론 전략 — deprecated gpt-5.3-codex 정리와 Cloud task 모델 정책 분리 추가
verification.mdx — 기준일, 최신 버전, 10차 검증 항목 갱신

근거 링크(공식)

2026-05-21 (CLI 0.131.0~0.132.0 + 최신 slash inventory + 모델 문서 재검증)

반영한 공식 변경(요약)

CLI 0.132.0 — Python SDK first-class auth, plain string input, richer TurnResult, codex exec resume --output-schema, original-resolution image fidelity, goal continuation guardrail
CLI 0.131.0 — data-driven service-tier commands, blended token usage, effective workspace roots, unified @ picker(files/directories/plugins/skills), plugin marketplace CLI commands, version-aware sharing, share checkout, remote-control daemon/runtime APIs, codex doctor
Work with Codex from anywhere — ChatGPT mobile app에서 Mac의 Codex app에 연결해 같은 projects/files/credentials/plugins/skills/configuration 사용, Hooks GA, Codex access tokens, Enterprise admin setup 문서 보강
Slash commands 재검증 — /approve, /ide, /memories, /raw, /skills, /theme, /vim 공식 표 등재 확인
모델 문서 재검증 — gpt-5.5가 ChatGPT 로그인과 API-key 인증 모두에서 Codex CLI/SDK·App/IDE에 지원되는 것으로 갱신

영향 챕터

index.mdx — 최신 기준 버전을 0.132.0 / GPT-5.5 / Python SDK / 최신 slash inventory로 갱신
Ch1. 설치/로그인 — 최신 안정 버전과 모바일 remote access 운영 기준 추가
Ch2. config.toml 설계 — gpt-5.5 API-key 인증 지원 기준으로 모델 기본값 설명 보정
Ch5. 슬래시 커맨드 운영 — 신규 공식 명령 /approve, /ide, /memories, /raw, /skills, /theme, /vim 반영
Ch7. exec/자동화 — codex exec resume --output-schema, Python SDK auth/turn API, remote-control daemon 운영 포인트 추가
Ch9. 멀티에이전트 — service-tier/subagent 운영 보강 반영
Ch11. MCP 연동 — plugin marketplace CLI, version-aware sharing, unified @ picker, MCP OAuth callback ids 반영
Ch12. 모델/추론 전략 — API-key 인증 기준 보정
Ch13. 거버넌스/롤아웃 — GPT-5.5 기본 정책 보정
verification.mdx — 기준일, 최신 버전, 모델/API-key, slash inventory 검증 항목 갱신

근거 링크(공식)

2026-05-10 (CLI 0.128.0~0.130.0 + Codex for Chrome + 모델 문서 재검증)

반영한 공식 변경(요약)

CLI 0.130.0 — plugin details의 bundled hooks 표시, plugin sharing link metadata/discoverability controls, codex remote-control, large thread pagination views, Bedrock aws login profiles, selected-environment 기반 view_image, live app-server config refresh
Codex for Chrome — 로그인된 Chrome 상태가 필요한 웹사이트 작업을 tab group 기반으로 병렬 수행하되, 새 host 승인·allowlist/blocklist·browser history 접근을 별도 통제
CLI 0.129.0 — modal Vim composer(/vim), /keymap, workspace-aware /diff, /hooks browser, plugin workspace sharing/share access controls/source filtering/remote bundle sync
CLI 0.128.0 — persisted /goal workflows, codex update, configurable TUI keymaps, plan-mode nudges, action-required terminal titles, active-turn /statusline·/title, permission profile 확장, external agent session import, MultiAgentV2 설정 명시화
모델 문서 재검증 — 공식 Codex Models 기준 추천 목록을 gpt-5.5, gpt-5.4, gpt-5.4-mini, gpt-5.3-codex, gpt-5.3-codex-spark로 정리하고, 잘못 들어간 gpt-5.5-codex/gpt-5.5-mini/gpt-5.5-nano 참조를 제거

영향 챕터

index.mdx — 최신 기준 버전을 0.130.0 / GPT-5.5 / Chrome 확장으로 갱신
Ch1. 설치/로그인 — 최신 안정 버전과 Chrome 확장 운영 기준 추가
Ch2. config.toml 설계 — gpt-5.5 기본값, plugin sharing, keymap 운영 보강
Ch5. 슬래시 커맨드 운영 — /goal, /keymap, /side, /stop 최신 공식 목록 반영
Ch7. exec/자동화 — --full-auto deprecated 안내와 codex remote-control 운영 포인트 추가
스레드 라이프사이클 — persisted /goal, large thread pagination view 반영
Ch10. Codex App/IDE — Codex for Chrome 보안/운영 기준 추가
Ch11. MCP 연동 — plugin sharing/source filtering/bundled hooks 운영 기준 추가
Ch12. 모델/추론 전략 — 공식 모델 목록 기준으로 재작성
verification.mdx — 기준일, 최신 버전, 신규 명령과 모델 검증 항목 갱신

근거 링크(공식)

2026-04-26 (CLI 0.123.0~0.125.0 + GPT-5.5 + App 26.423 반영)

반영한 공식 변경(요약)

CLI 0.125.0 — app-server integrations의 Unix socket 지원, thread/resume/fork cursor-based pagination, multiple environment name persistence, remote plugin install + marketplace upgrade, permission profile round-trip 정합성 개선, codex exec --json reasoning token usage 추가
CLI 0.124.0 — Alt+, reasoning quick cycle, approval 전 subagent review 자동 실행, remote plugin marketplace list/read, stable hooks, Amazon Bedrock support, /permissions side-conversation 유지, /statusline·/title normalization
CLI 0.123.0 — GPT-5.5 계열 가용성, /mcp verbose, built-in browser use, current/archived thread를 구분하는 resume hinting, plain # heading-only context lookup
GPT-5.5 모델 문서 갱신 — 이후 2026-05-10 재검증 기준으로 gpt-5.5가 대부분의 작업에 대한 기본 추천이며, gpt-5.4는 fallback, gpt-5.4-mini와 gpt-5.3-codex-spark는 보조/빠른 반복용으로 정리
Codex App 26.423 — diff reviewer comments, browser cookies, browser use, direct images to thread, continue-from-notification, slides generate/edit, Figma integration, browser on popout windows

영향 챕터

index.mdx — 최신 기준 버전을 0.125.0 / GPT-5.5 / App 26.423으로 갱신
Ch1. 설치/로그인 — 최신 안정 버전, App 26.423 운영 포인트 추가
Ch3. 승인/샌드박스 전략 — automatic approval review, permission state round-trip 보강
Ch5. 슬래시 커맨드 운영 — /mcp verbose, Alt+,, /permissions 정합성 메모 추가
Ch7. exec/자동화 — codex exec --json reasoning token usage, hooks stable 반영
스레드 라이프사이클 — resume hinting, cursor pagination, multi-environment persistence 반영
Ch10. Codex App/IDE — App 26.423 브라우저/리뷰 워크플로우 추가
Ch11. MCP 연동 — /mcp verbose, remote marketplace, remote plugin install/upgrade 반영
Ch12. 모델/추론 전략 — GPT-5.5 중심으로 전면 개편
verification.mdx — 기준일, 최신 버전, 0.123.0~0.125.0 및 App 26.423 검증 항목 갱신

근거 링크(공식)

2026-04-22 (CLI 0.121.0~0.122.0 + App 26.415 반영)

반영한 공식 변경(요약)

CLI 0.122.0 — standalone install self-contained 정리, codex app의 Windows/Intel Mac 데스크톱 열기/설치 개선, queued input에서 slash command와 ! shell prompt 지원, Plan Mode fresh-context 구현 시작, deny-read glob 정책/managed deny-read requirements/platform sandbox enforcement, 격리 codex exec용 --ignore-user-config/--ignore-rules, tool discovery + image generation 기본 활성화, large-file patching 보강
CLI 0.121.0 — codex marketplace add(GitHub/git URL/로컬 디렉토리/direct marketplace.json), Ctrl+R reverse search와 slash command local recall, memory mode/reset/deletion과 extension cleanup, MCP Apps tool call/namespaced registration/parallel-call opt-in/sandbox-state metadata
Codex App 26.415 — in-app browser, computer use, 프로젝트 없이 시작하는 chats, thread automations, task sidebar, context-aware suggestions, PR sidebar workflow, artifact viewer, memories, SSH remote connections alpha, multiple terminals, multi-window, Intel Mac support, new plugins

영향 챕터

index.mdx — 최신 기준 버전을 0.122.0 / App 26.415로 갱신하고 하이라이트 추가
Ch1. 설치/로그인 — 최신 안정 버전, reverse search, chats/in-app browser/task sidebar, Intel Mac support 반영
Ch2. config.toml 설계 — deny-read 정책, 격리 exec 플래그, tool discovery 기본화, marketplace source 운영 추가
메모리 운영 — memory mode/reset/deletion과 config 기준 운영 키 보강
Ch4. 보안 가이드 — deny-read, trusted workspace, logout token revoke, Windows sandbox grant 축소 반영
Ch5. 슬래시 커맨드 운영 — queued slash command, Ctrl+R, /side의 changelog-only 상태 반영
Ch7. exec/자동화 — large-file patching, 격리 exec 운영 포인트 추가
스레드 라이프사이클 — running thread에 대한 queued input 개입 모델 보강
Ch10. Codex App/IDE — App 26.415 작업공간 확장 항목 추가
Ch11. MCP 연동 — namespaced MCP registration, marketplace source 확장 반영
verification.mdx — 기준일, 최신 버전, 0.121.0~0.122.0 및 App 26.415 검증 항목 갱신

근거 링크(공식)

2026-04-15 (CLI 0.119.0~0.120.0 + ChatGPT 로그인 모델 정리 완료 반영)

반영한 공식 변경(요약)

CLI 0.120.0 — Realtime V2 background agent progress 스트리밍, active response 중 follow-up response queue, TUI hook activity 구분 표시, custom TUI status line의 renamed thread title, code-mode tool declaration의 MCP outputSchema 반영, SessionStart hook의 /clear source 구분
CLI 0.119.0 — Realtime voice sessions의 v2 WebRTC 기본화, MCP Apps/custom MCP servers의 resource read / tool-call metadata / custom-server tool search / server-driven elicitation / file upload 확장, remote/app-server의 egress websocket transport / remote --cd forwarding / sandbox-aware filesystem APIs / 실험적 codex exec-server, Ctrl+O 최신 응답 복사, /resume의 session ID/name 직접 점프, 더 유연한 TUI notifications, stale quota를 갱신하는 /status, 더 가벼워진 /mcp
모델 가용성 정리 완료 (2026-04-14) — ChatGPT 로그인 경로에서 gpt-5.2-codex, gpt-5.1-codex-mini, gpt-5.1-codex-max, gpt-5.1-codex, gpt-5.1, gpt-5 제거 완료

영향 챕터

index.mdx — 최신 기준 버전을 0.120.0으로 갱신하고 0.119.0~0.120.0 하이라이트 추가
Ch1. 설치/로그인 — 최신 안정 버전과 운영 최소 기준을 0.120.0으로 상향
Ch5. 슬래시 커맨드 운영 — /copy, /resume, /status, /statusline의 최신 동작 반영
Ch7. exec/자동화 — 실험적 codex exec-server, code mode의 MCP outputSchema 반영 추가
스레드 라이프사이클 — /resume 직접 점프와 Realtime V2 background progress 반영
Ch11. MCP 연동 — richer MCP support와 /mcp 경량화, cleanup 안정화 추가
verification.mdx — 기준일, 최신 버전, 0.119.0~0.120.0 검증 항목 갱신

근거 링크(공식)

2026-04-08 (CLI 0.117.0~0.118.0 + 모델 가용성 반영)

반영한 공식 변경(요약)

CLI 0.118.0 — Windows 샌드박스 proxy-only 네트워크를 OS 레벨 egress rules로 강제, app-server 클라이언트의 ChatGPT device-code 로그인 시작 안정화, codex exec prompt+stdin workflow 지원, custom model provider의 short-lived bearer token 동적 갱신, 프로젝트 로컬 .codex 첫 생성 보호, Linux bwrap 탐색 복구, app-server TUI의 /copy·/resume <name>·/agent 회귀 수정, MCP startup 경고 표시 복구
CLI 0.117.0 — product-scoped plugin sync, /plugins 브라우저, /title terminal-title picker, path-based sub-agent address(/root/agent_a), structured inter-agent messaging/agent listing, app-server TUI prompt history recall, view_image image URL 반환 및 이미지 히스토리 재개, app-server TUI 기본화
모델 가용성 업데이트 (2026-04-07) — ChatGPT 로그인 사용자의 model picker에서 gpt-5.2-codex, gpt-5.1*, gpt-5 계열이 단계적으로 제거되고 gpt-5.4, gpt-5.4-mini, gpt-5.3-codex, gpt-5.2 중심으로 정리

영향 챕터

index.mdx — 하이라이트와 기준 버전을 0.118.0 기준으로 갱신
Ch1. 설치/로그인 — 최신 안정 버전, app-server TUI 기본화, device-code 로그인 설명 갱신
Ch3. 승인/샌드박스 전략 — .codex 첫 생성 보호, Windows proxy-only egress, bwrap 탐색 복구 반영
Ch5. 슬래시 커맨드 운영 — /plugins, /title, /approvals alias 상태 반영, /skills·/theme 제거
Ch6. 프롬프트/스킬 설계 — plugins first-class workflow, /plugins 운영 포인트 추가
Ch7. exec/자동화 — codex exec prompt+stdin workflow 추가
Ch9. 멀티에이전트 — path-based agent address, structured inter-agent messaging 추가
Ch10. Codex App/IDE — app-server TUI 기본화, prompt history recall, /title 반영
Ch12. 모델/추론 전략 — ChatGPT 로그인 모델 가용성 정리, gpt-5.4-mini 추가
verification.mdx — 기준일, 최신 버전, 모델 가용성 검증 항목 갱신

근거 링크(공식)

2026-03-25 (CLI 0.116.0 반영)

반영한 공식 변경(요약)

CLI 0.116.0 — ChatGPT device-code 로그인(App-server TUI 온보딩 시 디바이스 코드 인증 + 기존 토큰 갱신), userpromptsubmit 훅(프롬프트 실행 전 차단/보강), 플러그인 설치 프롬프트(누락 플러그인 제안, suggestion allowlist, 원격 동기화), Realtime 세션에 최근 스레드 컨텍스트 포함(오디오 자기중단 감소), WebSocket prewarm 첫 턴 지연 수정(타임아웃 후 폴백), 원격 resume/fork 대화 히스토리 복원, Linux 샌드박스 시작 안정성 개선(심볼릭 링크, AppArmor, 시스템 bwrap 우선), 에이전트 작업 finalization 레이스 수정

영향 챕터

index.mdx — 하이라이트를 0.116.0 기준으로 갱신, updatedAt 갱신
Ch1. 설치/로그인 — ChatGPT device-code 로그인 추가
Ch3. 승인/샌드박스 전략 — Linux 샌드박스 안정성 개선 추가
Ch5. 슬래시 커맨드 운영 — userpromptsubmit 훅 추가
Ch6. 프롬프트/스킬 설계 — 플러그인 설치 프롬프트 추가
스레드 라이프사이클 — Realtime 컨텍스트, 원격 resume/fork 복원 추가

근거 링크(공식)

2026-03-17 (CLI 0.115.0 반영)

반영한 공식 변경(요약)

CLI 0.115.0 — view_image 풀해상도 이미지 검사(모델이 detail: 'original'로 원본 해상도 요청 가능), JS REPL에 codex.cwd/codex.homeDir 노출 및 셀 간 persistent tool references, 실시간 WebSocket 전용 transcription 모드 및 v2 handoff 지원, app-server filesystem RPCs(file/read, file/write, file/copy) + 새 Python SDK, Smart Approvals guardian subagent(다중 인터페이스에서 일관된 승인 라우팅), App integrations Responses API tool-search with fallback, wait_agent 도구 이름 변경(기존 wait에서 변경)

영향 챕터

index.mdx — 하이라이트를 0.115.0 기준으로 갱신, updatedAt 갱신
Ch3. 승인/샌드박스 전략 — Smart Approvals guardian subagent 섹션 추가
Ch7. exec/자동화 — App-server filesystem RPCs, Python SDK, view_image 추가
Ch9. 멀티에이전트 — guardian subagent, wait_agent 이름 변경, monitor 역할 표 갱신
Ch11. MCP 연동 — App integrations Responses API tool-search 추가

근거 링크(공식)

2026-03-13 (GPT-5.4 & App 26.312 반영)

반영한 공식 변경(요약)

GPT-5.4 기본 모델 전환 (2026-03-05) — 코딩+추론+도구 사용+에이전틱 워크플로우 통합 플래그십 모델. 네이티브 컴퓨터 사용, 1.05M 토큰 컨텍스트(922K input/128K output), 47% 토큰 효율 개선, 강화된 도구 탐색(tool search). gpt-5.3-codex 코딩 역량 계승. 새 기본 추천 모델
Codex Windows 앱 출시 (2026-03-04) — 네이티브 에이전트 샌드박스, PowerShell 지원, 크로스 플랫폼 세션 동기화, 모든 ChatGPT 플랜 지원
Codex Security 리서치 프리뷰 (2026-03-06) — GPT-5.4 기반 보안 스캐닝. 1.2M 커밋 스캔, 오탐 50% 감소, 과잉 심각도 90% 감소, 노이즈 84% 감소. Enterprise/Business/Edu 대상
Codex for Open Source (2026-03-07) — 1K+ 스타 OSS 메인테이너에게 6개월 무료 ChatGPT Pro
Promptfoo 인수 (2026-03-09) — AI 보안/평가 스타트업, Fortune 500 25%+ 사용. Frontier 플랫폼 통합 예정
GPT-5.1 모델 퇴역 (2026-03-11) — ChatGPT에서 GPT-5.3/5.4 변형으로 자동 마이그레이션
GPT-5.3-Codex-Spark Cerebras 실행: 1,000+ 토큰/초, 플래그십 대비 15배 빠름. OpenAI 첫 Nvidia 외부 프로덕션 배포
AGENTS.md 60K+ 프로젝트 채택: Linux Foundation 산하 Agentic AI Foundation이 표준 관리
Analytics API/Compliance API: 프로그래매틱 리포팅, 감사 로그(eDiscovery/DLP/SIEM), 셀프서브 대시보드
Codex App 26.312 (2026-03-12) — 테마 커스터마이징(베이스 테마, 색상, 폰트, 공유), 자동화 개편(로컬/워크트리 실행 선택, 커스텀 추론 수준/모델, 템플릿)
Codex App 26.305 (2026-03-05) — 원격 연결 개선, Windows 통합 터미널 복사/붙여넣기 수정, 보관된 고정 스레드 버그 수정

영향 챕터

index.mdx — GPT-5.4, Windows 앱, Codex Security 하이라이트 추가, updatedAt 갱신
Ch1. 설치/로그인 — Windows 앱 출시, 플랫폼 제한 해제, 자동화/테마 추가
Ch2. config.toml 설계 — 모델 예시를 gpt-5.4로 갱신
Ch4. 보안 가이드 — Codex Security 리서치 프리뷰, Promptfoo 인수 추가
Ch6. 프롬프트/스킬 설계 — AGENTS.md 60K+ 채택 통계 추가
Ch9. 멀티에이전트 — GPT-5.4 에이전틱 강화, App 자동화 개편 추가
Ch10. Codex App/IDE — Windows 앱 출시, App 26.312 테마/자동화 상세, App 26.305 수정 사항 추가
Ch12. 모델/추론 전략 — GPT-5.4 상세 수치, Spark Cerebras, GPT-5.1 퇴역, 비교표/운영 가이드 전면 갱신
Ch13. 거버넌스/롤아웃 — GPT-5.4 전환 운영, Codex for OSS, Enterprise API, AGENTS.md 생태계 추가
verification.mdx — GPT-5.4 모델 검증, Windows 앱, App 검증 항목 추가

근거 링크(공식)

2026-03-13

반영한 공식 변경(요약)

CLI 0.114.0 — 실험적 code mode(격리 코딩 워크플로우), hooks 엔진(SessionStart/Stop 이벤트), healthz/readyz 헬스체크 엔드포인트, 번들 시스템 스킬 비활성화 스위치, handoff 시 실시간 transcript 전달, $ 멘션 피커 개선(Skills/Apps/Plugins 라벨), Linux tmux 크래시 수정, 영구 권한/apply_patch 승인 수정
CLI 0.113.0 — request_permissions 런타임 권한 요청 도구(TUI 승인 렌더링), permission-profile 분리형 설정 언어(파일시스템/네트워크 정책 분리), 플러그인 마켓플레이스(검색/메타데이터/인증 검사/삭제), app-server exec 스트리밍(stdin/stdout/stderr, TTY/PTY), 웹 검색 도구 상세 설정, 이미지 생성 CWD 저장, SQLite 감사 로깅, 네트워크 프록시 하드닝(글로벌 와일드카드 거부), trust bootstrap 수정, winget 퍼블리싱

영향 챕터

index.mdx — 하이라이트를 0.114.0 기준으로 갱신
Ch1. 설치/로그인 — 최신 버전 0.114.0, winget 설치, tmux 이슈, healthz/readyz 추가
Ch2. config.toml 설계 — permission-profile 설정 언어, 번들 스킬 비활성화, 웹 검색 도구 설정 추가
Ch3. 승인/샌드박스 전략 — request_permissions 도구, permission-profile 분리 정책, 네트워크 프록시 하드닝, 영구 권한 수정 추가
Ch4. 보안 가이드 — 네트워크 프록시 하드닝, trust bootstrap, SQLite 감사 로깅 추가
Ch5. 슬래시 커맨드 운영 — $ 멘션 피커 개선, hooks 엔진 추가
Ch6. 프롬프트/스킬 설계 — 플러그인 마켓플레이스, 번들 스킬 비활성화 추가
Ch7. exec/자동화 — app-server exec 스트리밍, code mode, hooks 엔진 추가
Ch8. Cloud Tasks — 인증 에러 복구, healthz/readyz 엔드포인트 추가
Ch9. 멀티에이전트 — handoff transcript, hooks 엔진 자동화 추가
스레드 라이프사이클 — 재오픈 스레드 상태 복원, handoff transcript 추가
Ch10. Codex App/IDE — $ 멘션 피커, healthz/readyz, handoff transcript, 앱 세션 수정 추가
Ch11. MCP 연동 — 플러그인 마켓플레이스, 인증 검사, 삭제 엔드포인트 추가
Ch13. 거버넌스/롤아웃 — hooks 엔진, SQLite 로깅, winget 퍼블리싱 추가
verification.mdx — 기준일 갱신, 0.113.0~0.114.0 검증 항목 추가

근거 링크(공식)

2026-03-09

반영한 공식 변경(요약)

CLI 0.112.0 — @plugin 멘션, model picker 카탈로그 갱신, zsh-fork skill 실행의 per-turn sandbox merge
CLI 0.111.0 — Fast mode 기본화, 세션 시작 시 enabled plugins 컨텍스트 주입, structured MCP elicitation, 이미지 워크플로우/웹 검색 메타데이터 보강
CLI 0.110.0 — plugin system, /agent 기반 멀티에이전트 활성화, child-thread approval, 닉네임/role handoff, /fast 토글
CLI 0.107.0 — thread fork to sub-agent, multimodal custom tool outputs, model availability metadata, thread/resume의 approval/input 복원, MCP OAuth oauth_resource
CLI 0.105.0 — 추가 sandbox permission 요청, 프롬프트 타입별 auto-reject, child-thread approval 가시화, spawn_agents_on_csv 개선
CLI 0.102.0 — unified permissions flow, structured network approvals, customizable multi-agent roles, model/rerouted
CLI 0.99.0 — active turn steering API, requirements.toml의 web search/network constraints, required MCP fail-fast

핸드북 구조 변경

memories.mdx, thread-lifecycle.mdx 신규 추가
기존 장에 steering / plugins / MCP 운영 / 모델 선택 메타데이터 / 승인 고도화를 흡수
index.mdx 하이라이트를 0.112.0 기준으로 전면 갱신
updates.mdx에 0.99.0~0.112.0 릴리즈 기반 변경을 누적 기록

영향 챕터

index.mdx — 최신 하이라이트 전면 갱신
meta.json — 메모리/스레드 라이프사이클 페이지 추가
memories.mdx — memory 설정, stale fact 방지, reset 전략 신규 추가
thread-lifecycle.mdx — start/resume/fork/steer 운영 패턴 신규 추가
Ch2. config.toml 설계 — plugin/requirements/network constraint 운영 포인트 추가
Ch3. 승인/샌드박스 전략 — unified permissions, structured network approvals, resume/sub-agent approval 반영
Ch5. 슬래시 커맨드 운영 — /fast와 Fast mode 기본화 반영
Ch6. 프롬프트/스킬 설계 — plugin system, @plugin 멘션 운영 패턴 추가
Ch9. 멀티에이전트 — steering/fork/resume_agent/child-thread approval 흐름 보강
Ch10. Codex App/IDE — steering/resume API와 Fast/Standard 운영 포인트 보강
Ch11. MCP 연동 — fail-fast required MCP, structured elicitation, OAuth resource, plugin 기반 MCP 번들링 추가
Ch12. 모델/추론 전략 — model availability/reroute/picker 개선 포인트 추가
Ch13. 거버넌스/롤아웃 — plugin catalog, steering 감사 로그, network/search 강제 반영
Ch4. 보안 가이드 — sandbox/network hardening 항목 추가
verification.mdx — 기준일, 최신 버전, 링크 검증 수 갱신

근거 링크(공식)

2026-03-01

반영한 공식 변경(요약)

gpt-5.3-codex 기본 모델 전환 (SWE-Bench Pro 56.8%, 25% 빠른 속도, 최소 토큰 사용)
gpt-5.3-codex-spark 출시 (Pro 전용, 텍스트 전용 실시간 코딩 모델)
CLI 0.106.0 릴리즈 — 직접 설치 스크립트(macOS/Linux), js_repl experimental 승격, diff 기반 메모리 관리, zsh-fork 샌드박스 우회 취약점 패치, ~1M자 입력 크기 제한
CLI 0.105.0 기능 — TUI 구문 하이라이팅(/theme), 음성 입력(실험적), spawn_agents_on_csv 배치 처리, /copy·/clear·Ctrl-L 추가, 승인 프롬프트 타입별 자동 거부
멀티에이전트 정식 문서화 — 에이전트 역할(default/worker/explorer/monitor), /agent 커맨드, max_threads/max_depth 설정, CSV 배치 처리
Codex App macOS 데스크톱 정식 출시 — 워크트리 지원, 스레드별 터미널, 자동화/인박스, Plan Mode
Skills 체계 확장 — progressive disclosure, agents/openai.yaml 메타데이터, $skill-installer, 위치 계층 문서화
새 슬래시 커맨드 — /personality, /theme, /ps, /debug-config, /statusline, /agent, /apps, /experimental, /copy, /clear
Agents SDK 연동 — Codex를 MCP 서버로 실행해 멀티에이전트 파이프라인 구축
AGENTS.md 탐색 순서 공식 문서화 — override 파일 우선, 디렉토리 순회 방식

핸드북 구조 변경

Ch9. 멀티에이전트 신규 추가 (기존 Ch9~~Ch12 → Ch10~~Ch13으로 번호 조정)
Ch6 제목 변경: "프롬프트 설계" → "프롬프트/스킬 설계"
Ch9(구) 제목 변경: "IDE 확장" → "Codex App/IDE" (데스크톱 앱 내용 통합)
index.mdx 전면 업데이트: 최근 업데이트 하이라이트, 목차, 구성도 갱신

영향 챕터

index.mdx — 전면 업데이트
meta.json — 멀티에이전트 챕터 추가, 순서 조정
Ch1. 설치/로그인 — 직접 설치 스크립트, Codex App 섹션 강화, 버전 갱신
Ch2. config.toml 설계 — Feature Flags 섹션, /debug-config, 모델명 업데이트
Ch3. 승인/샌드박스 전략 — 승인 고도화(프롬프트 타입별 거부), /permissions 반영
Ch4. 보안 가이드 — zsh-fork 취약점 패치, 입력 크기 제한, 멀티에이전트 보안
Ch5. 슬래시 커맨드 운영 — 11개 신규 커맨드 추가, TUI 기능 설명
Ch6. 프롬프트/스킬 설계 — Skills 체계 전면 정리, AGENTS.md 탐색 순서, 음성 입력
Ch7. exec/자동화 — exec resume, Codex as MCP Server(Agents SDK)
Ch8. Cloud Tasks — GitHub @codex 통합, Cloud 보안 원칙
Ch9. 멀티에이전트 — 신규 챕터
Ch10. Codex App/IDE — 데스크톱 앱 통합, 워크트리, 고급 팁 추가
Ch11. MCP 연동 — Skills 의존성 선언, App MCP 단축키
Ch12. 모델/추론 전략 — gpt-5.3-codex/Spark 전면 교체, 비교표
Ch13. 거버넌스/롤아웃 — 롤아웃 표 수정, Agents SDK, 보안 패치 운영
verification.mdx — 교차검증 방법론 추가, 36개 링크 검증

근거 링크(공식)

2026-02-05

반영한 공식 변경(요약)

Codex app(데스크톱) 소개 + CLI에서 codex app <path>로 실행하는 흐름 반영
CLI Plan mode 기본 활성화 + /plan 명령/UX 보강 사항 반영
Team Config(공용 config/rules/skills) 소개 및 레이어 설명 반영
Custom prompts deprecated -> Skills 중심 운영 전환, /skill UI, /permissions 커맨드 반영
Models 문서 기준 추천 모델/기본값 업데이트(gpt-5.2-codex, gpt-5.1-codex-mini 등) 반영
@codex 기반 GitHub/Slack/Linear 통합 + Codex SDK/관리자 도구 문서 링크 보강
IDE 기능(Cloud delegation, 이미지 드래그&드롭) 최신 문서 링크 반영

영향 챕터

index.mdx
Ch1. 설치/로그인
Ch2. config.toml 설계
Ch5. 슬래시 커맨드 운영
Ch6. 프롬프트 설계
Ch9. IDE 확장
Ch10. MCP 연동
Ch11. 모델/추론 전략
Ch12. 거버넌스/롤아웃
verification.mdx

근거 링크(공식)

업데이트 기록 템플릿

아래 형식을 그대로 복사해 새 기록을 추가하세요.

### YYYY-MM-DD

**반영한 공식 변경(요약)**

- ...

**영향 챕터**

- ChX. ...

**근거 링크(공식)**

- https://developers.openai.com/codex/changelog

On this page

업데이트 내역

On this page