Codex CLI 치트시트 — 전체 참조

⌨️ 키보드 단축키

일반 제어

CtrlC 입력 취소/중단

CtrlL 화면 지우기

CtrlG 편집기에서 프롬프트 열기

EscEsc 마지막 작업 취소

↑↓ 프롬프트 기록 탐색

실행 중

Enter / Tab 대기 중인 작업 승인

접두사

@ 파일 참조 + 자동 완성

! 직접 셸 명령

/ 슬래시 명령

⚡ 슬래시 명령

모델과 모드

/model 모델 전환

/fast 빠른 모드 전환

/plan 플랜 모드 (읽기 전용)

/review 변경 사항 검토

/diff 변경 차이 보기

/permissions 권한 보기/업데이트

/theme 색상 테마 변경

세션

/clear 대화 지우기

/compact 컨텍스트 압축

/copy 마지막 응답 복사

/status 세션 상태 보기

/fork 세션 포크

/resume 세션 재개

/new 새 세션

/exit 대화형 세션 닫기

프로젝트와 설정

/init AGENTS.md 생성

/mention 파일/컨텍스트 참조

/agent 에이전트 전환/관리

/apps 앱 관리

/personality 성격 설정

/experimental 실험 기능 전환

도구와 기타

/mcp MCP 서버 관리

/ps 실행 중인 프로세스 목록

/skills 사용 가능한 스킬 목록

/feedback 피드백 제출

/logout 로그아웃

🖥️ CLI 플래그

기본 사용법

codex "프롬프트" 초기 프롬프트로 시작

--model 모델 설정

-i <파일> 이미지 파일 첨부

디렉토리와 프로필

--cd <디렉토리> 작업 디렉토리 변경

--add-dir <디렉토리> 추가 디렉토리

--profile <이름> 명명된 프로필 사용

검색과 자동화

--search 라이브 검색 활성화

--full-auto 전체 자동 승인 모드

로컬과 OSS

--oss 오픈소스 모델 사용

--local-provider 로컬 모델 사용

기능 제어

--enable <플래그> 기능 플래그 활성화

--disable <플래그> 기능 플래그 비활성화

--config key=val 설정 값 재정의

세션

-c 이전 세션 계속

--sandbox 샌드박스 모드 설정

--json JSON 출력 형식

🚀 실행과 스크립팅

실행 모드

codex exec "프롬프트" 비대화형 실행

codex e "프롬프트" exec 단축 별칭

--full-auto 모든 승인 건너뛰기

cat f | codex exec 파이프 입력 + 프롬프트NEW

출력

--json JSON 출력 형식

--ephemeral 세션 비영속화

-o <파일> 파일에 출력

--output-last-message 최종 NL 요약

세션 관리

codex resume 세션 재개 (선택기)

codex resume --last 최근 세션 재개

codex resume --all 전체 세션 (모든 디렉토리)

codex fork 세션 포크

환경 변수

CODEX_API_KEY API 키 환경 변수

🤖 모델과 설정

사용 가능한 모델

gpt-5.4 가장 강력 (권장)

gpt-5.3-codex 코딩 최적화

spark 빠르고 가벼움

4.1-mini 소형 고효율

설정 파일 위치

~/.codex/config.toml 사용자 설정 (전역)

.codex/config.toml 프로젝트 설정 (로컬)

설정 옵션

model 기본 모델

approval_policy 승인 동작

sandbox_mode 샌드박스 유형

web_search "cached" | "live" | "disabled"

personality 에이전트 성격

reasoning_effort 사고 깊이

review_model 리뷰 모델 재정의

tui.theme TUI 색상 테마

🔓 기능과 승인

기능 플래그

codex features list 모든 플래그 표시

codex features enable 영구 활성화

codex features disable 영구 비활성화

apps 앱 활성화

fast_mode 빠른 응답

multi_agent 멀티 에이전트

unified_exec 통합 실행

undo 취소 작업

승인 모드

Auto 작업 디렉토리 내 읽기/쓰기/실행

Read-only 파일 탐색만

Full Access 네트워크 포함 전체 접근 ⚠️

샌드박스

macOS seatbelt 내장 샌드박스

Linux Landlock 커널 수준 샌드박스

codex sandbox 샌드박스에서 명령 실행

🔌 MCP

CLI 명령

codex mcp list MCP 서버 목록

codex mcp show 서버 세부 정보 보기

codex mcp add MCP 서버 추가

codex mcp remove MCP 서버 제거

codex mcp login OAuth 로그인

codex mcp logout 인증 정보 제거

전송 방식

--url 스트리밍 HTTP (권장)

-- <명령> Stdio 런처 명령

서버 모드

codex mcp-server MCP 서버로 실행

인터랙티브

/mcp MCP 관리 UI

☁️ 클라우드와 에이전트

클라우드 명령

codex cloud 클라우드 작업 선택기

codex cloud exec 클라우드에서 작업 실행

codex cloud list 클라우드 작업 목록

--attempts N 최적 N회 실행 (1–4)

적용

codex apply 클라우드 차이를 로컬에 적용

AGENTS.md

AGENTS.md 프로젝트 에이전트 설정 파일

/init AGENTS.md 생성

/agent 에이전트 전환

서브에이전트

Subagents 자식 에이전트 생성

[agents] config config.toml의 에이전트 설정

기타 명령

codex login 인증 (ChatGPT 또는 API 키)

codex completion 셸 자동완성 (bash/zsh/fish)

codex app 데스크톱 앱 실행 (macOS)

codex execpolicy 실행 정책 규칙 확인