개발자 명령어
ChatGPT 데스크톱, Codex CLI 및 Codex IDE 확장 프로그램의 명령어와 슬래시 명령어 참조입니다.
ChatGPT 웹 명령어
ChatGPT 웹에는 자체 작성기 명령어 메뉴가 있습니다. 현재 채팅에서 사용할 수 있는 작업을
보려면 /을 입력하세요. ChatGPT 데스크톱 앱이나 CLI의 명령어
세트는 제공하지 않습니다. 따라서 이 참조의 Codex 슬래시 명령어, CLI 하위 명령어 및
플래그는 ChatGPT 웹에 적용되지 않습니다.
ChatGPT 데스크톱 앱 명령어
일반 명령어 페이지에서는 앱 탐색, 채팅 단축키, 키보드 사용자 지정과 채팅, 설정, 스킬, 예약된 작업, 플러그인 및 반려동물의 딥 링크를 다룹니다.
슬래시 명령어 페이지에서는
/feedback, /goal, /init,
/mcp, /plan, /review, /status 등 앱 작성기에서
사용할 수 있는 명령어를 다룹니다.
Codex CLI 명령어 참조
이 참조를 읽는 방법
이 페이지에는 문서화된 모든 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 |
이 환경 변수에서 bearer 토큰을 읽고 --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 |
Stable | 터미널 UI를 실행합니다. 위의 전역 플래그와 선택적 프롬프트 또는 이미지 첨부 파일을 받습니다. |
codex app |
Stable | macOS 또는 Windows에서 ChatGPT 데스크톱 앱을 실행합니다. macOS에서는 Codex가 작업 공간 경로를 열 수 있고, Windows에서는 열어야 할 경로를 출력합니다. |
codex app-server |
Experimental | stdio, WebSocket 또는 Unix 소켓을 통해 로컬 개발이나 디버깅에 사용할 Codex 앱 서버를 실행합니다. |
codex apply |
Stable | Codex 클라우드 채팅에서 생성된 최신 diff를 로컬 작업 트리에 적용합니다. 별칭: codex a. |
codex archive |
Stable | 세션 ID 또는 세션 이름으로 저장된 대화형 세션을 보관합니다. |
codex cloud |
Experimental | TUI를 열지 않고 터미널에서 Codex 클라우드 채팅을 탐색하거나 실행합니다. 별칭: codex cloud-tasks. |
codex completion |
Stable | Bash, Zsh, Fish 또는 PowerShell용 셸 자동 완성 스크립트를 생성합니다. |
codex debug app-server send-message-v2 |
Experimental | 기본 제공 테스트 클라이언트를 통해 단일 V2 메시지를 전송하여 app-server를 디버깅합니다. |
codex debug models |
Experimental | Codex가 확인하는 원시 모델 카탈로그를 출력하며, 번들 카탈로그만 검사하는 옵션도 제공합니다. |
codex debug prompt-input |
Experimental | 모델에 표시되는 프롬프트 입력 목록을 JSON으로 렌더링하며, 선택적으로 프롬프트와 이미지를 포함할 수 있습니다. |
codex delete |
Stable | 세션 ID 또는 세션 이름으로 저장된 대화형 세션을 영구 삭제합니다. |
codex doctor |
Stable | 로컬 설치, 구성, 인증, 런타임, Git, 터미널, app-server 및 스레드 인벤토리 문제에 대한 진단 보고서를 생성합니다. |
codex exec |
Stable | Codex를 비대화형으로 실행합니다. 별칭: codex e. 결과를 stdout 또는 JSONL로 스트리밍하고 선택적으로 이전 세션을 재개합니다. |
codex execpolicy |
Experimental | execpolicy 규칙 파일을 평가하여 명령어가 허용되는지, 승인을 요청하는지, 차단되는지 확인합니다. |
codex features |
Stable | 기능 플래그를 나열하고 config.toml에서 영구적으로 활성화하거나 비활성화합니다. |
codex fork |
Stable | 원본 기록을 유지하면서 이전 대화형 세션을 새 채팅으로 포크합니다. |
codex login |
Stable | ChatGPT OAuth, 기기 인증, API key 또는 stdin으로 파이프된 액세스 토큰을 사용하여 Codex를 인증합니다. |
codex logout |
Stable | 저장된 인증 자격 증명을 제거합니다. |
codex mcp |
Stable | Model Context Protocol 서버를 관리합니다(목록 표시, 추가, 제거, 인증). |
codex mcp-server |
Stable | Codex 자체를 stdio를 통한 MCP 서버로 실행합니다. 다른 에이전트가 Codex를 사용할 때 유용합니다. |
codex plugin |
Stable | 구성된 마켓플레이스 소스에서 플러그인을 설치하고 나열하며 제거합니다. |
codex plugin marketplace |
Stable | Git 또는 로컬 소스에서 플러그인 마켓플레이스를 추가하고 나열하며 업그레이드하거나 제거합니다. |
codex remote-control |
Experimental | 로컬 app-server의 원격 제어를 실행하거나 관리하고, 단기 페어링 코드를 생성합니다. |
codex resume |
Stable | ID로 이전 대화형 세션을 계속하거나 가장 최근 채팅을 재개합니다. |
codex review |
Stable | 커밋되지 않은 변경 사항, 기본 브랜치 diff, 커밋 또는 사용자 지정 검토 지침을 비대화형으로 검토합니다. |
codex sandbox |
Stable | Codex에서 제공하는 macOS, Linux 또는 Windows 샌드박스 안에서 임의의 명령어를 실행합니다. |
codex unarchive |
Stable | 세션 ID 또는 세션 이름으로 보관된 대화형 세션을 복원합니다. |
codex update |
Stable | 설치된 릴리스가 자체 업데이트를 지원하는 경우 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 인증용 bearer 토큰을 요구하는 경우 --remote-auth-token-env <ENV_VAR>을 추가합니다.
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 |
서명된 bearer 토큰에 예상되는 aud 클레임입니다. --ws-auth signed-bearer-token이 필요합니다. |
--ws-auth |
capability-token | signed-bearer-token |
app-server WebSocket 클라이언트의 인증 모드입니다. 생략하면 WebSocket 인증이 비활성화되며, 로컬이 아닌 수신기는 시작할 때 경고를 표시합니다. |
--ws-issuer |
string |
서명된 bearer 토큰에 예상되는 iss 클레임입니다. --ws-auth signed-bearer-token이 필요합니다. |
--ws-max-clock-skew-seconds |
number |
서명된 bearer 토큰의 exp 및 nbf 클레임을 검증할 때 허용할 시계 오차입니다. --ws-auth signed-bearer-token이 필요합니다. |
--ws-shared-secret-file |
absolute path |
서명된 JWT bearer 토큰을 검증하는 데 사용되는 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을 실행하세요.
원격 제어를 활성화한 상태로 로컬 app-server 데몬을 시작하려면
codex remote-control start을, 중지하려면 codex remote-control stop을 사용하세요. 관리형
원격 제어 클라이언트와 SSH 원격 워크플로에서는 이러한 명령어를 사용합니다. 로컬
프로토콜 클라이언트를 구축할 때 codex app-server --listen을 대체하는 명령어는 아닙니다.
데몬이 실행된 후에는 codex remote-control pair을 사용하여 단기
수동 페어링 코드를 생성하고 출력하세요. 기계 판독 가능한 출력을 사용하려면 원격 제어
명령어에 --json을 추가합니다. pair의 JSON 응답에는
pairingCode, manualPairingCode, environmentId 및 expiresAt이 포함됩니다.
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에 인증이 필요한 경우 이 환경 변수에서 bearer 토큰을 읽습니다. |
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에 인증이 필요한 경우 이 환경 변수에서 bearer 토큰을 읽습니다. |
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] |
ID로 exec 세션을 재개하거나 --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 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 서버를 나열합니다. 기계 판독 가능한 출력을 사용하려면 --json을 추가합니다. |
login <name> |
--scopes scope1,scope2 |
스트리밍 가능한 HTTP 서버의 OAuth 로그인을 시작합니다(OAuth를 지원하는 서버만 해당). |
logout <name> |
스트리밍 가능한 HTTP 서버에 저장된 OAuth 자격 증명을 제거합니다. | |
remove <name> |
저장된 MCP 서버 정의를 삭제합니다. |
add 하위 명령어는 stdio 및 스트리밍 가능한 HTTP 전송을 모두 지원합니다.
| 키 | 유형 / 값 | 세부 정보 |
|---|---|---|
--bearer-token-env-var |
ENV_VAR |
스트리밍 가능한 HTTP 서버에 연결할 때 값이 bearer 토큰으로 전송되는 환경 변수입니다. |
--env KEY=VALUE |
repeatable |
stdio 서버를 실행할 때 적용되는 환경 변수 할당입니다. |
--oauth-client-id |
CLIENT_ID |
스트리밍 가능한 HTTP MCP 서버의 OAuth 클라이언트 식별자입니다. --url이 필요합니다. |
--oauth-resource |
RESOURCE |
스트리밍 가능한 HTTP MCP 서버의 로그인 중 포함할 OAuth 리소스 매개변수입니다. --url이 필요합니다. |
--url |
https://… |
stdio 대신 스트리밍 가능한 HTTP 서버를 등록합니다. COMMAND...과 함께 사용할 수 없습니다. |
COMMAND... |
stdio transport |
MCP 서버를 실행할 실행 파일과 인수입니다. -- 뒤에 지정합니다. |
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를 stdio 기반 MCP 서버로 실행합니다. 이 명령어는 전역 구성 재정의를 상속하며 다운스트림 클라이언트가 연결을 닫으면 종료됩니다.
codex resume
ID로 대화형 세션을 계속하거나 가장 최근 채팅을 재개합니다. --all을 전달하지 않는 한 codex resume은 --last의 범위를 현재 작업 디렉터리로 제한합니다. 모델 및 샌드박스 재정의를 포함하여 codex과 동일한 전역 플래그를 받습니다.
현재 작업 디렉터리가 세션에 저장된 디렉터리와 다르면
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을 사용하세요. |
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 Landlock
| 키 | 유형 / 값 | 세부 정보 |
|---|---|---|
--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를 누르고 취소하려면 Esc를 누릅니다.
- 완료된 최신 Codex 출력을 복사하려면 Ctrl+O를 누르거나
/copy을 실행합니다. - 현재 승인 및 샌드박스 설정에 따라 로컬 셸 명령어를 실행하려면 줄 앞에
!을 붙입니다. - Codex가 작업하는 동안 Tab을 누르면 다음 턴에 사용할 후속 프롬프트, 슬래시 명령어 또는 셸 명령어를 대기열에 추가할 수 있습니다.
- Codex가 작업하는 동안 Enter를 누르면 현재 턴에 새 지침을 삽입할 수 있습니다.
- 작성기가 비어 있을 때 Esc를 두 번 누르면 이전 사용자 메시지를 편집하고 해당 지점부터 채팅을 포크할 수 있습니다.
- 세션을 닫으려면 Ctrl+C를 누르거나
/exit을 실행합니다.
관련 리소스
- Codex CLI 개요: 설치, 업그레이드 및 빠른 팁입니다.
- 구성 기본 사항: 모델 및 제공자 같은 기본값을 저장합니다.
- 고급 구성: 프로필, 제공자, 샌드박스 조정 및 통합입니다.
- AGENTS.md: Codex 에이전트 기능과 모범 사례의 개념적 개요입니다.
슬래시 명령어를 사용하면 키보드 중심으로 Codex를 빠르게 제어할 수 있습니다. 작성기에 /을
입력하여 슬래시 팝업을 열고 명령어를 선택하면, Codex가 터미널을 벗어나지 않고
모델 전환, 권한 조정 또는 긴 채팅 요약과 같은 작업을 수행합니다.
이 가이드에서는 다음 방법을 설명합니다.
- 작업에 적합한 기본 제공 슬래시 명령어 찾기
/model,/fast,/personality,/permissions,/approve,/raw,/agent및/status같은 명령어로 활성 세션 제어하기
Codex CLI 슬래시 명령어
기본 제공 슬래시 명령어
Codex에는 다음 명령어가 포함되어 있습니다. 슬래시 팝업을 열고 명령어 이름을 입력하기 시작하면 목록이 필터링됩니다.
채팅이 이미 실행 중일 때 슬래시 명령어를 입력하고 Tab을 누르면
다음 턴의 대기열에 추가할 수 있습니다. Codex는 대기 중인 슬래시 명령어를 실행 시점에 구문 분석하므로
현재 턴이 끝난 후에 명령어 메뉴와 오류가 표시됩니다. 슬래시
자동 완성은 명령어를 대기열에 추가하기 전에도 계속 작동합니다.
| 명령 | 용도 | 사용 시점 |
|---|---|---|
/permissions |
Codex가 먼저 묻지 않고 수행할 수 있는 작업을 설정합니다. | 세션 도중 Auto와 Read Only 사이를 전환하는 등 승인 요구 사항을 완화하거나 강화할 때 사용합니다. |
/ide |
열린 파일, 현재 선택 영역 및 기타 IDE 컨텍스트를 포함합니다. | IDE에서 무엇이 열려 있는지 다시 설명하지 않고 다음 프롬프트에 편집기 컨텍스트를 가져올 때 사용합니다. |
/keymap |
TUI 키보드 단축키를 다시 매핑합니다. | config.toml에서 사용자 지정 단축키 바인딩을 확인하고 영구 저장할 때 사용합니다. |
/vim |
작성기의 Vim 모드를 전환합니다. | Vim 일반/삽입 동작과 기본 작성기 편집 모드 사이를 전환할 때 사용합니다. |
/setup-default-sandbox |
권한이 강화된 에이전트 샌드박스를 설정합니다(Windows 전용). | Codex가 권한 강화 설정을 제안한 후 기능이 제한된 Windows 샌드박스를 교체할 때 사용합니다. |
/sandbox-add-read-dir |
샌드박스에 추가 디렉터리 읽기 권한을 부여합니다(Windows 전용). | 현재 읽기 가능 루트 외부의 절대 디렉터리 경로를 읽어야 하는 명령의 차단을 해제할 때 사용합니다. |
/agent, /subagents |
활성 에이전트 스레드를 전환합니다. | 생성된 하위 에이전트 스레드의 작업을 확인하거나 계속할 때 사용합니다. |
/apps |
앱(커넥터)을 탐색하고 프롬프트에 삽입합니다. | Codex에 앱 사용을 요청하기 전에 앱을 $app-slug 형태로 첨부할 때 사용합니다. |
/plugins |
설치되었거나 검색 가능한 플러그인을 탐색합니다. | 플러그인 도구를 확인하거나, 추천 플러그인을 설치하거나, 플러그인의 사용 가능 여부를 관리할 때 사용합니다. |
/hooks |
수명 주기 훅을 확인하고 관리합니다. | 구성된 훅을 확인하거나, 새 훅 또는 변경된 훅을 신뢰하거나, 실행 전 비관리형 훅을 비활성화할 때 사용합니다. |
/clear |
터미널을 지우고 새 채팅을 시작합니다. | 새로 시작하기 위해 표시된 UI와 채팅 컨텍스트를 함께 초기화할 때 사용합니다. |
/rename |
현재 채팅의 이름을 변경합니다. | TUI를 벗어나지 않고 저장된 세션에 알아보기 쉬운 이름을 지정할 때 사용합니다. |
/archive |
현재 세션을 보관하고 Codex를 종료합니다. | 대화 기록을 삭제하지 않고 활성 세션 목록에서 현재 세션을 제거할 때 사용합니다. |
/delete |
현재 세션을 영구 삭제하고 Codex를 종료합니다. | 보관만으로 충분하지 않을 때 대화 기록과 하위 세션을 제거하는 데 사용합니다. |
/compact |
표시된 채팅을 요약하여 토큰을 확보합니다. | 긴 작업 후 컨텍스트 창을 과도하게 사용하지 않으면서 Codex가 핵심 내용을 유지하도록 할 때 사용합니다. |
/copy |
최근에 완료된 Codex 출력을 복사합니다. | 직접 선택하지 않고 최근에 완료된 응답이나 계획 텍스트를 가져올 때 사용합니다. Ctrl+O을 눌러도 됩니다. |
/diff |
Git이 아직 추적하지 않는 파일을 포함하여 Git diff를 표시합니다. | 커밋하거나 테스트를 실행하기 전에 Codex의 편집 내용을 검토할 때 사용합니다. |
/exit |
CLI를 종료합니다(/quit과 동일). |
대체 표기이며, 두 명령 모두 세션을 종료합니다. |
/experimental |
실험적 기능을 전환합니다. | Network proxy 또는 Prevent sleep while running과 같은 옵션을 활성화할 때 사용합니다. |
/approve |
최근 자동 검토 거부 건의 재시도를 한 번 승인합니다. | 자동 검토자가 거부한 명령이나 작업을 재시도할 때 사용합니다. |
/memories |
메모리 사용 및 생성을 구성합니다. | TUI를 벗어나지 않고 메모리 주입 또는 메모리 생성을 켜거나 끌 때 사용합니다. |
/skills |
스킬을 탐색하고 사용합니다. | 관련 로컬 스킬을 선택하여 작업별 동작을 개선할 때 사용합니다. |
/import |
Claude Code 설정, 프로젝트 및 최근 채팅을 가져옵니다. | 지원되는 외부 에이전트 아티팩트를 Codex 구성 및 로컬 파일로 마이그레이션할 때 사용합니다. |
/feedback |
Codex 유지 관리자에게 로그를 전송합니다. | 문제를 보고하거나 지원팀과 진단 정보를 공유할 때 사용합니다. |
/init |
현재 디렉터리에 AGENTS.md 스캐폴드를 생성합니다. |
작업 중인 저장소나 하위 디렉터리에 대한 지속적인 지침을 기록할 때 사용합니다. |
/logout |
Codex에서 로그아웃합니다. | 공유 컴퓨터를 사용할 때 로컬 자격 증명을 지울 때 사용합니다. |
/mcp |
구성된 Model Context Protocol (MCP) 도구를 나열합니다. | 세션 중 Codex가 호출할 수 있는 외부 도구를 확인할 때 사용합니다. 서버 세부 정보를 보려면 verbose을 추가합니다. |
/mention |
채팅에 파일을 첨부합니다. | Codex가 다음에 확인할 특정 파일이나 폴더를 지정할 때 사용합니다. |
/model |
활성 모델과 가능한 경우 추론 수준을 선택합니다. | 작업을 실행하기 전에 gpt-5.6-luna 및 gpt-5.6-terra 같은 모델 사이를 전환할 때 사용합니다. |
/fast |
모델 카탈로그에서 제공하는 경우 Fast 서비스 티어를 전환합니다. | 현재 모델의 Fast 티어를 켜거나 끄고 선택 사항을 영구 저장할 때 사용합니다. |
/plan |
계획 모드로 전환하고 선택적으로 프롬프트를 전송합니다. | 구현 작업을 시작하기 전에 Codex에 실행 계획을 제안하도록 요청할 때 사용합니다. |
/goal |
작업 목표를 설정, 편집, 일시 중지, 재개, 확인 또는 삭제합니다. | 더 큰 작업이 실행되는 동안 Codex가 추적할 지속적인 목표를 지정할 때 사용합니다. |
/personality |
응답의 커뮤니케이션 스타일을 선택합니다. | 지침을 변경하지 않고 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 상태 표시줄 필드를 대화형으로 구성합니다. | 바닥글 항목(model/context/limits/git/tokens/session)을 선택하고 순서를 바꾼 뒤 config.toml에 저장합니다. |
/title |
터미널 창 또는 탭 제목 필드를 대화형으로 구성합니다. | project, status, thread, branch, model 및 task progress 같은 제목 항목을 선택하고 순서를 변경합니다. |
/theme |
구문 강조 테마를 선택합니다. | 터미널 구문 강조 테마를 미리 보고 영구 저장할 때 사용합니다. |
/pets, /pet |
터미널 펫을 선택하거나 숨깁니다. | 기본 제공 또는 사용자 지정 앰비언트 펫으로 TUI를 개인화할 때 사용합니다. |
/quit과 /exit은 모두 CLI를 종료합니다. 중요한 작업을 저장하거나
커밋한 후에만 사용하세요.
먼저 묻지 않고 Codex가 수행할 수 있는 작업을 조정하려면 /permissions을 사용하세요. 최근 작업이
자동 검토에서 거부되어 재시도해야 할 때만 /approve을
사용하세요.
슬래시 명령으로 세션 제어하기
다음 워크플로를 사용하면 Codex를 다시 시작하지 않고도 세션이 계획대로 진행되도록 관리할 수 있습니다.
/model으로 활성 모델 설정하기
- Codex를 시작하고 작성기를 엽니다.
/model을 입력하고 Enter를 누릅니다.- 팝업에서
gpt-5.6-luna또는gpt-5.6-terra같은 모델을 선택합니다.
예상 결과: Codex가 대화 기록에서 새 모델을 확인해 줍니다. 변경 사항을 확인하려면 /status을 실행하세요.
/fast으로 Fast 모드 전환하기
- 현재 모델의 Fast 서비스 티어를 켜려면
/fast을 입력합니다. - 끄려면
/fast을 다시 입력합니다.
예상 결과: Codex가 티어를 전환하고 선택 사항을 저장합니다. TUI 바닥글에서
/statusline을 사용하여 Fast 모드 상태 표시줄 항목을 표시할 수도 있습니다.
Fast 티어 명령은 카탈로그에 따라 제공됩니다. 현재 모델에서 Fast 티어를
지원하지 않으면 Codex는 /fast을 표시하지 않습니다.
/personality으로 커뮤니케이션 스타일 설정하기
프롬프트를 다시 작성하지 않고 Codex의 커뮤니케이션 방식을 변경하려면 /personality을 사용하세요.
- 활성 채팅에서
/personality을 입력하고 Enter를 누릅니다. - 팝업에서 스타일을 선택합니다.
예상 결과: Codex가 대화 기록에서 새 스타일을 확인해 주고 이후 채팅 응답에 해당 스타일을 사용합니다.
Codex는 friendly, pragmatic 및 none 성격을 지원합니다. 성격 관련 지침을
비활성화하려면 none을 사용하세요.
활성 모델에서 성격별 지침을 지원하지 않으면 Codex가 이 명령을 숨깁니다.
/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가 기능 선택 사항을 구성에 저장하고 다시 시작할 때 적용합니다.
/approve으로 자동 검토 거부 승인하기
자동 검토자가 최근 작업을 거부했으며 Codex가 해당 작업을 한 번 재시도하게 하려면
/approve을 사용하세요.
/approve을 입력합니다.- Codex가 관련 거부 작업을 표시하면 재시도를 확인합니다.
예상 결과: Codex가 현재 세션 정책에 따라 거부된 작업을 한 번 재시도합니다.
/memories으로 메모리 구성하기
/memories을 입력합니다.- Codex가 기존 메모리를 사용할지, 새 메모리를 생성할지 또는 메모리 동작을 비활성화할지 선택합니다.
예상 결과: Codex가 이후 세션에 적용되는 관련 메모리 설정을 업데이트합니다.
/skills으로 스킬 사용하기
/skills을 입력합니다.- Codex에서 적용할 스킬을 선택합니다.
예상 결과: Codex가 선택한 스킬 컨텍스트를 삽입하여 다음 요청에서 해당 스킬의 지침을 따르도록 합니다.
/import으로 Claude Code 설정 가져오기
/import을 입력합니다.- Claude Code를 선택합니다.
- 마이그레이션할 설정, 프로젝트 파일 또는 최근 채팅을 선택합니다.
예상 결과: 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가 현재 세션을 보관하고 대화형 TUI를 닫습니다.
Codex는 세션 대화 기록을 로컬에 보관하며, 나중에
codex unarchive <SESSION>으로 복원할 수 있습니다.
작업 실행 중에는 /archive을 사용할 수 없습니다.
/delete으로 현재 세션 삭제하기
/delete을 입력하고 Enter를 누릅니다.- 현재 세션을 삭제하고 Codex를 종료할지 확인합니다.
예상 결과: Codex가 현재 세션 대화 기록을 삭제하고 대화형 TUI를 닫습니다. 삭제는 영구적이며 생성된 모든 하위 세션도 제거됩니다.
채팅 실행 중이거나 사이드 채팅 안에서는 /delete을 사용할 수 없습니다.
/permissions으로 권한 업데이트하기
/permissions을 입력하고 Enter를 누릅니다.- 사용자가 원하는 제어 수준에 맞는 승인 프리셋을 선택합니다. 예를 들어
자동 실행에는
Auto을, 편집 내용 검토에는Read Only을 선택합니다. 명명된 권한 프로필이 활성화되어 있으면 선택기에 구성된 사용자 지정 프로필과 설명도 표시됩니다.
예상 결과: Codex가 업데이트된 정책을 알립니다. 이후 작업에는 다시 변경할 때까지 업데이트된 승인 모드가 적용됩니다.
/ide으로 IDE 컨텍스트 포함하기
/ide을 입력합니다.- 현재 IDE 선택 영역이나 열린 파일을 Codex가 어떻게 처리해야 하는지 설명하려면 인라인 텍스트를 선택적으로 추가합니다.
예상 결과: Codex가 다음 프롬프트에 사용 가능한 IDE 컨텍스트를 포함합니다.
/vim으로 Vim 모드 전환하기
/vim을 입력합니다.- 작성기에서 계속 편집합니다.
예상 결과: Codex가 현재 세션의 작성기 Vim 모드를 전환합니다. 새 세션에서 Vim
모드를 기본값으로 사용하려면 tui.vim_mode_default = true을
config.toml에 설정하세요.
/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으로 기본값을 영구 저장할 수도 있습니다.
/sandbox-add-read-dir으로 샌드박스 읽기 권한 부여하기
이 명령은 Windows에서 CLI를 네이티브로 실행할 때만 사용할 수 있습니다.
/sandbox-add-read-dir C:\absolute\directory\path을 입력하고 Enter를 누릅니다.- 해당 경로가 존재하는 절대 디렉터리인지 확인합니다.
예상 결과: Codex가 Windows 샌드박스 정책을 새로 고치고 이후 샌드박스에서 실행되는 명령이 해당 디렉터리를 읽을 수 있도록 권한을 부여합니다.
/status으로 세션 확인하기
- 채팅에서
/status을 입력합니다. - 출력에서 활성 모델, 승인 정책, 쓰기 가능 루트 및 현재 토큰 사용량을 검토합니다. TUI가 원격으로 연결된 경우 출력에 원격 주소와 서버 버전도 표시됩니다.
예상 결과: Codex가 예상한 환경에서 작동 중임을 확인하는 요약을 출력합니다.
/usage으로 계정 사용량 확인하기
- 사용량 메뉴를 열려면
/usage을 입력합니다. - 토큰 활동을 표시할지 또는 사용 가능한 획득 재설정을 사용할지 선택합니다.
- 토큰 활동을 직접 열려면
/usage daily,/usage weekly또는/usage cumulative을 입력합니다.
예상 결과: Codex가 사용량 작업을 열거나 선택한 보기에 대한 계정 토큰 활동을 표시합니다. 세션에 Codex 서비스 계정 인증이 없으면 Codex가 로그인 요구 사항을 표시합니다.
/debug-config으로 구성 계층 확인하기
/debug-config을 입력합니다.- 출력에서 구성 계층 순서(우선순위가 가장 낮은 것부터), 켜짐/꺼짐 상태 및 정책 소스를 검토합니다.
예상 결과: Codex가 계층 진단 정보와 함께 구성된 경우
allowed_approval_policies, allowed_sandbox_modes, mcp_servers, rules,
enforce_residency 및 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으로 변경 사항 검토하기
- Git diff를 확인하려면
/diff을 입력합니다. - CLI 안에서 출력을 스크롤하여 편집된 파일과 추가된 파일을 검토합니다.
예상 결과: Codex가 스테이징한 변경 사항, 아직 스테이징하지 않은 변경 사항 및 Git이 아직 추적하지 않는 파일을 표시하여 유지할 항목을 결정할 수 있게 합니다.
/mention으로 파일 강조 표시하기
/mention뒤에 경로를 입력합니다(예:/mention src/lib/api.ts).- 팝업에서 일치하는 결과를 선택합니다.
예상 결과: Codex가 파일을 채팅에 추가하여 이후 턴에서 해당 파일을 직접 참조하도록 합니다.
/new으로 새 채팅 시작하기
/new을 입력하고 Enter를 누릅니다.
예상 결과: Codex가 동일한 CLI 세션에서 새 채팅을 시작하므로 터미널을 벗어나지 않고 채팅을 전환할 수 있습니다.
새 채팅을 만들면서 이름을 지정하려면 /new bug bash을 실행하세요.
/clear과 달리 /new은 현재 터미널 보기를 먼저 지우지 않습니다.
/rename으로 현재 채팅 이름 변경하기
/rename <name>을 입력하거나/rename을 입력하여 이름 지정 프롬프트를 엽니다.- 나중에 채팅을 찾는 데 도움이 될 짧은 이름을 입력합니다.
예상 결과: Codex가 대화 기록을 변경하지 않고 저장된 채팅 이름을 업데이트합니다.
/resume으로 저장된 채팅 재개하기
/resume을 입력하고 Enter를 누릅니다.- 저장된 세션 선택기에서 원하는 세션을 선택합니다.
예상 결과: Codex가 선택한 채팅의 대화 기록을 다시 불러와 원래 기록을 그대로 유지하면서 중단한 지점부터 계속할 수 있게 합니다.
/fork으로 현재 채팅 포크하기
/fork을 입력하고 Enter를 누릅니다.
예상 결과: 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을 사용할 수 없습니다.
/init으로 AGENTS.md 생성하기
- Codex가 지속적인 지침을 찾도록 할 디렉터리에서
/init을 실행합니다. - 생성된
AGENTS.md을 검토한 다음 저장소 규칙에 맞게 편집합니다.
예상 결과: Codex가 이후 세션을 위해 다듬고 커밋할 수 있는 AGENTS.md 스캐폴드를
생성합니다.
/review으로 작업 트리 검토 요청하기
/review을 입력합니다.- 정확한 파일 변경 사항을 확인하려면 이어서
/diff을 입력합니다.
예상 결과: Codex가 작업 트리에서 발견한 문제를 동작 변경과 누락된 테스트에
초점을 맞춰 요약합니다. config.toml에서 review_model을 설정하지 않았다면
현재 세션 모델을 사용합니다.
/mcp으로 MCP 도구 나열하기
/mcp을 입력합니다.- 목록을 검토하여 사용할 수 있는 MCP 서버와 도구를 확인합니다.
예상 결과: 이 세션에서 Codex가 호출할 수 있도록 구성된 Model Context Protocol (MCP) 도구가 표시됩니다.
자세한 서버 진단 정보를 포함하려면 /mcp verbose을 사용하세요. verbose 이외의 값을 전달하면 Codex가 명령 사용법을 표시합니다.
/apps으로 앱 탐색하기
/apps을 입력합니다.- 목록에서 앱을 선택합니다.
예상 결과: Codex가 앱 멘션을 $app-slug 형태로 작성기에 삽입하므로
즉시 Codex에 앱 사용을 요청할 수 있습니다.
/plugins으로 플러그인 탐색하기
/plugins을 입력합니다.- 마켓플레이스 탭을 선택한 다음 플러그인을 선택하여 기능이나 사용 가능한 작업을 확인합니다.
예상 결과: Codex가 플러그인 브라우저를 열어 설치된 플러그인, 구성에서 허용하는 검색 가능한 플러그인 및 설치된 플러그인의 상태를 검토할 수 있게 합니다. 설치된 플러그인에서 Space를 눌러 활성화 상태를 전환합니다.
/hooks으로 수명 주기 훅 확인 및 관리하기
/hooks을 입력합니다.- 훅 이벤트를 선택하여 일치하는 핸들러를 확인합니다.
- 필요에 따라 비관리형 훅을 신뢰하거나, 비활성화하거나, 다시 활성화합니다.
예상 결과: Codex가 훅 브라우저를 열어 구성된 수명 주기 훅을 검토할 수 있게 합니다. 관리형 훅은 관리형으로 표시되며 사용자 훅 브라우저에서 비활성화할 수 없습니다.
/agent으로 에이전트 스레드 전환하기
/agent또는/subagents을 입력하고 Enter를 누릅니다.- 선택기에서 원하는 스레드를 선택합니다.
예상 결과: Codex가 활성 스레드를 전환하여 해당 에이전트의 작업을 확인하거나 계속할 수 있게 합니다.
/feedback으로 피드백 보내기
/feedback을 입력하고 Enter를 누릅니다.- 프롬프트에 따라 로그나 진단 정보를 포함합니다.
예상 결과: Codex가 요청된 진단 정보를 수집하여 유지 관리자에게 제출합니다.
/logout으로 로그아웃하기
/logout을 입력하고 Enter를 누릅니다.
예상 결과: Codex가 현재 사용자 세션의 로컬 자격 증명을 지웁니다.
/quit 또는 /exit으로 CLI 종료하기
/quit(또는/exit)을 입력하고 Enter를 누릅니다.
예상 결과: Codex가 즉시 종료됩니다. 중요한 작업은 먼저 저장하거나 커밋하세요.
IDE 확장 프로그램 명령
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 사이드바 패널을 엽니다. |
IDE 확장 프로그램 슬래시 명령
슬래시 명령을 사용하면 작성기를 벗어나지 않고 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 worktree에서 채팅을 실행합니다. |