ドキュメント
Claude Code
Claude Codeは、Anthropic形式のエンドポイントをすべてゲートウェイとして扱います。2つの変数でKunavoを指定し、さらに3つでKunavoが提供するモデルを固定します。インストールはそのままで、各セッションの料金はサブスクリプションではなく残高からトークン単位で差し引かれます。
2つの環境変数 — ANTHROPIC_BASE_URLとANTHROPIC_AUTH_TOKEN — で、インストールを変更せずClaude Codeを従量課金に移行します。
# One terminal session
export ANTHROPIC_BASE_URL=https://api.kunavo.com # origin, no /v1
export ANTHROPIC_AUTH_TOKEN=sk-kn-...
# Pin models Kunavo serves. Claude Code's default and its opus/sonnet aliases
# follow Anthropic's newest models; the sonnet alias asks for Sonnet 5.5,
# which Kunavo does not serve — unpinned, /model sonnet 404s.
export ANTHROPIC_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5
claudeANTHROPIC_BASE_URLにはオリジンを指定します。Claude Codeは/v1/messagesを自分で追加します。Anthropic公式の確認用スニペットはcurl "$ANTHROPIC_BASE_URL/v1/messages"です。そのため、/v1で終わる値を指定すると、リクエスト先は/v1/v1/messagesとなり、404が返ります。これは設定で最もよくある失敗です。その他のよくある問題については、ANTHROPIC_BASE_URLのページをご覧ください。sonnetエイリアスはSonnet 5.5を、haikuエイリアスはHaiku 5.5を要求します（v2.1.293以降）。Kunavoはどちらも提供していないため、/model sonnet、/model haiku、およびこれらのエイリアスに設定されたサブエージェントも、モデルを固定しない限り404を返します。ANTHROPIC_MODELはセッションのモデルを設定します。ANTHROPIC_DEFAULT_OPUS_MODELは/model opusを対象とします（Opus 5.5にはClaude Code v2.1.280以降が必要です）。ANTHROPIC_DEFAULT_SONNET_MODELは/model sonnetを対象とし、ANTHROPIC_DEFAULT_HAIKU_MODELは/model haikuとバックグラウンド呼び出しを対象とします。GET /v1/modelsにあるIDはいずれも使用できます。ANTHROPIC_API_KEYではなくANTHROPIC_AUTH_TOKENを使ってください。2つの変数は送信するヘッダーを選びます。AUTH_TOKENはAuthorization: Bearerを送信し、API_KEYはx-api-keyを送信します。Kunavoはどちらも読み取りますが、API_KEYは有効になる前に対話型セッションで一度、承認の確認を求められます。AUTH_TOKENではその確認はありません。カスタムの ANTHROPIC_BASE_URL の背後での動作を変える Claude Code のリリースです。CHANGELOG から抜粋し、日付はそれぞれの npm でのリリース日です。
- 2.1.299（npm、2026-10-14）：Claude Code が Anthropic 自体に送るリクエスト（機能フラグ、起動、fast mode、プロフィール、フィードバック）に、サードパーティのゲートウェイ用に設定したキーが含まれなくなりました。また、カスタム base URL を通るストリームは、データを 180 秒ではなく 300 秒待つようになりました。
- 2.1.304（npm、2026-10-19）：カスタム base URL の背後ではツール検索がデフォルトでオンになり、ゲートウェイから 400 または 422 が返るとツール検索なしで再試行します。
- 2.1.305（npm、2026-10-20）：Vertex、Bedrock などのプロバイダーでエンドポイントやゲートウェイがツール検索を拒否したとき、また
ToolSearchを禁止したり--toolsから外したりしたゲートウェイの背後で、すべてのリクエストが失敗するという 2.1.304 の回帰を修正しました。現在の Claude Code はツール検索なしで再試行します。
2.1.305 以降を使ってください。2.1.299 はゲートウェイのキーを Anthropic 自身のエンドポイントに送らなくなった最初のリリースで、2.1.305 は ToolSearch を禁止したり --tools から外したりしていても回復できる最初のリリースです。
Agent SDK は同じ CLI を実行します。各 SDK リリースにどの Claude Code が同梱されているかは Agent SDK のページにあります。
sk-kn-で始まります）。$10からクレジットを追加すると、呼び出しはその残高から支払われ、失敗した呼び出しは課金されません。ダッシュボードを開くと、Claude Code設定が表示されます。手順
/app/keysでキーを作成してコピーします。キーは一度だけ表示されます。- このセッションでは上記の変数をエクスポートするか、
~/.claude/settings.jsonのenvブロックに保存します。{"env":{"ANTHROPIC_BASE_URL":"https://api.kunavo.com","ANTHROPIC_AUTH_TOKEN":"sk-kn-...","ANTHROPIC_MODEL":"claude-sonnet-5","ANTHROPIC_DEFAULT_OPUS_MODEL":"claude-opus-5-5","ANTHROPIC_DEFAULT_SONNET_MODEL":"claude-sonnet-5","ANTHROPIC_DEFAULT_HAIKU_MODEL":"claude-haiku-4-5"}}。Anthropicのドキュメントでは、認証情報をプロジェクトの.claude/settings.jsonに記載しないよう明示しています。このファイルはコミットされるためです。 claudeを実行してStatusタブを開きます。Auth tokenを示す行があれば、ゲートウェイの認証情報が有効です。claude.aiアカウントを示すLogin methodの行が表示される場合は、変数が認識されていません。- VS Code拡張機能では、VS Code独自のユーザー設定内の
claudeCode.environmentVariablesに変数を指定します。拡張機能は起動前に認証情報を確認するため、~/.claude/settings.jsonは起動されたプロセスには引き継がれても、その確認処理には引き継がれません。
Anthropicの「Claude CodeをLLMゲートウェイに接続する」で2026年10月3日に確認しました。サードパーティの設定は変更されます。ここに記載されたフィールド名が表示内容と一致しなくなった場合は、このページではなく、そのページを正しい情報源としてください。
クライアントをデバッグする前に確認すること
1回のリクエストで、失敗の原因がエンドポイント、キー、設定ファイルのどれかを特定できます。これがJSONを返すなら、同じベースURLとキーがClaude Codeで機能します。
# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/messages \
-H "Authorization: Bearer sk-kn-..." \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model":"claude-sonnet-5","max_tokens":16,"messages":[{"role":"user","content":"ping"}]}'フィールドに入力するモデルID
すべてのテキストモデルにはモデルIDでアクセスできます。現在の一覧はGET /v1/models、価格付きのカタログはモデルページにあります。料金は100万トークンあたりのUSDで、入力 / 出力の順です。
| モデル ID | Kunavo 入力 / 出力 | Claude Codeでの位置付け |
|---|---|---|
claude-sonnet-5 | $1.40 / $7.00 | デフォルトの作業用モデル。/ |
claude-opus-5-5 | $2.80 / $14.00 | 計画立案とアーキテクチャレベルの編集 |
claude-haiku-4-5 | $0.70 / $3.50 | haikuエイリアスとClaude Code自身のバックグラウンド呼び出しに使われます。ANTHROPIC_ |
claude-fable-5 | $7.00 / $35.00 | 料金に見合う計画立案向けの最先端ティア |
よくある質問
ClaudeのサブスクリプションなしでClaude Codeを使うには？
ANTHROPIC_BASE_URLにAnthropic形式のエンドポイントを、ANTHROPIC_AUTH_TOKENにそのエンドポイントのキーを設定し、ANTHROPIC_MODELをそのエンドポイントが提供するモデルに固定します。Claude Codeの組み込みデフォルトモデルが提供されているとは限らないためです。Claude Codeはclaude.aiではなく、そのエンドポイントに対して認証を行います。利用料金はサブスクリプションプランではなく、その認証情報の所有者によってトークン単位で請求されます。Anthropicはこれをゲートウェイモードとして説明しています。保存済みのclaude.aiログイン情報はディスク上に残りますが使われず、変数を解除すればすぐに再び使われます。
ANTHROPIC_BASE_URL に /v1 を含める必要がありますか？
いいえ。Claude Codeがルートを自分で追加するため、変数にはオリジン（https://api.kunavo.com）を指定し、https://api.kunavo.com/v1は指定しません。Anthropic公式の確認用コマンドはcurl "$ANTHROPIC_BASE_URL/v1/messages"で、この連結の仕組みを直接確認できます。すでに/v1で終わるベースURLを指定すると、リクエスト先が/v1/v1/messagesとなり、404が返ります。
ANTHROPIC_AUTH_TOKEN と ANTHROPIC_API_KEY の違いは何ですか？
両者は異なるHTTPヘッダーに認証情報を設定します。ANTHROPIC_AUTH_TOKENはAuthorization: Bearerを、ANTHROPIC_API_KEYはx-api-keyを送信します。誤った変数にキーを設定すると、エンドポイントが読み取らないヘッダーで届くため、リクエストは401で失敗します。ゲートウェイのドキュメントに「ベアラートークン」とあればANTHROPIC_AUTH_TOKENを、「APIキー」または「x-api-key」とあればANTHROPIC_API_KEYを使ってください。
カスタムベースURLの背後で利用できなくなるClaude Codeの機能はありますか？
Remote Controlと音声入力にはclaude.aiのIDが必要なため、ゲートウェイの認証情報が設定されている間は利用できません。Remote Controlは、ANTHROPIC_BASE_URLがAnthropic以外のホストを指している場合にも無効になります。また、高速モードの利用可否確認はベースURLを使わず、api.anthropic.comに直接アクセスします。エージェント、ツール、サブエージェント、MCPサーバーなど、コアループの機能はすべてMessages API上で動作し、影響を受けません。