Codex CLI의 Slash command

Slash command는 Codex를 빠르게 키보드 중심으로 제어하게 합니다. Composer에서 /를 입력하면 slash popup이 열립니다. command를 선택하면 terminal을 떠나지 않고 모델 전환, 권한 조정, 긴 대화 요약 같은 동작을 수행합니다.

이 가이드에서 다루는 내용:

• 작업에 맞는 built-in slash command 찾기
• /model, /fast, /personality, /permissions, /agent, /status 같은 command로 활성 세션 조정하기

Built-in slash command

Codex에는 다음 command가 포함됩니다. Slash popup을 열고 command 이름을 입력해 목록을 필터링합니다.

작업이 이미 실행 중이면 slash command를 입력하고 Tab을 눌러 다음 턴에 queue할 수 있습니다. Codex는 queue된 slash command를 실행 시점에 parse하므로 command menu와 error는 현재 턴이 끝난 뒤 나타납니다. Queue에 넣기 전에도 slash completion은 계속 동작합니다.

/quit와 /exit는 모두 CLI를 종료합니다. 중요한 작업을 저장하거나 commit한 뒤 사용하십시오.

/approvals command는 alias로 계속 동작하지만 slash popup 목록에는 더 이상 표시되지 않습니다.

Slash command로 세션 제어

다음 workflow는 Codex를 재시작하지 않고 세션을 조정하는 데 사용합니다.

/model로 활성 모델 설정

1. Codex를 시작하고 composer를 엽니다.
2. /model을 입력하고 Enter를 누릅니다.
3. Popup에서 gpt-4.1-mini 또는 gpt-4.1 같은 모델을 선택합니다.

예상 결과: Codex가 transcript에서 새 모델을 확인합니다. 변경 확인에는 /status를 실행합니다.

/fast로 Fast mode 전환

1. /fast on, /fast off, /fast status 중 하나를 입력합니다.
2. 설정을 유지하고 싶으면 Codex가 저장을 제안할 때 확인합니다.

예상 결과: Codex가 현재 thread에서 Fast mode가 켜졌는지 꺼졌는지 보고합니다. TUI footer에는 /statusline으로 Fast mode status-line item을 표시할 수도 있습니다.

/personality로 communication style 설정

Prompt를 다시 쓰지 않고 Codex의 communication 방식을 바꾸려면 /personality를 사용합니다.

1. 활성 대화에서 /personality를 입력하고 Enter를 누릅니다.
2. Popup에서 style을 선택합니다.

예상 결과: Codex가 transcript에서 새 style을 확인하고 이후 thread 응답에 사용합니다.

Codex는 friendly, pragmatic, none personality를 지원합니다. Personality instruction을 비활성화하려면 none을 사용합니다.

활성 모델이 personality-specific instruction을 지원하지 않으면 Codex는 이 command를 숨깁니다.

/plan으로 plan mode 전환

1. /plan을 입력하고 Enter를 눌러 활성 대화를 plan mode로 전환합니다.
2. 선택적으로 inline prompt를 제공합니다. 예: /plan Propose a migration plan for this service.
3. Inline /plan 인자를 사용할 때도 content를 붙여 넣거나 이미지를 첨부할 수 있습니다.

예상 결과: Codex가 plan mode로 들어가고 선택한 inline prompt를 첫 planning 요청으로 사용합니다.

작업이 이미 실행 중일 때는 /plan을 일시적으로 사용할 수 없습니다.

/goal로 experimental goal 설정

/goal은 experimental 기능이며 features.goals가 활성화된 경우에만 사용할 수 있습니다. 활성화하려면 /experimental을 열거나 config.toml의 [features] 아래에 goals = true를 추가합니다.

1. /goal {objective}를 입력해 goal을 설정합니다. 예: /goal Finish the migration and keep tests green.
2. /goal을 입력해 현재 goal을 봅니다.
3. /goal pause, /goal resume, /goal clear로 pause, resume, remove를 수행합니다.

예상 결과: 작업이 계속되는 동안 Codex가 goal을 활성 thread에 붙여 둡니다.

/experimental로 experimental feature 전환

1. /experimental을 입력하고 Enter를 누릅니다.
2. 원하는 feature를 토글합니다. 예: Apps 또는 Smart Approvals. Prompt가 요구하면 Codex를 다시 시작합니다.

예상 결과: Codex가 feature 선택을 config에 저장하고 restart 시 적용합니다.

/clear로 터미널을 지우고 새 chat 시작

1. /clear를 입력하고 Enter를 누릅니다.

예상 결과: Codex가 terminal을 지우고 visible transcript를 reset하며 같은 CLI 세션에서 새 chat을 시작합니다.

Ctrl+L과 달리 /clear는 새 대화를 시작합니다.

Ctrl+L은 terminal view만 지우고 현재 chat은 유지합니다. 작업이 진행 중이면 Codex는 두 동작을 모두 비활성화합니다.

/permissions로 권한 갱신

1. /permissions를 입력하고 Enter를 누릅니다.
2. 예를 들어 hands-off 실행에는 Auto, 편집을 검토하려면 Read Only처럼 편안한 수준에 맞는 approval preset을 선택합니다.

예상 결과: Codex가 갱신된 policy를 알립니다. 이후 action은 다시 변경할 때까지 갱신된 approval mode를 따릅니다.

/copy로 최신 응답 복사

1. /copy를 입력하고 Enter를 누릅니다.

예상 결과: Codex가 최신 완료된 Codex 출력을 clipboard에 복사합니다.

턴이 아직 실행 중이면 /copy는 진행 중 응답 대신 최신 완료 출력을 사용합니다. 첫 Codex 출력이 완료되기 전이나 rollback 직후에는 command를 사용할 수 없습니다.

Main TUI에서 Ctrl+O를 눌러 slash command menu를 열지 않고 최신 완료 응답을 복사할 수도 있습니다.

/sandbox-add-read-dir로 sandbox 읽기 접근 부여

이 command는 CLI를 Windows에서 native로 실행할 때만 사용할 수 있습니다.

1. /sandbox-add-read-dir C:\absolute\directory\path를 입력하고 Enter를 누릅니다.
2. 해당 path가 기존 절대 디렉터리인지 확인합니다.

예상 결과: Codex가 Windows sandbox policy를 새로 고치고, 이후 sandbox에서 실행되는 명령이 해당 디렉터리를 읽을 수 있게 합니다.

/status로 세션 inspect

1. 아무 대화에서나 /status를 입력합니다.
2. 활성 모델, 승인 정책, writable root, 현재 token 사용량을 확인합니다.

예상 결과: Shell에서 codex status가 출력하는 것과 비슷한 summary가 표시되어 Codex가 예상 위치에서 동작하는지 확인할 수 있습니다.

/debug-config로 config layer inspect

1. /debug-config를 입력합니다.
2. Config layer order(낮은 우선순위부터), on/off state, policy source 출력을 확인합니다.

예상 결과: Codex가 layer diagnostic과 allowed_approval_policies, allowed_sandbox_modes, mcp_servers, rules, enforce_residency, 구성된 경우 experimental_network 같은 policy detail을 출력합니다.

이 출력은 effective setting이 config.toml과 다른 이유를 debug하는 데 사용합니다.

/statusline으로 footer 항목 구성

1. /statusline을 입력합니다.
2. Picker에서 항목을 toggle하고 reorder한 뒤 확인합니다.

예상 결과: Footer status line이 즉시 업데이트되고 config.toml의 tui.status_line에 저장됩니다.

사용 가능한 status-line item에는 model, model+reasoning, context stats, rate limits, git branch, token counter, session id, current directory/project root, Codex version이 포함됩니다.

/title로 terminal title 항목 구성

1. /title을 입력합니다.
2. Picker에서 항목을 toggle하고 reorder한 뒤 확인합니다.

예상 결과: Terminal window 또는 tab title이 즉시 업데이트되고 config.toml의 tui.terminal_title에 저장됩니다.

사용 가능한 title item에는 app name, project, spinner, status, thread, git branch, model, task progress가 포함됩니다.

/keymap으로 TUI shortcut remap

TUI keyboard shortcut binding을 inspect, update, persist하려면 /keymap을 사용합니다.

1. /keymap을 입력합니다.
2. 변경하려는 shortcut context와 action을 선택합니다.
3. 새 binding을 입력하거나 기존 binding을 제거합니다.

예상 결과: Codex가 활성 keymap을 업데이트하고 custom binding을 config.toml의 tui.keymap에 씁니다.

Key binding은 ctrl-a, shift-enter, page-down 같은 이름을 사용합니다. Context-specific binding은 tui.keymap.global을 오버라이드합니다. 빈 binding 목록은 해당 action의 binding을 해제합니다.

/ps로 background terminal 확인

1. /ps를 입력합니다.
2. Background terminal 목록과 status를 확인합니다.

예상 결과: Codex가 각 background terminal의 command와 최근 non-empty 출력 최대 세 줄을 보여 주므로 진행 상황을 빠르게 파악할 수 있습니다.

Background terminal은 unified_exec 사용 시 나타납니다. 그렇지 않으면 목록이 비어 있을 수 있습니다.

/stop으로 background terminal 중지

1. /stop을 입력합니다.
2. Codex가 묻는 경우 표시된 terminal 중지를 확인합니다.

예상 결과: Codex가 현재 세션의 모든 background terminal을 중지합니다. /clean은 /stop alias로 계속 사용할 수 있습니다.

/compact로 transcript 압축

1. 긴 대화 뒤 /compact를 입력합니다.
2. Codex가 지금까지의 대화를 요약할지 물으면 확인합니다.

예상 결과: Codex가 이전 턴을 concise summary로 대체해 중요한 detail을 유지하면서 context를 확보합니다.

/diff로 변경 검토

1. /diff를 입력해 Git diff를 inspect합니다.
2. CLI 안에서 출력 내용을 scroll하며 편집과 추가 파일을 검토합니다.

예상 결과: Codex가 staged 변경, 아직 staged되지 않은 변경, Git이 아직 추적하지 않는 파일을 보여 주므로 무엇을 유지할지 결정할 수 있습니다.

/mention으로 파일 highlight

1. /mention 뒤에 path를 입력합니다. 예: /mention src/lib/api.ts.
2. Popup에서 일치하는 결과를 선택합니다.

예상 결과: Codex가 파일을 대화에 추가해 follow-up 턴에서 직접 참조하게 합니다.

/new로 새 대화 시작

1. /new를 입력하고 Enter를 누릅니다.

예상 결과: 같은 CLI 세션에서 새 대화를 시작하므로 terminal을 떠나지 않고 작업을 전환할 수 있습니다.

/clear와 달리 /new는 먼저 현재 terminal view를 지우지 않습니다.

/resume으로 저장된 대화 재개

1. /resume을 입력하고 Enter를 누릅니다.
2. Saved-session picker에서 원하는 세션을 선택합니다.

예상 결과: Codex가 선택한 대화의 transcript를 다시 로드해 원래 history를 유지한 채 이어서 작업할 수 있습니다.

/fork로 현재 대화 fork

1. /fork를 입력하고 Enter를 누릅니다.

예상 결과: Codex가 현재 대화를 새 ID를 가진 thread로 clone하고 원래 transcript는 그대로 두어 대안 접근을 병렬로 탐색할 수 있습니다.

현재 대화가 아니라 저장된 세션을 fork해야 한다면 terminal에서 codex fork를 실행해 session picker를 엽니다.

/side로 side conversation 시작

/side는 main task에서 벗어나지 않고 현재 대화에서 ephemeral fork를 시작합니다.

1. /side를 입력해 side conversation을 엽니다.
2. 선택적으로 inline text를 추가합니다. 예: /side Check whether this plan has an obvious risk.
3. 집중 detour가 끝나면 parent thread로 돌아옵니다.

예상 결과: Codex가 parent thread와 분리된 transcript를 가진 side conversation을 엽니다. Side mode에 있는 동안에도 TUI는 parent-thread status를 계속 보여 주므로 main task 실행 여부를 확인할 수 있습니다.

/side는 다른 side conversation 안이나 review mode 중에는 사용할 수 없습니다.

/init로 AGENTS.md 생성

1. Codex가 지속 지침을 찾을 디렉터리에서 /init을 실행합니다.
2. 생성된 AGENTS.md를 검토한 뒤 저장소 관례에 맞게 편집합니다.

예상 결과: Codex가 향후 세션을 위해 다듬고 commit할 수 있는 AGENTS.md scaffold를 만듭니다.

/review로 working tree review 요청

1. /review를 입력합니다.
2. 정확한 파일 변경을 inspect하고 싶으면 /diff를 이어서 사용합니다.

예상 결과: Codex가 behavior change와 missing test에 초점을 맞춰 working tree에서 찾은 issue를 요약합니다. config.toml에 review_model을 설정하지 않았다면 현재 세션 모델을 사용합니다.

/mcp로 MCP 도구 목록 표시

1. /mcp를 입력합니다.
2. 목록을 검토해 이 세션에서 어떤 MCP 서버와 도구를 사용할 수 있는지 확인합니다.

예상 결과: 현재 세션에서 Codex가 호출할 수 있는 구성된 Model Context Protocol(MCP) 도구가 표시됩니다.

자세한 server diagnostic을 포함하려면 /mcp verbose를 사용합니다. verbose 외의 값을 전달하면 Codex는 command usage를 표시합니다.

/apps로 앱 탐색

1. /apps를 입력합니다.
2. 목록에서 앱을 선택합니다.

예상 결과: Codex가 앱 mention을 composer에 $app-slug로 삽입하므로 바로 Codex에 사용을 요청할 수 있습니다.

/plugins로 플러그인 탐색

1. /plugins를 입력합니다.
2. Marketplace tab을 선택한 뒤 plugin을 골라 capability 또는 available action을 inspect합니다.

예상 결과: Codex가 plugin browser를 열어 installed plugin, configuration이 허용하는 discoverable plugin, installed plugin state를 검토할 수 있게 합니다. 설치된 plugin에서 Space를 누르면 enabled state를 toggle합니다.

/agent로 에이전트 thread 전환

1. /agent를 입력하고 Enter를 누릅니다.
2. Picker에서 원하는 thread를 선택합니다.

예상 결과: Codex가 active thread를 전환해 해당 에이전트 작업을 inspect하거나 이어서 진행할 수 있습니다.

/feedback으로 feedback 보내기

1. /feedback을 입력하고 Enter를 누릅니다.
2. Prompt에 따라 log 또는 diagnostic을 포함합니다.

예상 결과: Codex가 요청된 diagnostic을 수집하고 maintainers에게 제출합니다.

/logout으로 sign out

1. /logout을 입력하고 Enter를 누릅니다.

예상 결과: Codex가 현재 사용자 세션의 local credential을 지웁니다.

/quit 또는 /exit로 CLI 종료

1. /quit 또는 /exit를 입력하고 Enter를 누릅니다.

예상 결과: Codex가 즉시 종료됩니다. 중요한 작업은 먼저 저장하거나 commit하십시오.