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-로 시작하지 않습니다.