개발자 명령어 | 참조

ChatGPT 데스크톱 앱 명령어

일반 명령어 페이지에서는 앱 탐색, 채팅 단축키, 키보드 맞춤 설정 및 채팅, 설정, 스킬, 예약 작업, 플러그인, 펫으로 연결되는 딥 링크를 다룹니다.

슬래시 명령어 페이지에서는 /feedback, /goal, /init, /mcp, /plan, /review, /status 등 앱 작성기에서 사용할 수 있는 명령어를 다룹니다.

이 참조 문서를 읽는 방법

이 페이지에는 문서화된 모든 Codex CLI 명령어와 플래그가 정리되어 있습니다. 대화형 표에서 키나 설명으로 검색할 수 있습니다. 각 섹션에는 옵션이 안정 단계인지 실험 단계인지 표시되어 있으며, 위험한 조합에는 별도 설명이 있습니다.

전역 플래그

키	유형 / 값	세부 정보
`--add-dir`	`path`	기본 워크스페이스 외에 추가 디렉터리에 대한 쓰기 권한을 부여합니다. 여러 경로를 지정하려면 반복해서 사용하세요.
`--ask-for-approval, -a`	`untrusted \| on-request \| never`	명령어를 실행하기 전에 Codex가 사람의 승인을 받기 위해 일시 중지하는 시점을 제어합니다.
`--cd, -C`	`path`	에이전트가 요청 처리를 시작하기 전에 작업 디렉터리를 설정합니다.
`--config, -c`	`key=value`	구성 값을 재정의합니다. 가능하면 값을 TOML로 구문 분석하고, 그렇지 않으면 리터럴 문자열을 사용합니다.
`--dangerously-bypass-approvals-and-sandbox, --yolo`	`boolean`	승인이나 샌드박싱 없이 모든 명령어를 실행합니다. 외부에서 강력하게 보호된 환경 내에서만 사용하세요.
`--dangerously-bypass-hook-trust`	`boolean`	이 호출에서 영구 저장된 훅 신뢰를 요구하지 않고 활성화된 훅을 실행합니다. 훅 소스를 이미 검증하는 자동화에만 사용해야 합니다.
`--disable`	`feature`	기능 플래그를 강제로 비활성화합니다(`-c features.<name>=false`으로 변환됨). 반복해서 사용할 수 있습니다.
`--enable`	`feature`	기능 플래그를 강제로 활성화합니다(`-c features.<name>=true`으로 변환됨). 반복해서 사용할 수 있습니다.
`--image, -i`	`path[,path...]`	초기 프롬프트에 하나 이상의 이미지 파일을 첨부합니다. 여러 경로는 쉼표로 구분하거나 플래그를 반복해서 지정하세요.
`--local-provider`	`lmstudio \| ollama`	`--oss`과 함께 사용할 로컬 공급자를 선택하여 이번 실행에서 `oss_provider`을 재정의합니다.
`--model, -m`	`string`	구성에 설정된 모델을 재정의합니다(예: `gpt-5.6-terra`).
`--no-alt-screen`	`boolean`	TUI의 대체 화면 모드를 비활성화합니다(이번 실행에서 `tui.alternate_screen`을 재정의함).
`--oss`	`boolean`	로컬 오픈 소스 모델 공급자를 사용합니다. Codex는 `--local-provider`, 구성된 `oss_provider`을 사용하거나 LM Studio와 Ollama 중 하나를 선택하라는 메시지를 표시합니다.
`--profile, -p`	`string`	기본 사용자 구성 위에 `$CODEX_HOME/profile-name.config.toml`을 계층으로 적용합니다.
`--remote`	`ws://host:port \| wss://host:port \| unix:// \| unix://PATH`	WebSocket 또는 Unix 소켓을 통해 원격 app-server 엔드포인트에 연결합니다. `codex`, `codex resume`, `codex fork`, `codex archive`, `codex delete`, `codex unarchive`에서 지원되며, 다른 하위 명령어는 원격 모드를 거부합니다.
`--remote-auth-token-env`	`ENV_VAR`	이 환경 변수에서 전달자 토큰을 읽어 `--remote`로 연결할 때 전송합니다. `--remote`이 필요하며, 토큰은 `wss://` URL 또는 로컬 전용 `ws://` URL을 통해서만 전송됩니다.
`--sandbox, -s`	`read-only \| workspace-write \| danger-full-access`	모델이 생성한 셸 명령어에 적용할 샌드박스 정책을 선택합니다.
`--search`	`boolean`	실시간 웹 검색을 활성화합니다(기본 `"cached"` 대신 `web_search = "live"` 설정).
`--strict-config`	`boolean`	`config.toml`에 이 Codex 버전이 인식하지 못하는 필드가 있으면 오류를 발생시킵니다. `codex`, `exec`, `review`, `resume`, `fork`, `app-server`, `mcp-server`, `exec-server` 등의 런타임 명령어에서 지원됩니다.
`PROMPT`	`string`	세션을 시작할 때 사용할 선택적 텍스트 지시입니다. 미리 입력된 메시지 없이 TUI를 시작하려면 생략하세요.

이 옵션은 기본 codex 명령어에 적용됩니다. 대부분은 다른 명령어에도 전파됩니다. 예외는 위의 참고 사항이나 해당 명령어 도움말을 확인하세요. 전파되는 플래그는 해당 명령어 도움말을 따르세요. 예를 들어 codex exec --oss ...은 --oss을 exec에 적용합니다.

명령 개요

키	성숙도	세부 정보
`codex`	안정	터미널 UI를 시작합니다. 위의 전역 플래그와 선택적 프롬프트 또는 이미지 첨부 파일을 받습니다.
`codex app`	안정	macOS 또는 Windows에서 ChatGPT 데스크톱 앱을 시작합니다. macOS에서는 Codex가 워크스페이스 경로를 열 수 있고, Windows에서는 열 경로를 출력합니다.
`codex app-server`	실험	stdio, WebSocket 또는 Unix 소켓을 통해 로컬 개발이나 디버깅에 사용할 Codex 앱 서버를 시작합니다.
`codex apply`	안정	Codex 클라우드 채팅에서 생성된 최신 diff를 로컬 작업 트리에 적용합니다. 별칭: `codex a`.
`codex archive`	안정	저장된 대화형 세션을 세션 ID 또는 세션 이름으로 보관합니다.
`codex cloud`	실험	TUI를 열지 않고 터미널에서 Codex 클라우드 채팅을 탐색하거나 실행합니다. 별칭: `codex cloud-tasks`.
`codex completion`	안정	Bash, Zsh, Fish 또는 PowerShell용 셸 완성 스크립트를 생성합니다.
`codex debug app-server send-message-v2`	실험	기본 제공 테스트 클라이언트를 통해 단일 V2 메시지를 전송하여 app-server를 디버깅합니다.
`codex debug models`	실험	Codex에 표시되는 원시 모델 카탈로그를 출력하며, 번들 카탈로그만 검사하는 옵션도 제공합니다.
`codex debug prompt-input`	실험	모델에 표시되는 프롬프트 입력 목록을 JSON으로 렌더링하며, 선택적으로 프롬프트와 이미지를 포함합니다.
`codex delete`	안정	저장된 대화형 세션을 세션 ID 또는 세션 이름으로 영구 삭제합니다.
`codex doctor`	안정	로컬 설치, 구성, 인증, 런타임, Git, 터미널, app-server 및 스레드 인벤토리 문제에 대한 진단 보고서를 생성합니다.
`codex exec`	안정	Codex를 비대화형으로 실행합니다. 별칭: `codex e`. 결과를 stdout 또는 JSONL로 스트리밍하고, 선택적으로 이전 세션을 재개합니다.
`codex execpolicy`	실험	execpolicy 규칙 파일을 평가하여 명령어가 허용되는지, 승인을 요청하는지, 차단되는지 확인합니다.
`codex features`	안정	기능 플래그를 나열하고 `config.toml`에서 영구적으로 활성화하거나 비활성화합니다.
`codex fork`	안정	원본 기록을 유지하면서 이전 대화형 세션을 새 채팅으로 포크합니다.
`codex login`	안정	ChatGPT OAuth, 기기 인증, API key 또는 stdin으로 파이프된 액세스 토큰을 사용하여 Codex를 인증합니다.
`codex logout`	안정	저장된 인증 자격 증명을 제거합니다.
`codex mcp`	안정	Model Context Protocol 서버를 관리합니다(목록 조회, 추가, 제거, 인증).
`codex mcp-server`	사용 중단	stdio를 통해 Codex를 MCP server로 실행하는 사용 중단된 인터페이스입니다. 대신 Codex 앱 서버를 사용하세요. Claude Code에서 Codex를 호출하려면 Claude Code용 Codex 플러그인을 사용하세요.
`codex plugin`	안정	구성된 마켓플레이스 소스에서 플러그인을 설치하고, 나열하고, 제거합니다.
`codex plugin marketplace`	안정	Git 또는 로컬 소스에서 플러그인 마켓플레이스를 추가하고, 나열하고, 업그레이드하거나 제거합니다.
`codex remote-control`	실험	로컬 app-server의 원격 제어를 실행하거나 관리하고, 수명이 짧은 페어링 코드를 생성합니다.
`codex resume`	안정	이전 대화형 세션을 ID로 계속하거나 가장 최근 채팅을 재개합니다.
`codex review`	안정	커밋되지 않은 변경 사항, 기준 브랜치 diff, 커밋 또는 사용자 지정 검토 지시에 대해 비대화형 검토를 실행합니다.
`codex sandbox`	안정	Codex에서 제공하는 macOS, Linux 또는 Windows 샌드박스 내에서 임의의 명령어를 실행합니다.
`codex unarchive`	안정	보관된 대화형 세션을 세션 ID 또는 세션 이름으로 복원합니다.
`codex update`	안정	설치된 릴리스가 자체 업데이트를 지원하는 경우 Codex CLI 업데이트를 확인하고 적용합니다.

명령 세부 정보

`codex` (대화형)

하위 명령어 없이 codex을 실행하면 대화형 터미널 UI(TUI)가 시작됩니다. 에이전트는 위의 전역 플래그와 이미지 첨부 파일을 받습니다. 웹 검색은 기본적으로 캐시 모드를 사용합니다. 실시간 탐색으로 전환하려면 --search을 사용하세요. 절차가 간단한 로컬 작업에는 --sandbox workspace-write --ask-for-approval on-request을 사용하세요.

codex app-server --listen ws://IP:PORT로 시작한 앱 서버에 TUI를 연결하려면 --remote ws://host:port 또는 --remote wss://host:port을 사용하세요. 로컬 Unix 소켓의 경우 기본 소켓에는 --remote unix://을, 명시적 경로에는 --remote unix://PATH을 사용하세요. 서버가 WebSocket 인증용 전달자 토큰을 요구하면 --remote-auth-token-env <ENV_VAR>을 추가하세요.

`codex agents`

명령 센터를 열어 채팅을 탐색하고 공유 서버의 에이전트 간에 전환합니다. --remote <URL>로 원격 서버에 연결하고 --cd <DIR>로 새 원격 작업의 디렉터리를 설정합니다. codex agents는 --no-daemon을 지원하지 않습니다.

`codex queue`

기존 세션에 보낼 텍스트 메시지를 대기열에 추가합니다:

codex queue --thread <SESSION_ID> --message "Run the remaining checks"

--thread에는 UUID 또는 정확한 세션 이름을 지정할 수 있습니다. 세션 이름이 같으면 UUID를 사용합니다. 이 명령은 --remote 및 --remote-auth-token-env도 허용하지만, 이미지 첨부는 지원하지 않습니다.

`codex app-server`

Codex 앱 서버를 로컬에서 시작합니다. 주로 개발 및 디버깅을 위한 기능이며 사전 고지 없이 변경될 수 있습니다.

키	유형 / 값	세부 정보
`--analytics-default-enabled`	`boolean`	사용자가 구성에서 사용을 거부하지 않는 한 자사 app-server 클라이언트의 분석 기능을 기본적으로 활성화합니다.
`--listen`	`stdio:// \| ws://IP:PORT \| unix:// \| unix://PATH \| off`	전송 수신기 URL입니다. JSONL에는 `stdio://`, TCP WebSocket 엔드포인트에는 `ws://IP:PORT`, 기본 Unix 소켓에는 `unix://`, 사용자 지정 Unix 소켓에는 `unix://PATH`을 사용하고, 로컬 전송을 비활성화하려면 `off`을 사용하세요.
`--stdio`	`boolean`	stdio 전송을 사용합니다. `--listen stdio://`과 동일하며 `--listen`과 함께 사용할 수 없습니다.
`--ws-audience`	`string`	서명된 전달자 토큰에 예상되는 `aud` 클레임입니다. `--ws-auth signed-bearer-token`이 필요합니다.
`--ws-auth`	`capability-token \| signed-bearer-token`	app-server WebSocket 클라이언트의 인증 모드입니다. 생략하면 WebSocket 인증이 비활성화되며, 로컬이 아닌 수신기는 시작 중에 경고를 표시합니다.
`--ws-issuer`	`string`	서명된 전달자 토큰에 예상되는 `iss` 클레임입니다. `--ws-auth signed-bearer-token`이 필요합니다.
`--ws-max-clock-skew-seconds`	`number`	서명된 전달자 토큰의 `exp` 및 `nbf` 클레임을 검증할 때 허용되는 시계 오차입니다. `--ws-auth signed-bearer-token`이 필요합니다.
`--ws-shared-secret-file`	`absolute path`	서명된 JWT 전달자 토큰을 검증하는 데 사용되는 HMAC 공유 비밀이 포함된 파일입니다. `--ws-auth signed-bearer-token`과 함께 사용해야 합니다.
`--ws-token-file`	`absolute path`	공유 기능 토큰이 포함된 파일입니다. 대신 `--ws-token-sha256`을 제공하지 않는다면 `--ws-auth capability-token`과 함께 사용하세요.
`--ws-token-sha256`	`hexadecimal SHA-256 digest`	기능 토큰 인증에 예상되는 SHA-256 다이제스트입니다. 클라이언트 토큰이 다른 소스에서 제공되는 경우 `--ws-token-file` 대신 사용하세요.

codex app-server --listen stdio://은 기본 JSONL-over-stdio 동작을 유지하며, codex app-server --stdio은 해당 전송의 별칭입니다. --listen ws://IP:PORT은 app-server 클라이언트의 WebSocket 전송을 활성화합니다. 서버는 ws:// 수신 URL을 받습니다. 클라이언트가 wss://로 연결할 때는 TLS 종료나 보안 프록시를 사용하세요. Codex의 기본 Unix 소켓에서 WebSocket 핸드셰이크를 수락하려면 --listen unix://을 사용하고, 소켓 경로를 선택하려면 --listen unix:///absolute/path.sock을 사용하세요. 클라이언트 바인딩용 스키마를 생성하는 경우 제한된 필드와 메서드를 포함하려면 --experimental을 추가하세요.

로컬 호스트를 시작하지 않고 app-server를 원격 Code Mode 호스트에 연결하려면 --code-mode-host wss://code-mode.example.com/host을 추가하세요. 이 아웃바운드 연결은 --listen과 별개이며 app-server 프로세스의 모든 스레드가 공유합니다. ws://은 localhost 또는 SSH 포워딩된 호스트에만 사용하세요.

`codex remote-control`

codex remote-control을 실행하면 조건이 충족될 때 관리형 백그라운드 서버를 통해 원격 제어를 시작하고, 그렇지 않으면 포그라운드로 실행합니다. codex remote-control --no-daemon을 사용하면 명시적으로 포그라운드에서 실행합니다. codex remote-control start로 원격 제어가 활성화된 로컬 app-server 데몬을 시작하고, codex remote-control stop으로 중지합니다. 관리형 원격 제어 클라이언트와 SSH 원격 워크플로는 이 명령들을 사용합니다. 이 명령들은 codex app-server --listen을 대체하지 않으므로, 로컬 프로토콜 클라이언트를 만들 때는 해당 명령을 사용합니다.

데몬이 실행되면 codex remote-control pair를 사용하여 유효 기간이 짧은 수동 페어링 코드를 생성하고 출력합니다. 원격 제어 명령에 --json을 추가하면 기계가 읽을 수 있는 형식으로 출력됩니다. pair의 JSON 응답에는 pairingCode, manualPairingCode, environmentId 및 expiresAt이 포함됩니다. --no-daemon은 하위 명령 없이 실행하는 remote-control 명령에만 적용됩니다. start, stop 또는 pair와 함께 사용하지 않습니다.

`codex app`

macOS 또는 Windows에서 터미널을 통해 ChatGPT 데스크톱 앱을 시작합니다. macOS에서는 Codex가 특정 워크스페이스 경로를 열 수 있고, Windows에서는 열 경로를 출력합니다.

키	유형 / 값	세부 정보
`--download-url`	`url`	설치 중 사용되는 ChatGPT 데스크톱 앱 설치 프로그램 URL을 고급 재정의합니다.
`PATH`	`path`	ChatGPT 데스크톱 앱의 워크스페이스 경로입니다. macOS에서는 Codex가 이 경로를 열고, Windows에서는 경로를 출력합니다.

codex app은 설치된 ChatGPT 데스크톱 앱을 열고, 앱이 없으면 설치 프로그램을 시작합니다. macOS에서는 Codex가 제공된 워크스페이스 경로를 열고, Windows에서는 설치 후 열 경로를 출력합니다.

`codex debug app-server send-message-v2`

기본 제공 app-server 테스트 클라이언트를 사용하여 app-server의 V2 스레드/턴 흐름을 통해 메시지 하나를 전송합니다.

키	유형 / 값	세부 정보
`USER_MESSAGE`	`string`	기본 제공 V2 테스트 클라이언트 흐름을 통해 app-server로 전송되는 메시지 텍스트입니다.

이 디버그 흐름은 experimentalApi: true로 초기화하고, 스레드를 시작하고, 턴을 전송한 다음 서버 알림을 스트리밍합니다. 로컬에서 app-server 프로토콜 동작을 재현하고 검사할 때 사용하세요.

`codex debug models`

Codex에 표시되는 원시 모델 카탈로그를 JSON으로 출력합니다.

키	유형 / 값	세부 정보
`--bundled`	`boolean`	새로 고침을 건너뛰고 현재 Codex 바이너리에 번들로 포함된 모델 카탈로그만 출력합니다.

원격 모델 엔드포인트에서 새로 고치지 않고 현재 바이너리에 번들로 포함된 카탈로그만 검사하려면 --bundled을 사용하세요.

`codex debug prompt-input`

모델에 표시되는 정확한 프롬프트 입력 목록을 JSON으로 렌더링합니다. 지시 검색, 세션 컨텍스트 또는 프롬프트 구성을 디버깅할 때 사용하세요.

키	유형 / 값	세부 정보
`--image, -i`	`path[,path...]`	사용자 프롬프트에 하나 이상의 이미지를 첨부합니다. 여러 경로는 쉼표로 구분하거나 플래그를 반복해서 지정하세요.
`PROMPT`	`string`	세션 컨텍스트 뒤에 추가되는 선택적 사용자 프롬프트입니다.

`codex apply`

Codex 클라우드 채팅의 최신 diff를 로컬 저장소에 적용합니다. 인증을 완료하고 해당 채팅에 대한 액세스 권한이 있어야 합니다.

키	유형 / 값	세부 정보
`TASK_ID`	`string`	diff를 적용할 Codex 클라우드 채팅의 식별자입니다.

Codex는 패치된 파일을 출력하며 git apply이 실패하면(예: 충돌 발생) 0이 아닌 값으로 종료됩니다.

`codex review`

코드 검토를 비대화형으로 실행합니다. 검토 대상 하나만 선택하거나 사용자 지정 검토 지시를 프롬프트로 전달하세요.

키	유형 / 값	세부 정보
`--base`	`branch`	지정된 기준 브랜치를 기준으로 변경 사항을 검토합니다.
`--commit`	`SHA`	지정된 커밋에서 도입된 변경 사항을 검토합니다.
`--strict-config`	`boolean`	`config.toml`에 이 Codex 버전이 인식하지 못하는 필드가 있으면 오류를 발생시킵니다.
`--title`	`string`	검토 요약에 표시되는 커밋 제목을 설정합니다. `--commit`이 필요합니다.
`--uncommitted`	`boolean`	스테이징된 변경 사항, 스테이징되지 않은 변경 사항 및 추적되지 않는 변경 사항을 검토합니다.
`PROMPT`	`string \| - (read stdin)`	사용자 지정 검토 지시입니다. stdin에서 지시를 읽으려면 `-`을 사용하세요.

--uncommitted, --base, --commit 및 사용자 지정 PROMPT은 서로 충돌합니다. --title은 --commit과 함께만 사용하세요.

`codex archive` 및 `codex unarchive`

저장된 대화형 세션을 세션 ID 또는 세션 이름으로 보관하거나 복원합니다. 기록을 삭제하지 않고 세션 선택기를 정리하려면 이 명령어를 사용하세요. 세션 ID가 세션 이름보다 우선합니다.

codex archive <SESSION>
codex unarchive <SESSION>

키	유형 / 값	세부 정보
`--remote`	`ws://host:port \| wss://host:port \| unix:// \| unix://PATH`	보관 상태를 변경하기 전에 원격 app-server 엔드포인트에 연결합니다.
`--remote-auth-token-env`	`ENV_VAR`	`--remote`에 인증이 필요할 때 이 환경 변수에서 전달자 토큰을 읽습니다.
`SESSION`	`session ID \| session name`	보관하거나 복원할 저장된 세션입니다. 세션 ID가 세션 이름보다 우선합니다.

`codex delete`

저장된 대화형 세션을 세션 ID 또는 세션 이름으로 영구 삭제합니다. 활성 세션 목록에서 숨기는 대신 기록을 제거하려는 경우에만 사용하세요.

codex delete <SESSION>
codex delete <SESSION_UUID> --force

키	유형 / 값	세부 정보
`--force`	`boolean`	확인 메시지 없이 삭제합니다. 세션 인수는 UUID여야 하며, 이름을 사용하면 여전히 대화형 확인이 필요합니다.
`--remote`	`ws://host:port \| wss://host:port \| unix:// \| unix://PATH`	세션을 삭제하기 전에 원격 app-server 엔드포인트에 연결합니다.
`--remote-auth-token-env`	`ENV_VAR`	`--remote`에 인증이 필요할 때 이 환경 변수에서 전달자 토큰을 읽습니다.
`SESSION`	`session ID \| session name`	삭제할 저장된 세션입니다. 세션 ID가 세션 이름보다 우선합니다.

--force은 세션 UUID에만 사용하세요. 이름이 지정된 세션에는 계속 확인이 필요하므로 Codex가 확인 메시지 없이 중복되거나 모호한 이름을 삭제하지 않습니다.

`codex cloud`

터미널에서 Codex 클라우드 채팅과 상호 작용합니다. 기본 명령어는 대화형 선택기를 엽니다. codex cloud exec은 작업을 직접 제출하고, codex cloud list는 스크립팅이나 빠른 검사를 위해 최근 채팅을 반환합니다.

키	유형 / 값	세부 정보
`--attempts`	`1-4`	Codex 클라우드에서 실행할 어시스턴트 시도 횟수(best-of-N)입니다.
`--env`	`ENV_ID`	대상 Codex 클라우드 환경 식별자입니다(필수). 옵션을 나열하려면 `codex cloud`을 사용하세요.
`QUERY`	`string`	작업 프롬프트입니다. 생략하면 Codex가 세부 정보를 대화형으로 요청합니다.

인증에는 기본 CLI와 동일한 자격 증명이 사용됩니다. 작업 제출에 실패하면 Codex가 0이 아닌 값으로 종료됩니다.

`codex cloud list`

선택적 필터링과 페이지 매김을 사용하여 최근 클라우드 채팅을 나열합니다.

키	유형 / 값	세부 정보
`--cursor`	`string`	이전 요청에서 반환된 페이지 매김 커서입니다.
`--env`	`ENV_ID`	환경 식별자로 작업을 필터링합니다.
`--json`	`boolean`	일반 텍스트 대신 기계 판독 가능한 JSON을 출력합니다.
`--limit`	`1-20`	반환할 최대 작업 수입니다.

일반 텍스트 출력에서는 작업 URL 다음에 상태 세부 정보가 표시됩니다. 자동화에는 --json을 사용하세요. JSON 페이로드에는 tasks 배열과 선택적 cursor 값이 포함됩니다. 각 작업에는 id, url, title, status, updated_at, environment_id, environment_label, summary, is_review, attempt_total이 포함됩니다.

`codex completion`

셸 완성 스크립트를 생성하고 출력을 적절한 위치로 리디렉션합니다(예: codex completion zsh > "${fpath[1]}/_codex").

키	유형 / 값	세부 정보
`SHELL`	`bash \| zsh \| fish \| power-shell \| elvish`	완성을 생성할 셸입니다. 출력은 stdout으로 전송됩니다.

`codex doctor`

지원 문제를 제출하기 전이나 손상된 Codex 설치를 조사하는 동안 로컬 진단 보고서를 생성합니다. 보고서는 설치, 구성, 인증, 런타임, Git, 터미널, app-server 및 스레드 인벤토리의 상태를 확인합니다.

키	유형 / 값	세부 정보
`--all`	`boolean`	상세한 사람이 읽을 수 있는 보고서에서 긴 목록을 펼칩니다.
`--ascii`	`boolean`	사람이 읽을 수 있는 출력에 ASCII 상태 레이블과 구분 기호를 사용합니다.
`--json`	`boolean`	민감 정보가 삭제된 기계 판독 가능 지원 보고서를 출력합니다.
`--no-color`	`boolean`	사람이 읽을 수 있는 출력에서 ANSI 색상을 비활성화합니다.
`--summary`	`boolean`	그룹화된 검사 행과 최종 개수 요약만 표시합니다.

`codex features`

$CODEX_HOME/config.toml에 저장된 기능 플래그를 관리합니다. enable 및 disable 명령어는 변경 사항을 영구 저장하여 이후 세션에도 적용합니다. features 하위 명령어는 --profile을 받지 않습니다.

키	유형 / 값	세부 정보
`Disable subcommand`	`codex features disable <feature>`	`$CODEX_HOME/config.toml`에서 기능 플래그를 영구적으로 비활성화합니다.
`Enable subcommand`	`codex features enable <feature>`	`$CODEX_HOME/config.toml`에서 기능 플래그를 영구적으로 활성화합니다.
`List subcommand`	`codex features list`	알려진 기능 플래그, 성숙도 단계 및 실제 적용 상태를 표시합니다.

`codex exec`

사람의 상호 작용 없이 완료되어야 하는 스크립트 또는 CI 형식의 실행에는 codex exec(또는 축약형 codex e)을 사용하세요.

키	유형 / 값	세부 정보
`--cd, -C`	`path`	작업을 실행하기 전에 워크스페이스 루트를 설정합니다.
`--color`	`always \| never \| auto`	stdout의 ANSI 색상을 제어합니다.
`--dangerously-bypass-approvals-and-sandbox, --yolo`	`boolean`	승인 메시지와 샌드박싱을 우회합니다. 위험하므로 격리된 실행기 내에서만 사용하세요.
`--dangerously-bypass-hook-trust`	`boolean`	이 호출에서 영구 저장된 훅 신뢰를 요구하지 않고 활성화된 훅을 실행합니다. 훅 소스를 이미 검증하는 자동화에만 사용해야 합니다.
`--ephemeral`	`boolean`	세션 롤아웃 파일을 디스크에 영구 저장하지 않고 실행합니다.
`--full-auto`	`boolean`	사용 중단된 호환성 플래그입니다. `--sandbox workspace-write`을 사용하는 것이 좋습니다. 이 플래그를 사용하면 Codex가 경고를 출력합니다.
`--ignore-rules`	`boolean`	이번 실행에서 사용자 또는 프로젝트 execpolicy `.rules` 파일을 로드하지 않습니다.
`--ignore-user-config`	`boolean`	`$CODEX_HOME/config.toml`을 로드하지 않습니다. 인증에는 계속 `CODEX_HOME`이 사용됩니다.
`--image, -i`	`path[,path...]`	첫 번째 메시지에 이미지를 첨부합니다. 반복해서 사용할 수 있으며 쉼표로 구분된 목록을 지원합니다.
`--json, --experimental-json`	`boolean`	서식 있는 텍스트 대신 줄바꿈으로 구분된 JSON 이벤트를 출력합니다.
`--local-provider`	`lmstudio \| ollama`	`--oss`과 함께 사용할 로컬 공급자를 선택하여 이번 실행에서 `oss_provider`을 재정의합니다.
`--model, -m`	`string`	이번 실행에서 구성된 모델을 재정의합니다.
`--oss`	`boolean`	로컬 오픈 소스 공급자를 사용합니다. Codex는 `--local-provider` 또는 구성된 `oss_provider`을 사용하며, 둘 다 설정되지 않은 경우 오류와 함께 종료됩니다.
`--output-last-message, -o`	`path`	어시스턴트의 최종 메시지를 파일에 씁니다. 후속 스크립팅에 유용합니다.
`--output-schema`	`path`	예상되는 최종 응답 형태를 설명하는 JSON Schema 파일입니다. Codex가 도구 출력을 이에 맞춰 검증합니다.
`--profile, -p`	`string`	기본 사용자 구성 위에 `$CODEX_HOME/profile-name.config.toml`을 계층으로 적용합니다.
`--sandbox, -s`	`read-only \| workspace-write \| danger-full-access`	모델이 생성한 명령어에 적용할 샌드박스 정책입니다. 기본값은 구성을 따릅니다.
`--skip-git-repo-check`	`boolean`	Git 저장소 외부에서 실행할 수 있도록 허용합니다(일회성 디렉터리에 유용).
`-c, --config`	`key=value`	비대화형 실행을 위한 인라인 구성 재정의입니다(반복 가능).
`PROMPT`	`string \| - (read stdin)`	작업의 초기 지시입니다. stdin에서 프롬프트를 파이프하려면 `-`을 사용하세요.
`Resume subcommand`	`codex exec resume [SESSION_ID]`	exec 세션을 ID로 재개하거나, `--last`을 추가하여 현재 작업 디렉터리의 가장 최근 세션을 계속합니다. 모든 디렉터리의 세션을 고려하려면 `--all`을 추가하세요. 선택적 후속 프롬프트를 받습니다.

Codex는 기본적으로 서식 있는 출력을 작성합니다. 줄바꿈으로 구분된 JSON 이벤트(상태 변경마다 하나씩)를 받으려면 --json을 추가하세요. 선택적 resume 하위 명령어를 사용하면 비대화형 작업을 계속할 수 있습니다. 현재 작업 디렉터리에서 가장 최근 세션을 선택하려면 --last을 사용하고, 모든 세션에서 검색하려면 --all을 추가하세요.

키	유형 / 값	세부 정보
`--all`	`boolean`	가장 최근 세션을 선택할 때 현재 작업 디렉터리 외부의 세션도 포함합니다.
`--image, -i`	`path[,path...]`	후속 프롬프트에 하나 이상의 이미지를 첨부합니다. 여러 경로는 쉼표로 구분하거나 플래그를 반복해서 지정하세요.
`--last`	`boolean`	현재 작업 디렉터리에서 가장 최근 채팅을 재개합니다.
`PROMPT`	`string \| - (read stdin)`	재개 직후 전송되는 선택적 후속 지시입니다.
`SESSION_ID`	`uuid \| session name`	지정된 세션을 재개합니다. 가장 최근 세션을 계속하려면 생략하고 `--last`을 사용하세요.

codex exec fork <SESSION_ID> [PROMPT]를 사용하면 저장된 세션을 새 세션으로 복사할 수 있습니다. 세션 인수에는 UUID 또는 이름을 지정할 수 있습니다. 프롬프트가 없으면 Codex는 턴을 시작하지 않고 포크를 생성합니다. 프롬프트로 -를 전달하면 stdin에서 읽고, --image를 추가하면 이미지를 첨부합니다.

이미지, --output-schema, --output-last-message 또는 --ephemeral을 사용할 때는 프롬프트가 필요합니다.

새 실행이나 포크한 실행에 --worktree를 추가하면 관리형 Git 작업 트리를 만들 수 있습니다:

codex exec --worktree "implement the next step"
codex exec fork <SESSION_ID> --worktree "try an alternative approach"

--worktree는 로컬 실행이 필요합니다. resume, review, --ephemeral 또는 --ignore-user-config와 함께 사용하지 마세요.

`codex execpolicy`

execpolicy 규칙 파일을 저장하기 전에 검사합니다. codex execpolicy check은 하나 이상의 --rules 플래그(예: ~/.codex/rules 아래의 파일)를 받으며, 가장 엄격한 결정과 일치하는 모든 규칙을 보여 주는 JSON을 출력합니다. 출력의 서식을 지정하려면 --pretty을 추가하세요. execpolicy 명령어는 현재 프리뷰 단계입니다.

키	유형 / 값	세부 정보
`--pretty`	`boolean`	JSON 결과를 보기 좋게 출력합니다.
`--rules, -r`	`path (repeatable)`	평가할 execpolicy 규칙 파일의 경로입니다. 여러 파일의 규칙을 결합하려면 플래그를 여러 번 지정하세요.
`COMMAND...`	`var-args`	지정된 정책을 기준으로 검사할 명령어입니다.

`codex login`

ChatGPT 계정, API key 또는 액세스 토큰으로 CLI를 인증합니다. 플래그를 지정하지 않으면 Codex가 ChatGPT OAuth 흐름을 위한 브라우저를 엽니다.

키	유형 / 값	세부 정보
`--device-auth`	`boolean`	브라우저 창을 시작하는 대신 OAuth 기기 코드 흐름을 사용합니다.
`--with-access-token`	`boolean`	stdin에서 액세스 토큰을 읽습니다(예: `printenv CODEX_ACCESS_TOKEN \| codex login --with-access-token`).
`--with-api-key`	`boolean`	stdin에서 API key를 읽습니다(예: `printenv OPENAI_API_KEY \| codex login --with-api-key`).
`status subcommand`	`codex login status`	활성 인증 모드를 출력하며, 로그인되어 있으면 0으로 종료됩니다.

codex login status은 자격 증명이 있을 때 0로 종료되므로 자동화 스크립트에 유용합니다.

`codex logout`

API key 및 ChatGPT 인증에 저장된 자격 증명을 모두 제거합니다. 이 명령어에는 플래그가 없습니다.

`codex mcp`

~/.codex/config.toml에 저장된 Model Context Protocol 서버 항목을 관리합니다.

키	유형 / 값	세부 정보
`add <name>`	`-- <command...> \| --url <value>`	stdio 시작 명령어나 스트리밍 가능한 HTTP URL을 사용하여 서버를 등록합니다. stdio 전송에서 `--env KEY=VALUE`을 지원합니다.
`get <name>`	`--json`	특정 서버 구성을 표시합니다. `--json`은 원시 구성 항목을 출력합니다.
`list`	`--json`	구성된 MCP server를 나열합니다. 기계 판독 가능한 출력을 사용하려면 `--json`을 추가하세요.
`login <name>`	`--scopes scope1,scope2`	스트리밍 가능한 HTTP 서버에 대한 OAuth 로그인을 시작합니다(OAuth를 지원하는 서버만 해당).
`logout <name>`		스트리밍 가능한 HTTP 서버에 저장된 OAuth 자격 증명을 제거합니다.
`remove <name>`		저장된 MCP server 정의를 삭제합니다.

add 하위 명령어는 stdio 및 스트리밍 가능한 HTTP 전송을 모두 지원합니다.

키	유형 / 값	세부 정보
`--bearer-token-env-var`	`ENV_VAR`	스트리밍 가능한 HTTP 서버에 연결할 때 해당 값이 전달자 토큰으로 전송되는 환경 변수입니다.
`--env KEY=VALUE`	`repeatable`	stdio 서버를 시작할 때 적용되는 환경 변수 할당입니다.
`--oauth-client-id`	`CLIENT_ID`	스트리밍 가능한 HTTP MCP server의 OAuth 클라이언트 식별자입니다. `--url`이 필요합니다.
`--oauth-resource`	`RESOURCE`	스트리밍 가능한 HTTP MCP server에 로그인할 때 포함할 OAuth 리소스 매개변수입니다. `--url`이 필요합니다.
`--url`	`https://…`	stdio 대신 스트리밍 가능한 HTTP 서버를 등록합니다. `COMMAND...`과 함께 사용할 수 없습니다.
`COMMAND...`	`stdio transport`	MCP server를 시작할 실행 파일과 인수입니다. `--` 뒤에 지정하세요.

OAuth 작업(login, logout)은 스트리밍 가능한 HTTP 서버에서만 작동하며, 서버가 OAuth를 지원하는 경우에만 사용할 수 있습니다.

`codex plugin`

구성된 마켓플레이스에서 플러그인을 설치하고, 나열하고, 제거합니다.

키	유형 / 값	세부 정보
`add <plugin[@marketplace]>`	`[--marketplace, -m NAME] [--json]`	구성된 마켓플레이스에서 플러그인을 설치합니다. 플러그인 인수에서 `@marketplace`을 생략하는 경우 `--marketplace` 또는 `-m`을 사용하세요.
`list`	`[--marketplace, -m NAME] [--available --json] [--json]`	설치된 플러그인을 나열합니다. `--json`를 사용하면 출력에 `installed` 및 `available` 배열이 포함됩니다. `--available`은 설치되지 않은 마켓플레이스 플러그인을 포함하며 `--json`이 필요합니다.
`marketplace`		구성된 마켓플레이스 소스를 관리합니다. 아래의 `codex plugin marketplace`을 참조하세요.
`remove <plugin[@marketplace]>`	`[--marketplace, -m NAME] [--json]`	로컬 구성과 캐시에서 설치된 플러그인을 제거합니다. 자동화 친화적 출력에는 `--json`을 사용하세요.

codex plugin add --json은 pluginId, name, marketplaceName, version, installedPath, authPolicy을 출력합니다. codex plugin list --json은 installed 및 available 배열을 출력합니다. 항목에는 pluginId, name, marketplaceName, version, installed, enabled, source, installPolicy, authPolicy이 포함되며, 가능한 경우 구성된 마켓플레이스 소스 유형과 값을 담은 marketplaceSource도 포함됩니다. codex plugin remove --json은 pluginId, name, marketplaceName을 출력합니다.

`codex plugin marketplace`

Codex가 탐색하고 설치할 수 있는 플러그인 마켓플레이스 소스를 관리합니다.

키	유형 / 값	세부 정보
`add <source>`	`[--ref REF] [--sparse PATH] [--json]`	GitHub 축약형, Git URL, SSH URL 또는 로컬 마켓플레이스 루트 디렉터리에서 플러그인 마켓플레이스를 설치합니다. `--sparse`은 Git 소스에서만 지원되며 반복해서 사용할 수 있습니다.
`list`	`[--json]`	Codex가 현재 고려 중인 플러그인 마켓플레이스와 각 마켓플레이스의 루트 경로를 표시합니다.
`remove <marketplace-name>`	`[--json]`	구성된 플러그인 마켓플레이스를 제거합니다.
`upgrade [marketplace-name]`	`[--json]`	구성된 Git 마켓플레이스 하나를 새로 고치거나, 이름을 제공하지 않으면 구성된 모든 Git 마켓플레이스를 새로 고칩니다.

codex plugin marketplace add은 owner/repo 또는 owner/repo@ref 같은 GitHub 축약형, HTTP 또는 HTTPS Git URL, SSH Git URL 및 로컬 마켓플레이스 루트 디렉터리를 받습니다. Git ref를 고정하려면 --ref을 사용하고, Git 기반 마켓플레이스 저장소에 희소 체크아웃을 사용하려면 --sparse PATH을 반복하세요.

codex plugin marketplace list은 암시적으로 검색된 기본 마켓플레이스와 구성된 마켓플레이스 스냅샷을 포함하여 범위 내 마켓플레이스 이름과 루트를 출력합니다.

자동화 친화적 출력을 사용하려면 마켓플레이스 추가, 목록 조회, 업그레이드 또는 제거 명령어에 --json을 추가하세요. 마켓플레이스 추가 JSON에는 marketplaceName, installedRoot, alreadyAdded이 포함됩니다. 목록 JSON에는 name, root 및 선택적 marketplaceSource을 포함하는 marketplaces 배열이 들어갑니다. 업그레이드 JSON에는 selectedMarketplaces, upgradedRoots, errors이 포함되고, 제거 JSON에는 marketplaceName 및 installedRoot이 포함됩니다.

`codex mcp-server`

`codex resume`

ID로 대화형 세션을 이어가거나 가장 최근 채팅을 재개합니다. codex resume은 --last의 범위를 현재 작업 디렉터리로 제한하며, --all을 전달하면 이 제한을 해제합니다. 모델과 샌드박스 설정을 재정의할 수 있지만, --worktree는 사용할 수 없습니다.

현재 작업 디렉터리가 세션에 저장된 디렉터리와 다르면 Codex가 사용할 디렉터리를 묻습니다. 이 선택을 확인 메시지 없이 재사용하려면 tui.resume_cwd을 "current" 또는 "session"으로 설정하세요. 명시적 --cd(-C) 재정의가 tui.resume_cwd보다 우선합니다.

키	유형 / 값	세부 정보
`--all`	`boolean`	가장 최근 세션을 선택할 때 현재 작업 디렉터리 외부의 세션도 포함합니다.
`--include-non-interactive`	`boolean`	선택기 및 `--last` 선택에 비대화형 세션을 포함합니다.
`--last`	`boolean`	선택기를 건너뛰고 현재 작업 디렉터리에서 가장 최근 채팅을 재개합니다.
`SESSION_ID`	`uuid \| session name`	지정된 세션을 재개합니다. 가장 최근 세션을 계속하려면 생략하고 `--last`을 사용하세요.

`codex fork`

이전 대화형 세션을 새 채팅으로 포크합니다. 기본적으로 codex fork은 세션 선택기를 엽니다. 대신 가장 최근 세션을 포크하려면 --last을 추가하세요.

현재 세션 디렉터리와 저장된 세션 디렉터리가 다르면 codex fork은 codex resume과 동일한 작업 디렉터리 확인 메시지와 tui.resume_cwd 설정을 사용합니다.

키	유형 / 값	세부 정보
`--all`	`boolean`	선택기에 현재 작업 디렉터리 외부의 세션도 표시합니다.
`--last`	`boolean`	선택기를 건너뛰고 가장 최근 채팅을 자동으로 포크합니다.
`SESSION_ID`	`uuid`	지정된 세션을 포크합니다. 가장 최근 세션을 포크하려면 생략하고 `--last`을 사용하세요.

관리형 Git 작업 트리로 포크하려면 codex fork <SESSION_ID> --worktree를 실행하세요. 명시적인 세션 ID와 로컬 실행이 필요하며, --last 또는 세션 선택기는 지원하지 않습니다.

`codex sandbox`

샌드박스 도우미를 사용하여 Codex가 내부에서 사용하는 것과 동일한 정책에 따라 명령어를 실행합니다.

macOS seatbelt

키	유형 / 값	세부 정보
`--allow-unix-socket`	`path`	샌드박스된 명령어가 이 경로를 루트로 하는 Unix 소켓을 바인딩하거나 연결할 수 있도록 허용합니다. 여러 경로를 허용하려면 반복해서 사용하세요.
`--cd, -C`	`DIR`	프로필 확인 및 명령어 실행에 사용되는 작업 디렉터리입니다. `--permission-profile`이 필요합니다.
`--config, -c`	`key=value`	구성 재정의를 샌드박스된 실행에 전달합니다(반복 가능).
`--include-managed-config`	`boolean`	명시적 권한 프로필을 확인할 때 관리형 요구 사항을 포함합니다. `--permission-profile`이 필요합니다.
`--log-denials`	`boolean`	명령어가 실행되는 동안 `log stream`으로 macOS 샌드박스 거부를 캡처하고 종료 후 출력합니다.
`--permission-profile, -P`	`NAME`	활성 구성 스택에서 이름이 지정된 권한 프로필을 적용합니다.
`--profile, -p`	`NAME`	기본 사용자 구성 위에 `$CODEX_HOME/NAME.config.toml`을 계층으로 적용합니다.
`COMMAND...`	`var-args`	macOS Seatbelt에서 실행할 셸 명령어입니다. `--` 뒤의 모든 내용이 전달됩니다.

Linux 샌드박스

키	유형 / 값	세부 정보
`--cd, -C`	`DIR`	프로필 확인 및 명령어 실행에 사용되는 작업 디렉터리입니다. `--permission-profile`이 필요합니다.
`--config, -c`	`key=value`	샌드박스를 시작하기 전에 적용되는 구성 재정의입니다(반복 가능).
`--include-managed-config`	`boolean`	명시적 권한 프로필을 확인할 때 관리형 요구 사항을 포함합니다. `--permission-profile`가 필요합니다.
`--permission-profile, -P`	`NAME`	활성 구성 스택에서 이름이 지정된 권한 프로필을 적용합니다.
`--profile, -p`	`NAME`	기본 사용자 구성 위에 `$CODEX_HOME/NAME.config.toml`을 계층으로 적용합니다.
`COMMAND...`	`var-args`	Landlock + seccomp에서 실행할 명령어입니다. `--` 뒤에 실행 파일을 지정하세요.

Windows

키	유형 / 값	세부 정보
`--cd, -C`	`DIR`	프로필 확인 및 명령어 실행에 사용되는 작업 디렉터리입니다. `--permission-profile`이 필요합니다.
`--config, -c`	`key=value`	샌드박스를 시작하기 전에 적용되는 구성 재정의입니다(반복 가능).
`--include-managed-config`	`boolean`	명시적 권한 프로필을 확인할 때 관리형 요구 사항을 포함합니다. `--permission-profile`이 필요합니다.
`--permission-profile, -P`	`NAME`	활성 구성 스택에서 이름이 지정된 권한 프로필을 적용합니다.
`--profile, -p`	`NAME`	기본 사용자 구성 위에 `$CODEX_HOME/NAME.config.toml`을 계층으로 적용합니다.
`COMMAND...`	`var-args`	네이티브 Windows 샌드박스에서 실행할 명령어입니다. `--` 뒤에 실행 파일을 지정하세요.

`codex update`

설치된 릴리스가 자체 업데이트를 지원하는 경우 Codex CLI 업데이트를 확인하고 적용합니다. 디버그 빌드는 대신 릴리스 빌드를 설치하라는 메시지를 출력합니다.

플래그 조합 및 안전한 사용 팁

워크스페이스 내부에서 수행할 수 있는 무인 로컬 작업에는 --sandbox workspace-write을 사용하고, 전용 샌드박스 VM 내부가 아니라면 --dangerously-bypass-approvals-and-sandbox을 사용하지 마세요.
Codex에 더 많은 디렉터리의 쓰기 권한을 부여해야 할 때는 --sandbox danger-full-access을 강제로 사용하기보다 --add-dir을 사용하는 것이 좋습니다.
CI에서 기계 판독 가능한 진행 상황과 최종 자연어 요약을 캡처하려면 --json과 --output-last-message을 함께 사용하세요.

대화형 단축키

@를 입력하면 작업 공간에서 파일을 검색하고 해당 경로를 프롬프트에 추가할 수 있습니다.
Up 또는 Down을 누르면 이전에 작성한 초안을 불러올 수 있습니다.
Ctrl+R을 눌러 프롬프트 기록을 검색한 다음, Enter를 눌러 검색 결과를 사용하거나 Escape를 눌러 취소합니다.
Ctrl+O를 누르거나 /copy를 실행하면 가장 최근에 완료된 Codex 출력을 복사할 수 있습니다.
줄 앞에 !를 붙이면 현재 승인 및 샌드박스 설정에 따라 로컬 셸 명령을 실행할 수 있습니다.
Codex가 작업 중일 때 Tab을 누르면 후속 프롬프트, 슬래시 명령 또는 셸 명령을 다음 턴의 대기열에 추가할 수 있습니다.
Codex가 작업 중일 때 Enter를 누르면 현재 턴에 새 지침을 추가할 수 있습니다.
입력창이 비어 있을 때 Escape를 두 번 누르면 이전 사용자 메시지를 수정하고 해당 지점에서 대화를 분기할 수 있습니다.
Ctrl+C를 누르거나 /exit를 실행하면 세션을 종료할 수 있습니다.

기본 제공 슬래시 명령

Codex에는 다음 명령어가 포함되어 있습니다. 슬래시 팝업을 열고 명령어 이름을 입력하기 시작하면 목록을 필터링할 수 있습니다.

채팅이 이미 실행 중일 때 슬래시 명령어를 입력하고 Tab을 누르면 다음 턴의 대기열에 추가할 수 있습니다. Codex는 대기열의 슬래시 명령어가 실행될 때 이를 구문 분석하므로 명령어 메뉴와 오류는 현재 턴이 끝난 후 표시됩니다. 명령어를 대기열에 추가하기 전에도 슬래시 완성 기능은 계속 작동합니다.

명령	용도	사용 시점
`/permissions`	Codex가 사전 확인 없이 수행할 수 있는 작업을 설정합니다.	세션 도중 Auto와 Read Only 간 전환 등 승인 요건을 완화하거나 강화할 때 사용합니다.
`/ide`	열린 파일, 현재 선택 영역, 기타 IDE 컨텍스트를 포함합니다.	IDE에 무엇이 열려 있는지 다시 설명하지 않고 다음 프롬프트에 편집기 컨텍스트를 가져올 때 사용합니다.
`/keymap`	TUI 키보드 단축키를 재설정합니다.	사용자 지정 단축키 매핑을 확인하고 `config.toml`에 저장할 때 사용합니다.
`/vim`	입력창의 Vim 모드를 켜거나 끕니다.	Vim 일반/삽입 모드와 기본 입력창 편집 모드 사이를 전환할 때 사용합니다.
`/setup-default-sandbox`	권한이 상승된 에이전트 샌드박스를 설정합니다(Windows 전용).	Codex가 권한 상승 설정을 제안한 후 기능이 제한된 Windows 샌드박스를 교체할 때 사용합니다.
`/agents`	에이전트 제어 센터를 엽니다.	연결된 서버에서 채팅을 살펴보고 에이전트 간에 전환할 때 사용합니다.
`/subagents`	활성 하위 에이전트 스레드를 전환합니다.	현재 세션에서 하위 에이전트의 작업을 확인하거나 이어갈 때 사용합니다.
`/apps`	앱(커넥터)을 찾아보고 프롬프트에 삽입합니다.	Codex에 앱 사용을 요청하기 전에 앱을 `$app-slug` 형식으로 첨부할 때 사용합니다.
`/plugins`	설치된 플러그인과 검색 가능한 플러그인을 찾아봅니다.	플러그인 도구를 확인하거나, 추천 플러그인을 설치하거나, 플러그인의 사용 가능 여부를 관리할 때 사용합니다.
`/hooks`	수명 주기 훅을 확인하고 관리합니다.	설정된 훅을 확인하거나, 새로 추가되거나 변경된 훅을 신뢰하도록 설정하거나, 관리 대상이 아닌 훅이 실행되기 전에 비활성화할 때 사용합니다.
`/clear`	터미널을 지우고 새 채팅을 시작합니다.	새로 시작하기 위해 화면에 표시된 UI와 채팅 컨텍스트를 함께 초기화할 때 사용합니다.
`/rename`	현재 채팅의 이름을 변경합니다.	TUI를 벗어나지 않고 저장된 세션에 알아보기 쉬운 이름을 지정할 때 사용합니다.
`/archive`	현재 세션을 보관 처리합니다.	대화 기록을 삭제하지 않고 현재 세션을 활성 세션 목록에서 제거할 때 사용합니다.
`/delete`	현재 세션을 영구적으로 삭제합니다.	보관 처리만으로 충분하지 않아 대화 기록과 하위 세션까지 제거할 때 사용합니다.
`/compact`	화면에 표시된 채팅을 요약하여 토큰을 확보합니다.	장시간 실행 후 Codex가 컨텍스트 창을 초과하지 않으면서 핵심 내용을 유지하도록 할 때 사용합니다.
`/copy`	가장 최근에 완료된 Codex 출력을 복사합니다.	수동으로 선택하지 않고 가장 최근에 완료된 응답이나 계획 텍스트를 복사할 때 사용합니다. `Ctrl+O` 키를 눌러도 됩니다.
`/diff`	Git이 아직 추적하지 않는 파일을 포함하여 Git diff를 표시합니다.	커밋하거나 테스트를 실행하기 전에 Codex의 수정 사항을 검토할 때 사용합니다.
`/exit`	CLI를 종료합니다(`/quit`와 동일).	다른 이름의 명령으로, 두 명령 모두 세션을 종료합니다.
`/experimental`	실험적 기능을 켜거나 끕니다.	네트워크 프록시나 실행 중 절전 방지 등의 옵션을 활성화할 때 사용합니다.
`/approve`	최근 자동 검토에서 거부된 작업의 재시도를 한 번 승인합니다.	자동 검토자가 거부한 명령이나 작업을 재시도할 때 사용합니다.
`/memories`	메모리 사용과 생성을 설정합니다.	TUI를 벗어나지 않고 메모리 주입이나 메모리 생성을 켜거나 끌 때 사용합니다.
`/skills`	스킬을 찾아보고 사용합니다.	관련 로컬 스킬을 선택하여 특정 작업에 맞게 동작을 개선할 때 사용합니다.
`/import`	Claude Code 또는 Cursor의 설정, 프로젝트, 채팅을 가져옵니다.	지원되는 외부 에이전트 자료를 Codex 설정과 로컬 파일로 이전할 때 사용합니다.
`/feedback`	Codex 유지 관리자에게 로그를 보냅니다.	문제를 보고하거나 지원팀에 진단 정보를 공유할 때 사용합니다.
`/init`	현재 디렉터리에 `AGENTS.md`의 기본 틀을 생성합니다.	작업 중인 저장소나 하위 디렉터리에 지속적으로 적용할 지침을 기록할 때 사용합니다.
`/logout`	Codex에서 로그아웃합니다.	공유 컴퓨터를 사용할 때 로컬 자격 증명을 지우는 데 사용합니다.
`/mcp`	설정된 Model Context Protocol(MCP) 도구를 나열합니다.	세션 중 Codex가 호출할 수 있는 외부 도구를 확인할 때 사용합니다. 서버 세부 정보를 보려면 `verbose`를 추가합니다.
`/mention`	채팅에 파일을 첨부합니다.	Codex가 다음에 살펴볼 특정 파일이나 폴더를 지정할 때 사용합니다.
`/model`	활성 모델과 추론 수준(지원되는 경우)을 선택합니다.	`gpt-6-luna` 또는 `gpt-6.1-sol`가 표시되면 사용합니다.
`/fast`	모델 카탈로그에서 Fast 서비스 등급을 제공하는 경우 이를 켜거나 끕니다.	현재 모델의 Fast 등급을 켜거나 끄고 선택을 저장할 때 사용합니다.
`/plan`	계획 모드로 전환하고 선택적으로 프롬프트를 보냅니다.	구현 작업을 시작하기 전에 Codex에 실행 계획을 제안하도록 요청할 때 사용합니다.
`/goal`	작업 목표를 설정, 편집, 일시 중지, 재개, 확인하거나 삭제합니다.	큰 작업을 진행하는 동안 Codex가 지속적으로 추적할 목표를 지정할 때 사용합니다.
`/ps`	백그라운드 터미널과 최근 출력을 표시합니다.	기본 대화 기록을 벗어나지 않고 장시간 실행 중인 명령을 확인할 때 사용합니다.
`/stop`	모든 백그라운드 터미널을 중지합니다.	현재 세션에서 시작한 백그라운드 터미널 작업을 취소할 때 사용합니다.
`/fork`	현재 채팅을 새 채팅으로 분기합니다.	현재 대화 기록을 유지하면서 새로운 접근 방식을 살펴보기 위해 활성 세션을 분기할 때 사용합니다.
`/app`	ChatGPT 데스크톱 앱에서 현재 세션을 계속합니다.	macOS 또는 Windows에서 TUI에서 데스크톱 앱으로 이동할 때 사용합니다.
`/side`, `/btw`	임시 보조 채팅을 시작합니다.	기본 채팅의 대화 기록을 흐트러뜨리지 않고 특정 내용에 관한 후속 질문을 할 때 사용합니다.
`/raw`	원시 스크롤백 모드를 켜거나 끕니다.	긴 출력을 검토하면서 터미널에서 텍스트를 선택하고 복사할 때 서식을 줄이는 데 사용합니다.
`/resume`	세션 목록에서 저장된 채팅을 재개합니다.	처음부터 다시 시작하지 않고 이전 CLI 세션의 작업을 이어서 진행할 때 사용합니다.
`/new`	같은 CLI 세션 안에서 새 채팅을 시작합니다.	같은 저장소에서 새 프롬프트를 사용하기 위해 CLI를 벗어나지 않고 채팅 컨텍스트를 초기화할 때 사용합니다.
`/quit`	CLI를 종료합니다.	세션을 즉시 종료할 때 사용합니다.
`/review`	Codex에 작업 트리 검토를 요청합니다.	Codex가 작업을 완료한 후 또는 로컬 변경 사항을 추가로 검토받고 싶을 때 실행합니다.
`/status`	세션 설정과 토큰 사용량을 표시합니다.	활성 모델, 승인 정책, 쓰기 가능한 루트, 남은 컨텍스트 용량을 확인할 때 사용합니다.
`/usage`	계정 토큰 사용량을 확인하거나 사용 한도 초기화를 사용합니다.	TUI 안에서 일간, 주간 또는 누적 ChatGPT 토큰 사용 내역을 확인할 때 사용합니다.
`/debug-config`	설정 계층과 요구 사항 진단 정보를 출력합니다.	실험적 네트워크 제약 조건을 포함한 우선순위와 정책 요구 사항을 디버깅할 때 사용합니다.
`/statusline`	TUI 상태 표시줄 필드를 대화형으로 설정합니다.	하단 항목(모델/컨텍스트/한도/git/토큰/세션)을 선택하고 순서를 바꾼 후 config.toml에 저장할 때 사용합니다.
`/title`	터미널 창 또는 탭 제목 필드를 대화형으로 설정합니다.	프로젝트, 상태, 스레드, 브랜치, 모델, 작업 진행 상황 등의 제목 항목을 선택하고 순서를 바꿀 때 사용합니다.
`/theme`	구문 강조 테마를 선택합니다.	터미널 구문 강조 테마를 미리 보고 저장할 때 사용합니다.
`/pets`, `/pet`	터미널 펫을 선택하거나 숨깁니다.	기본 제공 또는 사용자 지정 장식용 펫으로 TUI를 꾸밀 때 사용합니다.
`/tui`	다음 실행에 사용할 터미널 모드를 선택합니다.	터미널 스크롤백과 전체 화면 대화 기록 간에 전환할 때 사용합니다.
`/export`	대화를 Markdown으로 내보냅니다.	전체 대화 기록을 파일에 저장하거나 클립보드에 복사할 때 사용합니다.
`/recap`	현재 대화의 요약을 생성합니다.	컨텍스트를 압축하지 않고 채팅 내용을 파악할 때 사용합니다.
`/cd`	세션의 작업 디렉터리를 변경합니다.	대기 중인 기본 채팅을 다른 디렉터리에서 이어갈 때 사용합니다.
`/pwd`, `/cwd`	작업 디렉터리를 표시합니다.	활성 세션이 사용하는 디렉터리를 확인할 때 사용합니다.
`/worktree`	관리형 Git 작업 트리에서 채팅을 시작하거나 이어갑니다.	로컬 저장소의 별도 체크아웃에서 작업할 때 사용합니다.
`/daemon`	백그라운드 서버 제어 기능을 엽니다.	연결을 확인하고 Codex가 소유한 로컬 서버를 관리할 때 사용합니다.
`/warnings`	저장된 경고와 진단 정보를 봅니다.	세션 중에 표시된 경고를 다시 확인할 때 사용합니다.

/quit과 /exit은 모두 CLI를 종료합니다. 중요한 작업을 저장하거나 커밋한 후에만 사용하세요.

Codex가 먼저 묻지 않고 수행할 수 있는 작업을 조정하려면 /permissions을 사용하세요. 자동 검토가 거부한 최근 작업을 다시 시도해야 할 때만 /approve을 사용하세요.

슬래시 명령으로 세션 제어하기

다음 워크플로를 사용하면 Codex를 다시 시작하지 않고도 세션을 계획대로 유지할 수 있습니다.

`/tui`로 터미널 모드 선택하기

/tui를 입력합니다.
스크롤백 또는 전체 화면 모드를 선택한 뒤 확인합니다.
Codex를 다시 시작하여 선택 사항을 적용합니다.

예상 결과: 다음 실행 시 저장된 터미널 모드를 사용합니다. 실행 시 설정을 재정의하는 --no-alt-screen 등의 옵션은 여전히 적용됩니다.

`/export`로 대화 내보내기

/export를 입력합니다.
클립보드에 복사 또는 파일에 저장 을 선택합니다.

예상 결과: Codex가 전체 대화를 Markdown으로 내보냅니다. 파일에 바로 저장하려면 /export session.md를 실행하세요. 현재 턴이 끝날 때까지 기다린 뒤 내보내세요.

`/recap`으로 채팅 요약하기

Codex가 대기 상태일 때 /recap을 입력합니다.

예상 결과: Codex가 대화 요약을 생성합니다. 이는 tui.auto_recap = false로 설정된 경우에도 마찬가지입니다. 컨텍스트 공간을 확보하려면 /compact를 사용하세요.

`/cd`로 디렉터리 변경하기

/pwd(또는 /cwd)를 입력하여 현재 디렉터리를 확인합니다.
/cd <path>를 입력하여 디렉터리를 변경하거나, /cd를 입력하여 홈 디렉터리를 사용합니다.

예상 결과: Codex가 선택한 디렉터리에서 채팅을 이어갑니다. 디렉터리를 변경하려면 기본 세션이 대기 상태여야 하며, 대기열에 있는 입력이나 백그라운드 터미널이 없어야 합니다.

`/worktree`로 작업 트리에서 이어가기

로컬 Git 저장소에서 /worktree를 입력합니다.
새 작업 트리에서 새 채팅을 시작할지, 현재 대화를 이어갈지 선택합니다.

예상 결과: Codex가 관리형 Git 작업 트리를 만들고 선택한 채팅을 그곳에서 시작합니다. 작업 트리 찾아보기 를 선택하면 기존 작업 트리와 이를 소유한 채팅을 찾을 수 있습니다. 이 명령은 로컬 작업 트리 지원이 필요하며, 작업이 실행 중일 때는 사용할 수 없습니다.

`/daemon`으로 백그라운드 서버 관리하기

/daemon을 입력합니다.
서버 연결과 사용 가능한 작업을 확인합니다.

예상 결과: Codex가 로컬 백그라운드 서버용으로 최신 공개 안정 버전을 설치하거나 현재 CLI 빌드를 사용하도록 제안합니다. 업데이트를 확인하면 Codex가 종료되며 진행 중인 작업이 중단될 수 있습니다. 원격 연결인 경우 서버가 실행되는 호스트에서 서버를 관리하세요.

`/warnings`로 경고 확인하기

/warnings를 입력합니다.

예상 결과: Codex가 저장된 경고와 해당 경고의 자세한 진단 정보를 표시합니다.

`/model`로 활성 모델 설정하기

선택기에는 계정과 워크스페이스에서 사용할 수 있는 모델만 표시됩니다. GPT-6.1 Sol이 목록에 없으면 다른 모델을 선택하세요. 플랜별 GPT-6.1 Sol 사용 가능 여부를 참고하세요.

Codex를 시작하고 입력창을 엽니다.
/model를 입력하고 Enter 키를 누릅니다.
팝업에서 gpt-6-luna 또는 gpt-6.1-sol 등의 모델을 선택합니다.

예상 결과: Codex가 기록에서 새 모델을 확인해 줍니다. /status을 실행하여 변경 사항을 확인하세요.

`/fast`로 Fast 모드 켜거나 끄기

/fast을 입력하여 현재 모델의 Fast 서비스 티어를 켭니다.
/fast을 다시 입력하여 끕니다.

예상 결과: Codex가 티어를 전환하고 선택을 저장합니다. TUI 바닥글에서 /statusline을 사용하여 Fast 모드 상태 표시줄 항목을 표시할 수도 있습니다.

Fast 티어 명령은 카탈로그에 따라 제공됩니다. 현재 모델이 Fast 티어를 지원한다고 명시하지 않으면 Codex는 /fast을 표시하지 않습니다.

`/plan`로 계획 모드로 전환하기

/plan을 입력하고 Enter를 눌러 활성 채팅을 계획 모드로 전환합니다.
선택 사항: 인라인 프롬프트 텍스트를 제공합니다(예: /plan Propose a migration plan for this service).
인라인 /plan 인수를 사용하는 동안 콘텐츠를 붙여 넣거나 이미지를 첨부할 수 있습니다.

예상 결과: Codex가 계획 모드로 전환하고 선택적 인라인 프롬프트를 첫 계획 요청으로 사용합니다.

Codex가 이미 작업 중이면 /plan을 일시적으로 사용할 수 없습니다.

`/goal`로 작업 목표 설정하거나 확인하기

/goal <objective>을 입력하여 목표를 설정합니다(예: /goal Finish the migration and keep tests green).
/goal을 입력하여 현재 목표를 확인합니다.
/goal edit을 사용하여 목표를 수정합니다. /goal pause, /goal resume 또는 /goal clear을 사용하여 목표를 일시 중지하거나, 재개하거나, 제거합니다.

예상 결과: 작업이 계속되는 동안 Codex가 목표를 활성 채팅에 연결해 둡니다.

목표 내용은 비어 있으면 안 되며 최대 4,000자여야 합니다. 지침이 더 길면 세부 정보를 파일에 넣고 목표가 해당 파일을 가리키도록 하세요.

`/experimental`로 실험적 기능 켜거나 끄기

/experimental을 입력하고 Enter를 누릅니다.
원하는 기능(예: Network proxy 또는 Prevent sleep while running)을 전환한 다음, 프롬프트에서 요청하면 Codex를 다시 시작합니다.

예상 결과: Codex가 선택한 기능을 config에 저장하고 다시 시작할 때 적용합니다.

`/approve`로 자동 검토에서 거부된 작업 승인하기

자동 검토자가 최근 작업을 거부했고 Codex가 이를 한 번 다시 시도하도록 하려면 /approve을 사용하세요.

/approve을 입력합니다.
Codex가 관련 거부 작업을 표시하면 재시도를 확인합니다.

예상 결과: Codex가 현재 세션 정책에 따라 해당 거부 작업을 한 번 다시 시도합니다.

`/memories`로 메모리 설정하기

/memories을 입력합니다.
Codex가 기존 메모리를 사용할지, 새 메모리를 생성할지 또는 메모리 동작을 비활성화한 상태로 둘지 선택합니다.

예상 결과: Codex가 향후 세션에 적용할 관련 메모리 설정을 업데이트합니다.

`/skills`로 스킬 사용하기

/skills을 입력합니다.
Codex에 적용할 스킬을 선택합니다.

예상 결과: Codex가 선택한 스킬 컨텍스트를 삽입하여 다음 요청이 해당 스킬의 지침을 따르도록 합니다.

`/import`로 Claude Code 또는 Cursor 설정 가져오기

/import을 입력합니다.
Claude Code 또는 Cursor 를 선택합니다.
마이그레이션할 설정, 프로젝트 파일 또는 최근 채팅을 선택합니다.

예상 결과: Codex가 외부 에이전트 가져오기 선택기를 열고 선택한 지원 아티팩트를 Codex 구성과 로컬 파일로 가져옵니다. 세션 검색에는 지난 30일간의 채팅이 최대 50개까지 포함됩니다.

로컬 TUI 세션에서 /import을 실행하세요. 작업 실행 중, 원격 세션 및 로컬 app-server 데몬에 연결된 동안에는 사용할 수 없습니다.

데스크톱 앱 워크플로와 지원되는 아티팩트 유형은 다른 에이전트에서 가져오기를 참조하세요.

`/clear`로 터미널을 지우고 새 채팅 시작하기

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

예상 결과: Codex가 터미널을 지우고 표시된 기록을 초기화한 후 동일한 CLI 세션에서 새 채팅을 시작합니다.

새 채팅을 만들면서 이름을 지정하려면 /clear release prep을 실행하세요.

Ctrl+L과 달리 /clear은 새 채팅을 시작합니다.

Ctrl+L은 터미널 보기만 지우고 현재 채팅은 유지합니다. 작업 진행 중에는 Codex가 두 동작을 모두 비활성화합니다.

`/archive`로 현재 세션 보관하기

/archive를 입력하고 Enter 키를 누릅니다.
현재 세션을 보관할지 확인합니다.

예상 결과: 로컬 백그라운드 서버나 원격 서버에 연결되어 있으면 Codex가 세션을 보관하고 명령 센터로 돌아갑니다. 공유 서버가 없으면 Codex가 종료됩니다. 대화 기록은 유지되며, 나중에 codex unarchive <SESSION>로 복원할 수 있습니다.

턴이 실행 중인 경우 /archive를 확인하면 해당 턴이 중지된 후 세션이 보관됩니다.

`/delete`로 현재 세션 삭제하기

/delete를 입력하고 Enter 키를 누릅니다.
현재 세션을 삭제할지 확인합니다.

예상 결과: Codex가 대화 기록과 여기서 파생된 모든 하위 세션을 영구적으로 삭제합니다. 로컬 백그라운드 서버나 원격 서버에 연결되어 있으면 Codex가 명령 센터로 돌아갑니다. 공유 서버가 없으면 Codex가 종료됩니다.

채팅 실행 중이거나 사이드 채팅 안에서는 /delete을 사용할 수 없습니다.

`/permissions`로 권한 업데이트하기

/permissions을 입력하고 Enter를 누릅니다.
원하는 제어 수준에 맞는 승인 프리셋을 선택합니다. 예를 들어 개입 없는 실행에는 Auto을, 편집 검토에는 Read Only을 선택합니다. 명명된 권한 프로필이 활성화되어 있으면 선택기에 구성된 사용자 지정 프로필과 설명도 표시됩니다.

예상 결과: Codex가 업데이트된 정책을 알립니다. 이후 작업에는 다시 변경할 때까지 업데이트된 승인 모드가 적용됩니다.

`/ide`로 IDE 컨텍스트 포함하기

/ide을 입력합니다.
현재 IDE 선택 영역이나 열린 파일로 Codex가 수행할 작업을 설명하려면 선택적으로 인라인 텍스트를 추가합니다.

예상 결과: Codex가 다음 프롬프트에 사용 가능한 IDE 컨텍스트를 포함합니다.

`/vim`로 Vim 모드 켜거나 끄기

/vim을 입력합니다.
작성기에서 계속 편집합니다.

예상 결과: Codex가 현재 세션의 작성기 Vim 모드를 전환합니다. 새 세션에서 Vim 모드를 기본값으로 설정하려면 config.toml에서 tui.vim_mode_default = true을 설정하세요.

`/setup-default-sandbox`로 권한이 상승된 Windows 샌드박스 설정하기

이 명령은 Codex가 성능이 제한된 restricted-token 샌드박스를 사용하는 Windows에서만 표시됩니다.

/setup-default-sandbox을 입력합니다.
관리자 설정 절차를 따릅니다.

예상 결과: Codex가 권한이 강화된 Windows 샌드박스를 구성하고 해당하는 자동 승인 프리셋을 선택합니다.

`/copy`로 최신 응답 복사하기

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

예상 결과: Codex가 가장 최근에 완료된 Codex 출력을 클립보드에 복사합니다.

턴이 아직 실행 중이면 /copy은 진행 중인 응답 대신 가장 최근에 완료된 출력을 사용합니다. 첫 Codex 출력이 완료되기 전과 롤백 직후에는 이 명령을 사용할 수 없습니다.

기본 TUI에서 Ctrl+O를 눌러 슬래시 명령 메뉴를 열지 않고도 가장 최근에 완료된 응답을 복사할 수 있습니다.

`/raw`로 원시 스크롤백 켜거나 끄기

/raw, /raw on 또는 /raw off을 입력합니다.

예상 결과: Codex가 원시 스크롤백 모드를 전환하여 터미널 선택과 복사를 더 직접적으로 만듭니다. 기본 Alt+R 바인딩을 사용하거나 tui.raw_output_mode = true으로 기본값을 영구 저장할 수도 있습니다.

`/status`로 세션 확인하기

채팅에서 /status을 입력합니다.
활성 모델, 승인 정책, 쓰기 가능한 루트 및 현재 토큰 사용량을 출력에서 검토합니다. TUI가 원격으로 연결되면 출력에 원격 주소와 서버 버전도 표시됩니다.

예상 결과: Codex가 예상한 환경에서 작동하고 있음을 확인하는 요약을 출력합니다.

`/usage`로 계정 사용량 확인하기

/usage을 입력하여 사용량 메뉴를 엽니다.
토큰 활동을 표시할지 또는 획득한 사용 한도 초기화 권한을 사용할지 선택합니다.
토큰 활동을 바로 열려면 /usage daily, /usage weekly 또는 /usage cumulative을 입력합니다.

예상 결과: Codex가 사용량 작업을 열거나 선택한 보기의 계정 토큰 활동을 표시합니다. 세션에 Codex 서비스 계정 인증이 없으면 Codex가 로그인 요구 사항을 표시합니다.

`/debug-config`로 설정 계층 확인하기

/debug-config을 입력합니다.
config 계층 순서(우선순위가 가장 낮은 계층부터), 켜짐/꺼짐 상태 및 정책 소스를 출력에서 검토합니다.

예상 결과: Codex가 계층 진단과 함께 구성된 경우 allowed_approval_policies, allowed_sandbox_modes, mcp_servers, rules 및 experimental_network 같은 정책 세부 정보를 출력합니다.

유효 설정이 config.toml과 다른 이유를 디버깅할 때 이 출력을 사용하세요.

`/statusline`로 하단 항목 설정하기

/statusline을 입력합니다.
선택기를 사용해 항목을 전환하고 순서를 바꾼 다음 확인합니다.

예상 결과: 바닥글 상태 표시줄이 즉시 업데이트되고 config.toml의 tui.status_line에 영구 저장됩니다.

사용 가능한 상태 표시줄 항목에는 model, model+reasoning, context stats, rate limits, git branch, token counters, session id, current directory/project root 및 Codex version이 포함됩니다.

`/title`로 터미널 제목 항목 설정하기

/title을 입력합니다.
선택기를 사용해 항목을 전환하고 순서를 바꾼 다음 확인합니다.

예상 결과: 터미널 창 또는 탭 제목이 즉시 업데이트되고 config.toml의 tui.terminal_title에 영구 저장됩니다.

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

`/theme`로 구문 강조 테마 선택하기

/theme을 입력합니다.
선택기에서 테마를 미리 본 다음 확인합니다.

예상 결과: Codex가 구문 강조를 업데이트하고 선택 항목을 config.toml의 tui.theme에 영구 저장합니다.

`/pets`로 터미널 펫 선택하기

/pets(또는 /pet)을 입력하여 펫 선택기를 엽니다.
내장 또는 사용자 지정 펫을 선택하거나 펫을 끕니다.

예상 결과: Codex가 지원되는 터미널에 선택한 앰비언트 펫을 표시하고 선택을 영구 저장합니다. /pets off을 입력하여 숨길 수도 있습니다.

`/keymap`로 TUI 단축키 재설정하기

/keymap을 사용하여 TUI의 키보드 단축키 바인딩을 확인하고 업데이트한 후 영구 저장하세요.

/keymap을 입력합니다.
변경할 단축키 컨텍스트와 작업을 선택합니다.
새 바인딩을 입력하거나 기존 바인딩을 제거합니다.

예상 결과: Codex가 활성 키맵을 업데이트하고 사용자 지정 바인딩을 config.toml의 tui.keymap에 기록합니다.

키 바인딩은 ctrl-a, shift-enter 및 page-down 같은 이름을 사용합니다. 컨텍스트별 바인딩은 tui.keymap.global보다 우선하며, 빈 바인딩 목록은 작업의 바인딩을 해제합니다.

`/ps`로 백그라운드 터미널 확인하기

/ps을 입력합니다.
백그라운드 터미널 목록과 상태를 검토합니다.

예상 결과: Codex가 진행 상황을 한눈에 파악할 수 있도록 각 백그라운드 터미널의 명령과 최근의 비어 있지 않은 출력 줄을 최대 3개까지 표시합니다.

unified_exec이 사용 중일 때 백그라운드 터미널이 표시되며, 그렇지 않으면 목록이 비어 있을 수 있습니다.

`/stop`로 백그라운드 터미널 중지하기

/stop을 입력합니다.
나열된 터미널을 중지하기 전에 Codex가 요청하면 확인합니다.

예상 결과: Codex가 현재 세션의 모든 백그라운드 터미널을 중지합니다. /clean은 여전히 /stop의 별칭으로 사용할 수 있습니다.

`/compact`로 대화 기록을 간결하게 유지하기

긴 대화 후 /compact을 입력합니다.
Codex가 지금까지의 채팅을 요약하겠다고 제안하면 확인합니다.

예상 결과: Codex가 이전 턴을 간결한 요약으로 대체하여 중요한 세부 정보를 유지하면서 컨텍스트를 확보합니다.

`/diff`로 변경 사항 검토하기

/diff을 입력하여 Git diff를 확인합니다.
CLI 안에서 출력을 스크롤하여 편집 내용과 추가된 파일을 검토합니다.

예상 결과: Codex가 스테이징한 변경 사항, 아직 스테이징하지 않은 변경 사항, 그리고 Git이 아직 추적하지 않는 파일을 표시하므로 유지할 항목을 결정할 수 있습니다.

`/mention`로 파일 강조하기

/mention 뒤에 경로를 입력합니다(예: /mention src/lib/api.ts).
팝업에서 일치하는 결과를 선택합니다.

예상 결과: Codex가 파일을 채팅에 추가하여 후속 턴이 해당 파일을 직접 참조하도록 합니다.

`/new`로 새 채팅 시작하기

/new를 입력하고 Enter 키를 누릅니다.
Codex가 체크아웃 위치를 선택하도록 안내하면 현재 디렉터리 또는 새 작업 트리를 선택합니다.

예상 결과: Codex가 동일한 CLI 세션에서 새 채팅을 시작하므로 터미널을 벗어나지 않고 채팅을 전환할 수 있습니다.

새 채팅을 만들면서 이름을 지정하려면 /new bug bash을 실행하세요.

/clear과 달리 /new은 현재 터미널 보기를 먼저 지우지 않습니다.

`/rename`로 현재 채팅 이름 변경하기

/rename <name>을 입력하거나 /rename을 입력하여 이름 지정 프롬프트를 엽니다.
나중에 채팅을 찾는 데 도움이 될 짧은 이름을 입력합니다.

예상 결과: Codex가 기록을 변경하지 않고 저장된 채팅 이름을 업데이트합니다.

`/resume`로 저장된 채팅 재개하기

/resume을 입력하고 Enter를 누릅니다.
저장된 세션 선택기에서 원하는 세션을 선택합니다.

예상 결과: Codex가 선택한 채팅의 기록을 다시 불러와 원래 기록을 그대로 유지하면서 중단한 지점부터 작업을 계속할 수 있게 합니다.

`/fork`로 현재 채팅 분기하기

/fork를 입력하고 Enter 키를 누릅니다.
Codex가 체크아웃 위치를 선택하도록 안내하면 현재 디렉터리 또는 새 작업 트리를 선택합니다.

예상 결과: Codex가 현재 채팅을 새 ID가 있는 새 채팅으로 복제하고 원본 기록은 그대로 유지하므로 다른 접근 방식을 병렬로 살펴볼 수 있습니다.

현재 세션이 아니라 저장된 세션을 포크해야 한다면 터미널에서 codex fork을 실행하여 세션 선택기를 여세요.

`/app`로 데스크톱 앱에서 이어서 작업하기

macOS와 Windows에서 /app을 입력하면 ChatGPT 데스크톱 앱에서 현재 세션이 열립니다. 앱이 설치되어 있지 않거나 실행 중이 아니면 Codex가 앱을 설치하거나 실행하라는 오류를 표시합니다.

예상 결과: 데스크톱 앱에서 동일한 저장된 채팅이 열려 대화를 계속할 수 있습니다.

`/side`로 보조 채팅 시작하기

기본 채팅에서 벗어나지 않고 현재 채팅으로부터 임시 포크를 시작하려면 /side을 사용하세요.

/side을 입력하여 사이드 채팅을 엽니다.
선택적으로 인라인 텍스트를 추가합니다(예: /side Check whether this plan has an obvious risk).
집중적인 논의가 끝나면 상위 채팅으로 돌아갑니다.

예상 결과: Codex가 상위 채팅과 별도의 기록을 가진 사이드 채팅을 엽니다. 사이드 모드에 있는 동안 TUI에는 상위 채팅의 상태가 계속 표시되므로 기본 채팅이 아직 실행 중인지 확인할 수 있습니다.

다른 사이드 채팅 안과 검토 모드에서는 /side을 사용할 수 없습니다.

`AGENTS.md` 생성에 `/init` 사용하기

Codex가 지속적 지침을 찾도록 할 디렉터리에서 /init을 실행합니다.
생성된 AGENTS.md을 검토한 다음 저장소 규칙에 맞게 편집합니다.

예상 결과: Codex가 향후 세션을 위해 다듬고 커밋할 수 있는 AGENTS.md 스캐폴드를 생성합니다.

`/review`로 작업 트리 검토 요청하기

/review을 입력합니다.
정확한 파일 변경 사항을 확인하려면 /diff으로 후속 요청을 합니다.

예상 결과: Codex가 작업 트리에서 발견한 문제를 동작 변경과 누락된 테스트를 중심으로 요약합니다. config.toml에서 review_model을 설정하지 않으면 현재 세션 모델을 사용합니다.

`/mcp`로 MCP 도구 목록 확인하기

/mcp을 입력합니다.
목록을 검토하여 사용 가능한 MCP server와 도구를 확인합니다.

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

/mcp verbose를 사용하면 자세한 서버 진단 정보를 포함할 수 있습니다. /mcp login <name>를 사용하면 활성 세션에서 구성된 MCP server에 로그인할 수 있습니다.

`/apps`로 앱 둘러보기

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

예상 결과: Codex가 앱 멘션을 $app-slug 형태로 작성기에 삽입하므로 즉시 Codex에 해당 앱을 사용하도록 요청할 수 있습니다.

`/plugins`로 플러그인 둘러보기

/plugins을 입력합니다.
마켓플레이스 탭을 선택한 다음 플러그인을 선택하여 기능이나 사용 가능한 작업을 확인합니다.

예상 결과: Codex가 플러그인 브라우저를 열어 설치된 플러그인, 구성에서 허용하는 검색 가능한 플러그인 및 설치된 플러그인의 상태를 검토할 수 있게 합니다. 설치된 플러그인에서 Space를 누르면 활성화 상태가 전환됩니다.

`/hooks`로 수명 주기 훅 확인 및 관리하기

/hooks을 입력합니다.
훅 이벤트를 선택하여 일치하는 핸들러를 확인합니다.
필요에 따라 관리되지 않는 훅을 신뢰하거나, 비활성화하거나, 다시 활성화합니다.

예상 결과: Codex가 훅 브라우저를 열어 구성된 수명 주기 훅을 검토할 수 있게 합니다. 관리형 훅은 관리 대상으로 표시되며 사용자 훅 브라우저에서 비활성화할 수 없습니다.

`/agents`로 채팅 관리하기

/agents를 입력하고 Enter 키를 누릅니다.
명령 센터에서 채팅을 선택하여 엽니다.

예상 결과: Codex가 연결된 서버의 채팅 개요를 표시합니다. 각 채팅의 상태를 확인하고 채팅 간에 전환할 수 있습니다. 터미널에서 명령 센터를 직접 열려면 codex agents를 실행합니다. 명령 센터를 사용하려면 공유 로컬 서버나 원격 서버가 필요합니다.

`/subagents`로 에이전트 스레드 전환하기

/subagents를 입력하고 Enter 키를 누릅니다.
선택 목록에서 원하는 스레드를 선택합니다.

예상 결과: Codex가 활성 스레드를 전환하므로 해당 에이전트의 작업을 확인하거나 계속할 수 있습니다.

`/feedback`로 피드백 보내기

/feedback을 입력하고 Enter를 누릅니다.
프롬프트에 따라 로그 또는 진단 정보를 포함합니다.

예상 결과: Codex가 요청한 진단 정보를 수집하여 유지관리자에게 제출합니다.

`/logout`로 로그아웃하기

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

예상 결과: Codex가 현재 사용자 세션의 로컬 자격 증명을 지웁니다.

`/quit` 또는 `/exit`로 CLI 종료하기

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

예상 결과: Codex가 즉시 종료됩니다. 먼저 중요한 작업을 저장하거나 커밋하세요.

다음 명령을 사용하여 VS Code Command Palette에서 Codex를 제어하세요. 키보드 단축키에 바인딩할 수도 있습니다.

단축키 지정하기

Codex 명령의 키 바인딩을 할당하거나 변경하려면 다음 단계를 따르세요.

Command Palette를 엽니다(macOS에서는 Cmd+Shift+P, Windows/Linux에서는 Ctrl+Shift+P).
Preferences: Open Keyboard Shortcuts 를 실행합니다.
Codex 또는 명령 ID(예: chatgpt.newChat)를 검색합니다.
연필 아이콘을 선택한 다음 원하는 단축키를 입력합니다.

확장 프로그램 명령어

명령	기본 키 바인딩	설명
`chatgpt.addToThread`	-	선택한 텍스트 범위를 현재 채팅의 컨텍스트로 추가합니다
`chatgpt.addFileToThread`	-	전체 파일을 현재 채팅의 컨텍스트로 추가합니다
`chatgpt.newChat`	macOS: `Cmd+N` Windows/Linux: `Ctrl+N`	새 채팅을 만듭니다
`chatgpt.newCodexPanel`	-	새 Codex 패널을 만듭니다
`chatgpt.openCommandMenu`	-	Codex 명령 메뉴를 엽니다
`chatgpt.openSidebar`	-	Codex 사이드바 패널을 엽니다

슬래시 명령을 사용하면 작성기를 벗어나지 않고 Codex를 제어할 수 있습니다. 이를 사용하여 상태를 확인하거나, 로컬 모드와 클라우드 모드 사이를 전환하거나, 피드백을 보내세요.

슬래시 명령어 사용하기

Codex 작성기에서 /을 입력합니다.
목록에서 명령을 선택하거나 계속 입력하여 필터링합니다(예: /status).
Enter 를 누릅니다.

사용 가능한 슬래시 명령어

슬래시 명령	설명
`/approve`	자동 검토가 활성화된 경우 최근 자동 검토 거부 건에 대한 한 번의 재시도를 승인합니다.
`/cloud`	클라우드 실행을 사용할 수 있는 경우 클라우드에서 채팅을 실행합니다.
`/cloud-environment`	채팅의 클라우드 환경을 선택합니다.
`/compact`	현재 채팅의 컨텍스트를 압축합니다.
`/fast`	사용 가능한 경우 카탈로그에서 제공하는 Fast 서비스 티어를 켜거나 끕니다.
`/feedback`	피드백을 제출하고 선택적으로 로그를 포함할 수 있는 피드백 대화 상자를 엽니다.
`/fork`	로컬 채팅을 새 로컬 채팅으로 복사합니다.
`/goal`	Codex가 지향할 지속적인 목표를 설정합니다.
`/ide-context`	자동 IDE 컨텍스트를 켜거나 끕니다.
`/init`	현재 프로젝트의 `AGENTS.md` 스캐폴드를 생성합니다.
`/local`	로컬 워크스페이스에서 채팅을 실행합니다.
`/mcp`	MCP 상태를 열어 연결된 서버를 확인합니다.
`/memories`	Memories를 사용할 수 있는 경우 채팅에서 메모리를 사용하거나 생성할지 구성합니다.
`/model`	현재 채팅의 모델을 선택합니다.
`/personality`	현재 모델이 성격을 지원하는 경우 Codex의 응답 방식을 선택합니다.
`/plan`	여러 단계의 계획을 위한 계획 모드를 전환합니다.
`/project`	새 채팅의 프로젝트를 선택합니다.
`/reasoning`	현재 채팅의 추론 수준을 선택합니다.
`/review`	코드 검토 모드를 시작하여 커밋되지 않은 변경 사항을 검토하거나 기준 브랜치와 비교합니다.
`/side`	기본 채팅을 중단하지 않고 임시 사이드 채팅을 시작합니다.
`/status`	채팅 ID, 컨텍스트 사용량 및 사용량 제한을 표시합니다.
`/worktree`	새 Git 작업 트리에서 채팅을 실행합니다.

ChatGPT 데스크톱 앱 명령어

이 참조 문서를 읽는 방법

전역 플래그

명령 개요

명령 세부 정보

codex (대화형)

codex agents

codex queue

codex app-server

codex remote-control

codex app

codex debug app-server send-message-v2

codex debug models

codex debug prompt-input

codex apply

codex review

codex archive 및 codex unarchive

codex delete

codex cloud

codex cloud list

codex completion

codex doctor

codex features

codex exec

codex execpolicy

codex login

codex logout

codex mcp

codex plugin

codex plugin marketplace

codex mcp-server

codex resume

codex fork

codex sandbox

macOS seatbelt

Linux 샌드박스

Windows

codex update

플래그 조합 및 안전한 사용 팁

대화형 단축키

관련 자료

기본 제공 슬래시 명령

슬래시 명령으로 세션 제어하기

/tui로 터미널 모드 선택하기

/export로 대화 내보내기

/recap으로 채팅 요약하기

/cd로 디렉터리 변경하기

/worktree로 작업 트리에서 이어가기

/daemon으로 백그라운드 서버 관리하기

/warnings로 경고 확인하기

/model로 활성 모델 설정하기

/fast로 Fast 모드 켜거나 끄기

/plan로 계획 모드로 전환하기

/goal로 작업 목표 설정하거나 확인하기

/experimental로 실험적 기능 켜거나 끄기

/approve로 자동 검토에서 거부된 작업 승인하기

/memories로 메모리 설정하기

/skills로 스킬 사용하기

/import로 Claude Code 또는 Cursor 설정 가져오기

/clear로 터미널을 지우고 새 채팅 시작하기

/archive로 현재 세션 보관하기

/delete로 현재 세션 삭제하기

/permissions로 권한 업데이트하기

/ide로 IDE 컨텍스트 포함하기

/vim로 Vim 모드 켜거나 끄기

/setup-default-sandbox로 권한이 상승된 Windows 샌드박스 설정하기

/copy로 최신 응답 복사하기

/raw로 원시 스크롤백 켜거나 끄기

/status로 세션 확인하기

/usage로 계정 사용량 확인하기

/debug-config로 설정 계층 확인하기

/statusline로 하단 항목 설정하기

/title로 터미널 제목 항목 설정하기

/theme로 구문 강조 테마 선택하기

/pets로 터미널 펫 선택하기

/keymap로 TUI 단축키 재설정하기

/ps로 백그라운드 터미널 확인하기

/stop로 백그라운드 터미널 중지하기

/compact로 대화 기록을 간결하게 유지하기

/diff로 변경 사항 검토하기

`codex` (대화형)

`codex agents`

`codex queue`

`codex app-server`

`codex remote-control`

`codex app`

`codex debug app-server send-message-v2`

`codex debug models`

`codex debug prompt-input`

`codex apply`

`codex review`

`codex archive` 및 `codex unarchive`

`codex delete`

`codex cloud`

`codex cloud list`

`codex completion`

`codex doctor`

`codex features`

`codex exec`

`codex execpolicy`

`codex login`

`codex logout`

`codex mcp`

`codex plugin`

`codex plugin marketplace`

`codex mcp-server`

`codex resume`

`codex fork`

`codex sandbox`

`codex update`

`/tui`로 터미널 모드 선택하기

`/export`로 대화 내보내기

`/recap`으로 채팅 요약하기

`/cd`로 디렉터리 변경하기

`/worktree`로 작업 트리에서 이어가기

`/daemon`으로 백그라운드 서버 관리하기

`/warnings`로 경고 확인하기

`/model`로 활성 모델 설정하기

`/fast`로 Fast 모드 켜거나 끄기

`/plan`로 계획 모드로 전환하기

`/goal`로 작업 목표 설정하거나 확인하기

`/experimental`로 실험적 기능 켜거나 끄기

`/approve`로 자동 검토에서 거부된 작업 승인하기

`/memories`로 메모리 설정하기

`/skills`로 스킬 사용하기

`/import`로 Claude Code 또는 Cursor 설정 가져오기

`/clear`로 터미널을 지우고 새 채팅 시작하기

`/archive`로 현재 세션 보관하기

`/delete`로 현재 세션 삭제하기

`/permissions`로 권한 업데이트하기

`/ide`로 IDE 컨텍스트 포함하기

`/vim`로 Vim 모드 켜거나 끄기

`/setup-default-sandbox`로 권한이 상승된 Windows 샌드박스 설정하기

`/copy`로 최신 응답 복사하기

`/raw`로 원시 스크롤백 켜거나 끄기

`/status`로 세션 확인하기

`/usage`로 계정 사용량 확인하기

`/debug-config`로 설정 계층 확인하기

`/statusline`로 하단 항목 설정하기

`/title`로 터미널 제목 항목 설정하기

`/theme`로 구문 강조 테마 선택하기

`/pets`로 터미널 펫 선택하기

`/keymap`로 TUI 단축키 재설정하기

`/ps`로 백그라운드 터미널 확인하기

`/stop`로 백그라운드 터미널 중지하기

`/compact`로 대화 기록을 간결하게 유지하기

`/diff`로 변경 사항 검토하기

`/mention`로 파일 강조하기

`/new`로 새 채팅 시작하기

`/rename`로 현재 채팅 이름 변경하기

`/resume`로 저장된 채팅 재개하기

`/fork`로 현재 채팅 분기하기

`/app`로 데스크톱 앱에서 이어서 작업하기

`/side`로 보조 채팅 시작하기

`AGENTS.md` 생성에 `/init` 사용하기

`/review`로 작업 트리 검토 요청하기

`/mcp`로 MCP 도구 목록 확인하기

`/apps`로 앱 둘러보기

`/plugins`로 플러그인 둘러보기

`/hooks`로 수명 주기 훅 확인 및 관리하기