NNexithDocs
상태대시보드 ↗
개요 및 빠른 시작모델 카탈로그가이드API 레퍼런스연동OAuth2 / OIDC

Codex CLI에서 Nexith 사용하기

최신 Codex는 OpenAI Responses 프로토콜(POST /v1/responses)만 사용합니다. Nexith 게이트웨이에는 이 계층 어댑터가 있어 요청 형태로 Codex를 식별하고, 내부적으로 chat 파이프라인으로 번역해 실행한 뒤 결과를 다시 Responses 형태로 번역합니다 — 라우팅, 과금, 출구 정제는 다른 프로토콜과 완전히 같은 경로를 공유합니다.

구성#

~/.codex/config.toml에 작성합니다:

model = "nexith-core"
model_provider = "nexith"

[model_providers.nexith]
name = "Nexith"
base_url = "https://gateway.nexith.ai/v1"
env_key = "NEXITH_API_KEY"
wire_api = "responses"

그런 다음:

export NEXITH_API_KEY="nx-你的key"
codex

base_url에는 /v1이 필요합니다(Codex가 그 뒤에 /responses를 붙임). 이 점은 Anthropic 클라이언트와 반대이므로 혼용하지 마세요. api.nexith.ai/v1도 사용할 수 있습니다.

지원 엔드포인트#

엔드포인트 용도
POST /v1/responses Codex 주 경로, 스트리밍과 function_call 지원
POST /v1/chat/completions wire_api를 chat으로 설정하면 이 경로 사용
GET /v1/models 모델 목록

도구 호출(apply_patch 등)#

검증 포인트:

  • 요청 측: function_call 항목 → assistant의 tool_calls; function_call_output → tool 역할 메시지. call_id는 전체 구간에서 tool_call_id로 유지되어 짝이 어긋나지 않습니다.
  • 응답 측: 업스트림의 tool_calls → output의 function_call 항목, arguments는 문자열 형태를 유지합니다 (Codex는 문자열을 그대로 받으며 객체 왕복을 하지 않습니다).
  • 스트리밍: 파라미터 조각은 업스트림 슬라이스대로 포워딩되며, 병합 결과는 업스트림과 동일합니다.

알려진 제한: Responses 요청에서 type이 function이 아닌 내장 도구(예: Codex 자체의 local_shell, web_search)는 현재 버려지며 업스트림으로 전달되지 않습니다. Codex를 사용할 때는 사용자 정의 function 도구를 중심으로 사용하세요.

과금과 긴 작업#

  • 단일 요청 120초 상한(현재). 지나치게 긴 agent 루프의 단일 턴이 초과하면 잘립니다 — 처리 중입니다.
  • 32k 컨텍스트를 넘는 nexith-core 요청은 자동으로 더 강한 업스트림으로 업그레이드되고 업그레이드 등급으로 과금됩니다.

문제 해결#

upstream rejected / 400 대부분 기록에 남은 도구 호출 짝이 불완전한 경우입니다. 게이트웨이가 진입 시 한 번 인접 보정(자리표시자 추가 또는 고아 제거)을 수행하지만, 근본 해결은 클라이언트가 function_call과 function_call_output을 짝으로 보장하는 것입니다.

408 / 재연결 업스트림 타임아웃입니다. 특정 업스트림이 자주 느리면 게이트웨이가 장애 조치를 수행합니다. 계속 발생하면 구체적인 작업 유형을 알려 주세요.

401 env_key가 가리키는 환경 변수가 설정되지 않았거나 key가 nx-로 시작하지 않습니다.