업데이트 내역

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

최종 업데이트

2026년 5월 10일(KST) 기준

운영 원칙

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

최근 업데이트

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년 5월 10일(KST) 기준

운영 원칙

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

최근 업데이트

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

업데이트 내역

목차

업데이트 내역

목차