핵심 요약
공식 명령 27개와 공통·명령별 옵션을 범위별로 정리합니다.
CLI 0.155.1까지의 daemon update 등 릴리스 추가 사항을 구분합니다.
2026-09-22 Developer Commands의 CLI 표를 기준으로 명령 27개와 공통·명령별 옵션 표를 수록했습니다. 아래 값은 공식 문서의 타입·허용값·인자 형태이며, 실제 실행 시에는 placeholder를 바꾸고 codex <command> --help를 확인하세요. CLI 0.155.1까지의 릴리스 추가 사항은 마지막 절에 따로 정리했습니다.
슬래시 명령 · Developer Commands
명령 용도 codex대화형 TUI 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 remote-controlremote daemon·pairing; experimental codex resume이전 대화 재개 codex review비대화형 코드 리뷰 codex sandboxOS sandbox 안에서 명령 실행 codex unarchive보관 세션 복원 codex update지원 release build 자체 업데이트
키 타입·값·인자 --add-dirpath--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--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-configbooleanPROMPTstring
--profile은 $CODEX_HOME/<profile>.config.toml을 겹쳐 적용합니다. --remote-auth-token-env는 --remote가 필요하며 token은 WSS 또는 local WS로만 전송합니다. --search는 cached 대신 live search를 선택합니다. --strict-config는 알 수 없는 설정을 오류로 처리합니다.
키 타입·값·인자 --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 연결입니다.
키 타입·값·인자 --download-urlurlPATHpath
키 타입·값·인자 USER_MESSAGEstring
--bundled는 원격 갱신 없이 binary에 포함된 catalog만 출력합니다.
키 타입·값·인자 --image, -ipath[,path...]PROMPTstring
출력에는 모델에 전달되는 instruction·context가 포함되므로 외부에 붙이기 전에 내용을 확인하세요.
키 타입·값·인자 --basebranch--commitSHA--strict-configboolean--titlestring--uncommittedbooleanPROMPTstring | - (read stdin)
--uncommitted, --base, --commit, 사용자 PROMPT 중 하나만 선택합니다. --title은 --commit과 함께 씁니다.
키 타입·값·인자 --remotews://host:port | wss://host:port | unix:// | unix://PATH--remote-auth-token-envENV_VARSESSIONsession ID | session name
키 타입·값·인자 --forceboolean--remotews://host:port | wss://host:port | unix:// | unix://PATH--remote-auth-token-envENV_VARSESSIONsession ID | session name
--force는 session UUID에만 적용됩니다. 같은 이름이 여러 개일 수 있어 이름 삭제는 확인이 필요합니다.
키 타입·값·인자 --attempts1-4--envENV_IDQUERYstring
이 표는 codex cloud exec의 task 제출 옵션입니다.
키 타입·값·인자 --cursorstring--envENV_ID--jsonboolean--limit1-20
키 타입·값·인자 SHELLbash | zsh | fish | power-shell | elvish
키 타입·값·인자 --allboolean--asciiboolean--jsonboolean--no-colorboolean--summaryboolean
키 타입·값·인자 Disable subcommandcodex features disable <feature>Enable subcommandcodex features enable <feature>List subcommandcodex features list
enable/disable은 설정 파일에 저장합니다. 이 명령은 --profile을 받지 않습니다.
키 타입·값·인자 --cd, -Cpath--coloralways | never | auto--dangerously-bypass-approvals-and-sandbox, --yoloboolean--dangerously-bypass-hook-trustboolean--ephemeralboolean--full-autoboolean--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-c, --configkey=valuePROMPTstring | - (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를 명시하세요.
키 타입·값·인자 --allboolean--image, -ipath[,path...]--lastbooleanPROMPTstring | - (read stdin)SESSION_IDuuid | session name
--last는 현재 cwd에 한정되며 --all로 전체 세션을 검색합니다.
키 타입·값·인자 --prettyboolean--rules, -rpath (repeatable)COMMAND...var-args
키 타입·값·인자 --device-authboolean--with-access-tokenboolean--with-api-keybooleanstatus subcommandcodex login status
API key·access token은 인자 값에 넣지 않고 stdin으로 전달합니다. status의 종료 코드 0은 로그인 상태입니다.
키 타입·값·인자 add <name>-- <command...> | --url <value>get <name>--jsonlist--jsonlogin <name>--scopes scope1,scope2logout <name>— remove <name>—
OAuth login/logout은 이를 지원하는 streamable HTTP 서버에만 적용됩니다.
키 타입·값·인자 --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이 필요합니다.
키 타입·값·인자 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 배열이 있습니다.
키 타입·값·인자 add <source>[--ref REF] [--sparse PATH] [--json]list[--json]remove <marketplace-name>[--json]upgrade [marketplace-name][--json]
--sparse는 Git source에만 적용하며 반복할 수 있습니다.
키 타입·값·인자 --allboolean--include-non-interactiveboolean--lastbooleanSESSION_IDuuid | session name
cwd 선택은 tui.resume_cwd로 저장할 수 있으며 명시적 --cd가 우선합니다.
키 타입·값·인자 --allboolean--lastbooleanSESSION_IDuuid
키 타입·값·인자 --allow-unix-socketpath--cd, -CDIR--config, -ckey=value--include-managed-configboolean--log-denialsboolean--permission-profile, -PNAME--profile, -pNAMECOMMAND...var-args
--cd와 --include-managed-config는 --permission-profile이 필요합니다. --allow-unix-socket은 macOS 전용입니다.
키 타입·값·인자 --cd, -CDIR--config, -ckey=value--include-managed-configboolean--permission-profile, -PNAME--profile, -pNAMECOMMAND...var-args
--cd와 --include-managed-config는 --permission-profile이 필요합니다.
키 타입·값·인자 --cd, -CDIR--config, -ckey=value--include-managed-configboolean--permission-profile, -PNAME--profile, -pNAMECOMMAND...var-args
--cd와 --include-managed-config는 --permission-profile이 필요합니다.
명령 범위 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로 확인합니다.
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를 구분하세요.
관련 문서