opencode에서 Nexith 사용하기
opencode는 표준 OpenAI 호환 프로토콜(POST /v1/chat/completions)을 사용합니다. 가장 범용적인 경로이며,
대부분의 서드파티 도구가 접속하는 방식입니다.
구성#
opencode는 provider 구성을 통해 OpenAI 호환 백엔드를 선언합니다:
{
"provider": {
"nexith": {
"npm": "@ai-sdk/openai-compatible",
"name": "Nexith",
"options": {
"baseURL": "https://gateway.nexith.ai/v1",
"apiKey": "nx-你的key"
},
"models": {
"nexith-core": { "name": "Nexith Core" }
}
}
}
}구성 키 이름은 opencode 자체 문서를 기준으로 하세요. Nexith 측에서 필요한 것은 baseURL에
/v1포함 + apiKey에nx-key 사용입니다.https://api.nexith.ai/v1도 사용할 수 있습니다.
Nexith 측 지원 현황#
| 기능 | 상태 |
|---|---|
POST /v1/chat/completions(스트리밍/비스트리밍) |
✅ |
tools / tool_choice / parallel_tool_calls |
✅ 그대로 전달 |
tool_calls 스트리밍 조각(index + function.arguments 증분) |
✅ 그대로 포워딩, 재정렬 없음 |
finish_reason: "tool_calls" |
✅ 그대로 유지 |
assistant 메시지 재생(tool_calls + tool_call_id) |
✅ |
GET /v1/models |
✅ |
| Anthropic / Responses 프로토콜 | claude-code.md / codex.md 참고 |
tools가 비어 있지 않으면 게이트웨이는 업스트림의 reasoning_effort를 none으로 정규화합니다(도구가 있을 때 추론은 속도를 늦추고
token 예산을 소진하기 때문). 이는 의도된 동작입니다.
과금과 긴 작업#
- 단일 요청 120초 상한(현재). opencode의 긴 agent 루프에서 단일 턴이 120s를 넘으면 잘립니다 — 처리 중입니다.
- 스트리밍 응답은 현재
stream_options.include_usage를 포함하지 않으므로 업스트림이 스트리밍 사용량을 반환하지 않습니다: 과금은 추정치를 기반으로 하며 prompt cache 할인이 적용되지 않습니다. 반복 프리픽스가 많은 agent 루프에는 영향이 커서 이미 할 일 목록에 있습니다. - 32k 컨텍스트를 넘는
nexith-core요청은 자동으로 더 강한 업스트림으로 업그레이드되고 업그레이드 등급으로 과금됩니다.
문제 해결#
스트리밍 응답이 멈춤 / 오랜 시간 출력 없음 업스트림의 긴 사고 동안 게이트웨이는 어떤 바이트도 보내지 않습니다(현재 SSE 하트비트 없음). 할 일 목록에 있습니다.
도구 이름 또는 파라미터 손실
업스트림이 규격과 다르게 name보다 arguments를 먼저 보내면 현재 구현은 이름을 빈 값으로 고정합니다. 표준 업스트림에는 이 문제가 없습니다.
401
key는 nx-로 시작해야 합니다. Authorization: Bearer와 x-api-key 두 헤더 모두 게이트웨이가 허용합니다.