OpenAI Codex CLI는 터미널에서 실행되는 에이전틱 코딩 어시스턴트입니다. 기능을 계획하고, 전체 리포지토리에 걸쳐 코드를 작성하며, 셸 명령을 실행하고, 결과물을 납품합니다.
GitHub Copilot이 인라인 제안을 제공하는 것과 달리, Codex CLI는 자율적으로 동작합니다. 원하는 결과를 설명하면, Codex가 코드베이스를 읽고, 구현을 계획하고, 파일을 작성하고, 테스트를 실행한 뒤 결과를 보고합니다. 모든 루프가 터미널 안에서 완결됩니다.
2026년 Codex CLI에 대해 알아야 할 모든 것——설치, 설정, 확장, 통합——을 안내합니다.
OpenAI Codex CLI란?
Codex CLI는 OpenAI의 에이전틱 코딩 도구로, 2025년 4월에 출시되어 2026년까지 지속적으로 업데이트되고 있습니다. 이전 "Codex"(API 모델)와 한 가지 핵심적인 차이가 있습니다: 제안이 아닌 실제 행동을 수행합니다.
Codex CLI가 하는 것:
- 전체 리포지토리를 컨텍스트로 읽음 (열려 있는 파일만이 아님)
- 코드 한 줄을 쓰기 전에 다단계 구현을 계획
- 셸 명령 실행 (
npm test,git commit,make build) - 디렉터리를 가로질러 파일 작성·편집·리팩터링
- 테스트가 통과하거나 차단 문제가 발생할 때까지 루프 반복
기본적으로 하지 않는 것:
- 이미지나 동영상 생성
- 웹 검색
- 클라우드에 파일 저장 또는 공유
- 커스텀 통합 없이 외부 API 호출
이 제한들은 의도된 것이며——플러그인으로 해결할 수 있습니다. 자세한 내용은 아래에서 다룹니다.
Codex CLI 설치 방법
요구 사항: Node.js 18 이상, OpenAI API 키, macOS 또는 Linux (Windows는 WSL 경유). 최적의 호환성을 위해 Node.js 20 LTS를 권장합니다.
npm i -g @openai/codex
API 키를 설정합니다:
export OPENAI_API_KEY=sk-...
세션 간 유지를 위해 셸 프로파일(~/.zshrc, ~/.bashrc)에 추가하세요.
설치 확인:
codex --version
Codex CLI 설정 방법
Codex CLI는 ~/.codex/config.json에서 설정을 읽습니다. 이 파일을 생성하거나 편집하세요:
{
"model": "gpt-4.5",
"notify": true,
"approvalMode": "suggest"
}
주요 설정 옵션:
| 옵션 | 값 | 효과 |
|---|---|---|
model |
gpt-4.5, o3, o4-mini |
계획 및 코드 생성에 사용할 모델 |
approvalMode |
suggest, auto-edit, full-auto |
승인 없이 Codex가 자율적으로 행동하는 정도 |
notify |
true / false |
작업 완료 시 데스크톱 알림 |
context |
경로 또는 auto |
추가 컨텍스트 파일 포함 |
approvalMode 설명:
suggest——Codex가 각 변경 사항을 제안하고 수동으로 승인합니다. 프로덕션 리포지토리에 적합.auto-edit——Codex가 승인 없이 파일을 편집하지만 셸 명령 실행 전에는 확인을 요청합니다.full-auto——Codex가 전체 루프를 자율적으로 계획·실행합니다. 격리된 작업이나 클린 브랜치에 적합.
Codex CLI 핵심 기능
확장 없이 기본 제공되는 Codex의 기능들:
1. 에이전틱 코드 구현
codex "Add a rate limiter middleware to the Express API — 100 req/min per IP, return 429 with Retry-After header"
Codex가 프로젝트 구조를 읽고, 적절한 파일을 식별하고, 미들웨어를 작성하고, app.js에 연결하고, 테스트를 추가합니다.
2. 리포지토리 전체 리팩터링
codex "Migrate all fetch() calls in /src to use the axios wrapper in lib/http.js"
Codex가 리포지토리 전체에서 모든 인스턴스를 찾아 일관성 있게 재작성하고 테스트 스위트를 실행합니다.
3. 테스트 생성
codex "Generate Jest tests for every exported function in /src/utils — aim for 80% branch coverage"
4. 셸 명령 체이닝
Codex는 명령을 자연스럽게 체이닝합니다:
npm run build && anycap video generate --prompt "product demo" --model veo-3.1 -o demo.mp4 && git add . && git commit -m "add demo"
각 명령의 출력을 파악하고 적응합니다. npm run build가 실패하면 계속 진행하는 대신 오류를 진단합니다.
5. 문서 생성
codex "Write a README for this project — setup instructions, API reference, and examples"
Codex CLI 확장: 캐퍼빌리티 레이어
Codex는 의도적으로 코딩 작업으로 범위를 제한합니다. 동영상 생성, 이미지 생성, 웹 검색, 클라우드 스토리지는 내장되어 있지 않으며——스킬이나 MCP 서버를 통해 Codex가 호출하는 캐퍼빌리티 레이어에 존재합니다.
MCP 서버
Model Context Protocol 서버를 통해 Codex가 외부 도구를 내장 도구처럼 호출할 수 있습니다. 각 MCP 서버는 하나의 기능을 담당합니다——동영상 API, 데이터베이스, 브라우저 자동화 도구.
단점: 각 서버마다 별도의 설정, 인증, 유지 관리가 필요합니다. 동영상 + 이미지 + 검색 + 스토리지가 필요하다면 서버가 4개입니다.
스킬 (CLI 기반)
스킬은 Codex가 인식하고 셸 명령으로 호출하는 CLI 도구입니다. 가장 간단한 확장 모델: CLI를 설치하면 Codex가 호출할 수 있습니다.
AnyCap은 한 번의 설치로 전체 기능 공백을 채우는 스킬입니다——설정에 60초도 걸리지 않습니다:
- 동영상 생성 (Veo 3.1, Sora 2 Pro, Kling 3.0, Seedance 2.0)
- 이미지 생성 (GPT Image 2, Seedream 5, Flux)
- 인용이 포함된 웹 검색
- 클라우드 스토리지 및 파일 공유
npm i -g anycap
anycap login
anycap skill install --target ~/.codex/skills/anycap-cli/
설치 후 Codex는 모든 anycap 명령을 사용 가능한 액션으로 인식합니다.
Codex + AnyCap으로 할 수 있는 것
제품 데모 동영상 생성
anycap video generate \
--prompt "a smooth walkthrough of a SaaS dashboard, clean UI, soft lighting" \
--model veo-3.1 \
-o demo.mp4
Codex가 기능을 구현하고, AnyCap이 데모를 생성합니다. 같은 터미널 세션에서.
→ 전체 가이드: Codex로 동영상 생성하는 방법
빌드용 이미지 생성
anycap image generate \
--prompt "product hero shot, dark UI, floating interface, product photography" \
--model gpt-image-2 \
-o hero.png
→ 전체 가이드: Codex로 이미지 생성하는 방법
최신 정보를 위한 웹 검색
anycap search --prompt "best practices for API rate limiting 2026" --citations
Codex가 인용이 포함된 구조화된 결과를 받아 코드 생성의 사실적 근거로 활용합니다.
→ 전체 가이드: Codex 웹 검색 가이드 2026
생성된 파일 저장 및 공유
anycap drive upload demo.mp4
공유 가능한 링크를 반환합니다. Codex가 생성하는 문서에 이를 삽입할 수 있습니다.
Codex CLI vs. Claude Code vs. Cursor
| Codex CLI | Claude Code | Cursor | |
|---|---|---|---|
| 주요 인터페이스 | 터미널 | 터미널 | IDE (VS Code) |
| 모델 | GPT-4.5 / o3 / o4-mini | Claude 3.7 / 4 | GPT-4o / Claude |
| 리포지토리 컨텍스트 | 전체 리포지토리 | 전체 리포지토리 | 파일/폴더 범위 |
| 셸 실행 | 지원 | 지원 | 제한적 |
| 에코시스템 | OpenAI 네이티브 | Anthropic 네이티브 | 멀티 모델 |
| AnyCap 지원 | ✅ ~/.codex/skills/ |
✅ ~/.claude/skills/ |
✅ ~/.cursor/skills/ |
| 최적 용도 | OpenAI 에코시스템, 자율 루프 | 긴 추론 작업, 서브에이전트 병렬 처리 | IDE 내 편집 + 생성 |
동일한 anycap 명령이 세 가지 도구 모두에서 작동합니다——설치 경로는 다르지만 기능은 동일합니다.
Codex CLI + OpenAI 에코시스템: 풀 스택
OpenAI로 엔드투엔드로 구축하는 경우:
# 1. Research (web-grounded)
anycap search --prompt "competitor features for project management SaaS 2026" --citations
# 2. Plan + implement (Codex)
codex "Add the top 3 missing features identified in the research to our roadmap page"
# 3. Generate visuals (GPT Image 2, via AnyCap)
anycap image generate --prompt "roadmap hero, timeline graphic, product UI" --model gpt-image-2 -o roadmap-hero.png
# 4. Generate demo video (Sora 2 Pro, via AnyCap)
anycap video generate --prompt "product roadmap walkthrough" --model sora-2-pro --mode image-to-video --param images=./roadmap-hero.png -o demo.mp4
# 5. Store and share
anycap drive upload demo.mp4
Codex + GPT Image 2 + Sora 2 Pro + AnyCap 검색——모두 OpenAI 네이티브 또는 호환, 하나의 CLI로 라우팅됩니다.
자주 묻는 질문
Codex CLI는 무료인가요?
Codex CLI 설치는 무료입니다. OpenAI 계정의 API 사용량에 따라 비용이 발생합니다. 모델 선택에 따라 비용이 달라집니다——o4-mini는 일반 작업에서 세션당 약 $0.0030.01, 0.15입니다. AnyCap은 신규 사용자에게 250 크레딧을 무료 제공——약 22회의 이미지 생성 또는 5개의 짧은 동영상을 체험하기에 충분합니다.o3는 복잡한 추론 작업에 적합하며 세션당 약 $0.05
Codex CLI와 Codex API의 차이점은?
Codex API(20212023년 제공)는 코드 완성 모델이었습니다——프롬프트를 보내면 완성된 코드를 받는 방식입니다. Codex CLI(2025년)는 에이전틱 시스템입니다: 리포지토리를 읽고, 구현을 계획하고, 셸 명령을 실행하고, 코드를 엔드투엔드로 납품합니다. 완전히 다른 패러다임입니다.
Codex CLI는 Windows에서 작동하나요?
예, WSL(Linux용 Windows 하위 시스템) 경유로 작동합니다. 네이티브 Windows 지원은 제한적이며, WSL 2 + Ubuntu가 권장되는 방법입니다.
approvalMode: full-auto란 무엇이며 언제 사용해야 하나요?
Full-auto는 Codex가 각 단계에서 승인을 요청하지 않고 파일 편집, 셸 명령, 테스트 실행 등 전체 계획을 실행한다는 의미입니다. 격리된 기능 브랜치에서 사용하고, 검토 없이 메인 브랜치나 프로덕션 리포지토리에 사용하지 마세요.
Codex CLI와 Claude Code를 함께 사용할 수 있나요?
예. 별도의 설정을 가진 독립적인 도구입니다. 일부 팀은 주요 구현 루프(OpenAI 모델)에 Codex를, 긴 추론 작업이나 병렬 서브에이전트 워크플로에 Claude Code를 사용합니다. AnyCap은 두 도구 모두와 동일하게 작동합니다.
Codex CLI에 동영상 생성 기능을 추가하려면?
AnyCap을 설치(npm i -g anycap && anycap login)한 후 anycap skill install --target ~/.codex/skills/anycap-cli/를 실행합니다. 이후 Codex는 anycap video generate를 사용 가능한 명령으로 인식합니다. 전체 가이드: Codex 동영상 생성.
결론
Codex CLI는 2026년 가장 강력한 터미널 네이티브 코딩 에이전트입니다. 설치하고 설정하면 계획, 작성, 테스트, 커밋을 단일 무인 세션에서 자율적으로 처리하는 전체 코딩 루프를 맡길 수 있습니다.
기능 공백——미디어 생성, 웹 검색, 클라우드 스토리지——은 AnyCap 하나를 설치하면 해결됩니다. 같은 CLI, 같은 세션, 완전한 파이프라인. Codex + AnyCap을 사용하는 팀들은 이전에 3~4개의 별도 도구가 필요했던 기능부터 데모까지의 전체 사이클(코드 → 이미지 → 동영상)을 단일 터미널 세션에서 완료할 수 있다고 보고합니다.
→ Codex에 전체 기능 추가하기——AnyCap 무료 설치
📖 다음으로 읽을 것
- Codex로 동영상 생성하는 방법: 2026 완전 가이드 — 동영상 생성 파이프라인: Veo 3.1, Sora 2 Pro, Kling 3.0, Seedance 2.0.
- Codex로 이미지 생성하는 방법: 2026 완전 가이드 — Codex용 이미지 생성: GPT Image 2, Seedream 5 등.
- Codex 웹 검색 가이드 2026 — Codex 워크플로에 실시간 웹 리서치 추가하기.
- 코딩 에이전트를 위한 최고의 AI 동영상 모델 비교 — Veo 3.1 vs Seedance vs Kling vs Sora: 내 워크플로에 맞는 모델 선택.
- 캐퍼빌리티 런타임이란? — Codex에 미디어와 검색 기능을 제공하는 인프라 레이어.
관련 아티클
- 에이전틱 AI vs 기존 AI: 5가지 핵심 차이점 — 도구와 자율성이 차세대 AI를 정의하는 이유.
- AI 에이전트란? 완전한 개발자 가이드 — 에이전트 아키텍처, 툴 레이어, Codex가 모델에서 차지하는 위치.
AnyCap 팀이 작성했습니다. 우리는 하나의 CLI로 Codex, Claude Code, Cursor에 동영상·이미지·검색·스토리지 기능을 제공하는 캐퍼빌리티 런타임을 구축합니다.