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

작업별 가이드

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

대화와 컨텍스트

Cmd. /clearCmd. /renameCmd. /archiveCmd. /deleteCmd. /compactCmd. /copyCmd. /memoriesCmd. /importCmd. /initCmd. /mentionCmd. /forkCmd. /sideCmd. /resumeCmd. /newCmd. /cdCmd. /exportCmd. /recap

계획과 실행

Cmd. /planCmd. /goalCmd. /psCmd. /stopCmd. /app

검토와 검증

Cmd. /review

모델과 설정

Cmd. /modelCmd. /fast

권한과 연결

Cmd. /permissionsCmd. /ideCmd. /setup-default-sandboxCmd. /sandbox-add-read-dirCmd. /pluginsCmd. /hooksCmd. /approveCmd. /skillsCmd. /mcp

상태와 진단

Cmd. /agentCmd. /appsCmd. /diffCmd. /feedbackCmd. /personalityCmd. /rawCmd. /statusCmd. /debug-configCmd. /title

화면과 입력

Cmd. /keymapCmd. /vimCmd. /experimentalCmd. /statuslineCmd. /themeCmd. /petsCmd. /voiceCmd. /worktree

계정과 사용량

Cmd. /exitCmd. /logoutCmd. /quitCmd. /usage

이전 명령

Cmd. /approvals

검증과 이력

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

릴리스 반영 이력

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

핵심 요약

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

현재 안내로 돌아가기

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건)

관련 문서

릴리스 반영 이력

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

업데이트 내역

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

검증 리포트

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

이전 검증 기록

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

업데이트 내역

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

핸드북 변경사항

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

이전 검증 기록

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

On this page

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