Claude Code で Nexith を使用する
Claude Code は Anthropic プロトコル(/v1/messages、x-api-key)のみを送信します。Nexith ゲートウェイはこの層のアダプターを内蔵しています。
翻訳するのはプロトコル境界のみで、内部は同じ実行パイプラインを通過します。ルーティング、プロバイダーディスパッチ、課金、出口(egress)の秘匿化はすべて再利用されます。
設定#
export ANTHROPIC_BASE_URL="https://api.nexith.ai"
export ANTHROPIC_API_KEY="nx-你的key"この 2 行を ~/.zshrc または ~/.bashrc に書いて永続化し、あとはプロジェクトディレクトリで通常どおり claude を使用します。
base URL について(最も設定を誤りやすい箇所)#
/v1 を付けないでください。 クライアントは base の後ろに自分で /v1/messages を連結します:
| 記述した値 | クライアントが実際に要求する URL | 結果 |
|---|---|---|
https://api.nexith.ai |
https://api.nexith.ai/v1/messages |
✅ |
https://api.nexith.ai/v1 |
https://api.nexith.ai/v1/v1/messages |
❌ 失敗 |
これは Anthropic 公式 SDK の規約と一致します(公式の base は https://api.anthropic.com で、/v1 を付けません)。
どちらの host でも使用可能#
api.nexith.ai と gateway.nexith.ai は同じバックエンドの 2 つの入口で、どちらを設定しても構いません。
(歴史的な注意:2026-09-20 より前は api.nexith.ai がモデルエンドポイントを転送していなかったため、これを使うと
missing_api_key が返りました。これは key の正否とは無関係なエラーです。現在は修正済みです。)
認証情報#
- Claude Code が送信するのは
x-api-key(Authorizationではありません)。 - ゲートウェイは両方を受け付けます:
Authorization: Bearer <token>を優先し、x-api-keyをフォールバックとします。 - key は platform.nexith.ai で作成し、
nx-+ 32 文字の形式です。
対応エンドポイント#
| エンドポイント | 説明 |
|---|---|
POST /v1/messages |
Anthropic Messages。tool use とストリーミングをサポート |
POST /v1/messages/count_tokens |
token カウント |
POST /v1/chat/completions |
OpenAI 互換(同一バックエンド) |
POST /v1/responses |
OpenAI Responses(Codex 用) |
GET /v1/models |
モデル一覧 |
ツール呼び出し#
検証済みで利用可能です:ツール定義は input_schema をそのままアップストリームの parameters に変換します。レスポンスは Anthropic 仕様に従って
フレーム化されます:content_block_start(type: tool_use)→ 複数の input_json_delta(パラメータはアップストリームのスライスを
そのまま転送し、JSON の解析と再シリアライズを行わないため、長いパラメータが往復で精度を失いません)→ content_block_stop
→ stop_reason: "tool_use" 付きの message_delta。
tool_choice のマッピング:auto → auto、any → required、tool → 関数指定。
課金と長時間タスク#
- 課金は実際の token で精算され、精算台帳と同一のソースです。
- 1 リクエストの上限は 120 秒(現在)。超長い agent ループで 1 ターンが 120s を超えると打ち切られます。この点は対応中です。
- コンテキストが 32k を超える
nexith-coreリクエストは自動的に強力なアップストリームへエスカレーションされ、エスカレーション後のティアで課金されます。
トラブルシューティング#
401 missing_api_key
リクエストがゲートウェイに届いていないことを意味します。base URL に余分な /v1 がないか(上表参照)、ドメイン名が間違っていないか確認してください。
401 invalid_api_key
リクエストはゲートウェイに届いていますが、key が正しくありません:nx- で始まること、余分な空白がないこと、アカウント残高が十分であることを確認してください。
403 / 404
/v1/messages はこの 2 つの host でのみ提供されます。他のドメイン(platform.nexith.ai など)を使用しても有効になりません。
ストリーミングが止まって動かない アップストリームモデルは長い推論中に自発的にデータを送信しません。現在のゲートウェイには SSE ハートビートがありません。非常に長い推論の間、クライアントからは停止しているように 見える場合があります。この点は TODO に記載済みです。