메인 콘텐츠로 건너뛰기
Capriole AI API 키 하나로 Codex에서 GPT-6.2 Astra와 GPT-6.2 Sol 모델을 공식 API 가격보다 최대 92% 저렴하게 사용할 수 있습니다.

Codex란

Codex는 소프트웨어 개발을 위한 OpenAI의 코딩 에이전트입니다. Capriole AI의 Responses 호환 API로 요청을 보내도록 구성한 사용자 지정 모델 제공자를 통해 Capriole AI를 사용할 수 있습니다.

사전 준비

시작하기 전에 다음이 있는지 확인하세요.
  • Capriole AI 계정(여기에서 가입)
  • Premium 플랜(월 USD 9, 무제한 웹 채팅 포함) 또는 Team 플랜. API 키를 만들려면 둘 중 하나가 필요합니다(구독하기)
  • Capriole AI API 키(키 받기)

설치

Codex CLI

공식 설치 프로그램으로 Codex CLI를 설치하세요.
또는 npm으로 설치하세요.
설치를 확인하세요.

Codex app

OpenAI Codex에서 앱을 다운로드하세요.

구성

모델 검증

Codex CLI 0.169.1 버전은 아래 구성으로 Capriole AI를 통한 파일 읽기, 파일 쓰기, 최종 답변 검사를 통과합니다. ~/.codex/config.toml을 만들거나 업데이트하세요.
각 설정의 역할은 다음과 같습니다.
  • model은 기본 모델입니다. 세션에서는 /model로, 명령줄에서는 --model로 바꾸세요.
  • model_provider는 그 아래에 정의된 Capriole AI 제공자를 선택합니다.
  • Codex가 /responses를 직접 추가하므로 base_url에는 /v1이 포함됩니다.
  • wire_api = "responses"는 Codex가 사용자 지정 제공자에 지원하는 유일한 프로토콜인 Responses API를 사용합니다.
  • env_key는 환경 변수에서 키를 읽어 Bearer 토큰으로 보냅니다.

Codex 실행

API 키를 설정한 다음 프로젝트 디렉터리에서 Codex를 시작하세요.
비대화형으로 실행하려면 codex exec을 사용하세요.

지원 모델

Codex는 Responses API를 통해 Capriole AI의 OpenAI 모델을 사용합니다. 아래 네이티브 모델 ID를 사용하면 Codex에 내장된 모델 선택과 추론 설정을 이용할 수 있습니다. 별도의 model_catalog_json은 필요하지 않습니다.
  • gpt-6.2-astra
  • gpt-6.2-sol
  • gpt-6-astra
  • gpt-6.1-sol
  • gpt-6-sol
  • gpt-6-luna
  • gpt-5.6-terra
  • gpt-5.6-luna
gpt-6.2-astra와 gpt-6.2-sol에는 Codex 0.169.1 이상을, gpt-6.1-sol에는 0.159.2 이상을 사용하세요. 이전 버전에는 이 모델들의 메타데이터가 없어 일반 설정으로 대체됩니다. API는 openai/ 접두사가 붙은 ID와 openai-latest도 받습니다. openai-latest 별칭은 Capriole AI가 권장하는 OpenAI 플래그십 모델을 따릅니다. Capriole AI는 Responses API로 Grok을 제공하므로 Codex는 같은 제공자로 xai/grok-4.7도 실행할 수 있습니다. Codex에는 OpenAI 네이티브 모델 ID의 메타데이터만 내장되어 있습니다. openai-latest와 xai/grok-4.7에서는 Model metadata ... not found를 출력하고 대체 설정을 사용합니다. 세션은 그대로 작동하지만, 최상의 결과를 얻으려면 gpt-6.2-astra 같은 네이티브 ID를 사용하세요.

문제 해결

Codex가 인증 오류를 반환하는 이유는 무엇인가요?

codex를 실행하기 전에 같은 셸에서 CAPRIOLE_AI_API_KEY를 내보냈는지 확인하세요.

Codex가 모델을 찾지 못하는 이유는 무엇인가요?

model_provider = "capriole_ai"가 설정되어 있고 model이 지원 모델 섹션의 ID 중 하나인지 확인하세요.

요청이 엔드포인트 또는 프로토콜 오류로 실패하는 이유는 무엇인가요?

[model_providers.capriole_ai] 아래에 base_url = "https://api.caprioletech.com/v1"과 wire_api = "responses"가 설정되어 있는지 확인하세요.

Codex가 Capriole AI 제공자를 무시하는 이유는 무엇인가요?

openai 같은 예약된 내장 제공자 ID를 사용하지 마세요. 사용자 지정 제공자 ID는 capriole_ai로 유지하세요.

구성 변경이 적용되지 않는 이유는 무엇인가요?

~/.codex/config.toml이 활성 사용자 구성 파일인지 확인하고, 프로젝트 범위 .codex/config.toml에 의존하기 전에 프로젝트를 신뢰한 다음 Codex를 다시 시작하세요.

참고

마지막 수정일 2026년 11월 18일