🖥️ CLI & 플래그
핵심 명령
codex대화형 TUI
codex exec "prompt"비대화형 실행
codex exec resume --last마지막 exec 세션 이어가기
codex resume --last대화형 세션 재개
codex fork --last최근 세션 포크
codex apply TASK_IDCloud task diff 로컬 적용
codex cloud list --json최근 Cloud task 조회
codex mcp listMCP 서버 목록
codex features list기능 플래그 확인
codex completion powershellPowerShell completion 생성
전역 플래그
--model모델 강제 지정 (예:
gpt-5.4)--sandboxread-only | workspace-write | danger-full-access--ask-for-approvaluntrusted | on-request | never--full-autoAuto 프리셋: workspace-write + on-request
--yolo승인/샌드박스 우회 위험
--search웹 검색을 live 모드로 전환
--add-dir추가 디렉터리 쓰기 권한
-c key=value1회성 config override
exec / 자동화
codex exec -stdin에서 프롬프트 읽기
cat spec.md | codex exec "Implement this"프롬프트 + stdin 병행 0.118.0
--jsonJSONL 이벤트 출력
--output-last-message out.txt최종 응답 파일 저장
--output-schema schema.json구조화 출력 검증
--skip-git-repo-checkGit 저장소 외부 실행 허용
--ephemeral세션 상태를 디스크에 남기지 않음
MCP / App / Cloud
codex mcp add name -- urlstdio 또는 HTTP MCP 등록
codex mcp login nameOAuth형 MCP 로그인
codex mcp-serverCodex 자체를 MCP 서버로 실행
codex cloud exec --env ENV_IDCloud task 직접 제출
codex app데스크톱 앱 실행 (macOS 중심, Windows는 별도 앱)
⚡ 슬래시 명령어
세션 제어
/clear화면과 대화 초기화
/new같은 CLI 안에서 새 대화 시작
/resume저장된 대화 재개
/fork현재 대화 분기
/compact대화 요약으로 컨텍스트 절약
/copy마지막 완료 응답 복사
/status모델/권한/토큰 사용량 확인
/debug-configconfig 레이어 진단
작업 흐름
/plan계획 모드 전환 및 계획 요청
/diffGit diff 검토
/review작업 트리 리뷰
/mention파일/폴더 첨부
/agent에이전트 스레드 전환
/ps백그라운드 터미널 상태
/mcpMCP 도구 목록
/apps앱/커넥터 삽입
설정 전환
/model모델 및 추론 수준 변경
/fastFast mode on/off/status
/permissionsAuto / Read Only 등 승인 정책 변경
/personalityfriendly / pragmatic / none
/experimental실험 기능 토글
/statusline하단 상태줄 항목 구성
/logout로그아웃
🔐 보안 & 샌드박스
기본 개념
샌드박스: 파일/네트워크/프로세스의 기술적 한계
승인 정책: 언제 사용자 확인을 요구할지 결정
기본적으로 네트워크는 꺼져 있고 쓰기는 워크스페이스에 제한됨
추천 조합
codex버전 관리 폴더에서 Auto 기본 추천
--sandbox read-only -a on-request안전한 브라우징/질의응답
--sandbox workspace-write -a untrusted파일 편집은 허용, 위험 명령은 승인
--full-auto로컬 자동화 프리셋
--yolo완전 우회, 격리 환경 내부에서만 사용 위험
네트워크 / 보호 경로
[sandbox_workspace_write]network_access = true 로 네트워크 허용web_search = "cached"기본 검색 캐시 모드
web_search = "live"실시간 검색 또는
--search.git, .agents, .codex 는 writable root 안에서도 보호됨⚙️ 설정 & 파일
주요 파일 위치
~/.codex/config.toml사용자 기본 설정
.codex/config.toml프로젝트별 설정
~/.codex/auth.json파일 기반 인증 캐시
AGENTS.md리포지토리 작업 지침
~/.codex/skills사용자 스킬
.codex/skills프로젝트 스킬
설정 우선순위
1. CLI 플래그 및
-c override2.
--profile 값3. 프로젝트
.codex/config.toml (가장 가까운 경로 우선)4. 사용자
~/.codex/config.toml5. 시스템
/etc/codex/config.toml자주 바꾸는 옵션
model = "gpt-5.4"기본 모델
approval_policy = "on-request"승인 정책
sandbox_mode = "workspace-write"샌드박스 정책
model_reasoning_effort = "high"추론 강도
personality = "friendly"응답 스타일
log_dir = "./.codex-log"로그 저장 경로
cli_auth_credentials_store = "keyring"인증 저장소: keyring / file / auto
기능 플래그
[features]옵션 기능 on/off
fast_mode = trueFast mode
multi_agent = true서브에이전트 협업
shell_snapshot = true반복 명령 가속
smart_approvals = false실험 기능
codex_hooks = false훅 엔진 실험
🧩 플러그인 · 스킬 · MCP
플러그인
플러그인은 skills, app 연동, MCP 설정을 재사용 가능한 번들로 묶음
.codex-plugin/plugin.json필수 manifest
skills/선택: 패키징된 스킬
.mcp.json선택: MCP 매핑
.app.json선택: app/connector 매핑
설치 위치
~/.agents/plugins/marketplace.json사용자 스코프 마켓플레이스
~/.codex/plugins/사용자 스코프 플러그인
.agents/plugins/marketplace.json리포지토리 스코프
./plugins/로컬 플러그인 디렉터리 예시
스킬 / MCP
스킬은 명시 호출 또는 프롬프트 기반 자동 선택 가능
MCP는 stdio 또는 HTTP transport 지원
/mcp, codex mcp add, codex mcp login 조합 사용⊞ Windows & WSL
Windows 권장값
Windows 11 권장, 최신 Windows 10은 best effort
[windows]sandbox = "elevated" 권장sandbox = "unelevated"관리자 권한이 없을 때 대안
/sandbox-add-read-dir C:\pathWindows 전용 읽기 권한 추가
WSL 사용
wsl --installWSL 설치
code .WSL 터미널에서 VS Code 열기
npm i -g @openai/codexWSL 안에서 Codex 설치
리포지토리는
~/code 아래에 두는 것이 빠름WSL 워크스페이스는 Linux 샌드박스 semantics 사용
VS Code 설정
chatgpt.runCodexInWindowsSubsystemForLinux가능하면 WSL에서 Codex 실행
🧠 모델 · 워크플로 · 팁
모델 선택
gpt-5.4대부분의 전문 작업용 기본 선택
gpt-5.4-mini빠른 탐색, 큰 파일 리뷰, 경량 서브에이전트
gpt-5.3-codex-spark실시간/초저지연 연구 프리뷰
codex --model gpt-5.4-miniCLI에서 즉시 전환
/model세션 중 모델 전환
Fast mode
/fast onGPT-5.4 계열의 빠른 경로 사용
/fast status현재 상태 확인
권장 워크플로
1. 깨끗한 Git 상태에서 시작
2.
/plan 또는 read-only로 먼저 방향 확인3. Auto 또는 workspace-write로 구현
4.
/diff 와 /review 로 검토5. 테스트 후 커밋/PR 생성
Cloud / 비동기 작업
병렬 task, best-of-N, PR 제안, 장시간 위임 작업에 적합
codex cloud exec --attempts 3best-of-N 스타일 시도
운영 팁
API 키 자동화보다 로컬 사용은 ChatGPT 로그인 권장
원격/헤드리스 환경은
--device-auth 우선 검토기업 프록시는
CODEX_CA_CERTIFICATE 설정텔레메트리는 기본 비활성화, 필요 시
[otel] 로 opt-in프로젝트 규칙은
AGENTS.md 와 .codex/ 에 모으는 편이 좋음🚀 빠른 시작
설치
npm i -g @openai/codexCodex CLI 전역 설치
brew install --cask codexmacOS 대안 설치
codex대화형 TUI 시작
npm i -g @openai/codex@latest최신 버전 업그레이드
로그인
codex login기본 브라우저 OAuth 로그인
codex login --device-auth헤드리스/원격 장치용 device code 로그인
printenv OPENAI_API_KEY | codex login --with-api-keyAPI 키 인증
codex login status현재 인증 상태 확인
Codex 표면
CLI: 로컬 터미널 코딩 에이전트
App: 프로젝트 단위 병렬 스레드/리뷰 UI
IDE: VS Code, Cursor, Windsurf 연동
Cloud: ChatGPT의 비동기 작업 위임