Codex CLI는 터미널에서 로컬로 실행되면서 API를 통해 원격 AI 모델에 연결하는 오픈소스 AI 코딩 어시스턴트입니다. 성능과 보안을 위해 Rust로 제작되었으며, 엄격한 샌드박스 보호를 유지하면서 선택한 디렉토리의 코드를 읽고, 수정하고, 실행할 수 있습니다.
이 가이드는 Novita AI를 통해 Qwen Coder 같은 전문 코딩 모델, DeepSeek 같은 추론 특화 모델, Kimi K2 같은 에이전트 모델 등 고급 AI 모델과 Codex CLI를 구성하는 방법을 보여줍니다.
Codex CLI란 무엇인가요?
Codex CLI는 로컬 실행과 클라우드 AI 기능을 결합한 터미널 기반 코딩 에이전트입니다. 코드 스니펫만 생성하는 코드 생성 도구와 달리, Codex CLI는 전체 프로젝트를 이해하고, 생성한 코드를 실행하며, 문제를 디버깅하고, 솔루션이 정상 작동할 때까지 반복할 수 있습니다.
주요 기능
로컬 우선 아키텍처: AI 모델에 API 호출을 하면서 기기에서 완전히 실행됩니다. 코드는 로컬에 유지하면서 강력한 클라우드 AI 기능을 활용할 수 있습니다.
프로젝트 이해: 전체 코드베이스를 읽고, 기존 패턴, 의존성, 코딩 스타일을 이해하여 프로젝트에 자연스럽게 통합되는 코드를 생성합니다.
자율 실행: 장시간 동안 독립적으로 작업할 수 있으며, 복잡한 작업을 분해하고 최소한의 감독으로 체계적으로 실행합니다.
유연한 승인 모드:
- 제안 모드: 모든 단계에서 승인을 요청합니다(기본값)
- 자동 편집 모드: 파일을 자동으로 편집하지만 명령을 실행하기 전에 확인을 요청합니다
- 완전 자동 모드: 확인 없이 완전한 자율 실행을 제공합니다
보안 기능: 네트워크가 비활성화되고 디렉토리 샌드박스가 적용된 환경에서 실행되어 시스템을 보호하면서 전체 기능을 유지합니다.
Codex CLI와 Claude Code의 주요 차이점
Codex CLI 설정을 시작하기 전에, 또 다른 인기 있는 AI 코딩 어시스턴트인 Claude Code와의 차이점을 이해하는 것이 중요합니다:
Codex CLI
- 모델 지원: OpenAI 모델 및 OpenAI 호환 API를 지원하며, 여러 제공자를 지원합니다
- 아키텍처: 터미널에서 실행되는 로컬 에이전트로, 원격 모델에 API 호출을 수행합니다
- 오픈소스: 커뮤니티 기여가 포함된 완전한 오픈소스입니다
Claude Code
- 모델 지원: Anthropic의 Claude 모델 및 Anthropic 호환 API에 중점을 두고 있습니다
- 아키텍처: 웹, 데스크톱, IDE 플랫폼 전반에 걸친 통합 환경을 제공합니다
- 개발: API 액세스가 가능한 독점 코어를 사용합니다
Codex CLI는 특히 기존 코드베이스에서의 정밀도와 복잡한 작업 처리 능력이 뛰어납니다. Claude Code는 사용자 경험과 초기 프로젝트 설정에 있어 선호되는 경우가 많습니다. 일부 사용자는 두 도구를 결합하여 최상의 결과를 얻습니다.
Claude 특화 워크플로우의 경우, Novita AI와 함께 Claude Code 사용 가이드를 확인하세요.
Codex CLI에서 서드파티 API를 사용하는 이유는 무엇인가요?
Codex CLI가 기본적으로 OpenAI 모델을 지원하지만, Novita AI 같은 서드파티 API는 주요 이점을 제공합니다:
전문 모델: 추론용 DeepSeek V3.1, 프로그래밍용 Qwen Coder, 에이전트 워크플로우용 Kimi K2 등 최신 모델에 액세스할 수 있습니다.
비용 및 성능: 특정 작업에 최적화된 모델로 경쟁력 있는 가격을 제공하며, 가벼운 응답부터 복잡한 문제 해결까지 지원합니다.
커스텀 모델: Novita AI를 사용하면 Codex CLI에서 특수 요구사항에 맞는 자체 커스텀 모델을 빠르게 사용할 수 있습니다.
안정성: 대체 제공자를 통해 요청 제한을 줄이고, 장애 또는 지역 제한 기간에도 일관된 액세스를 보장합니다.
Codex CLI에서 Novita AI 모델에 액세스하는 방법
사전 요구사항
- 계정 생성: Novita AI 웹사이트에 방문하여 계정을 등록하세요.
- API 키 생성: 로그인 후 키 관리 페이지로 이동하여 API 키를 생성하세요.
- 모델 이름 선택: Novita AI의 **모델 라이브러리**에서 사용하려는 모델 이름을 복사해야 합니다. 사용 가능한 모델은 다음과 같습니다:
deepseek/deepseek-v3.1qwen/qwen3-coder-480b-a35b-instructmoonshotai/kimi-k2-0905openai/gpt-oss-120bzai-org/glm-4.5google/gemma-3-12b-it
- 안전하게 저장: 구성에 필요하므로 안전하게 보관하세요.
설치
npm을 통해 설치 (권장)
npm install -g @openai/codex
Homebrew를 통해 설치 (macOS)
brew install codex
설치 확인
codex --version
Novita AI 모델 구성
구성 파일 설정
Codex CLI는 다음 위치에 있는 TOML 구성 파일을 사용합니다:
- macOS/Linux:
~/.codex/config.toml - Windows:
%USERPROFILE%\.codex\config.toml
기본 구성 템플릿
model = "MODEL_NAME"
model_provider = "novitaai"
[model_providers.novitaai]
name = "Novita AI"
base_url = "https://api.novita.ai/openai"
http_headers = {"Authorization" = "Bearer YOUR_NOVITA_API_KEY"}
wire_api = "chat"
사용 가능한 모델 및 사용 시기
| 모델 | 최적 사용 사례 | 장점 |
|---|---|---|
deepseek/deepseek-v3.1 |
복잡한 알고리즘 및 아키텍처 | 뛰어난 추론 및 문제 해결 능력 |
qwen/qwen3-coder-480b-a35b-instruct |
코드 생성 및 리팩토링 | 프로그래밍 작업에 특화됨 |
moonshotai/kimi-k2-0905 |
에이전트 워크플로우 및 자동화 | 빠른 실행, 긴 컨텍스트 처리 |
openai/gpt-oss-120b |
일반 개발 작업 | 안정적인 기준 성능 |
zai-org/glm-4.5 |
도구 통합 및 디버깅 | 도구 호출 성공률이 높음 |
google/gemma-3-12b-it |
가벼운 개발 작업 | 효율적이고 빠른 응답 |
시작하기
Codex CLI 실행
codex
기본 사용 예시
코드 생성:
> Create a Python class for handling REST API responses with error handling
프로젝트 분석:
> Review this codebase and suggest improvements for performance
버그 수정:
> Fix the authentication error in the login function
테스트:
> Generate comprehensive unit tests for the user service module
기존 프로젝트 작업
Codex CLI를 실행하기 전에 프로젝트 디렉토리로 이동하세요:
cd /path/to/your/project
codex
Codex CLI는 자동으로 프로젝트 구조를 이해하고, 기존 파일을 읽으며, 세션 전반에 걸쳐 코드베이스에 대한 컨텍스트를 유지합니다.
결론
Novita AI 모델과 함께 사용하는 Codex CLI는 로컬 제어와 클라우드 AI 기능을 결합한 강력하고 유연한 개발 환경을 제공합니다. 각 작업에 적합한 모델을 선택하고 환경을 올바르게 구성하면 코드 품질과 보안을 유지하면서 개발 워크플로우를 크게 가속화할 수 있습니다.
일반 개발 작업에는 Qwen Coder를 사용한 기본 구성으로 시작한 다음, 필요에 따라 복잡한 추론에는 DeepSeek, 자율 워크플로우에는 Kimi K2 같은 전문 모델을 시험해 보세요.
Novita AI 소개
Novita AI는 간단한 API를 사용하여 AI 모델을 쉽게 배포할 수 있는 방법을 개발자에게 제공하는 동시에, 구축 및 확장을 위한 저렴하고 안정적인 GPU 클라우드를 제공하는 AI 클라우드 플랫폼입니다.
추천 읽기
