Codex CLI의 / 메뉴는 외울 목록이 아니라 현재 세션을 조작하는 도구다. 2026년 8월 31일 공식 Developer commands 문서와 로컬 설치본 codex-cli 0.146.0을 확인했다. 명령은 버전·운영체제·활성 기능에 따라 달라질 수 있으므로 실제 기준은 /를 입력했을 때 보이는 메뉴다. 선택이 막히면 “권한, Git 변경, 대화 맥락, 저장된 세션 중 무엇을 바꾸려는가”부터 정한다.
목적별로 여덟 개만 먼저 익힌다
| 바꾸거나 확인할 대상 | 명령 | 판단 기준 |
|---|---|---|
| 실행 범위 | /status |
모델, 승인 정책, 쓰기 경로, 토큰 사용량 확인 |
| 승인 정책 | /permissions |
조사면 Read Only, 편집은 범위 확정 뒤 선택 |
| Git 변경 | /diff |
staged·unstaged·untracked 파일까지 검토 |
| 작업 검토 | /review |
동작 변화와 누락된 테스트를 다시 점검 |
| 긴 맥락 | /compact |
이전 대화를 요약해 컨텍스트 확보 |
| 과거 작업 | /resume |
저장된 대화를 그대로 이어감 |
| 대안 실험 | /fork |
현재 대화를 새 ID로 복제해 분기 |
| 짧은 우회 질문 | /side |
본 대화를 흐리지 않는 임시 대화 |
/permissions는 이후 행동의 승인 모드를 바꿀 뿐 저장소 규칙을 대신하지 않는다. 모드를 바꾼 다음 /status로 실제 정책과 writable roots를 다시 확인한다. 예상과 다른 설정이 적용됐다면 /debug-config로 구성 계층과 정책 출처를 확인한다. /diff는 Codex가 만든 수정만 보여 주는 것이 아니라 기존 사용자 변경도 함께 보여 줄 수 있으므로 예상 밖 파일부터 찾는다.
작업 단계에 맞춘 최소 흐름
조사만 할 때는 /status → /permissions(Read Only) → 작업 순서가 안전하다. 수정을 마친 뒤에는 /diff → 테스트 → /review → /diff로 닫는다. 리뷰가 “문제없음”이라고 해도 테스트 성공과 정확한 diff가 최종 근거다.
대화가 길어졌다면 먼저 목표, 확정 사실, 금지 변경, 남은 작업을 짧게 적고 /compact를 실행한다. 이 명령은 이전 대화를 요약하지만 파일을 저장하거나 커밋하지 않는다. 컨텍스트 정리와 Git 상태 정리를 같은 일로 착각하면 안 된다.
이어가기·분기·새 출발을 구분한다
어제의 맥락을 그대로 잇는다면 /resume, 현재 가설을 보존한 채 다른 해법을 시험한다면 /fork다. 저장된 과거 세션에서 바로 분기하려면 TUI의 /fork 대신 터미널에서 codex fork를 실행해 선택기를 연다. 짧은 검증 질문은 /side, 완전히 새 맥락은 /new를 사용한다. 화면까지 비우며 새 대화를 시작하려면 /clear를 쓴다. /clear는 단순 화면 지우기인 Ctrl+L과 달리 새 대화도 만든다.
삭제·종료 명령은 큐에 넣지 않는다
/archive는 현재 세션을 보관하고 종료하며 transcript를 남긴다. /quit과 /exit는 CLI만 종료한다. 반면 /delete는 현재 transcript와 그 아래에서 생성된 세션을 영구 삭제한다. 따라서 정리의 기본값은 /rename 후 /archive이고, /delete는 복구할 기록이 없음을 확인한 경우에만 쓴다.
작업 중 슬래시 명령을 입력하고 Tab을 누르면 다음 턴으로 큐에 넣을 수 있다. 공식 문서에 따르면 큐의 명령은 현재 턴이 끝난 뒤 파싱된다. /permissions, /archive, /delete처럼 권한·종료·삭제 상태를 바꾸는 명령은 큐에 넣지 말고 실행이 끝난 뒤 화면을 확인하며 직접 실행한다.
마지막 체크리스트는 네 줄이면 충분하다. /status로 범위 확인, /diff로 파일 확인, 테스트 결과 기록, 보관 전 이름 지정. 슬래시 명령어를 잘 쓰는 기준은 명령 수가 아니라 어떤 상태가 바뀌는지 예측할 수 있는가다.