OpenAI Codex CLI v1.0 정식 GA — 로컬 코드베이스 전체 인덱싱 지원

Codex CLI v1.0의 핵심 신기능

OpenAI는 2026년 10월 1일 Codex CLI v1.0을 정식 GA로 전환했다. 베타 기간 동안 가장 많이 요청된 기능인 로컬 프로젝트 전체 인덱싱(Full Repo Indexing) 이 핵심 변경점이다.

| 항목 | v0.x (베타) | v1.0 (GA) | |------|------------|----------| | 컨텍스트 범위 | 현재 디렉터리 파일 | 레포 전체 인덱싱 | | 최대 인덱싱 파일 수 | 없음(수동 첨부) | 50,000파일 | | 에이전트 모드 | 단일 턴 | 멀티스텝 자율 실행 | | 지원 모델 | gpt-4o | gpt-4o, o3 선택 가능 | | 가격 | — | 공식 페이지 참조 |

설치 및 인덱싱 빠른 시작

# 설치 (Node.js 20+ 필요)
npm install -g @openai/codex

# 레포 루트에서 인덱싱 초기화 (최초 1회)
codex index --model o3

# 전체 컨텍스트를 참조한 질의
codex "payments 모듈에서 발생하는 currency mismatch 버그 원인 추적해줘"

# 멀티스텝 에이전트 모드로 리팩터링
codex agent "src/legacy 폴더의 콜백 패턴을 async/await으로 전환하고 테스트 통과 확인"

인덱스는 .codex/ 디렉터리에 로컬 저장되며, .gitignore 패턴을 자동으로 존중한다. 민감 파일이 외부로 전송되는 구조가 아니라 인덱스 메타데이터만 API 요청 시 참조된다고 OpenAI는 밝혔다.

한국 개발자 관점 주의사항

• o3 모델 선택 시 인덱싱 쿼리 비용이 gpt-4o 대비 높으므로, 일상 질의는 gpt-4o, 복잡한 버그 추적에만 o3를 권장
• codex auth 명령으로 조직 API 키 공유 설정 가능 — 팀 단위 비용 모니터링은 OpenAI Usage Dashboard에서 프로젝트별로 분리 관리할 것
• 현재 한국어 주석·변수명 혼용 코드베이스에서 인덱싱 품질 이슈가 GitHub Discussions에 보고되고 있으며, OpenAI는 다음 패치(v1.0.1)에서 CJK 토크나이저 개선을 예고한 상태
• Cursor·Claude Code와의 직접 비교보다는 CI/CD 파이프라인 내 스크립트 자동화 용도로 포지셔닝하는 것이 현 시점에서 실용적