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 予算を食い尽くすため)。これは意図的な動作です。
課金と長時間タスク#
- 1 リクエストの上限は 120 秒(現在)。opencode の長い agent ループで 1 ターンが 120s を超えると打ち切られます。対応中です。
- ストリーミングレスポンスは現在
stream_options.include_usageを付けないため、アップストリームはストリーミング使用量を返しません。 課金は概算に基づき、prompt cache の割引も適用されません。これは同一プレフィックスの多い agent ループに大きな影響があり、 TODO に記載済みです。 - 32k コンテキストを超える
nexith-coreリクエストは自動的に強力なアップストリームへエスカレーションされ、エスカレーション後のティアで課金されます。
トラブルシューティング#
ストリーミングレスポンスが止まる / 長時間出力がない アップストリームの長い推論中、ゲートウェイは一切バイトを送信しません(現在 SSE ハートビートはありません)。TODO に記載済みです。
ツール名またはパラメータが失われる
アップストリームが非標準的に name より先に arguments を送信した場合、現在の実装では名前が空に固定されます。標準的なアップストリームではこの問題はありません。
401
key は nx- で始まる必要があります。Authorization: Bearer と x-api-key の両方のヘッダーをゲートウェイは受け付けます。