본문으로 바로가기
리옵트 핸드북
리옵트 핸드북
Codex 고급 활용

기본 세팅

Ch1. 설치/로그인Ch2. config.toml 설계메모리 운영

안전 & 운영

Ch3. 승인/샌드박스 전략Ch4. 보안 가이드

워크플로우

Ch5. 슬래시 커맨드 운영Ch6. 프롬프트/스킬 설계Ch7. exec/자동화스레드 라이프사이클Ch8. Cloud TasksCh9. 멀티에이전트

확장 & IDE

Ch10. Codex App/IDECh11. MCP 연동Ch12. 모델/추론 전략Ch13. 거버넌스/롤아웃

검증

검증 리포트업데이트 내역
핸드북›Codex 고급 활용›Ch5. 슬래시 커맨드 운영
한국어English

Ch5. 슬래시 커맨드 운영

/status·/usage·/diff·/review·/compact 세션 종료 체크리스트, /permissions·/model·/fast·/goal·/archive·/delete·/import 등 핵심 커맨드의 팀 표준화 포인트까지 슬래시 커맨드 운영

핵심 요약

  • 세션 종료 전 /status→/diff(미추적 포함)→/review→(긴 세션이면) /compact 순서를 체크리스트로 고정하면 품질 편차가 줄어듭니다.
  • /permissions로 Auto↔Read-only를 전환하고, /model·Alt+,로 모델·reasoning effort를, /fast로 Fast/Standard를 전환하며 리뷰·민감 작업은 Standard로 내립니다.
  • /approvals는 동작하지만 popup에서 빠졌으므로 /permissions를 기본 표기로 쓰고, /side·/hooks·/vim 등은 공식 slash 표에 등재됐습니다.
  • /goal(0.133.0 기본 활성화)은 장기 작업 목표를 pause/resume/clear로 다루고, /archive(0.136.0)는 세션을 resume/fork 대상에서 보호하며, /delete(0.140.0)는 transcript 자체를 영구 삭제합니다.
  • /usage(0.142.0)는 account-level token activity와 earned reset을 확인하므로 장기 goal·multi-agent 작업 전 점검 루틴에 넣습니다.
  • /app(0.138.0)은 현재 공식 slash 표에 등재됐고, /mcp verbose(0.123.0)는 세부 진단 인자로 관리합니다.
  • 0.146.0부터 /new [name]·/clear [name]으로 새 thread를 즉시 이름 붙이고, /side picker에서 열려 있는 side conversation을 전환할 수 있습니다.
  • 2026-08-03 공식 목록 재검증에서 /rename, /pets(/pet), Windows 전용 /setup-default-sandbox, /subagents·/btw 별칭을 운영 목록에 추가했습니다.
  • 0.148.0의 /export는 현재 TUI 대화 전체를 Markdown으로 내보냅니다. 0.150.0의 /copy는 전체 응답·코드 블록·인용문을 고르는 picker를 여므로 범위와 민감 정보를 확인합니다.
  • 공식 0.149.0 Changelog는 /cd·/pwd·/cwd를 working-directory 관리 명령군으로 추가했습니다. 현재 Developer Commands reference는 개별 계약이 아직 없으므로 설치본 slash picker에서 syntax·출력을 확인합니다.
  • 0.150.0부터 이름 없는 task는 자동으로 제목이 붙고 /rename은 편집 가능한 제목 제안을 제공합니다.

슬래시 커맨드는 Codex 세션을 제어하는 핵심 도구입니다. 자주 쓰는 커맨드를 팀 기준으로 정해두면 운영 효율이 눈에 띄게 올라갑니다.

팀 운영 루틴(권장)

아래 순서를 "세션 종료 전 체크리스트"로 고정해두면 품질 편차가 크게 줄어듭니다.

  1. /status로 현재 모델/승인/컨텍스트 상태 확인
  2. /diff로 변경 범위 확인(미추적 파일 포함)
  3. /review로 워킹 트리 2차 점검
  4. (긴 세션이면) /compact로 핵심만 요약해 컨텍스트 정리

커맨드 빠른 표 (최근 릴리스 기준)

커맨드목적팀 표준화 포인트
/permissions세션 중 승인/권한 레벨 조정"Auto ↔ Read-only 전환 기준"과 approval review 사용 기준을 문서화
/compact대화 내용을 요약해 토큰 절약긴 작업 후 루틴화
/copy마지막 어시스턴트 응답 복사결과 공유/문서화에 활용, Ctrl+O 단축키도 익히기
/export전체 TUI 대화를 Markdown으로 내보내기clipboard/새 파일 선택, 외부 공유 전 secret 검토
/rename [name]현재 채팅 이름 변경issue·branch·목적 기반 이름으로 /resume 검색 개선
/clear [name]화면 정리 또는 이름 있는 새 대화 시작Ctrl-L은 화면만, /clear는 새 채팅도 가능
/diffGit diff 표시(미추적 포함)커밋/PR 전 필수
/review워킹 트리 리뷰 실행기본 리뷰 프롬프트/모델(review_model)까지 표준화
/approve최근 auto-review 거부 동작 1회 재시도정책을 넓히지 않고 특정 거부만 사람이 확인해 재시도
/setup-default-sandboxelevated Windows sandbox 설정degraded restricted-token 상태에서만 관리자 flow 실행
/model모델(및 reasoning effort) 전환"분석/수정/리뷰" 단계별 권장 모델 정의, Alt+, 임시 조정 기준 포함
/fastFast/Standard 모드 전환속도 우선 세션의 기본값과 예외 기준 문서화
/plan작업 계획(Plan) 생성/편집큰 작업을 단계/검증 기준으로 쪼개서 안정화
/goal긴 작업의 지속 목표 설정/조회장시간 task의 목표, pause/resume/clear 기준 정의
/plugins플러그인 탐색/설치/제거 흐름 진입조직 표준 플러그인 sync와 인증 준비 상태 점검
/app현재 CLI thread를 Desktop으로 handoffCLI 조사 후 앱의 review/worktree UI에서 이어가기
/status세션 설정/토큰/쓰기 루트 등 상태 표시stale quota 정보가 보이면 새로고침 기준으로 활용
/usage계정 token activity와 rate-limit resetdaily/weekly/cumulative 사용량과 earned reset 확인
/mention파일/폴더를 대화에 첨부"수정 대상 파일 지정"을 루틴화
/ideIDE 열린 파일/선택 영역 포함편집기 컨텍스트를 다음 프롬프트에 연결
/initAGENTS.md 스캐폴딩 생성레포/디렉토리별 지속 규칙을 표준화
/mcpMCP 도구 목록 확인외부 도구가 의도대로 enable 되었는지 점검, 필요 시 verbose로 확장
/memories메모리 사용/생성 설정민감 작업과 장기 선호사항 저장 기준을 분리
/agent(/subagents)서브에이전트 스레드 전환/조회멀티에이전트 작업 모니터링
/fork현재 대화 스레드 분기대안 접근을 병렬로 실험할 때 사용
/side(/btw)부모 스레드를 보존한 임시 side 질문·전환0.146.0부터 열린 side conversation을 닫지 않고 전환
/rawraw scrollback 모드 전환긴 로그/터미널 출력 복사 정확도 개선
/new [name]같은 CLI 세션에서 이름 있는 새 대화 시작0.146.0부터 생성 시점에 이름 지정
/resume저장된 대화 재개session ID/name 직접 점프 기준까지 문서화
/archive현재/선택 세션 보관완료·폐기 세션을 resume/fork 대상에서 보호
/delete현재 세션 transcript 영구 삭제보존 금지/폐기 세션을 삭제, descendant session 포함
/importClaude Code artifact import가져온 설정은 /diff와 /debug-config로 검토
/personality응답 스타일 변경friendly/pragmatic/none 중 팀 표준 지정
/title터미널 제목 구분병렬 세션 구분 규칙(브랜치/이슈 번호 등) 적용
/themeTUI syntax theme 선택diff/code block 가독성 표준화
/pets(/pet)ambient terminal pet 선택·숨김표시 개인화, 화면공유 시 /pets off
/vimcomposer Vim mode 전환Vim 입력 모드 기본값 여부를 팀 기준으로 결정
/skills스킬 탐색/적용작업별 local skill 적용과 팀 스킬 배포 확인
/ps백그라운드 터미널 상태 확인장시간 명령 모니터링
/stop백그라운드 터미널 일괄 중지runaway 명령 정리, /clean alias 교육
/statuslineTUI 상태줄 필드 커스터마이징renamed thread title까지 포함한 팀 표준 상태줄 구성
/keymapTUI shortcut remap팀 표준 단축키, terminal 환경별 충돌 해소
/debug-configconfig 레이어/요구사항 진단설정 충돌 디버깅
/apps앱(커넥터) 탐색/삽입$app-slug로 프롬프트에 앱 첨부
/experimental실험적 기능 토글멀티에이전트 등 experimental 기능 관리
/logout로그아웃(자격증명 정리)공용 머신 운영 시 필수
/feedback로그 전송문제 리포팅 절차에 포함
/exit//quit종료-

TUI 복사 흐름 (0.105.0 → 0.150.0)

/copy는 0.150.0부터 전체 응답·코드 블록·인용문을 고르는 picker를 엽니다. 0.119.0부터는 Ctrl+O로 최신 에이전트 응답을 바로 복사할 수 있고, SSH/멀티플랫폼 환경에서도 클립보드 동작이 더 안정적입니다. Ctrl-L은 화면만 정리하고 스레드 컨텍스트는 유지하며, /clear는 화면 정리 외에 새 채팅을 시작하는 옵션도 있습니다.

0.145.0~0.146.0 운영 포인트

paginated thread history와 fork, persisted names/search/pins, named /new·/clear, side conversation 전환이 들어왔습니다. /import는 Cursor와 Claude Code의 settings·MCP·plugins·sessions·commands·project memories까지 범위가 넓어졌고, plugin/MCP 변경 후에는 연결과 tool inventory를 세션 안에서 refresh할 수 있습니다.

Fast 모드 운영 포인트 (0.110.0~0.111.0)

/fast 토글이 persisted 설정으로 들어왔고, 이후 릴리스에서는 Fast mode가 기본값이 되었습니다. 팀에서는 "Fast를 기본으로 쓰되, 리뷰나 복잡한 설계, 민감한 수정은 Standard로 내린다" 같은 운영 기준을 정해두는 게 좋습니다.

플러그인 워크플로우 1급화 (0.117.0)

플러그인이 제품 범위 sync와 설치/제거 흐름을 갖춘 1급 워크플로우로 승격됐습니다. /plugins는 현재 공식 slash commands 표에도 등재되어 있고, 세부 marketplace 변화는 changelog를 함께 추적합니다.

`/approvals` alias 상태 (2026-04 기준)

/approvals는 여전히 동작하지만, 공식 slash popup 목록에서는 더 이상 보이지 않습니다. 새 팀 표준 문서에서는 /permissions를 기본 표기로 쓰는 편이 안전합니다.

`/title` terminal-title picker (0.117.0)

/title은 classic TUI와 app-server TUI 모두에서 동작하며, 병렬 세션을 브랜치명·이슈번호·작업 종류로 구분할 때 유용합니다. 현재 공식 slash commands 표에도 등재되어 있습니다.

세션 재개/상태 확인 개선 (0.119.0~0.120.0)

0.119.0부터 /resume은 TUI에서 session ID나 이름으로 바로 점프할 수 있고, /status는 stale rate limit 정보를 더 적극적으로 새로고칩니다. 0.120.0에서는 커스텀 /statusline에 renamed thread title을 넣을 수 있어 병렬 세션 추적이 더 쉬워졌습니다.

실행 중 입력 UX 확장 (0.121.0~0.122.0)

0.121.0에서는 composer가 Ctrl+R reverse search와 accepted slash command local recall을 지원합니다. 0.122.0에서는 작업이 돌아가는 중 queued input으로 slash command와 ! shell prompt를 넣을 수 있어, 긴 작업을 멈추지 않고 상태 확인이나 보조 명령을 이어 넣기 쉬워졌습니다.

0.123.0~0.125.0 운영 포인트

0.123.0에서는 /mcp verbose와 current/archived thread를 더 잘 구분하는 /resume hinting이 추가됐습니다. 0.124.0에서는 Alt+,로 reasoning level을 빠르게 순환할 수 있고, /permissions 변경이 side conversation을 거쳐도 더 잘 유지됩니다. 0.125.0에서는 permission profile state가 TUI/app-server/MCP metadata 사이에서 더 일관되게 round-trip됩니다.

0.131.0~0.132.0 운영 포인트

0.131.0부터 TUI는 data-driven service-tier commands, blended token usage, effective workspace roots, responsive Markdown tables를 더 잘 표시합니다. @ picker는 files/directories/plugins/skills를 한 번에 찾고, 0.132.0에서는 codex exec resume --output-schema로 자동화 재개 시 구조화 출력 계약을 유지할 수 있습니다.

0.133.0~0.137.0 운영 포인트

/goal은 0.133.0부터 기본 활성화되어 active turn progress를 전용 저장소로 추적합니다. 0.135.0의 /status는 remote transport 연결 정보와 server version을 보여주고, /permissions는 named permission profiles를 picker에서 다룹니다. 0.136.0의 /archive는 세션을 보관해 resume/fork 대상에서 보호하며, 0.137.0의 TUI는 F13-F24 keybinding, searchable menu paste, reasoning-only status/title item을 지원합니다.

0.138.0~0.139.0 운영 포인트

0.138.0에서 /app이 release-tracked command로 확인되어 현재 CLI thread를 Codex Desktop으로 넘길 수 있습니다. 같은 범위에서 plugin JSON 출력, reasoning effort fallback shortcuts, 이미지 파일 path 노출, app-server token usage가 보강됐습니다. 0.139.0은 code mode web search, MCP schema 보존, resume/fork --last prompt 처리, plugin marketplace install/upgrade, codex debug app-server send-message-v2 복구를 반영합니다.

0.140.0~0.142.0 운영 포인트

/delete, /import, /usage가 공식 slash commands 표에 포함됐습니다. /delete는 /archive와 달리 transcript와 spawned descendant session을 영구 삭제하므로 보존 정책을 먼저 확인합니다. /import는 Claude Code 설정·프로젝트 파일·최근 채팅을 가져오며, 가져온 직후 /diff와 /debug-config를 실행하세요. /usage는 daily/weekly/cumulative token activity와 earned reset을 보여주므로 장시간 /goal이나 multi-agent delegation 전에 사용량 예산 확인용으로 씁니다.

2026-08-03 공식 slash inventory 재검증

/app, /copy, /rename, /pets(/pet), /setup-default-sandbox가 현재 공식 표에 포함되어 있습니다. /subagents는 /agent, /btw는 /side의 별칭입니다. Windows sandbox setup은 degraded restricted-token 상태에서만 표시되므로 일반 세션의 /permissions와 구분하세요.

`/side`는 공식 slash docs에 등재됨

이전에는 changelog-only 기능으로 추적했지만, 2026-05-10 검증 기준 공식 slash commands 문서에 /side가 들어왔습니다. 이제 짧은 리스크 점검이나 보조 질문을 부모 thread에서 떼어내는 표준 명령으로 다룰 수 있습니다. 단, side conversation 내부나 review mode 중에는 쓸 수 없습니다.

2026-05-21 공식 slash inventory 재검증

/hooks와 /vim은 모두 현재 공식 slash commands 표에 포함되어 있습니다. 같은 재검증에서 /approve, /ide, /memories, /raw, /skills, /theme도 표준 명령으로 확인했으므로, 팀 문서의 명령어 allowlist와 온보딩 자료를 함께 갱신하세요.

참고 문서

  • 슬래시 커맨드 목록: https://developers.openai.com/codex/cli/slash-commands (영어)
  • Codex CLI 기능: https://developers.openai.com/codex/cli/features (영어)

관련 문서

스레드 라이프사이클

start, resume, fork, steering 중심의 세션 운영 전략

기본 명령어 묶음 (세션 운영)

Codex 명령어 마스터 · /fast·/compact·/resume·/archive·/statusline·/goal·/side를 묶어 긴 작업의 세션 연속성과 컨텍스트를 관리하는 운영 명령어 모음과 빠른 표

Cmd. /archive

Codex 명령어 마스터 · 현재 TUI 세션을 보관 상태로 전환하는 /archive 명령. 보관 세션은 복원 전까지 resume/fork에서 보호되며 codex archive/unarchive 흐름과 연동됩니다.

이전 검증 기록

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

릴리스 반영 이력

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

Ch4. 보안 가이드

승인 기반 실행과 샌드박스(workspace-write 네트워크 차단), zsh-fork 패치(0.106.0)·deny-read 가드레일·글로벌 와일드카드 도메인 거부, requirements.toml 강제와 OTel 옵트인까지 Codex 보안 운영

Ch6. 프롬프트/스킬 설계

목표·범위·제약·검증·리스크·출력 6요소 작업 명세, AGENTS.md 탐색 순서, SKILL.md 구조와 Progressive Disclosure, plugin/@plugin 멘션까지 시니어용 프롬프트·스킬 설계

On this page

팀 운영 루틴(권장)커맨드 빠른 표 (최근 릴리스 기준)참고 문서