codex-cli 명령어 모음 (v0.46 기준)

나중에 다시 보려고 메모하는 명령어 모음입니다.

설치 (macOS 기준)

# Homebrew로 설치
brew install codex

# 또는 npm으로 설치
npm install -g @openai/codex

설치 후 codex --version으로 버전 확인할 수 있어요.

기본 실행

# 기본 인터랙티브 모드 시작
codex

# 이미지 첨부하면서 실행
codex -i screenshot.png "이 에러 설명해줘"
codex --image img1.png,img2.jpg "이 다이어그램 요약해줘"

# Non-interactive 실행 (exec 모드)
codex exec "테스트 실행해줘"
codex e "CI 실패 원인 파악해줘"

첫 실행 시 ChatGPT 계정으로 로그인하라고 나오는데, Plus나 Pro 플랜이면 사용량이 포함됩니다.

Slash 명령어들

TUI 안에서 /로 시작하는 명령어 사용 가능해요.

주요 명령어

• /model - 모델 전환 (GPT-5-Codex 추천)
• /approvals - 승인 모드 변경
• /status - 사용량 및 rate limit 확인
• /review - 코드 리뷰 요청
• /diff - 현재 변경사항 확인
• /history - 대화 히스토리 조회
• /new - 새 대화 시작
• /init - AGENTS.md 파일 생성
• /compact - 긴 대화 요약/압축

승인 모드 종류

/approvals 명령어로 전환할 수 있는 모드들입니다.

Read Only: 파일 읽기만 가능. 계획 단계나 대화용.

Auto (기본): 작업 디렉토리 안에서 파일 읽기/쓰기/명령 실행 자동 진행. 네트워크 접근이나 외부 디렉토리 작업은 승인 필요.

Full Access: 네트워크 접근 포함 모든 작업 자동 진행. 주의해서 써야 함.

코드 리뷰 기능

0.41 버전부터 개선된 기능입니다.

# 스테이징된 변경사항 리뷰
codex /review

# 특정 커밋 리뷰
codex /review commit HEAD
codex /review commit abc123def

# 커스텀 리뷰 (보안 관점)
codex /review diff --base main \
  --instructions "SQL injection, XSS, auth 체크해줘"

# 성능 관점 리뷰
codex /review diff --base main \
  --instructions "N+1 쿼리랑 불필요한 DB 호출 찾아줘"

git 커밋 해시를 외울 필요 없이 브라우징하면서 선택 가능합니다.

Exec 모드 활용

# 기본 실행
codex exec "이 버그 고쳐줘"

# JSON 스키마로 구조화된 응답 받기
codex exec --output-schema schema.json "작업 수행"

# 계획 과정 포함해서 보기
codex exec --include-plan-tool "기능 구현해줘"

exec 모드는 대화형이 아니라 일회성 작업에 유용합니다.

유용한 팁들

사용량 체크

# 별칭 설정해두면 편함
alias cs="codex /status"

# 큰 작업 전에 확인
cs

5시간 제한의 80% 넘어가면 작업 마무리하거나 가벼운 작업으로 전환하는 게 좋아요.

멀티모달 입력

이미지 붙여넣기가 되고, 스크린샷 분석해서 코드 생성도 가능합니다. 에러 화면 캡처해서 바로 물어보면 편해요.

Git 체크포인트

작업 전후로 커밋 만들어두는 게 안전합니다. Auto나 Full Access 모드 쓸 때 특히 중요.

git add -A
git commit -m "codex 작업 전 체크포인트"

컨텍스트 압축

대화가 너무 길어지면 응답이 느려지는데, /compact 명령어로 요약 가능합니다.

/compact
# 또는 커스텀 지시사항 추가
/compact "핵심 논의 내용만 남겨줘"

업그레이드

codex --upgrade

최신 버전으로 업그레이드할 때 이 명령어 쓰면 됩니다.

주의사항

Full Access 모드는 CI 파이프라인이나 샌드박스 환경에서만 쓰는 게 안전합니다.

Windows는 아직 실험 단계라 WSL 사용 권장됩니다.

---

추가로 필요한 명령어는 공식 문서 확인하면 됩니다.

• GitHub: github.com/openai/codex
• 공식 문서: developers.openai.com/codex/cli