ANTHROPIC_BASE_URL

ANTHROPIC_BASE_URL は、デフォルトの https://api.anthropic.com の代わりに、Anthropic SDK と Claude Code が API リクエストを送信するホストを指定します。パスを含めずにオリジンを設定してください。クライアントが /v1/messages を自動的に付加します。Authorization: Bearer ヘッダーに設定される ANTHROPIC_AUTH_TOKEN と組み合わせて使用します。

これが「キーの持ち込み（bring your own key）」や「カスタム base URL」と呼ばれる設定のすべてです。ANTHROPIC_BASE_URL を Kunavo のエンドポイントに、Kunavo のキーを ANTHROPIC_AUTH_TOKEN に設定すれば、リクエストは Anthropic Messages 形式で Kunavo を経由して Claude に届きます。モデル変数も四つすべて固定してください。sonnet と haiku のエイリアスは Kunavo が提供していないモデルを要求するため、固定しないと 404 が返ります。

# The origin only — no trailing /v1, no trailing slash.
export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...

# Claude Code: pin all four model variables to models the endpoint serves.
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

設定後、新しいターミナルを開いてください。Claude Code と SDK はプロセスの起動時にこれらの変数を読み込むため、すでに実行中のセッションでは以前のエンドポイントが使われ続けます。

各変数の役割

Claude Code が読み込む変数の完全な一覧は、Anthropicの環境変数リファレンスを参照してください。ここでは、エンドポイントの接続先を切り替える際に重要な変数を紹介します。

クライアントごとの設定方法

Claude Code

Claude Codeの起動元となるシェルプロファイルに環境変数をエクスポートし、新しいターミナルを開きます。インストール方法やワークフローは変わりません。

# ~/.zshrc (or ~/.bashrc) — applies to every Claude Code session.
export ANTHROPIC_BASE_URL=https://api.kunavo.com
export ANTHROPIC_AUTH_TOKEN=sk-kn-...

# Pin models this endpoint serves. Claude Code's default and its opus/sonnet
# aliases follow Anthropic's newest models, which may not be served here —
# unpinned, those calls 404.
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

現在のセッションが使用しているエンドポイントを確認するには、Claude Code内で /status を実行してください。キーの生成方法も含む手順については、Claude CodeでAPIキーを設定するを参照してください。

Anthropic SDK（Python / TypeScript）

SDKは同じ環境変数を読み込みます。また、両方の設定値をコンストラクターに渡すこともできます。1つのプロセスから複数のエンドポイントに接続する場合に便利です。

from anthropic import Anthropic

# The Anthropic SDK appends /v1/messages, so pass the origin — not .../v1.
client = Anthropic(
    base_url="https://api.kunavo.com",
    auth_token="sk-kn-...",          # sets the Authorization: Bearer header
)

msg = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=512,
    messages=[{"role": "user", "content": "Say hi"}],
)
print(msg.content[0].text)

OpenAI SDK — 異なる方式

コードがすでにOpenAI形式に対応している場合、ANTHROPIC_BASE_URLは不要です。base_urlをOpenAI互換パスに設定します。今回は /v1を含めて、同じClaudeモデルを /v1/chat/completions 経由で呼び出します。

from openai import OpenAI

# The OpenAI SDK is the other convention: it wants the /v1 in the base_url.
client = OpenAI(
    api_key="sk-kn-...",
    base_url="https://api.kunavo.com/v1",
)

r = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "Say hi"}],
)
print(r.choices[0].message.content)

Cline、Roo Code、Kilo Code、Cursor

エディターエージェントでは、ほとんどの場合、環境変数ではなく各ツールのUIに同じ2つの設定項目があります。「base URL」または「custom endpoint」欄と、APIキー欄です。ルールは変わりません。Anthropic形式のプロバイダーには /v1 を含めないオリジンを指定し、APIキー欄にキーを設定します。クライアントごとの手順は、Cline、Roo Code、Kilo Codeを参照してください。

設定を確認する

curlを1回実行するだけで、ベースURLと認証情報を同時に検証できます。JSON本文とともに200が返れば、両方とも正しく設定されています。

# 200 and a JSON body means the base URL and the token are both right.
curl -sS https://api.kunavo.com/v1/messages \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "content-type: application/json" \
  -d '{"model":"claude-haiku-4-5","max_tokens":16,
       "messages":[{"role":"user","content":"ping"}]}'

# In Claude Code, /status shows the endpoint the session is actually using.

動作しない場合

バージョンに関する注記

Anthropic API SDK、2026-10-21。Python SDK 2.0.0 と TypeScript SDK 1.0.0 は anthropic-version: 2026-10-21 を送信し、API キーを X-Api-Key ではなく Authorization: Bearer に入れます。Kunavo はどちらのヘッダーからでもキーを読み取るため、このアップグレードで Kunavo 側の変更は不要です。この API バージョンでは、temperature、top_p、top_k を含むリクエストは 400 で拒否され（Anthropic のAPI バージョン 2026-10-21 への移行ガイド、2026-10-22 に確認）、新しい SDK はこれらを引数として受け付けなくなりました。Python SDK 2.1.0 では TypeError が発生します。Kunavo はクライアントが指定するバージョンにかかわらず API バージョン 2023-06-01 でモデルを呼び出すため、temperature を（たとえば extra_body で）送り続けるリクエストも拒否されません。対応するモデルにはそのまま渡され、対応しないモデルでは Kunavo がそれを取り除き、X-Kunavo-Dropped-Params レスポンスヘッダーにその名前を示します。2026-10-22 に Python SDK 2.1.0 と TypeScript SDK 1.1.0 を使い、ローカルの Kunavo ビルドで確認しました。

カスタムの ANTHROPIC_BASE_URL の背後での動作を変える Claude Code のリリースです。CHANGELOG から抜粋し、日付はそれぞれの npm でのリリース日です。

• 2.1.285（npm、2026-09-29）：カスタム base URL の背後のセッションは、1M のコンテキストウィンドウを持つモデル（Opus 4.7 以降、Sonnet 5 以降、Fable）でそのウィンドウを使うようになりました。ゲートウェイが 200K トークンで止まる場合は、/autocompact 200k で上限を元に戻します。
• 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 から外したりしていても回復できる最初のリリースです。

ProまたはMaxのサブスクリプションへの影響

認証情報を格納する変数が設定されている間、Claude Codeの料金はログイン中のサブスクリプションではなくキーに対して請求されます。プラン上限は適用されず、利用料金はキーの所有者に請求されます。サブスクリプション自体には影響しません。変数を解除して新しいターミナルを開くと、Claude Codeはプランの利用に戻ります。この2つの請求方法が併用されることはありません。それぞれの費用の計算方法については、Claude Codeの料金を参照してください。

次へ

• KunavoのClaude API：全モデルとその料金
• 認証 — キー、ヘッダー、スコープ
• Messages API — Anthropicネイティブエンドポイント
• プロンプトキャッシュ — Claude Codeの料金を大きく抑える方法