Codex CLI Reference View

5장. CODEX CLI

OpenAI Codex CLI를 터미널에서 바로 활용하기 위한 설치, 최신 업데이트 확인, 핵심 기능 5가지를 한 번에 정리합니다.

설치 단계

4

업데이트 소스

2

핵심 기능

8

권장 레벨

L1-L2

섹션OpenAI 터미널 AI 코딩 에이전트

1. 설치 및 시작하기

📦 1단계

Node.js 확인 및 Codex CLI 설치

node --version 으로 v22 이상인지 확인 후 설치합니다.

  1. node --version → v22.x 이상 확인
  2. npm install -g @openai/codex
  3. codex --version 으로 설치 완료 확인
Codex CLI GitHub
🔑 2단계

OpenAI API 키 설정

~/.zshrc 에 export 로 등록하면 매 세션마다 자동 적용됩니다.

  1. platform.openai.com → API Keys 에서 발급
  2. echo 'export OPENAI_API_KEY="sk-..."' >> ~/.zshrc
  3. source ~/.zshrc 로 즉시 적용
OpenAI API Keys
📂 3단계

프로젝트 폴더에서 첫 실행

터미널에서 작업 폴더로 이동 후 codex 를 실행합니다.

  1. cd 프로젝트폴더
  2. codex (대화형 모드) 또는 codex "질문" (단발 쿼리)
  3. 처음 실행 시 이용약관 확인 후 Enter
⚙️ 4단계

승인 모드 설정

안전성을 위해 처음에는 suggest(제안만) 모드를 권장합니다.

  1. --approval-mode suggest : 변경 전 제안만 표시 (기본값)
  2. --approval-mode auto-edit : 파일 편집 자동 승인
  3. --approval-mode full-auto : 명령 실행까지 모두 자동
Codex CLI 공식 문서

2. 최근 업데이트 내역

출처: OpenAI Codex CLI GitHub Releases검증일 2026-04-21자동 점검 통과 · 14일 기준자세히 보기

2026-04-17

v0.1.2505 — 안정성 개선

멀티파일 편집 시 컨텍스트 추적 오류 수정 및 full-auto 모드에서의 명령 실행 신뢰도가 개선되었습니다.

2026-04-10

v0.1.2504 — Seatbelt 샌드박스 강화

macOS Seatbelt 정책이 강화되어 프로젝트 범위 외부 파일 접근이 더욱 엄격히 차단됩니다.

2025-04-16

v0.1 정식 공개

OpenAI Codex CLI 첫 번째 공개 릴리스. suggest / auto-edit / full-auto 3단계 승인 모드와 macOS 샌드박스 격리 실행이 포함되었습니다.

3. 핵심 기능 8가지

비개발자 학습 순서에 맞춰 기초 → 심화 → 실제 사례 구성으로 정리했습니다. 항목을 눌러 상세를 펼칠 수 있습니다.

맥락

OpenAI 공식 CLI — 출시 직후 GitHub 스타 1만 돌파

에디터 없이 서버나 CI 환경에서 코드를 빠르게 수정해야 할 때

설명

터미널 자연어로 코드 작성·수정·디버깅 — 에디터 없이 CLI만으로 개발 루프

빠른 프로토타입이나 서버 환경에서 에디터 없이 코드를 수정해야 할 때

실행 단계

  • codex 실행 후 자연어로 수정 요청
  • 제안 diff 확인 후 승인/거절
  • 승인 시 파일 자동 수정

결과

에디터 전환 없이 터미널에서 수정 사이클 완료

주의

full-auto는 의도치 않은 파일 수정 가능 — git commit 후 실행 권장

바로 실행

현재 디렉터리의 버그를 찾아서 수정해줘

참조 링크

맥락

AI 에이전트에서 사용자 제어 수준 선택이 핵심 설계 원칙

AI가 너무 많이 바꾸거나, 반대로 너무 조심스럽게 행동해서 속도가 느릴 때

설명

suggest / auto-edit / full-auto 세 단계로 개입 수준 조절

자동화 수준을 점진적으로 높여 작업 효율과 안전성을 동시에 확보하고 싶을 때

실행 단계

  • 처음 suggest 모드로 AI 판단 품질 확인
  • 익숙해지면 auto-edit로 파일 변경 자동화
  • CI·자동화 파이프라인에는 full-auto 활용

결과

상황에 맞게 자동화 수준 조절 — 신뢰성·속도 균형

주의

full-auto는 외부 명령 실행 — macOS Seatbelt 샌드박스 기본 활성화 확인

바로 실행

codex --approval-mode auto-edit "테스트 코드 추가해줘"

참조 링크

허브 버튼 링크 기준

허브 상단 4개 도구 버튼은 학습 흐름 고정을 위해 각각 m1~m4 내부 서브페이지로 이동합니다. 5장 Codex CLI는 별도 m5 서브페이지에서 확인합니다.

Codex CLI GitHubOpenAI Platform
타임라인으로 돌아가기