본문으로 바로가기
리옵트 핸드북
리옵트 핸드북
Codex 명령어 마스터표기와 명령 선택 기준상세 페이지 읽는 법전체 명령 목록터미널 CLI 명령·옵션 전체 참조

작업별 가이드

기본 명령어 묶음 (코어)기본 명령어 묶음 (세션 운영)커스텀 명령어 가이드MCP 명령/연동 가이드디자인 워크플로우

대화와 컨텍스트

Cmd. /archiveCmd. /copyCmd. /importCmd. /cd

계획과 실행

Cmd. /goalCmd. /app

모델과 설정

Cmd. /model

권한과 연결

Cmd. /pluginsCmd. /hooksCmd. /mcp

화면과 입력

Cmd. /statuslineCmd. /tuiCmd. /worktreeCmd. /voice

계정과 사용량

Cmd. /usage

검증과 이력

현재 검증 범위핸드북 변경사항릴리스 반영 이력이전 검증 기록명령별 변경 기록
핸드북›Codex 명령어 마스터›릴리스 반영 이력
한국어KOEnglishEN

릴리스 반영 이력

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

2026-10-23 · Codex CLI 0.163.0

안정판 **0.163.0(2026-10-15)**과 Developer Commands를 대조했습니다. npm latest=0.163.0, alpha=0.164.0-alpha.12입니다. alpha 변경은 안정판 사용법으로 반영하지 않습니다.

  • 설정·입력: /config 검색 패널에서 지원 설정을 즉시 바꾸고 재시작 필요 여부를 확인합니다. 응답 도중 보낸 후속 입력은 기본으로 즉시 전달되며, turn을 중단하면 실행 중인 Code Mode cell과 중첩 도구 호출도 중단됩니다.
  • 단축키·서버: /keymap의 기본 leader는 Ctrl+X이고 힌트는 선택·취소까지 유지됩니다. 음성 음소거는 F9로 이동했습니다. /daemon에서 managed background server를 재시작하면 중단될 작업을 알린 뒤 자동 재연결합니다.
  • 권한·Daybreak: 재개 시 저장된 권한과 네트워크 승인을 복원하되 명시적 override·현재 managed policy가 우선합니다. Daybreak는 적격 계정에서 기본 활성화되어 0.161.0의 opt-in 안내를 대체합니다. 서버가 허용하면 OpenAI API key로 인증한 codex exec에서도 프로그램을 지정할 수 있습니다.
  • 실행·복구: 서로 독립적인 읽기 전용 도구(스킬·메모리·대화 이력 조회 포함)를 병렬 실행할 수 있습니다. /side가 스레드 전환 뒤에도 기존 side 대화로 돌아가고 보류 질문의 답은 질문한 스레드로 전달됩니다. Windows 텍스트 붙여넣기·WSL clipboard timeout, 프로세스 종료 후 열린 pipe·원격 마지막 출력 회수도 수정됐습니다.
  • 호환성: patched zsh 번들이 제거됐으며 이전 shell flag 설정에는 이전 안내가 나옵니다. Linux sandbox 설명은 bubblewrap 파일시스템 격리와 seccomp 필터 기준으로 바뀌었습니다. proxy는 DNS 조회 전 권한을 검사하고 중복 Host 헤더·credential alias 우회를 차단합니다.
  • 공식 표 재검증: slash 표는 50→57행입니다. /agents(서버 command center)와 /subagents(하위 스레드)가 분리됐고 /tui·/export·/recap·/cd·/pwd(/cwd)·/worktree·/daemon·/warnings가 등재됐습니다. /agent·/personality·/sandbox-add-read-dir는 현재 표에 없어 이전 앵커를 보존하고 상태를 구분했습니다. CLI overview는 27→29행으로 codex agents·codex queue가 추가됐습니다. global·exec 옵션 변경과 Linux sandbox 표도 반영했습니다. /config·/voice는 여전히 릴리스 근거로 추적합니다.
  • GPT-5.5 종료 완료: 2026-10-14 19:00 UTC(한국 10-15 04:00)부터 ChatGPT 로그인 Codex에서 종료됐습니다. 플랜·클라이언트에서 제공되는 GPT-6.1 Sol(gpt-6.1-sol) 등으로 저장 설정·custom agent·scheduled task·스크립트를 갱신합니다. OpenAI API와 API-key 인증 Codex는 영향받지 않습니다.

근거: 0.163.0 릴리스, Developer Commands, 공식 Changelog, Models, npm dist-tags.

핵심 요약

  • 이 페이지는 이전 검증 당시의 기록입니다. 지원 상태와 현재 사용법은 개별 명령 페이지와 전체 목록을 기준으로 확인하세요. 과거의 “최소 지원 버전” 기록은 도입 버전을 새로 보증하지 않습니다.

현재 안내로 돌아가기

2026-10-10 CLI 0.161.0~0.162.1 반영

Developer Commands의 CLI 슬래시 표 50개 항목과 터미널 명령 표 27개 항목을 다시 대조했고, 10-07 대조 이후 키·값 변동은 없습니다. 릴리스 기준은 0.162.1 (2026-10-09), npm latest=0.162.1, alpha=0.163.0-alpha.5입니다. 공식 Changelog 페이지가 ChatGPT·Codex 통합 changelog로 개편되어 Codex CLI 버전 번호를 싣지 않으므로, 이번부터 CLI 릴리스는 GitHub 릴리스와 npm으로 추적합니다. 아래 추가 사항은 릴리스 노트 기준이고 공식 표에는 아직 없습니다.

  • 0.161.0 (2026-10-07): /mcp login <name>으로 실행 중인 터미널 세션에서 MCP 서버에 로그인합니다. 음성 대화에 쓸 마이크·스피커·마이크 입력 채널을 고를 수 있고 선택은 로컬에 저장됩니다. Daybreak가 opt-in이 되어 --enable cli_daybreak나 features.cli_daybreak = true를 켜지 않으면 컨트롤과 표시가 숨겨지고 /daybreak를 쓸 수 없으며 자동 Cyber routing이 빠집니다. codex exec --cyber-access-program과 TypeScript SDK의 cyberAccessProgram 옵션으로 turn 단위 Cyber access program을 고릅니다. 릴리스 노트는 GPT-6.1 Sol을 번들·Amazon Bedrock 카탈로그의 기본 모델로 다시 적었고, Bedrock의 multi-agent V2·Ultra reasoning과 Bedrock Mantle의 AWS GovCloud 리전 지원을 추가했습니다. 승인된 파일시스템 escalation의 쓰기 범위, background task의 권한 유지, 실행할 때 명시한 권한의 재연결 뒤 유지가 수정됐습니다. 인증 안내는 자격 증명이 항상 auth.json에 있다고 전제하지 않고 keyring 저장을 함께 다룹니다.
  • 0.162.0 (2026-10-08): /copy가 transcript 블록 사이를 이동하며 복사하고, Ctrl+Insert가 선택 영역을 복사하며, tui.mouse_scroll_speed로 마우스 휠 스크롤 속도를 조정합니다. agent Command Center에서 p로 task를 고정하고, 서버가 지원하면 고정한 task가 공유 Pinned 그룹에 유지됩니다. worktrees 기능이 켜진 신뢰된 로컬 프로젝트에서 managed Git worktree를 만들고 조회하는 도구가 추가됐습니다. 승인 헤더·질문·MCP 프롬프트·경고·배너·verification 프롬프트의 URL은 줄이 바뀐 링크까지 클릭할 수 있습니다. Responses 호환 custom model provider에 live web access와 remote compaction capability를 설정할 수 있고, Windows 릴리스에 서명된 PowerShell installer가 게시됩니다.
  • 0.162.1 (2026-10-09): 여러 줄 비동기 질문에서 TUI가 비정상 종료하던 문제와, 실행 중인 background server의 feature 설정이 CLI 기본값과 달라 시작에 실패하던 문제를 고쳤습니다. 명령 변경은 없습니다.
  • 모델 일정: GPT-5.5의 2026-10-14 종료 일정은 그대로입니다. 공식 Models 문서는 GPT-6.1 Sol의 Ultrafast를 Pro $500과 대상 Enterprise·Edu 플랜에서 제공한다고 적습니다.

/mcp · /copy · /voice · /worktree · /agent

근거: Developer Commands, Models, rust-v0.161.0, rust-v0.162.0, rust-v0.162.1.

2026-10-07 CLI 0.158.0~0.160.1 반영

Developer Commands의 CLI 슬래시 표 50개 항목과 터미널 명령 표 27개 항목을 다시 대조했습니다. 명령·옵션 구성은 그대로이고 /model 설명과 --model 예시(gpt-6.1-sol)만 바뀌었습니다. 릴리스 기준은 0.160.1 (2026-10-05), npm latest=0.160.1, alpha=0.162.0-alpha.18입니다.

  • 0.158.0 (2026-09-28): fullscreen TUI에 tui.copy_on_select(auto·always·never)와 tui.right_click_paste(auto·on·off) 설정이 생겼고, 복사한 transcript 선택 영역이 Markdown 서식을 유지합니다. codex mcp add --oauth-client-secret으로 사전 등록 OAuth client secret이 필요한 MCP 서버에 연결할 수 있습니다. 권한이 상승된 명령의 터미널 입력 승인(write_stdin_approval)이 기본으로 켜졌고, /ps는 여러 줄 명령을 미리보기에 표시합니다. exec-server의 직접 WebSocket 연결은 bearer token으로 보호할 수 있습니다. 번들 카탈로그에서 GPT-5.4가 빠졌습니다.
  • 0.159.0 (2026-09-29): opt-in instant_interrupt feature flag를 켜면 모델 응답이나 긴 code-mode 호출 도중에 새 입력이 바로 전달됩니다. 새 세션은 간결한 시작 화면을 쓰고, 경고 viewer는 닫을 때 확인한 경고를 지우며 k로 남겨 둘 수 있습니다. 계획 실행 여부를 고르는 동안 transcript를 스크롤할 수 있습니다. writable root 아래의 .aws 디렉터리가 기본 보호 대상에 들어갔습니다. 자동 후속 프롬프트 제안과 tui.prompt_suggestions 설정, 번들 plugin-creator 스킬은 제거됐습니다.
  • 0.159.1 (2026-09-29): GPT-6.1 Sol(gpt-6.1-sol)이 번들 카탈로그와 Amazon Bedrock Mantle·Runtime 카탈로그의 기본 모델이 됐습니다.
  • 0.159.20.159.3 (2026-09-2909-30): Windows에서 background process와 sandbox 명령이 콘솔 창을 띄우던 문제를 고쳤고, ChatGPT로 로그인한 로컬 세션에 계정 보안 설정 안내가 표시될 수 있습니다.
  • 0.160.0 (2026-10-01): agent command center에서 "Show more"로 이전 task를 더 불러옵니다. 로컬 Linux X11 터미널의 fullscreen 모드는 가운데 클릭 붙여넣기를 지원합니다. 프로젝트 밖(projectless) 세션은 정책이 허용할 때 workspace 기본 권한으로 시작하고, 재개할 때 저장된 권한을 복원합니다. /cd는 folder trust를 묻고 "Keep current directory" 선택지를 줍니다. Guardian 리뷰가 이전 사용자 지시를 조회하고 agent handoff 맥락을 참고하는 opt-in 기능도 추가됐습니다.
  • 0.160.1 (2026-10-05): 원격 stdio MCP 서버를 띄울 때 SYSTEMROOT·TEMP·TMP를 유지하는 Windows 수정입니다. 명령 변경은 없습니다.
  • 모델 일정: GPT-5.5의 2026-10-14 종료 일정은 그대로입니다. 공식 Models 문서는 GPT-6.1 Sol을 추천 모델로 올렸지만 GPT-5.5 대체 안내는 여전히 GPT-6 Sol입니다.

GPT-6.1 Sol · /tui · /mcp · /permissions

근거: Developer Commands, 공식 Changelog, Models, GPT-6.1 Sol, rust-v0.158.0, rust-v0.159.0, rust-v0.159.1, rust-v0.160.0.

2026-09-26 CLI 0.156.0~0.157.1 반영

Developer Commands의 CLI 슬래시 표 50개 항목과 터미널 명령 표 27개 항목을 다시 대조했습니다. 명령·옵션 구성은 그대로이고 /model·/diff·/app·/import 설명과 --model 예시(gpt-6-sol)만 바뀌었습니다. 릴리스 기준은 0.157.1 (2026-09-26), npm latest=0.157.1, alpha=0.159.0-alpha.4입니다.

  • 0.156.0 (2026-09-22): /tui로 다음 실행의 fullscreen UI를 고를 수 있습니다. 음성 대화가 기본 활성화되어 F8 토글과 /voice settings가 생겼고 Linux·Windows 오디오 런타임이 번들됩니다. /usage가 분석 대시보드로 바뀌고, worktree 지원이 기본 활성화됐습니다. 터미널 테마 6종, Mermaid·수식 표시, /daemon 메뉴와 --no-daemon이 추가됐습니다. friendly·pragmatic personality 설정은 더 이상 응답 스타일을 고르지 않습니다.
  • 0.156.1 (2026-09-23): model picker에서 GPT-6 Sol·GPT-6 Luna를 고를 수 있고, rate-limit 전환 안내는 GPT-6 Luna를 권합니다.
  • 0.157.0 (2026-09-25): GPT-6 Sol·Luna의 Amazon Bedrock 지원과 이전 모델용 migration prompt, fullscreen transcript 기본값과 Shift-클릭 선택 확장, 대상 대화형 세션의 background server 자동 시작, 다른 앱에서 열린 대화를 f로 fork, remote·background-server 세션의 /import를 추가했습니다.
  • 0.157.1 (2026-09-26): 릴리스 노트에 변경 요약이 없어 명령 영향이 확인되지 않았습니다.
  • 모델 일정: GPT-5.5는 2026-10-14 ChatGPT·ChatGPT Work·Codex(ChatGPT 로그인)에서 종료됩니다. OpenAI API에는 적용되지 않습니다.

GPT-6 Sol·Luna · /tui · /daemon · 음성 대화

근거: Developer Commands, 공식 Changelog, Models, rust-v0.156.0, rust-v0.157.0.

2026-09-22 공식 명령 재검증

공식 Developer Commands의 CLI 슬래시 표 50개 항목과 터미널 명령 표 27개 항목, 공통·명령별 옵션 표를 대조했습니다. 릴리스 기준은 **0.155.1 (2026-09-18)**입니다. 아래 과거 npm 채널 값은 당시 기록입니다.

  • 0.155.0 /voice: 지원 빌드에서 /experimental로 켜는 실험적 음성 대화입니다. 실시간 transcript와 마이크 제어를 제공합니다. 공식 슬래시 표에는 아직 없어 릴리스 추적 명령으로 분리했습니다.
  • daemon: codex app-server daemon update와 업데이트 일정 설정이 추가됐습니다. daemon 재시작 뒤 저장된 thread와 active goal을 복구할 수 있습니다.
  • 세션·MCP: agents 화면의 hide/archive/delete, managed worktree 소유 정보·삭제 확인, 지원 Mac의 MCP Touch ID 확인을 반영했습니다.
  • 0.155.1: 새 로컬 TUI 세션의 reasoning summary는 기본 비활성입니다. 명시적으로 지정한 설정은 유지됩니다. 0.155.0의 실시간 reasoning 표시와 기본 설정을 구분합니다.

전체 슬래시 명령 · 터미널 CLI 참조 · 음성 대화

근거: Developer Commands, 공식 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-09-05 (CLI 0.152.0~0.153.4 + GPT-6 Astra)

  • npm 기준을 latest=0.153.4, alpha=0.154.0-alpha.3으로 갱신하고 로컬 CLI 0.153.4로 교차 확인
  • **GPT-6 Astra(2026-09-03)**를 /model의 최상위 모델로 반영. 최소 CLI 0.153.0, 0.153.4부터 모델 미지정 세션의 bundled 기본값, 1.05M 컨텍스트·128K 출력·API $10/$1/$50, 지식 기준일 2026-04-30, 사이버보안 Critical 등급 경고를 한·영 /model 페이지에 추가
  • 0.152.0 planning tool 기본 비활성화(tools.update_plan.enabled)를 기준점 표에 반영. /plan 슬래시 명령과 다른 개념임을 명시
  • tui.auto_recap, plugin CLI의 원격 marketplace 관리, Vim undo/redo, Plus·Team 조기 사용량 경고, Full Access의 확인 전용 동작 Guardian 리뷰 생략(0.153.0)을 기준점 표에 반영
  • MCP 서버 이름의 :·@·/·. 허용과 tool별 output_token_limit, rate-limit 배너 액션(0.152.0)을 /mcp·/usage 기준에 반영
  • 공식 Codex 문서가 developers.openai.com/codex/* → learn.chatgpt.com/docs/*로 이전된 사실을 기준 출처 Callout에 기록(기존 링크는 308 리다이렉트로 도달)

2026-08-30 (CLI 0.151.0)

  • npm 기준을 latest=0.151.0, alpha=0.152.0-alpha.4로 갱신하고 공식 0.151.0 changelog를 전수 반영
  • Optional MCP discovery grace, extension MCP 결과 interception, 구조화 오류 보존을 /mcp에 추가
  • Repository별 plugin catalog, invalid marketplace 독립 보고를 /plugins 공급망 기준에 추가
  • permission profile 지속, stale Guardian 판정 폐기, remote executor path sandbox를 /permissions·/cd에 반영
  • 모델 전환/fallback tool·reasoning 정합성과 nested subagent root goal budget을 /model·/goal에 반영
  • 공식 표의 /clear 한·영 독립 페이지를 추가하고 /clear [name]을 /clear와 /new [name]으로 수정

2026-08-28 (CLI 0.149.0~0.150.1)

  • npm 기준 latest=0.150.1, alpha=0.151.0-alpha.6로 갱신하고 공식 0.149.0~0.150.1 changelog 반영
  • codex agents, codex queue, task @ 멘션, /cd·/pwd·/cwd를 세션·에이전트 운영에 추가하고 /cd 한·영 개별 페이지와 checker parity 추가
  • /copy picker, 자동 task title과 /rename 제안, clickable Markdown link, permission/Vim UX, Interrupt hooks 반영
  • untrusted project AGENTS.md, managed deny-read, diagnostic redaction, MCP·Windows·shutdown·Bedrock·remote compaction 수정과 mcp-server deprecation 반영

2026-08-20 (CLI 0.147.0~0.148.0)

  • npm 기준 latest=0.148.0, alpha=0.149.0-alpha.4로 갱신하고 공식 0.147.0·0.148.0 changelog를 반영
  • 전체 TUI 대화를 Markdown clipboard/file로 내보내는 /export 한·영 개별 페이지와 checker parity 추가
  • codex exec fork, resume picker archive/restore, 시작 중 prompt 작성, /status 예상 credit/cost를 session·exec 명령에 반영
  • portable Agent Plugins, --approve-for-me, Cursor skill/conversation import, MCP 2026-07-28 opt-in, built-in Bedrock provider, async/MCP hooks를 관련 페이지에 반영
  • codex exec --full-auto 제거와 secret redaction, OAuth/reconnect, plugin/network isolation, sandbox fail-closed 수정을 운영 기준에 추가
  • 모델 기본값을 GPT-5.6 Sol/Terra/Luna로 전환하고 GPT-5.4·mini의 2026-08-31 ChatGPT 로그인 종료를 반영

2026-08-03

  • 공식 GitHub Releases, 로컬 CLI, npm dist-tag를 재확인해 stable/latest 기준이 여전히 0.146.0임을 기록
  • 최신 공식 slash reference 기준 개별 페이지 4개 추가: /copy, /rename, /pets(/pet), Windows 전용 /setup-default-sandbox
  • /app을 release-tracked-only에서 공식 reference 등재 명령으로 갱신
  • /agent의 /subagents, /side의 /btw 별칭을 한·영판에 반영
  • meta.json과 check-codex-command-master.mjs를 확장해 신규 4개 페이지의 한·영 파일·순서·구문 parity를 검증

2026-08-01

  • GitHub Releases, 로컬 CLI, npm dist-tag 기준 최신 stable/latest를 v0.146.0, latest=0.146.0, alpha=0.147.0-alpha.4로 갱신
  • /new [name]·/clear [name], thread pinning, side conversation 전환, paginated history/fork와 ephemeral fork 비노출을 반영
  • /import를 Cursor·Claude Code settings/MCP/plugins/sessions/commands/project memories 범위로 확장
  • /plugins에 Agent Plugin manifest, workspace publish, Amazon Bedrock·Claude Code marketplace를 추가
  • /mcp에 auth/config/plugin 변경 후 live connection·App tool refresh와 proxy smoke test를 추가
  • replay/import/fork metadata 보존, Multi-agent V2, remote Code Mode, custom-provider web search, executor-provided skills 변경을 overview/verification에 반영

2026-07-12

  • 공식 Figma designs to code와 User stories to UI mocks use case를 기준으로 한·영 design-workflows 페이지 추가
  • /plugins, /skills, /mcp, /apps, /ide, /permissions, /diff, /review를 Figma·ImageGen·Playwright·Build Web Apps 흐름으로 연결
  • Figma MCP의 get_design_context, get_metadata, get_screenshot 확인 절차와 /mcp verbose fallback 추가
  • $imagegen 목업 → 새 Codex 작업에 이미지 재첨부 → Build Web Apps 구현 → $playwright 브라우저 검증 루프 추가
  • 별도 /design 슬래시 명령이 아니라 Skill·Plugin·MCP 조합이라는 제품 경계를 명시

2026-07-10

  • GitHub Releases와 npm dist-tag 기준 최신 stable/latest CLI를 v0.144.0으로 갱신하고 latest=0.144.0, alpha=0.145.0-alpha.1 교차 확인
  • /plugins에 remote plugin 기본 활성화, npm marketplace source, local/remote version 표시를 추가
  • /mcp에 tool search 기본화, ChatGPT-hosted session auth, interactive auth 기본화를 추가
  • /permissions에 app approval writes 모드를, /usage에 reset-credit 유형·만료·선택을 추가
  • /review에 대규모 repo branch picker 성능과 auto-review prompt/tool-set 보강을 추가
  • system proxy, codex remote-control pair, compaction·Windows sandbox·TUI sanitization·connector auth 안정성을 overview/verification에 반영

2026-07-01

  • GitHub Releases와 npm dist-tag 기준 최신 stable/latest CLI를 v0.142.5(2026-07-01)로 갱신하고, npm latest=0.142.5, alpha=0.143.0-alpha.31을 교차 확인
  • 0.142.5는 Responses WebSocket request payload 전체가 trace log에 기록되지 않도록 하는 bug fix로 분류하고, /delete, /import, /usage 등 명령 기능 기준은 0.140.0~0.142.0 설명을 유지
  • index, verification, 책장 요약(books-data.ts, home-server.ts)의 최신 stable/latest 표기를 0.142.5로 동기화

2026-06-25

  • 공식 Codex changelog와 slash commands 문서 기준 최신 stable CLI를 v0.142.0(2026-06-22)으로 갱신하고, npm dist-tag에서 latest=0.142.0, alpha=0.143.0-alpha.14를 교차 확인
  • 공식 slash commands 표에 추가된 /delete, /import, /usage 개별 페이지를 한글/영문 양쪽에 추가하고 meta.json, command inventory 검사 스크립트에 반영
  • /delete는 /archive와 구분해 current transcript와 spawned descendant session 영구 삭제, 실행 중 task/side conversation 제약, 보존 정책 확인을 문서화
  • /import는 Claude Code setup/project files/recent chats import 흐름과 local TUI 제약, import 후 /diff·/debug-config 검토 기준을 추가
  • /usage는 daily/weekly/cumulative token activity와 earned rate-limit reset을 장기 /goal·multi-agent 실행 전 점검 루틴으로 추가
  • 0.140.0~0.142.0의 plugin organization, rollout token budgets, indexed web search mode, scheduled UTC reminders/current-time handling, multi-agent delegation modes, TUI disconnect 복구를 overview와 verification에 반영

2026-06-12

  • 공식 Codex changelog 기준 최신 CLI를 v0.139.0(2026-06-09)으로 갱신
  • 0.138.0 changelog 기준 /app 개별 페이지 추가, 현재 CLI thread를 Codex Desktop으로 넘기는 handoff 흐름 반영
  • 공식 slash commands 문서를 다시 대조해 /archive가 공식 표에 등재된 상태로 보정하고, /app은 release-tracked command로 표시
  • 0.139.0의 code mode standalone web search, MCP schema oneOf/allOf 보존, large schema compaction 개선을 exec/MCP 운영 맥락에 반영
  • codex doctor editor/pager environment diagnostics와 JSON raw value redaction을 진단 기준에 추가
  • codex plugin add/remove --json, codex plugin list --available --json, marketplace source JSON, codex plugin marketplace install/upgrade 운영 포인트를 /plugins에 반영
  • app-server account token usage, ChatGPT v2 personal access token, codex debug app-server send-message-v2 복구를 command 운영/검증 문맥에 반영
  • reasoning effort fallback shortcuts, 모델 광고 순서 반영, 이미지 첨부/생성 파일 path 노출, resume/fork --last prompt 처리, MCP startup warning scoping, cloud-managed requirement 보존, sandbox -P permissions profile alias, effective sandbox mode 진단을 overview와 관련 페이지에 반영
  • 검증 스크립트의 command inventory parity 목록에 /app 추가

2026-06-08

  • 공식 GitHub release 기준 최신 CLI를 v0.137.0(2026-06-04)으로 갱신
  • 0.136.0 release 기준 /archive 개별 페이지 추가, codex archive / codex unarchive 흐름 반영
  • /permissions named permission profiles, --profile 파일 기반 migration, richer codex doctor, remote /status 보강 반영
  • codex app-server --stdio, thread archive/unarchive events, remote-control pairing/grant RPC를 관련 설명에 반영
  • codex plugin list --json, cached remote catalog suggestions, Multi-agent v2 runtime metadata, F13-F24 keybindings, searchable menu paste 반영
  • 검증 스크립트의 command inventory parity 목록에 /archive 추가

2026-05-21

  • 공식 Codex changelog 기준 최신 CLI를 v0.132.0(2026-05-20)으로 갱신
  • 공식 slash commands 문서를 다시 대조해 /approve, /ide, /memories, /raw, /skills, /theme, /vim 개별 페이지 추가
  • /vim을 changelog-only preview에서 공식 표준 명령으로 승격
  • codex doctor, 통합 @ picker(files/directories/plugins/skills), data-driven service-tier commands, remote-control daemon/API, plugin marketplace CLI, version-aware sharing 반영
  • codex exec resume --output-schema, Python SDK auth/turn API, original-resolution image fidelity, goal continuation guardrail 반영
  • gpt-5.5가 ChatGPT 로그인과 API-key 인증 모두에서 Codex CLI/SDK·App/IDE에 지원되는 것으로 모델 기준 갱신
  • 검증 스크립트의 command inventory parity 목록을 최신 공식 명령 페이지에 맞게 확장

2026-05-17

  • 공식 slash commands 문서와 2026-05-14 Codex changelog를 다시 대조
  • /hooks를 changelog-only preview에서 공식 표준 명령으로 승격하고 개별 페이지 추가
  • Hooks GA, features.hooks, plugin-bundled hooks opt-in, managed hook 제약을 반영
  • 영어판 codex-command-master를 같은 구조로 추가
  • 검증 스크립트를 한글/영문 공통 검사와 command inventory parity 검사까지 확장
  • 영어판 /model, /plugins, /resume, verification, updates를 요약 번역에서 운영 세부 번역으로 보강
  • verification 기준일을 2026-05-17 KST로 갱신

2026-05-10

  • 기준 버전을 v0.130.0으로 갱신
  • 공식 slash commands 문서 기준 /goal, /keymap, /side, /stop 개별 페이지 추가
  • /side를 changelog-only 추적 항목에서 공식 표준 명령으로 승격
  • /stop을 /clean alias보다 우선하는 팀 표준 표기로 반영
  • /hooks와 /vim은 0.129.0 changelog에는 있지만 공식 slash 표에는 아직 없어 preview 항목으로 verification에 남김
  • /model 페이지를 공식 Codex Models 문서 기준으로 재검증해 gpt-5.5-codex, gpt-5.5-mini, gpt-5.5-nano 참조를 제거
  • verification 기준일과 릴리즈 스캔 범위를 rust-v0.130.0까지 확장

2026-04-26

  • 기준 버전을 v0.125.0으로 갱신
  • \u002fmcp verbose와 latest changelog 기준 MCP 진단 흐름을 반영
  • \u002fpermissions의 side-conversation 정합성과 approval review 연결 메모를 추가
  • \u002fresume의 current/archived thread hinting, large-thread pagination 보강을 반영
  • \u002fstatusline·\u002ftitle normalized item 메모를 추가
  • \u002fplugins에 remote marketplace read/list, remote plugin install/upgrade 반영
  • verification 기준일과 릴리즈 스캔 범위를 rust-v0.125.0까지 확장

2026-04-22

  • 기준 버전을 v0.122.0으로 갱신
  • 실행 중 queued input에 slash command와 ! shell prompt를 넣을 수 있는 흐름 반영
  • composer의 Ctrl+R reverse search와 accepted slash command local recall 반영
  • /plugins에 marketplace source 확장과 tabbed workflow 보강 반영
  • changelog에만 있는 /side는 공식 slash docs 미등재 상태로 유지한다는 검증 메모 추가
  • verification 기준일과 릴리즈 스캔 범위를 rust-v0.122.0까지 확장

2026-04-15

  • 기준 버전을 v0.120.0으로 갱신
  • /resume에 session ID/name 직접 점프와 picker 안정화 반영
  • /copy의 Ctrl+O 단축키와 클립보드 안정성 개선 반영
  • /status의 stale quota refresh 동작 반영
  • /statusline의 renamed thread title 지원 반영
  • verification 기준일과 릴리즈 스캔 범위를 rust-v0.120.0까지 확장

2026-04-08

  • slash commands 페이지 + official changelog/release를 다시 대조해 기준점을 v0.118.0으로 갱신
  • /fast, /clear, /copy를 현재 공식 목록 기준으로 기본 묶음에 반영
  • /plugins, /title 신규 페이지 추가
  • /approvals를 alias 상태로 재정리하고 /permissions를 기본 표기로 통일
  • /model에 2026-04-07 ChatGPT 로그인 모델 가용성 업데이트 반영
  • verification 표에 /clear, /copy, /fast, /plugins, /title 도입 시점 추가

2026-03-25

  • v0.116.0 릴리즈 반영: ChatGPT device-code 로그인 (App-server TUI)
  • userpromptsubmit 훅 추가 — 프롬프트 실행 전 차단/보강
  • 플러그인 설치 프롬프트 — 누락 플러그인 자동 제안, suggestion allowlist, 원격 동기화
  • Realtime 세션에 최근 스레드 컨텍스트 포함, 오디오 자기중단 감소
  • WebSocket prewarm 첫 턴 지연 수정, Linux 샌드박스 시작 안정성 개선
  • 원격 resume/fork 대화 히스토리 복원 수정

2026-03-01

  • 신규 도서 Codex 명령어 마스터 생성
  • 기본 묶음 2개 + 심화 명령어 26개 구성
  • 확장/운영 페이지 추가
  • 공식 slash commands 기준으로 명령어 목록 반영
  • openai/codex 릴리즈 553건을 스캔해 명령어별 도입 시점(추가 확인/최초 언급/미확인) 표를 추가
  • 명령어별 릴리즈 노트 상세 링크(태그 URL) 연결

2026-03-03

  • 공식 slash-command Type ... 기준으로 개별 명령어 문법 블록 정밀화
  • /sandbox-add-read-dir, /logout, /mention, /quit 도입 근거를 릴리즈/PR 기준으로 보강
  • Codex 명령어 페이지 자동 점검 스크립트 추가(apps/handbook/scripts/check-codex-command-master.mjs)

2026-03-17

  • v0.115.0 릴리즈 반영: view_image 풀해상도 이미지 검사 도구
  • JS REPL에 codex.cwd/codex.homeDir 노출, 셀 간 persistent tool references
  • App-server filesystem RPCs (file/read, file/write, file/copy), 새 Python SDK
  • Smart Approvals guardian subagent 기반 라우팅
  • wait_agent 도구 이름 변경 (기존 wait에서 변경)
  • Realtime WebSocket transcription 모드, v2 handoff 지원
  • 릴리즈 스캔 범위를 rust-v0.115.0까지 확장

2026-03-13

  • v0.114.0 릴리즈 반영: GPT-5.4 기본 모델 변경 (/model)
  • Code Mode 실험 기능 추가 (/experimental)
  • 에이전트 역할 파일·TUI 표시·키보드 전환 지원 (/agent)
  • 승인 정책 명칭 "reject" → "granular" 변경 (/permissions)
  • Bubblewrap 기본 샌드박스·훅 엔진 도입 (overview)
  • 릴리즈 스캔 범위를 rust-v0.114.0까지 확장
  • 2차 검증 리포트 추가 (6항목 + 외부 출처 3건)

관련 문서

검증 리포트

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

업데이트 내역

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

이전 검증 기록

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

릴리스 반영 이력

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

핸드북 변경사항

Codex CLI: 최근 핸드북 구조 개선 내용을 확인하고 날짜별 릴리스·검증 기록으로 이동하는 변경 안내입니다.

On this page

2026-10-23 · Codex CLI 0.163.02026-10-10 CLI 0.161.0~0.162.1 반영2026-10-07 CLI 0.158.0~0.160.1 반영2026-09-26 CLI 0.156.0~0.157.1 반영2026-09-22 공식 명령 재검증2026-09-12 최신 변경2026-09-05 (CLI 0.152.0~0.153.4 + GPT-6 Astra)2026-08-30 (CLI 0.151.0)2026-08-28 (CLI 0.149.0~0.150.1)2026-08-20 (CLI 0.147.0~0.148.0)2026-08-032026-08-012026-07-122026-07-102026-07-012026-06-252026-06-122026-06-082026-05-212026-05-172026-05-102026-04-262026-04-222026-04-152026-04-082026-03-252026-03-012026-03-032026-03-172026-03-13