3장 Codex CLI (문서)

---
moduleId: m5
toolKey: codex-cli
title: 5장. CODEX CLI
sourceTsx: /projects/ai-coding-tools/hub/curriculum/m5
---

# 5장. CODEX CLI

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

> 인터랙티브 커리큘럼(TSX): [/projects/ai-coding-tools/hub/curriculum/m5](/projects/ai-coding-tools/hub/curriculum/m5)  
> 벤더 요약: [/ai-coding-tools-files/docs/vendor/codex-cli/summary.md](/ai-coding-tools-files/docs/vendor/codex-cli/summary.md)

## 개요

- **부제**: OpenAI 터미널 AI 코딩 에이전트
- **섹션**: Codex CLI Reference View

## 설치 (macOS 요약)

- 1. **Node.js 확인 및 Codex CLI 설치** — node --version 으로 v22 이상인지 확인 후 설치합니다.
- 2. **OpenAI API 키 설정** — ~/.zshrc 에 export 로 등록하면 매 세션마다 자동 적용됩니다.
- 3. **프로젝트 폴더에서 첫 실행** — 터미널에서 작업 폴더로 이동 후 codex 를 실행합니다.
- 4. **승인 모드 설정** — 안전성을 위해 처음에는 suggest(제안만) 모드를 권장합니다.

## 최근 업데이트

- 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 샌드박스 격리 실행이 포함되었습니다.

## 핵심 기능

### 터미널 대화형 AI 코딩

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

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

### 3단계 승인 모드 (Suggest / Auto-edit / Full-auto)

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

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

### 멀티파일 컨텍스트 편집

여러 파일을 읽고 수정 계획 후 일괄 적용 — 리팩터링·의존성 업데이트에 적합

- 시나리오: 프로젝트 전체에서 특정 패턴을 찾아 일관되게 수정해야 할 때

### 코드 실행 및 결과 피드백 루프

작성→실행→오류 분석→수정을 AI가 반복 — 테스트·린트·컴파일 오류 자동 처리

- 시나리오: 테스트가 실패하거나 빌드 오류가 반복될 때 AI에게 루프를 위임하고 싶을 때

### 실전 케이스 — Next.js 랜딩페이지를 터미널에서 30분 만에 제작

Codex CLI로 생성→컴포넌트→스타일→빌드까지 터미널 단독 완료(실전)

- 시나리오: 에디터 없이 서버에서 빠르게 랜딩페이지 MVP를 만들어야 할 때

## 공식 링크

- [Codex CLI GitHub](https://github.com/openai/codex)
- [OpenAI Platform](https://platform.openai.com)

## 링크 정책

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

<hr>
<h2>moduleId: m5
toolKey: codex-cli
title: 5장. CODEX CLI
sourceTsx: /projects/ai-coding-tools/hub/curriculum/m5</h2>
<h1>5장. CODEX CLI</h1>
<p>OpenAI Codex CLI를 터미널에서 바로 활용하기 위한 설치, 최신 업데이트 확인, 핵심 기능 5가지를 한 번에 정리합니다.</p>
<blockquote>
<p>인터랙티브 커리큘럼(TSX): <a href="/projects/ai-coding-tools/hub/curriculum/m5">/projects/ai-coding-tools/hub/curriculum/m5</a><br>벤더 요약: <a href="/ai-coding-tools-files/docs/vendor/codex-cli/summary.md">/ai-coding-tools-files/docs/vendor/codex-cli/summary.md</a></p>
</blockquote>
<h2>개요</h2>
<ul>
<li><strong>부제</strong>: OpenAI 터미널 AI 코딩 에이전트</li>
<li><strong>섹션</strong>: Codex CLI Reference View</li>
</ul>
<h2>설치 (macOS 요약)</h2>
<ul>
<li><ol>
<li><strong>Node.js 확인 및 Codex CLI 설치</strong> — node --version 으로 v22 이상인지 확인 후 설치합니다.</li>
</ol>
</li>
<li><ol start="2">
<li><strong>OpenAI API 키 설정</strong> — ~/.zshrc 에 export 로 등록하면 매 세션마다 자동 적용됩니다.</li>
</ol>
</li>
<li><ol start="3">
<li><strong>프로젝트 폴더에서 첫 실행</strong> — 터미널에서 작업 폴더로 이동 후 codex 를 실행합니다.</li>
</ol>
</li>
<li><ol start="4">
<li><strong>승인 모드 설정</strong> — 안전성을 위해 처음에는 suggest(제안만) 모드를 권장합니다.</li>
</ol>
</li>
</ul>
<h2>최근 업데이트</h2>
<ul>
<li>2026-04-17 — <strong>v0.1.2505 — 안정성 개선</strong>: 멀티파일 편집 시 컨텍스트 추적 오류 수정 및 full-auto 모드에서의 명령 실행 신뢰도가 개선되었습니다.</li>
<li>2026-04-10 — <strong>v0.1.2504 — Seatbelt 샌드박스 강화</strong>: macOS Seatbelt 정책이 강화되어 프로젝트 범위 외부 파일 접근이 더욱 엄격히 차단됩니다.</li>
<li>2025-04-16 — <strong>v0.1 정식 공개</strong>: OpenAI Codex CLI 첫 번째 공개 릴리스. suggest / auto-edit / full-auto 3단계 승인 모드와 macOS 샌드박스 격리 실행이 포함되었습니다.</li>
</ul>
<h2>핵심 기능</h2>
<h3>터미널 대화형 AI 코딩</h3>
<p>터미널 자연어로 코드 작성·수정·디버깅 — 에디터 없이 CLI만으로 개발 루프</p>
<ul>
<li>시나리오: 빠른 프로토타입이나 서버 환경에서 에디터 없이 코드를 수정해야 할 때</li>
</ul>
<h3>3단계 승인 모드 (Suggest / Auto-edit / Full-auto)</h3>
<p>suggest / auto-edit / full-auto 세 단계로 개입 수준 조절</p>
<ul>
<li>시나리오: 자동화 수준을 점진적으로 높여 작업 효율과 안전성을 동시에 확보하고 싶을 때</li>
</ul>
<h3>멀티파일 컨텍스트 편집</h3>
<p>여러 파일을 읽고 수정 계획 후 일괄 적용 — 리팩터링·의존성 업데이트에 적합</p>
<ul>
<li>시나리오: 프로젝트 전체에서 특정 패턴을 찾아 일관되게 수정해야 할 때</li>
</ul>
<h3>코드 실행 및 결과 피드백 루프</h3>
<p>작성→실행→오류 분석→수정을 AI가 반복 — 테스트·린트·컴파일 오류 자동 처리</p>
<ul>
<li>시나리오: 테스트가 실패하거나 빌드 오류가 반복될 때 AI에게 루프를 위임하고 싶을 때</li>
</ul>
<h3>실전 케이스 — Next.js 랜딩페이지를 터미널에서 30분 만에 제작</h3>
<p>Codex CLI로 생성→컴포넌트→스타일→빌드까지 터미널 단독 완료(실전)</p>
<ul>
<li>시나리오: 에디터 없이 서버에서 빠르게 랜딩페이지 MVP를 만들어야 할 때</li>
</ul>
<h2>공식 링크</h2>
<ul>
<li><a href="https://github.com/openai/codex">Codex CLI GitHub</a></li>
<li><a href="https://platform.openai.com">OpenAI Platform</a></li>
</ul>
<h2>링크 정책</h2>
<p>허브 상단 4개 도구 버튼은 학습 흐름 고정을 위해 각각 m1~m4 내부 서브페이지로 이동합니다. 5장 Codex CLI는 별도 m5 서브페이지에서 확인합니다.</p>