OpenAI Codex CLI v2 정식 출시—멀티파일 편집·로컬 실행 샌드박스 지원
OpenAI가 터미널 기반 코딩 에이전트 Codex CLI의 v2를 정식 GA로 출시하며 멀티파일 동시 편집과 로컬 샌드박스 실행 환경을 공식 지원하기 시작했다. 단일 프롬프트로 여러 파일에 걸친 리팩터링과 테스트 코드 생성을 자동화할 수 있어 IDE 없이 터미널만으로 에이전트 개발 루프를 완성할 수 있다. npm 또는 pip 단일 명령으로 설치되며, 기존 OpenAI API 키를 그대로 사용한다.
Codex CLI v2 핵심 변경점
이전 v1 대비 가장 큰 변화는 멀티파일 편집 엔진의 도입이다. v1은 단일 파일 패치(patch) 방식으로 동작했으나, v2는 프로젝트 디렉터리 전체를 컨텍스트로 파악한 뒤 변경이 필요한 파일 목록을 자동으로 결정하고 원자적(atomic)으로 적용한다. 변경 사항은 git diff 형식으로 사전 미리보기할 수 있어 의도치 않은 덮어쓰기를 방지한다.
로컬 샌드박스 실행: 생성된 코드를 격리된 컨테이너(Linux 네임스페이스 기반) 안에서 즉시 실행해 결과를 검증한 뒤 파일에 반영하는 --sandbox 플래그가 추가됐다. 인터넷 액세스와 파일시스템 마운트 범위를 플래그로 제한할 수 있어 CI 파이프라인에 통합하기에도 적합하다.
설치 및 기본 사용법
# npm 설치
npm install -g @openai/codex
# 기본 멀티파일 리팩터링
codex "src/ 디렉터리 전체를 ES Module 방식으로 전환하고 Jest 테스트를 Vitest로 마이그레이션해줘"
# 샌드박스 모드로 실행 후 반영
codex --sandbox "users API 엔드포인트에 입력값 검증 미들웨어를 추가하고 테스트를 통과시켜줘"
모델은 기본값으로 o3-mini가 설정되며 --model 플래그로 변경 가능하다. 과금은 기존 OpenAI API 요금 기준을 따르며 정확한 단가는 공식 페이지 참조.
한국 개발자 실전 워크플로 통합
레거시 코드 현대화: 오래된 CommonJS 기반 Node.js 프로젝트를 ESM + TypeScript로 일괄 전환할 때 파일 간 import 경로 수정, tsconfig 생성, 타입 선언 추가를 단일 명령으로 처리할 수 있다.
CI/CD 통합: GitHub Actions 워크플로에서 codex --sandbox --approve-all 옵션을 활용해 의존성 업그레이드 PR을 자동 생성하는 파이프라인을 구성하는 레퍼런스 예시가 공식 문서에 추가됐다.
Cursor·VS Code와 병행 사용: CLI 특성상 에디터에 종속되지 않으므로, 무거운 GUI 없이 SSH 접속 환경이나 서버 사이드 자동화 스크립트에서 에이전트 기능을 활용하려는 개발자에게 특히 유용하다.