본문으로 바로가기
리옵트 핸드북
리옵트 핸드북
Codex 명령어 마스터표기와 명령 선택 기준상세 페이지 읽는 법전체 명령 목록터미널 CLI 명령·옵션 전체 참조

작업별 가이드

기본 명령어 묶음 (코어)기본 명령어 묶음 (세션 운영)커스텀 명령어 가이드MCP 명령/연동 가이드디자인 워크플로우

대화와 컨텍스트

Cmd. /archiveCmd. /copyCmd. /importCmd. /cd

계획과 실행

Cmd. /goalCmd. /app

모델과 설정

Cmd. /model

권한과 연결

Cmd. /pluginsCmd. /hooksCmd. /mcp

화면과 입력

Cmd. /statuslineCmd. /tuiCmd. /worktreeCmd. /voice

계정과 사용량

Cmd. /usage

검증과 이력

현재 검증 범위핸드북 변경사항릴리스 반영 이력이전 검증 기록명령별 변경 기록
핸드북›Codex 명령어 마스터›터미널 CLI 명령·옵션 전체 참조
한국어KOEnglishEN

터미널 CLI 명령·옵션 전체 참조

Codex 공식 CLI 명령 29개와 공통·명령별 옵션 표, 릴리스에서 추가된 명령

핵심 요약

  • 공식 명령 29개와 공통·명령별 옵션을 범위별로 정리합니다.
  • CLI 0.163.0까지의 --no-daemon·daemon 자동 시작·--oauth-client-secret·--cyber-access-program 등 릴리스 추가 사항을 구분합니다.

2026-10-23 Developer Commands의 CLI 표를 기준으로 명령 29개와 공통·명령별 옵션 표를 수록했습니다. 아래 값은 공식 문서의 타입·허용값·인자 형태이며, 실제 실행 시에는 placeholder를 바꾸고 codex <command> --help를 확인하세요. CLI 0.163.0까지의 릴리스 추가 사항은 마지막 절에 따로 정리했습니다.

슬래시 명령 · Developer Commands

터미널 명령 29개

명령용도
codex대화형 TUI
codex agentsStable · 로컬·원격 서버의 command center
codex appdesktop app 실행
codex app-server통합 개발용 server; experimental
codex applycloud diff 적용
codex archive저장된 세션 보관
codex cloudcloud task 조회·실행; experimental
codex completionshell 자동완성 생성
codex debug app-server send-message-v2V2 protocol 요청 진단
codex debug models모델 catalog JSON
codex debug prompt-input모델에 전달될 prompt JSON
codex delete세션 영구 삭제
codex doctor설치·설정·runtime 진단
codex exec비대화형 작업
codex execpolicy실행 규칙 판정; preview
codex featuresfeature flag 조회·저장
codex fork저장된 세션 분기
codex login계정·API 인증
codex logout저장된 인증 해제
codex mcp외부 MCP 서버 관리
codex pluginplugin 관리
codex plugin marketplacemarketplace source 관리
codex queueStable · UUID·정확한 이름으로 기존 세션에 메시지 예약
codex remote-controlremote daemon·pairing; experimental
codex resume이전 대화 재개
codex review비대화형 코드 리뷰
codex sandboxOS sandbox 안에서 명령 실행
codex unarchive보관 세션 복원
codex update지원 release build 자체 업데이트

공통 옵션

키타입·값·인자
--add-dirpath
--approve-for-me, --not-so-yoloboolean
--ask-for-approval, -aon-request | never
--cd, -Cpath
--config, -ckey=value
--dangerously-bypass-approvals-and-sandbox, --yoloboolean
--dangerously-bypass-hook-trustboolean
--disablefeature
--enablefeature
--image, -ipath[,path...]
--local-providerlmstudio | ollama
--model, -mstring
--no-alt-screenboolean
--no-daemonboolean
--ossboolean
--profile, -pstring
--remotews://host:port | wss://host:port | unix:// | unix://PATH
--remote-auth-token-envENV_VAR
--sandbox, -sread-only | workspace-write | danger-full-access
--searchboolean
--strict-configboolean
--worktreeboolean
PROMPTstring

--profile은 $CODEX_HOME/<profile>.config.toml을 겹쳐 적용합니다. --remote-auth-token-env는 --remote가 필요하며 token은 WSS 또는 local WS로만 전송합니다. --search는 cached 대신 live search를 선택합니다. --strict-config는 알 수 없는 설정을 오류로 처리합니다.

codex app-server

키타입·값·인자
--analytics-default-enabledboolean
--code-mode-hostws://HOST/PATH | wss://HOST/PATH
--listenstdio:// | ws://IP:PORT | unix:// | unix://PATH | off
--stdioboolean
--ws-audiencestring
--ws-authcapability-token | signed-bearer-token
--ws-issuerstring
--ws-max-clock-skew-secondsnumber
--ws-shared-secret-fileabsolute path
--ws-token-fileabsolute path
--ws-token-sha256hexadecimal SHA-256 digest

--stdio와 --listen은 함께 쓰지 않습니다. signed-bearer-token 모드는 --ws-shared-secret-file이 필요합니다. --code-mode-host는 listener와 별개인 outbound 연결입니다.

codex app

키타입·값·인자
--download-urlurl
PATHpath

codex debug app-server send-message-v2

키타입·값·인자
USER_MESSAGEstring

codex debug models

키타입·값·인자
--bundledboolean

--bundled는 원격 갱신 없이 binary에 포함된 catalog만 출력합니다.

codex debug prompt-input

키타입·값·인자
--image, -ipath[,path...]
PROMPTstring

출력에는 모델에 전달되는 instruction·context가 포함되므로 외부에 붙이기 전에 내용을 확인하세요.

codex apply

키타입·값·인자
TASK_IDstring

codex review

키타입·값·인자
--basebranch
--commitSHA
--strict-configboolean
--titlestring
--uncommittedboolean
PROMPTstring | - (read stdin)

--uncommitted, --base, --commit, 사용자 PROMPT 중 하나만 선택합니다. --title은 --commit과 함께 씁니다.

codex archive and codex unarchive

키타입·값·인자
--remotews://host:port | wss://host:port | unix:// | unix://PATH
--remote-auth-token-envENV_VAR
SESSIONsession ID | session name

codex delete

키타입·값·인자
--forceboolean
--remotews://host:port | wss://host:port | unix:// | unix://PATH
--remote-auth-token-envENV_VAR
SESSIONsession ID | session name

--force는 session UUID에만 적용됩니다. 같은 이름이 여러 개일 수 있어 이름 삭제는 확인이 필요합니다.

codex cloud

키타입·값·인자
--attempts1-4
--envENV_ID
QUERYstring

이 표는 codex cloud exec의 task 제출 옵션입니다.

codex cloud list

키타입·값·인자
--cursorstring
--envENV_ID
--jsonboolean
--limit1-20

codex completion

키타입·값·인자
SHELLbash | zsh | fish | power-shell | elvish

codex doctor

키타입·값·인자
--allboolean
--asciiboolean
--jsonboolean
--no-colorboolean
--summaryboolean

codex features

키타입·값·인자
Disable subcommandcodex features disable <feature>
Enable subcommandcodex features enable <feature>
List subcommandcodex features list

enable/disable은 설정 파일에 저장합니다. 이 명령은 --profile을 받지 않습니다.

codex exec

키타입·값·인자
--approve-for-me, --not-so-yoloboolean
--cd, -Cpath
--coloralways | never | auto
--dangerously-bypass-approvals-and-sandbox, --yoloboolean
--dangerously-bypass-hook-trustboolean
--ephemeralboolean
--ignore-rulesboolean
--ignore-user-configboolean
--image, -ipath[,path...]
--json, --experimental-jsonboolean
--local-providerlmstudio | ollama
--model, -mstring
--ossboolean
--output-last-message, -opath
--output-schemapath
--profile, -pstring
--sandbox, -sread-only | workspace-write | danger-full-access
--skip-git-repo-checkboolean
--worktreeboolean
-c, --configkey=value
PROMPTstring | - (read stdin)
Resume subcommandcodex exec resume [SESSION_ID]

--json은 JSONL event, --output-last-message는 최종 응답 파일, --output-schema는 결과 schema입니다. --full-auto는 공식 reference에 deprecated 항목으로 남아 있지만 0.147~148 릴리스 추적에서 제거로 기록된 구문이므로 새 예제에서는 사용하지 않습니다. --sandbox workspace-write를 명시하세요.

codex exec resume

키타입·값·인자
--allboolean
--image, -ipath[,path...]
--lastboolean
PROMPTstring | - (read stdin)
SESSION_IDuuid | session name

--last는 현재 cwd에 한정되며 --all로 전체 세션을 검색합니다.

codex execpolicy

키타입·값·인자
--prettyboolean
--rules, -rpath (repeatable)
COMMAND...var-args

codex login

키타입·값·인자
--device-authboolean
--with-access-tokenboolean
--with-api-keyboolean
status subcommandcodex login status

API key·access token은 인자 값에 넣지 않고 stdin으로 전달합니다. status의 종료 코드 0은 로그인 상태입니다.

codex mcp

키타입·값·인자
add <name>-- <command...> | --url <value>
get <name>--json
list--json
login <name>--scopes scope1,scope2
logout <name>—
remove <name>—

OAuth login/logout은 이를 지원하는 streamable HTTP 서버에만 적용됩니다.

codex mcp add

키타입·값·인자
--bearer-token-env-varENV_VAR
--env KEY=VALUErepeatable
--oauth-client-idCLIENT_ID
--oauth-resourceRESOURCE
--urlhttps://…
COMMAND...stdio transport

--url과 stdio COMMAND...는 함께 쓰지 않습니다. OAuth client/resource 옵션은 --url이 필요합니다.

codex plugin

키타입·값·인자
add <plugin[@marketplace]>[--marketplace, -m NAME] [--json]
list[--marketplace, -m NAME] [--available --json] [--json]
marketplace—
remove <plugin[@marketplace]>[--marketplace, -m NAME] [--json]

list --available은 --json이 필요합니다. JSON 목록에는 installed·available 배열이 있습니다.

codex plugin marketplace

키타입·값·인자
add <source>[--ref REF] [--sparse PATH] [--json]
list[--json]
remove <marketplace-name>[--json]
upgrade [marketplace-name][--json]

--sparse는 Git source에만 적용하며 반복할 수 있습니다.

codex resume

키타입·값·인자
--allboolean
--include-non-interactiveboolean
--lastboolean
SESSION_IDuuid | session name

cwd 선택은 tui.resume_cwd로 저장할 수 있으며 명시적 --cd가 우선합니다.

codex fork

키타입·값·인자
--allboolean
--lastboolean
SESSION_IDuuid

macOS seatbelt

키타입·값·인자
--allow-unix-socketpath
--cd, -CDIR
--config, -ckey=value
--include-managed-configboolean
--log-denialsboolean
--permission-profile, -PNAME
--profile, -pNAME
COMMAND...var-args

--cd와 --include-managed-config는 --permission-profile이 필요합니다. --allow-unix-socket은 macOS 전용입니다.

Linux sandbox

키타입·값·인자
--cd, -CDIR
--config, -ckey=value
--include-managed-configboolean
--permission-profile, -PNAME
--profile, -pNAME
COMMAND...var-args

--cd와 --include-managed-config는 --permission-profile이 필요합니다.

Windows

키타입·값·인자
--cd, -CDIR
--config, -ckey=value
--include-managed-configboolean
--permission-profile, -PNAME
--profile, -pNAME
COMMAND...var-args

--cd와 --include-managed-config는 --permission-profile이 필요합니다.

0.163.0 현재 옵션과 호환성

--approve-for-me(--not-so-yolo)는 on-request 승인과 workspace-write sandbox에서 자동 승인 리뷰를 사용합니다. --sandbox·--yolo와 충돌하며 대화형 CLI에서는 --ask-for-approval과도 함께 쓸 수 없습니다. --worktree는 로컬 실행 전용이고 exec에서는 resume·review·--ephemeral·--ignore-user-config와 함께 쓸 수 없습니다. --no-daemon은 --remote·codex agents와 충돌합니다. codex agents·codex queue가 공식 overview에 등재됐고 Linux sandbox는 bubblewrap·seccomp 기준입니다.

0.163.0에서 Daybreak는 적격 계정에 기본 활성화됩니다. 아래 0.161.0의 opt-in 설명은 당시의 기록입니다. /config 검색 패널·Ctrl+X leader·F9 음소거·/daemon 재시작은 0.163.0 릴리스를 따릅니다.

릴리스 추가 명령과 호환성

명령범위
codex exec --cyber-access-program0.161.0 turn 단위 Cyber access program 선택; cli_daybreak가 꺼져 있어도 동작
codex --enable cli_daybreak0.161.0 Daybreak 컨트롤과 자동 Cyber routing을 켜는 opt-in
codex mcp add --oauth-client-secret0.158.0 사전 등록 OAuth client의 secret 지정; --oauth-client-id와 함께 사용
codex --no-daemon0.156.0 공유 background server를 건너뛰고 실행
codex app-server daemon update0.155.0 daemon 업데이트
codex agents / codex queue0.149~150 agent·queue 운영
codex exec fork0.147~148 비대화형 분기
codex remote-control / codex remote-control start / codex remote-control stop / codex remote-control pairremote foreground·daemon·pairing; --json 지원
codex mcp-server제거됨; codex app-server 참조

0.155.0은 daemon 업데이트 일정 설정과 재시작 후 thread·goal 복구를 추가했습니다. codex update는 CLI 설치본 자체 업데이트로, daemon update와 대상이 다릅니다. 플랫폼·설치 방식에 따른 하위 옵션은 설치본의 --help로 확인합니다.

0.156.0은 세션 안의 /daemon 메뉴와 공유 background server를 건너뛰는 --no-daemon을 추가했습니다. 0.157.0부터는 대상 대화형 세션이 background server를 자동으로 시작하고, server 설정이 호환되지 않으면 복구 방법을 고르게 합니다. 2026-10-23 공식 표에는 /daemon과 --no-daemon도 등재됐습니다.

0.158.0은 codex mcp add --oauth-client-secret을 추가했습니다. 비어 있지 않은 secret과 client ID가 함께 있어야 하고, 값은 서버 설정의 oauth.client_secret에 저장되며 debug 출력에서는 가려집니다. 공식 codex mcp add 옵션 표에는 아직 없습니다. 공식 표의 --model 예시는 gpt-6.1-sol로 바뀌었고, 0.159.1부터 모델을 지정하지 않으면 번들 기본값 GPT-6.1 Sol이 쓰입니다.

0.161.0은 codex exec --cyber-access-program을 추가했습니다. PR 설명 기준 값은 standard·daybreak_blue·daybreak_red이고, review와 prompt 없는 fork에는 쓸 수 없습니다. 지정한 값은 그 turn에만 적용되고 저장된 선택을 바꾸지 않습니다. 같은 릴리스에서 Daybreak가 opt-in이 되어 --enable cli_daybreak나 features.cli_daybreak = true를 켜지 않으면 Daybreak 컨트롤과 /daybreak, 자동 Cyber routing이 동작하지 않습니다. 두 항목 모두 공식 CLI 표와 non-interactive 문서에는 아직 없습니다.

codex doctor --summary
codex debug models --bundled
codex features list
codex review --uncommitted
codex exec --sandbox workspace-write --json "Explain this repository"

마지막 두 예시는 모델을 호출합니다. shell에서 쓰는 codex review·codex resume와 세션 안의 /review·/resume를 구분하세요.

출처

  • Developer Commands
  • Changelog

관련 문서

이전 검증 기록

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

업데이트 내역

Codex 고급 활용 · Codex 고급 활용 핸드북 변경 로그

Cmd. /app

현재 CLI 세션을 macOS·Windows의 ChatGPT desktop app에서 이어가는 명령

Codex 고급 활용

시니어 개발자를 위한 Codex 운영·확장 가이드 (CLI 0.163.0 / GPT-6.1 Sol 기본값 / GPT-5.5 종료 일정 반영)

Ch10. Codex App/IDE

Codex 고급 활용 · Codex App의 Git 워크트리·인라인 diff·Plan Mode, IDE Auto/Full Access/Read-only 모드와 steering/resume API, in-app browser와 Chrome 확장까지 데스크톱·IDE 인터페이스 운영 가이드

On this page

터미널 명령 29개공통 옵션codex app-servercodex appcodex debug app-server send-message-v2codex debug modelscodex debug prompt-inputcodex applycodex reviewcodex archive and codex unarchivecodex deletecodex cloudcodex cloud listcodex completioncodex doctorcodex featurescodex execcodex exec resumecodex execpolicycodex logincodex mcpcodex mcp addcodex plugincodex plugin marketplacecodex resumecodex forkmacOS seatbeltLinux sandboxWindows0.163.0 현재 옵션과 호환성릴리스 추가 명령과 호환성출처