Codex 명령어 마스터
Codex CLI 슬래시 명령어를 기본 묶음과 심화 페이지로 정리한 실전 핸드북
최근 수정된 챕터
/fast·/compact·/resume·/archive·/statusline·/goal·/side를 묶어 긴 작업의 세션 연속성과 컨텍스트를 관리하는 운영 명령어 모음과 빠른 표
/mcp·/apps·/plugins·/permissions로 Codex의 MCP 서버·도구를 안전하게 운영하는 방법. 읽기 전용 도입과 승인 정책 동시 설계를 원칙으로 합니다.
Codex 명령어를 세션 운영·실행 제어·안전/권한·확장 연동·개인화 5개 역할로 분류하고, 기본 묶음과 심화 개별의 선택 기준을 정리합니다.
Codex의 멀티에이전트 작업 스레드와 상태를 관리하는 /agent 명령. 역할 파일 로드, 모델·추론 수준 표시, 에이전트 빠른 전환을 다룹니다.
진행 중인 CLI thread를 macOS·네이티브 Windows Codex Desktop으로 넘겨 같은 세션을 앱 UI에서 이어가는 /app 핸드오프 명령
이 핸드북은 Codex CLI 명령어를 빠르게 선택하고 정확히 적용하기 위한 실무 가이드입니다. 기본 명령어는 묶어서 설명하고, 실무 영향이 큰 명령어는 개별 심화 페이지로 분리했습니다.
기준 출처
OpenAI Codex 공식 slash commands 페이지를 기본 기준으로 삼고, slash docs보다 먼저 반영된 최신
명령은 official changelog/release로 보강했습니다. 2026-06-25 KST 검증 기준, 공식 최신 stable CLI는
v0.142.0 (2026-06-22) 입니다. npm alpha dist-tag에는 0.143.0-alpha.14가 있지만 팀 표준 기준은
stable/latest tag를 우선합니다.
v0.140.0~v0.142.0 업데이트 (2026-06-25)
- 새 공식 명령 3개 추가 —
/delete,/import,/usage를 공식 slash commands 표와 changelog 기준으로 개별 페이지에 반영 - 세션 삭제/보존 분리 —
/delete는 current transcript와 spawned descendant session을 영구 삭제하므로/archive와 보존 정책을 분리 - Claude Code import —
/import로 Claude Code 설정·프로젝트 파일·최근 채팅을 Codex configuration/local files로 가져오되, import 후/diff와/debug-config를 필수 점검 - 사용량 점검 —
/usage daily|weekly|cumulative와 earned rate-limit reset을 장기/goal·multi-agent 실행 전 점검 루틴에 추가 - 운영 변화 반영 — indexed web search mode, plugin organization, rollout token budgets, multi-agent delegation modes, UTC scheduled reminders/current-time handling, TUI disconnect 복구를 overview/검증 기준에 반영
v0.138.0~v0.139.0 업데이트 (2026-06-12)
/app추가 — 0.138.0 changelog 기준 현재 CLI thread를 macOS/Windows Codex Desktop으로 넘기는 release-tracked command를 개별 페이지로 추가- code mode/MCP 호환성 보강 — 0.139.0의 standalone web search 호출, MCP tool input schema의
oneOf/allOf보존, 큰 schema compaction 개선을 exec/MCP 운영 기준에 반영 - 진단 표준 갱신 —
codex doctor가 editor/pager environment를 로컬 리포트에 포함하고 JSON에서는 raw value를 redaction하는 흐름을 setup/검증 기준에 추가 - plugin marketplace 자동화 보강 — plugin add/remove/marketplace 명령의
--json,codex plugin list --available --json, marketplace source JSON,marketplace install/upgrade흐름을/plugins에 반영 - app-server/debug 보강 — account token usage 조회, ChatGPT v2 personal access token,
codex debug app-server send-message-v2복구를 자동화/검증 문맥에 반영 - 모델/입력 UX 보강 — reasoning effort fallback shortcuts, 모델이 광고한 effort 순서 반영, 이미지 첨부/생성 파일 path 노출을
/model과 앱/exec 운영에 연결 - 안전/상태 보강 — sandbox
-Ppermissions profile alias, network proxy enforcement,/debug-configeffective sandbox mode 표시,resume/fork --lastprompt 처리, MCP startup warning scoping, cloud-managed requirement 보존 반영
v0.133.0~v0.137.0 업데이트 (2026-06-08)
/archive추가 — 0.136.0 release 기준 TUI/archive와 CLIcodex archive/codex unarchive를 개별 페이지로 추가- 권한/프로필 갱신 —
/permissions가 named permission profiles와 custom profiles를 표시하고,--profile은 별도 profile file 기반으로 전환 - app-server/remote 보강 —
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 반영 - 운영 UX 보강 — richer
codex doctor, remote/status, F13-F24 keybindings, searchable menu paste, reasoning-only status/title item 반영
v0.131.0~v0.132.0 업데이트 (2026-05-21)
- 공식 slash inventory 보강 —
/approve,/ide,/memories,/raw,/skills,/theme,/vim을 공식 문서 기준 개별 페이지로 추가 /vim승격 — 0.129.0 changelog-only preview에서 공식 slash commands 표준 명령으로 승격- CLI 0.132.0 —
codex exec resume --output-schema, Python SDK auth/turn API, original-resolution image fidelity, goal continuation guardrail 반영 - CLI 0.131.0 —
codex doctor, 통합@picker(files/directories/plugins/skills), data-driven service-tier commands, remote-control daemon/API, plugin marketplace CLI와 version-aware sharing 반영 - 모델 기준 갱신 —
gpt-5.5가 ChatGPT 로그인과 API-key 인증 모두에서 Codex CLI/SDK·App/IDE에 지원되는 최신 frontier 기본값으로 재정리
v0.128.0~v0.130.0 업데이트 (2026-05-10)
/goal— 긴 작업의 persisted goal을 설정/조회/pause/resume/clear하는 공식 명령으로 반영/keymap— TUI shortcut을 context별로 점검하고config.toml에 저장하는 명령 추가/side— 공식 slash docs에 등재되어 임시 side conversation 표준 명령으로 승격/stop— background terminal 중지 명령 추가,/clean은 alias로 유지/hooks— 공식 slash docs와 2026-05-14 Hooks GA 기준으로 정식 명령 페이지 추가- changelog 우선 surface —
/vim은 2026-05-21 재검증에서 공식 slash 표준 명령으로 승격
빠른 진입
명령어 체계 먼저 보기
명령어 분류와 선택 기준
기본 묶음 먼저 익히기
/status, /clear, /copy, /new 같은 공통 기본기
심화 명령 바로 적용
권한/샌드박스/에이전트 운영부터 심화
참고 링크
- Codex slash commands: https://developers.openai.com/codex/cli/slash-commands
- Codex CLI features: https://developers.openai.com/codex/cli/features
- Codex changelog: https://developers.openai.com/codex/changelog
- Codex releases: https://github.com/openai/codex/releases
릴리즈 타임라인 확인
명령어별 “최초 추가 시점”과 “최초 언급 시점”은
/books/codex-command-master/verification에서 릴리즈 링크와 함께 확인할 수 있습니다.