문서

Codex CLI

Codex는 Responses API만 지원합니다. config.toml의 제공업체 블록 하나로 Kunavo의 네이티브 /v1/responses 엔드포인트를 지정하고, 키는 파일에 직접 넣지 않고 환경 변수에 보관합니다.

~/.codex/config.toml의 [model_providers.kunavo] 블록에 env_key를 설정하면 키가 환경 변수에 남고 구성 파일에는 저장되지 않습니다

~/.codex/config.toml

model = "gpt-5-6-sol"
model_provider = "kunavo"

[model_providers.kunavo]
name = "Kunavo"
base_url = "https://api.kunavo.com/v1"
env_key = "KUNAVO_API_KEY"     # the NAME of the variable, not the key
# wire_api defaults to "responses", which is the only supported value

wire_api에 허용되는 값은 이제 "responses" 하나뿐이며, 생략하면 기본값으로 사용됩니다. Codex에서 Chat Completions 지원이 제거되었으므로 wire_api = "chat"를 설정하라는 이전 가이드는 오래된 내용입니다. 실제 /v1/responses 경로가 없는 엔드포인트는 Codex에서 사용할 수 없습니다. Kunavo는 이를 네이티브로 구현합니다.

env_key에는 환경 변수의 이름이 들어가며, 키 자체가 들어가는 것이 아닙니다. 이는 OpenAI 측에서 의도한 방식입니다. config.toml는 사람들이 커밋하거나 이슈에 붙여넣는 파일이기 때문입니다.

아직 키가 없나요? Kunavo 계정을 만들고, 키를 생성한 다음(키는 sk-kn-로 시작합니다) $10부터 크레딧을 추가하세요. 호출 비용은 해당 잔액에서 차감되며 실패한 호출에는 요금이 부과되지 않습니다. 그러면 대시보드가 Codex CLI 설정 화면에서 열립니다.

단계별 안내

/app/keys에서 키를 생성해 복사하세요. 키는 한 번만 표시됩니다.
위 블록을 ~/.codex/config.toml에 추가하세요. 파일이 없으면 새로 만드세요.
env_key에 지정된 변수를 내보내세요: export KUNAVO_API_KEY=sk-kn-...
codex를 실행하세요. 최상위 model_provider는 블록을 선택하고, model는 그 안의 ID를 선택합니다.
파일을 수정하지 않고 세션별로 모델을 전환하려면 codex -m <model id>를 사용하거나, 제공업체 블록을 여러 개 유지하고 model_provider를 변경하세요.

Codex 구성 파일 참조 문서에서 확인했습니다(2026년 9월 6일 기준). 서드파티 설정은 변경될 수 있으므로, 여기의 필드 이름이 실제 화면과 다르면 이 문서가 아니라 해당 페이지를 기준으로 삼으세요.

이것이 요약본입니다. 전체 안내—모델 선택, 실제 세션 비용, 실패 유형—는 Codex CLI API 키 가이드에 있습니다.

클라이언트를 디버깅하기 전에 확인할 사항

한 번의 요청으로 문제가 엔드포인트, 키 또는 구성 파일 중 어디에 있는지 판단할 수 있습니다. 이 요청에서 JSON이 반환되면 동일한 base URL과 키가 Codex CLI에서 작동합니다.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

필드에 입력할 model id

모든 텍스트 모델은 model id로 접근할 수 있습니다. 현재 목록은 GET /v1/models이며, 가격이 포함된 카탈로그는 모델 페이지에서 확인할 수 있습니다. 요금은 토큰 100만 개당 USD 기준이며 입력 / 출력 순서입니다.

모델 ID	Kunavo 입력/출력	Codex CLI에서의 위치
`gpt-5-6-sol`	$2.00 / $12.00	기본 Codex 조합 — Responses 네이티브 방식으로 바로 연결
`gpt-6-sol`	$0.80 / $4.00	복잡한 코딩과 에이전트를 위한 OpenAI의 GPT-6 — 동일한 Responses 경로를 사용하며 5.6 Sol보다 낮은 요율
`gpt-6-luna`	$0.04 / $0.20	대량 처리나 낮은 노력으로 충분한 작업에 적합한 가장 저렴한 GPT-6
`gpt-5-6-terra`	$0.70 / $4.20	편집 위주 세션에 적합한 더 저렴한 GPT 계열 모델
`claude-sonnet-5`	$1.40 / $7.00	Responses를 사용하는 GPT 계열이 아닌 모델 — 게이트웨이에서 형식을 변환
`claude-opus-5`	$3.50 / $17.50	추론을 깊게 할 가치가 있는 계획 수립 작업

월정액 없이 선불 잔액에서 토큰별로 청구됩니다. billing을 참고하세요. 반복되는 컨텍스트(에디터나 채팅 클라이언트가 보내는 데이터의 대부분)에서는 모델 선택보다 프롬프트 캐싱이 청구액에 더 큰 영향을 줍니다.

자주 묻는 질문

Codex CLI가 사용자 지정 API 엔드포인트를 가리키도록 하려면 어떻게 하나요?

~/.codex/config.toml에 name, base_url, env_key가 포함된 [model_providers.<id>] 테이블을 추가한 다음, 최상위 model_provider를 해당 ID로, model을 실행할 모델의 ID로 설정하세요. base_url은 서비스의 /v1 루트입니다. env_key에는 키가 저장된 환경 변수의 이름을 지정하므로 키 자체는 파일에 나타나지 않습니다.

Codex CLI에는 어떤 wire_api 값이 필요한가요?

"responses"입니다. 구성 참조 문서에 따르면 이 값만 지원되며, 생략할 경우 기본값입니다. Codex에서 Chat Completions 지원이 제거되었으므로 /v1/chat/completions만 구현하는 엔드포인트는 구성과 관계없이 Codex에서 사용할 수 없습니다. 엔드포인트는 실제 /v1/responses 경로를 제공해야 합니다.

Codex CLI에서 Claude 모델을 실행할 수 있나요?

엔드포인트가 Responses API로 모델을 제공한다면 가능합니다. Codex는 지정된 base_url로 Responses 형식의 요청을 보내고 모델 ID를 그대로 전달하므로, Responses를 해당 모델의 형식으로 변환하는 게이트웨이를 통해 Codex에서 Claude 또는 Gemini ID를 사용할 수 있습니다. Codex 자체는 어느 공급업체가 응답하는지 알지 못합니다.

Codex CLI는 API 키를 어디에 보관하나요?

config.toml이 아니라 제공업체 블록의 env_key 필드에 지정된 환경 변수에 보관합니다. Codex는 시작할 때 변수를 읽으므로 키는 셸 프로필이나 비밀 관리 도구에 두고, 구성 파일은 안전하게 커밋하거나 버그 보고서에 붙여넣을 수 있습니다.