Codex란
Codex는 소프트웨어 개발을 위한 OpenAI의 코딩 에이전트입니다. Capriole AI의 Responses 호환 API로 요청을 보내도록 구성한 사용자 지정 모델 제공자를 통해 Capriole AI를 사용할 수 있습니다.사전 준비
시작하기 전에 다음이 있는지 확인하세요.설치
Codex CLI
Codex app
OpenAI Codex에서 앱을 다운로드하세요.구성
~/.codex/config.toml을 만들거나 업데이트하세요.
Codex 실행
API key를 설정한 다음 Codex를 시작하세요.지원 모델
Codex는 Responses API를 통해 Capriole AI의 OpenAI 모델을 사용합니다. 아래 네이티브 모델 ID를 사용하면 Codex에 내장된 모델 선택과 추론 설정을 이용할 수 있습니다. 별도의model_catalog_json은 필요하지 않습니다. Capriole AI가 지원하는 모델만 호출할 수 있습니다.
gpt-6-astragpt-6.1-solgpt-6-solgpt-6-lunagpt-5.6-terragpt-5.6-lunagpt-5.5
gpt-6.1-sol에는 Codex 0.159.2 이상을 사용하세요. 이전 버전에는 이 모델의 메타데이터가 없어 일반 설정으로 대체됩니다.
API는 openai/ 접두사가 붙은 ID와 openai-latest도 받습니다. openai-latest 별칭은 Capriole AI가 권장하는 OpenAI 플래그십 모델을 따릅니다.
문제 해결
Codex가 인증 오류를 반환하는 이유는 무엇인가요?
codex를 실행하기 전에 같은 셸에서 CAPRIOLE_AI_API_KEY를 내보냈는지 확인하세요.
Codex가 모델을 찾지 못하는 이유는 무엇인가요?
model_provider = "capriole_ai"가 설정되어 있고 model이 openai-latest 또는 지원되는 Capriole AI OpenAI 모델 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를 다시 시작하세요.
참고
- 이 구성은
env_key를 사용하므로 API key가 구성 파일이 아니라 셸 환경에 남습니다. - 공식 참고: Codex CLI, Codex config basics, Codex config reference, sample configuration.