OpenAI Codex CLI, 정식 GA—터미널에서 코드 자율 실행
OpenAI가 경량 오픈소스 코딩 에이전트 Codex CLI를 정식 일반 공개(GA)했다. 로컬 파일시스템 읽기·쓰기, 셸 명령 실행, 멀티파일 리팩터링을 터미널 단에서 자율 처리하며, 한국 개발자도 npm 한 줄로 즉시 설치·사용 가능하다.
Codex CLI란 무엇인가
OpenAI Codex CLI는 GPT-4o 계열 모델을 백엔드로 사용하는 터미널 전용 AI 코딩 에이전트다. Claude Code와 달리 **완전 오픈소스(MIT 라이선스)**로 공개되어 있어 커스텀 모델 엔드포인트나 사내 프록시 서버와 연결하는 것이 가능하다. 핵심 기능은 다음과 같다.
- Sandbox 실행 모드: macOS Seatbelt / Linux seccomp 기반으로 파일 접근 범위를 프로젝트 디렉터리로 제한
- 멀티파일 편집: 단일 프롬프트로 여러 파일을 동시에 읽고 수정하며 diff 미리보기 제공
- 대화형 승인 흐름:
--approval-mode auto플래그로 무인 CI 파이프라인 통합 가능
설치 및 빠른 시작
# Node.js 22+ 필요
npm install -g @openai/codex
# API 키 설정
export OPENAI_API_KEY="sk-..."
# 프로젝트 루트에서 실행
codex "테스트 커버리지가 낮은 함수 찾아서 Jest 테스트 추가해줘"
모델 기본값은 codex-mini-latest이며 비용은 공식 페이지 참조. --model gpt-4o 플래그로 교체 가능하다. 컨텍스트 윈도우는 최대 128,000 토큰으로 중대형 모노레포도 소화한다.
한국 크리에이터·개발자 활용 포인트
1. CI/CD 자동화: GitHub Actions 워크플로에서 codex --approval-mode auto로 PR 리뷰 코멘트를 자동 반영하는 봇 구성이 가능하다.
2. 오픈소스 커스터마이징: MIT 라이선스이므로 사내 LLM(예: 온프레미스 LLaMA 계열)과 연결해 코드가 외부로 전송되지 않는 보안 환경을 구성할 수 있다.
3. Claude Code와 비교: Claude Code는 Anthropic 모델 전용·유료 구독 필수인 반면, Codex CLI는 OpenAI API 종량제로 소규모 팀이나 개인 프로젝트에서 비용 예측이 용이하다. 다만 GUI 없이 순수 CLI 환경만 지원하므로 Cursor 같은 IDE 통합은 별도 플러그인이 필요하다.
주의: Sandbox 모드를 비활성화(
--no-sandbox)하면 시스템 전역 명령 실행이 가능해지므로, 신뢰할 수 없는 프롬프트 입력 환경에서는 반드시 활성화 상태를 유지할 것.