20260508 버전

CLI 명령어

기본

명령어

설명

Codex [OPTIONS] [PROMPT]

하위 명령 없이 실행하면 대화형 Codex TUI를 시작.

[PROMPT] 를 입력하면 그 프롬프트로 세션을 시작

공통 옵션: 대부분의 명령에서 공통으로 사용할 수 있음

명령어	설명
-c, --config <key=value>	~/.codex/config.toml 설정을 임시로 덮어씀
--enable <FEATURE>	기능 플래그 활성화
--disable <FEATURE>	기능 플래그 비활성화
-h, --help	도움말 출력
-V, --version	버전 출력 (일부 명령에서 지원)

대화형/에이전트 실행 계열에서 자주 사용하는 옵션

명령어	설명
-m, --model <MODEL>	사용할 모델 지정
-i, --image <FILE>	초기 프롬프트에 이미지 첨부
-p, --profile <CONFIG_PROFILE>	설정 프로필 사용
-s, --sandbox <read-only\|workspace-write\|danger-full-access>	샌드박스 정책 지정
-C, --cd <DIR>	작업 루트 지정
--add-dir <DIR>	추가 쓰기 가능한 디렉토리 지정
-a, --ask-for-approval <untrusted\|on-failure\|on-request\|never>	승인 요청 정책
--search	웹 검색 도구 활성화
--oss	오픈소스 프로바이더(provider) 사용
--local-provider <lmstudio\|ollama>	로컬 프로바이더(provider) 지정
--no-alt-screen	TUI를 alternate screen 없이 실행
--dangerously-bypass-approvals-and-sandbox	승인 샌드박스 우회 (사용 주의 필요함)

상위 명령어

명령어	설명
codex exec / codex e	codex를 비대화형으로 실행 (CI, 스크립트, 일회성 작업에 적합)
codex review	현재의 변경 사항을 비대화형으로 코드 리뷰
codex login	로그인, 인증을 관리
codex logout	저장된 인증 정보를 제거
codex mcp	외부 MCP 서버 서
codex plugin	Codex 플러그인을 관리
codex mcp-server	Codex를 stdio MCP 서버로 시작
codex app-server	app server 또는 관련 도구를 실행
codex app	Codex 데스크톱 앱을 실행
codex completion	셀 자동완성 스크립트를 생성
codex update	Codex를 최신 버전으로 업데이트
codex sandbox	Codex 제공 샌드박스 안에서 명령을 실행
codex debug	디버깅 도구 모음
codex apply / codex a	Codex agent가 만든 최신 diff를 git apply로 현재 워킹 트리에 적용
codex resume	이전 대화형 세션을 이어서 열기
codex fork	이전 대화형 세션을 포크해서 새 분기로 열기
codex cloud:	실험적 Codex Cloud 작업 조회/적용 명령
codex exec-server	standalone exec-server 서비스를 실행
codex features	기능 플래그를 조회/활성화/비활성화
codex help	도움말을 출력

exec 계열

명령어	설명
codex exec [PROMPT]	프롬프트를 받아 Codex를 비대화형으로 실행 -를 쓰거나 stdin을 pipe하면 stdin에서 지시를 읽음
codex exec resume [SESSION_ID] [PROMPT]	이전 비대화형 세션을 이어서 실행 --last로 가장 최근 세션 선택
codex exec review [PROMPT]	현재 비대화형 코드를 리뷰
주요 옵션: --json, --output-last-message <FILE>, --output-schema <FILE>, --ephemeral, --skip-git-repo-check, --ignore-user-config, --ignore-rules

review 계열

명령어	설명
codex review [PROMPT]	코드 리뷰 실행
--uncommitted	staged/unstaged/untracked 변경 리뷰
--base <BRANCH>	특정 base branch 대비 리뷰
--commit <SHA>	특정 커밋 리뷰
--title <TITLE>	리뷰 요약 제목 지정

login / logout 계열

명령어	설명
codex login	로그인 시작
codex login status	로그인 상태 표시
codex login --with-api-key	stdin에서 API key 읽기
codex login --with-agent-identity	stdin에서 Agent Identity 토큰 읽기
codex login --device-auth	디바이스 인증 사용
codex logout	저장된 인증 정보 제거

mcp 계열

명령어	설명
codex mcp list	설정된 MCP 서버 목록 표시
codex mcp list --json	JSON으로 출력
codex mcp get <NAME>	특정 MCP 서버 설정 표시
codex mcp get <NAME> --json	JSON으로 출력
codex mcp add <NAME> -- <COMMAND>...	stdio MCP 서버 추가
codex mcp add <NAME> --url <URL>	streamable HTTP MCP 서버 추가
codex mcp remove <NAME>	MCP 서버 설정 제거
codex mcp login <NAME>	MCP 서버 OAuth 인증
codex mcp logout <NAME>	MCP 서버 인증 해제
mcp add 주요 옵션: --env <KEY=VALUE>, --url <URL>, --bearer-token-env-var <ENV_VAR>

plugin 계열

명령어	설명
codex plugin marketplace	플러그인 marketplace 관리
codex plugin marketplace add <SOURCE>	marketplace 추가
codex plugin marketplace upgrade [MARKETPLACE_NAME]	marketplace 업데이트
codex plugin marketplace remove <MARKETPLACE_NAME>	marketplace 제거
plugin add의 <SOURCE>는 owner/repo[@ref], HTTP(S) Git URL, SSH URL, 로컬 marketplace 디렉터리를 지원함. 옵션으로 --ref <REF>, --sparse <PATH>가 있음

mcp-server 계열

명령어	설명
codex mcp-server	Codex를 stdio 기반 MCP 서버로 실행

app-server 계열

명령어	설명
codex app-server	app server 실행
codex app-server proxy	실행 중인 app-server control socket으로 stdio bytes 프록시
codex app-server generate-ts --out <DIR>	pp server protocol TypeScript binding 생성
codex app-server generate-json-schema --out <DIR>	app server protocol JSON Schema 생성
주요 옵션: --listen <URL>, --analytics-default-enabled, --ws-auth, --ws-token-file, --ws-token-sha256, --ws-shared-secret-file, --ws-issuer, --ws-audience, --ws-max-clock-skew-seconds

app 계열

명령어	설명
codex app [PATH]	Codex Desktop 앱을 해당 워크스페이스 경로로 오픈. 기본값은 현재 디렉토리
--download-url <URL>	앱 설치 프로그램 다운로드 URL override.

completion 계열

명령어	설명
codex completion [SHELL]	셸 자동완성 스크립트 생성
지원 셸: bash, elvish, fish, powershell, zsh

update 계열

명령어	설명
codex update	Codex를 최신 버전으로 업데이트

sandbox 계열

명령어	설명
codex sandbox macos [COMMAND]...	맥 Seatbelt 샌드박스에서 명령 실행. alias: seatbelt
codex sandbox linux [COMMAND]...	리눅스 sandbox에서 명령 실행. alias: landlock
codex sandbox windows [COMMAND]...	윈도우 restricted token sandbox에서 명령 실행
주요 옵션: --permissions-profile <NAME>, -C/--cd <DIR>, --include-managed-config. macOS는 추가로 --allow-unix-socket <PATH>, --log-denials 지원

debug 계열

명령어	설명
codex debug models	raw model catalog를 JSON으로 출력
codex debug models --bundled	바이너리에 포함된 bundled catalog만 출력
codex debug prompt-input [PROMPT]	모델에 보이는 prompt input list를 JSON으로 렌더링
codex debug app-server	app server 디버깅 도구
codex debug app-server send-message-v2 <USER_MESSAGE>	app server에 테스트 메시지 전송

apply 계열

명령어	설명
codex apply <TASK_ID> / codex a <TASK_ID>	Codex 에이전트가 만든 최신 diff를 현재 워킹 트리에 적용

resume 계열

명령어	설명
codex resume [SESSION_ID] [PROMPT]	이전 대화형 세션을 이어서 열기
--last	가장 최근 세션 바로 이어 열기
--all	모든 세션 표시
--include-non-interactive	비대화형 세션도 포함

fork 계열

명령어	설명
codex fork [SESSION_ID] [PROMPT]	이전 대화형 세션을 포크해서 새 세션으로 열기
--last	가장 최근 세션 포크
--all	모든 세션 표시

cloud 계열

명령어	설명
codex cloud	Codex Cloud 작업을 탐색하고 로컬에 적용
codex cloud exec --env <ENV_ID> [QUERY]	새 Cloud 작업 제출
codex cloud status <TASK_ID>	Cloud 작업 상태 확인
codex cloud list	Cloud 작업 목록 표시
codex cloud apply <TASK_ID>	Cloud 작업 diff를 로컬에 적용
codex cloud diff <TASK_ID>	Cloud 작업 diff 출력
주요 옵션: --env <ENV_ID>, --attempts <N>, --branch <BRANCH>, --limit <N>, --cursor <CURSOR>, --json, --attempt <N>

exec-server 계열

명령어	설명
codex exec-server	standalone exec-server 서비스 실행
--listen <URL>	WebSocket listen 주소. 기본값 ws://127.0.0.1:0.

features 계열

명령어	설명
codex features list	알려진 feature flag와 상태 출력
codex features enable <FEATURE>	config.toml에서 feature 활성화
codex features disable <FEATURE>	config.toml에서 feature 비활성화

TUI 명령어

명령어	설명
/model	모델과 reasoning effort 선택
/fast	Fast mode 토글. 더 빠른 추론, plan 사용량 증가
/permissions	Codex 허용 권한 설정
/approvals	권한/승인 설정. /permissions와 같은 계열로 표시
/keymap	TUI 단축키 재설정
/experimental	실험 기능 토글
/autoreview	최근 auto-review 거부 1회 재시도 승인
/memories	메모리 사용/생성 설정
/skills	skills 활성화/비활성화
/review	현재 변경사항 리뷰
/rename	현재 이름 변경
/new	새 채팅 시작
/resume	저장된 채팅 재개
/fork	현재 채팅 포크
/init	AGENTS.md 생성
/compact	컨텍스트 한계 방지를 위해 대화 요약
/plan	Plan mode로 전환
/collab	협업 모드 변경, experimental
/agent	활성 agent thread 전환
/subagents	활성 agent thread 전환, /agent 계열
/side	ephemeral fork로 side conversation 시작
/copy	마지막 응답을 Markdown으로 복사
/diff	git diff 표시, untracked 포함
/mention	파일 mention
/status	현재 세션 설정과 토큰 사용량 표시
/debug-config	config layer와 requirement source 디버그 표시
/title	TUI title 표시 항목 설정
/statusline	status line 표시 항목 설정
/theme	syntax highlighting theme 선택
/mcp	설정된 MCP tools 목록 표시. /mcp verbose 가능
/plugins	플러그인 탐색
/logout	Codex 로그아웃
/exit	Codex 종료
/feedback	로그/피드백 전송
/ps	background 터미널 목록 표시
/stop	모든 background 터미널 중지
/clear	터미널을 지우고 새 채팅 시작
/personality	Codex 커뮤니케이션 스타일 선택
/realtime	realtime voice mode 토글, experimental

goal 계열

TUI 환경에선 codex --enable goals로 실행하면 표시됨

명령어	설명
/goal	현재 goal 보기
/goal <objective>	long-running task goal 설정
/goal pause	goal 일시정지
/goal resume	goal 재개
/goal clear	goal 삭제

Codex CLI, TUI 명령어 모음