슬래시 '/' Command 설명서

잘나스 · 2026-06-22 18:15:05
Codex 사용 시 입력창에서 '/'로 실행하는 Slash Command를 정리한 설명서다.
'/'를 입력하면 명령어 팝업이 뜨고, 명령어 이름을 계속 입력하면 목록이 필터링된다.
Codex CLI, Codex IDE 확장, Codex 앱마다 제공되는 명령어가 조금씩 다르다.
현재 기준으로는 Codex CLI 쪽 명령어가 가장 많다.

참고:
- Codex CLI Slash Commands 공식 문서: https://developers.openai.com/codex/cli/slash-commands
- Codex IDE Slash Commands 공식 문서: https://developers.openai.com/codex/ide/slash-commands
- Codex App Commands 공식 문서: https://developers.openai.com/codex/app/commands
- Codex Custom Prompts 공식 문서: https://developers.openai.com/codex/custom-prompts


1. Codex CLI에서 많이 쓰는 '/' 명령어 전체 정리


명령어기능언제 쓰면 좋은지
/status현재 세션 상태 표시현재 모델, 승인 정책, 토큰/컨텍스트 사용량, 작업 디렉터리 상태를 확인할 때 쓴다.
/model사용할 모델 변경빠른 모델과 더 깊게 추론하는 모델을 바꾸고 싶을 때 사용한다.
/fastFast 모드 켜기/끄기/상태 확인지원되는 모델에서 더 빠른 응답 모드를 쓰고 싶을 때 사용한다. 예: /fast on, /fast off, /fast status
/permissionsCodex가 허락 없이 할 수 있는 작업 범위 조정읽기 전용, 자동 승인, 더 엄격한 승인 모드 등으로 바꿀 때 사용한다.
/approve자동 리뷰에서 거부된 최근 작업을 한 번 재승인Codex가 명령 실행이나 수정 작업을 거부당했는데, 사용자가 신뢰해서 다시 시도시키고 싶을 때 사용한다.
/plan계획 모드로 전환바로 코드를 고치기 전에 먼저 작업 계획을 세우게 하고 싶을 때 사용한다.
/review현재 작업 트리 코드 리뷰Codex가 수정한 코드나 현재 변경사항을 리뷰하게 할 때 사용한다.
/diffGit diff 확인Codex가 어떤 파일을 어떻게 바꿨는지 커밋 전에 확인할 때 사용한다.
/clear터미널 화면과 대화 초기화현재 보이는 대화 흐름을 정리하고 새로 시작하고 싶을 때 사용한다.
/compact긴 대화를 요약해서 컨텍스트 절약대화가 길어졌을 때 핵심만 남기고 토큰을 확보할 때 사용한다.
/copy최근 Codex 답변 복사마지막 완료된 답변이나 계획을 클립보드로 복사할 때 사용한다. Ctrl+O도 가능하다.
/new같은 CLI 세션 안에서 새 대화 시작같은 프로젝트 폴더에서 완전히 새 작업을 시작하고 싶을 때 사용한다.
/resume저장된 이전 대화 이어가기예전에 하던 Codex 세션을 다시 불러올 때 사용한다.
/fork현재 대화를 새 스레드로 분기기존 흐름은 유지하면서 다른 방식으로 문제를 풀어보고 싶을 때 사용한다.
/side임시 사이드 대화 시작메인 작업 흐름을 망치지 않고 짧은 질문이나 확인을 따로 하고 싶을 때 사용한다.
/quitCLI 종료Codex 세션을 끝낼 때 사용한다.
/exitCLI 종료/quit과 같은 기능이다.
/init현재 디렉터리에 AGENTS.md 초안 생성프로젝트별 작업 규칙, 코딩 스타일, 테스트 명령 등을 Codex가 기억하게 만들고 싶을 때 사용한다.
/mention파일이나 폴더를 대화에 첨부특정 파일을 Codex에게 보라고 지시할 때 사용한다.
/ideIDE의 열린 파일, 선택 영역 등 컨텍스트 포함VS Code 같은 IDE와 연결된 상태에서 현재 보고 있는 파일/선택 영역을 다음 요청에 반영할 때 사용한다.
/mcp설정된 MCP 도구 목록 확인Codex가 외부 도구나 서버를 사용할 수 있는지 확인할 때 사용한다.
/plugins설치/사용 가능한 플러그인 확인Codex 플러그인 상태를 보고 관리할 때 사용한다.
/apps앱/커넥터 탐색 및 프롬프트 삽입연결 가능한 앱을 $app-slug 형태로 붙여 작업시키고 싶을 때 사용한다.
/skills스킬 탐색 및 사용특정 작업에 맞는 재사용 가능한 Skill을 선택해 Codex 동작을 보강할 때 사용한다.
/hooks라이프사이클 훅 확인/관리작업 전후 자동 실행되는 훅 설정을 점검하거나 신뢰/비활성화할 때 사용한다.
/memories메모리 사용/생성 설정Codex가 메모리를 주입하거나 생성하는 기능을 켜고 끌 때 사용한다.
/personality응답 스타일 변경답변을 더 간결하게, 설명적으로, 협업형으로 바꾸고 싶을 때 사용한다. 공식 문서에는 friendly, pragmatic, none 스타일이 언급되어 있다.
/raw원시 스크롤백 모드 토글긴 터미널 출력에서 복사/선택을 더 깔끔하게 하고 싶을 때 사용한다.
/ps실험적 백그라운드 터미널 출력 확인Codex가 백그라운드에서 돌린 명령의 상태를 볼 때 사용한다.
/stop백그라운드 터미널 작업 중지현재 세션에서 시작된 백그라운드 명령을 멈출 때 사용한다.
/experimental실험 기능 토글서브에이전트 같은 실험 기능을 켜고 끌 때 사용한다.
/agent활성 에이전트 스레드 전환생성된 서브에이전트 작업을 확인하거나 이어서 진행할 때 사용한다.
/goal목표 설정/일시정지/재개/확인/삭제큰 작업에서 Codex가 계속 추적해야 할 목표를 지정할 때 사용한다. 단, features.goals가 필요하다.
/keymapTUI 단축키 재설정Codex 터미널 UI의 키보드 단축키를 바꾸고 config.toml에 저장할 때 사용한다.
/vim입력창 Vim 모드 토글입력창을 Vim 방식으로 편집하고 싶을 때 사용한다.
/statuslineTUI 하단 상태줄 구성모델, 컨텍스트, 토큰, Git 상태 등 표시 항목을 고르고 순서를 바꿀 때 사용한다.
/title터미널 창/탭 제목 구성프로젝트명, 브랜치, 모델, 진행 상태 등을 터미널 제목에 표시하고 싶을 때 사용한다.
/theme문법 강조 테마 선택터미널 출력의 코드 하이라이팅 테마를 바꿀 때 사용한다.
/feedback로그와 함께 피드백 전송Codex 문제를 보고하거나 진단 정보를 보낼 때 사용한다.
/debug-config설정 계층과 요구사항 진단 출력config.toml, 정책, 네트워크 제약 등 설정 충돌을 점검할 때 사용한다.
/sandbox-add-read-dir샌드박스 읽기 허용 디렉터리 추가Windows 네이티브 CLI에서 현재 읽기 권한 밖의 절대 경로를 추가로 읽게 할 때 사용한다. Windows 전용이다.

위 목록은 OpenAI의 Codex CLI Slash Commands 공식 문서에 정리된 내장 명령어 기준이다.
공식 문서에서도 Codex CLI에는 /model, /fast, /personality, /permissions, /approve, /raw, /agent, /status 같은 명령어로 세션을 제어할 수 있다고 설명한다.


2. 실제 개발할 때 가장 자주 쓸 명령어

PHP, NAS, 웹 개발 작업을 Codex로 한다면 처음에는 아래 명령어만 익혀도 충분하다.


우선순위명령어실전 사용 예
1/status지금 Codex가 어떤 모델, 권한, 폴더에서 작업 중인지 확인한다.
2/permissions파일 수정은 허용하되, 명령 실행은 물어보게 한다.
3/plan바로 수정하지 말고 먼저 수정 계획부터 세우게 한다.
4/diffCodex가 바꾼 파일을 확인한다.
5/review수정한 코드에 오류나 보안 문제가 없는지 점검한다.
6/mention특정 PHP 파일을 지정해서 분석시킨다.
7/compact대화가 길어졌을 때 핵심 요약 후 계속 진행한다.
8/init프로젝트 규칙을 AGENTS.md로 만들어 Codex에게 고정 지침을 준다.
9/model작업 난이도에 따라 모델을 변경한다.
10/quit작업을 종료한다.


3. 예시로 보는 사용 흐름

예를 들어 register.php, chk_id.php, SajuService.php를 수정한다고 하면 흐름은 이렇게 잡으면 좋다.

먼저 현재 작업 폴더, 모델, 권한 상태를 확인한다.

/status
파일 수정 권한과 명령 실행 권한을 어느 정도 줄지 정한다.

/permissions
특정 파일을 Codex에게 명확히 지정한다.

/mention app/Services/SajuService.php
바로 코드를 고치게 하지 않고 설계부터 받는다.

/plan 회원가입 시 저장된 생년월일 정보를 사주 입력 화면의 '나의사주' 체크박스와 연동하는 구조를 먼저 설계해줘.
수정 후 변경사항을 확인한다.

/diff
마지막으로 코드 리뷰를 시킨다.

/review

4. IDE 확장에서 쓰는 '/' 명령어

VS Code 같은 Codex IDE 확장에서는 공식 문서 기준으로 명령어가 더 단순하다.
주요 명령어는 다음과 같다.


명령어기능
/auto-context최근 파일과 IDE 컨텍스트를 자동 포함할지 켜고 끈다.
/cloud작업을 원격 클라우드 모드로 실행한다. 클라우드 접근 권한이 필요하다.
/cloud-environment클라우드 모드에서 사용할 환경을 선택한다.
/feedback피드백 창을 열고 로그 포함 여부를 선택한다.
/local로컬 워크스페이스에서 작업하는 모드로 전환한다.
/review코드 리뷰 모드를 시작한다.
/status스레드 ID, 컨텍스트 사용량, rate limit 등을 표시한다.


5. Codex 앱에서 쓰는 '/' 명령어

Codex 데스크톱 앱에서도 '/' 명령어가 있지만, 공식 문서에는 CLI보다 적은 목록이 안내되어 있다.
앱에서는 사용 환경과 권한에 따라 명령어가 달라질 수 있다.


명령어 기능
/feedback 피드백 창을 열고 로그를 포함해 보낼 수 있다.
/mcp 연결된 MCP 서버 상태를 본다.
/plan-mode 여러 단계 작업을 위한 계획 모드를 켜고 끈다.
/review 미커밋 변경사항이나 기준 브랜치 대비 코드 리뷰를 시작한다.
/status 스레드 ID, 컨텍스트 사용량, rate limit 등을 표시한다.

6. 커스텀 '/' 명령어에 대한 주의점

예전에는 ~/.codex/prompts 안에 마크다운 파일을 만들어서 /prompts:명령어처럼 커스텀 Slash Command로 호출할 수 있었다.
하지만 공식 문서에서는 현재 Custom Prompts는 deprecated, 즉 더 이상 권장되지 않으며, 재사용 가능한 작업 지침은 Skills를 사용하라고 안내한다.

즉, 앞으로 반복 작업을 만들고 싶다면 예전 방식인 /prompts:xxx보다 Skill 또는 AGENTS.md 중심으로 정리하는 게 좋다.


7. 추천 사용법

Codex를 처음 쓸 때는 모든 '/' 명령어를 외우려고 하지 말고, 이 정도만 먼저 쓰면 된다.

/status
/permissions
/plan
/mention
/diff
/review
/compact
/init
/quit

특히 코딩 작업에서는 /plan → 코드 수정 → /diff → /review 흐름이 가장 안전하다.

PHP 7.3 이하, MySQL, ipTIME NAS 환경에서는 Codex가 최신 문법을 무심코 쓸 수 있다.
그래서 /init으로 AGENTS.md를 만들어서 아래 같은 프로젝트 규칙을 먼저 고정해두는 게 좋다.

- PHP 7.3 이하 호환 문법 사용
- 상단 페이지 소개 주석 유지
- mysqli prepared statement 우선 사용
- 운영 서버 경로와 NAS 환경을 임의로 바꾸지 않기
- 수정 전 변경 계획 먼저 제시
- 수정 후 변경 파일과 변경 이유 요약