[AI 터미널 도구 8~9일차] Codex CLI 시작하기

도서명 : AI 자율학습 클로드 코드·코덱스 CLI·제미나이 CLI 완전 활용법

이 포스팅은 길벗 출판사의 코딩 자율학습단 20기 활동의 일환으로, 개인 공부 정리용 포스팅이다.

---

6장 - Codex CLI 시작하기

6.1 - Codex CLI 설치 및 실행

Codex CLI : OpenAI의 GPT-5 Codex 계열 모델을 기반으로 동작하는 오픈소스 터미널 도구이다.
node.js 와 npm 설치가 선행되어야 한다. macOS와 Linux를 우선 지원하기 때문에 WSL 환경이 적합하다고 한다. 25년12월 기준으로 Plus에 포함해 제공된다고 한다.

설치

# macOS/Linux/Windows 공통
npm install -g @openai/codex

# macOS Homebrew 사용시
brew install codex

codex --version

실행

codex

6.2 - 기본 사용 흐름

기본 대화

• 여러 줄 입력하기
  • Shift + Enter 로 줄바꿈
• @기호로 파일 참조하기
• 이미지 첨부하기
  • -i screenshot.png
  • 드래그 앤 드롭

세션 작업

• 새 대회 시작
  • /new
• 최근 작업 이어가기
  • codex resume --last
• 세션 종료
  • Ctrl + C
  • /quit , /exit

6.3 - 실행 모드와 권한 관리

실행 방식

• 대화형 실행 : codex 명령을 실행했을 때 기본적으로 시작되는 방식. 사용자는 Codex와 연속적인 대화를 주고 받으며 설계 - 구현 - 수정 작업을 이어갈 수 있다. 세션이 유지되는 동안 Codex는 이전 대화 맥락을 참고해 응답함.

# 기본
codex

# 모델 지정
codex --model gpt-5.2-codex

# 안전 설정
codex -a untrusted --sandbox read-only

# 자동화 설정
codex --full-auto

# 위험
codex --dangerously-bypass-approvals-and-andbox

• 단일 요청 실행 : Codex를 대화형 세션으로 유지하지 않고, 하나의 요청을 처리한 뒤 종료하는 실행 방식. 자동화 스크립트, 반복 작업 , CI 환경에서 특히 유용하다.

  codex exec "린트 오류가 있는지 확인해줘."
  

• 자동화 환경 실행 : GitHub Actions, GitLab CI/CD, Jenkins와 같은 자동화 환경에서도 활용할 수 있다.

  run: codex exec --full-auto "변경된 코드 리뷰하고 수정해줘."
  

승인 정책

승인 정책 : Codex가 셸 명령을 실행하기 전에 사용자 승인 여부를 언제 요청할지를 결정하는 기준

• untrusted
  • 신뢰하는 명령만 자동 실행하고, 시스템 변경 가능성이 있는 명령은 항상 승인을 요청
  • codex -a untrusted
• on-request
  • Codex가 명령의 위험도가 높다고 판단될 때만 승인 요청을 띄움
  • codex -a on-request
• on-failure
  • 명령을 먼저 실행하고, 실패했을 때만 승인 요청을 띄운다.
  • codex -a on-failure --sandbox workspace-write
• never
  • 어떤 상황에서도 승인 요청을 하지 않고 자동으로 실행. 실험용이나 격리된 환경에서만 사용
  • codex -a never --sandbox workspace-write

샌드박스

샌드박스 : Codex가 접근하고 수정할 수 있는 파일과 디렉터리의 범위를 제한하는 실행 환경 보호 장치

• read-only
  • 파일 읽기만 허용한다. 문서 검토, 코드 리뷰 등 읽기 중 작업에 적합
  • codex --sandbox read-only
• workspace-write
  • 현재 프로젝트 폴더 안에서는 자유롭게 읽고 쓸 수 있지만, 그 외 영역은 접근할 수 없다. 가장 널리 사용하는 모드
  • codex --sandbox workspace-write
• danger-full-access
  • 시스템 전체를 읽고 쓸 수 있다. Codex가 시스템 파일을 수정할 수도 있으므로 가상 환경에서만 사용해야 한다.
  • codex --sandbox danger-full-access

6.4 - 슬래시 명령어

• /compact - 대화 압축
• /diff - Git 변경 사항 검사
• /logout - 인증 정보 삭제
• /mention - 파일 명시 참조
• /review - 변경 사항 점검
• /status - 세션 설정과 사용량 확인