NNexithDocs
ステータスダッシュボード ↗
概要とクイックスタートモデルカタログガイドAPI リファレンス連携OAuth2 / OIDC

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 に記載済みです。