環境変数

ANTHROPIC_BASE_URL

API エンドポイントを上書きして、リクエストをプロキシやゲートウェイ経由でルーティングする。そのゲートウェイが MCP ツール検索を拒否した場合の挙動については、Tool search through an LLM gateway を参照。v2.1.196 以降、この設定が api.anthropic.com 以外のホストを指している場合、Remote Control が無効化される。これは Amazon Bedrock、Google Cloud's Agent Platform、Microsoft Foundry での挙動と一致する。

使い方・用途

  • API リクエストをプロキシや LLM ゲートウェイ経由にルーティングしたいときに使う
  • 組織内のゲートウェイを通して Anthropic API へのアクセスを一元管理したいときに使う
  • ゲートウェイが MCP ツール検索を拒否する場合のツール検索の挙動を制御したいときに使う
英語原文(公式ドキュメントより)

Override the API endpoint to route requests through a proxy or gateway. For what happens when that gateway rejects MCP tool search, see Tool search through an LLM gateway. As of v2.1.196, Remote Control is disabled when this points at a host other than api.anthropic.com, matching its behavior on Amazon Bedrock, Google Cloud's Agent Platform, and Microsoft Foundry

関連する変更履歴

v2.1.307(1件)

Fixed
カスタムの ANTHROPIC_BASE_URL ゲートウェイ経由時や Foundry 上で、効果のない prompt-caching-scope ベータヘッダーが送信される問題を修正した
英語原文を表示
Fixed the prompt-caching-scope beta header being sent behind custom ANTHROPIC_BASE_URL gateways and on Foundry, where it has no effect

v2.1.304(1件)

Changed
カスタム ANTHROPIC_BASE_URL 使用時のツール検索をデフォルトで有効にするように変更:ゲートウェイから 400 または 422 が返された場合は、ツール検索なしで再試行する
英語原文を表示
Changed tool search to be on by default behind a custom ANTHROPIC_BASE_URL; a 400 or 422 from the gateway is retried without it

変更後

ツール検索が有効な状態で ANTHROPIC_BASE_URL 経由のゲートウェイを利用でき、ゲートウェイが対応していない場合でも自動的に再試行して処理を続行できる。

v2.1.299(4件)

Fixed
カスタム ANTHROPIC_BASE_URL 配下のゲートウェイ固有のモデル名のセッションで、200K トークン付近でリクエストを送信せず「Prompt is too long · automatic compaction failed」で終了する問題を修正した。
英語原文を表示
Fixed sessions on a gateway-specific model name behind a custom ANTHROPIC_BASE_URL ending with "Prompt is too long · automatic compaction failed" near 200K tokens instead of sending the request

関連ドキュメント

Fixed
管理対象設定ファイルが ANTHROPIC_BASE_URL を設定している場合に、サーバー管理設定の Anthropic へのリクエストがサードパーティゲートウェイの API キーを運ぶ問題を修正した
英語原文を表示
Fixed the server-managed settings request to Anthropic carrying a third-party gateway's API key when a managed settings file sets ANTHROPIC_BASE_URL
Fixed
カスタムの ANTHROPIC_BASE_URL を経由するストリームが、データが到着しないまま 180 秒で中断される問題を修正し、フィーチャーフラグの読み込み状態にかかわらず 300 秒待つようにした
英語原文を表示
Fixed streams through a custom ANTHROPIC_BASE_URL being aborted after 180 seconds with no data arriving; they now wait 300 seconds, whether or not feature flags are loaded

関連ドキュメント

Fixed
サードパーティゲートウェイ用に設定された API キー(ANTHROPIC_BASE_URL)が、Anthropic への機能フラグ・起動・fast mode・プロファイル・フィードバックの各リクエストに送られる問題を修正した。Anthropic の API キーは引き続き送信される
英語原文を表示
Fixed feature flag, startup, fast mode, profile and feedback requests to Anthropic carrying the API key configured for a third-party gateway (ANTHROPIC_BASE_URL); Anthropic API keys are still sent

v2.1.290(1件)

Fixed
ゲートウェイ経由 (ANTHROPIC_BASE_URL と ANTHROPIC_AUTH_TOKEN) で Claude を利用し Anthropic アカウントを持たないユーザーに対して mod が無効のままになる問題を修正した
英語原文を表示
Fixed mods staying off for people who reach Claude through a gateway (ANTHROPIC_BASE_URL with ANTHROPIC_AUTH_TOKEN) and have no Anthropic account

v2.1.285(1件)

Changed
カスタムの ANTHROPIC_BASE_URL を経由するセッションの挙動を変更した: 1M コンテキストウィンドウを持つモデル(Opus 4.7+、Sonnet 5+、Fable)ではそれを使用するようになった。ゲートウェイが 200K で止まる場合は /autocompact 200k を実行する
英語原文を表示
Changed sessions behind a custom ANTHROPIC_BASE_URL to use the 1M context window of models that have one (Opus 4.7+, Sonnet 5+, Fable); run /autocompact 200k if your gateway stops at 200K

変更後

カスタム ANTHROPIC_BASE_URL(LLM ゲートウェイなど)経由のセッションでも、1M コンテキストウィンドウに対応したモデル(Opus 4.7 以降、Sonnet 5 以降、Fable モデル)が 1M ウィンドウを使えるようになり、従来より長い会話や大きなコードベースの作業をコンパクト化せずに続けられる。ゲートウェイ側が 200K で止まる場合は /autocompact 200k を実行すれば従来どおり 200K で自動コンパクトできる。

v2.1.276(1件)

Fixed
ANTHROPIC_BASE_URL がプロキシやゲートウェイを指している場合に、すべてのリクエストが 400 … Input tag 'advisor_20260301' で失敗する問題を修正した(2.1.275 のリグレッション)
英語原文を表示
Fixed every request failing with 400 … Input tag 'advisor_20260301' when ANTHROPIC_BASE_URL points at a proxy or gateway (2.1.275 regression)

v2.1.268(1件)

Fixed
2.1.265 以降、サードパーティの Anthropic 互換エンドポイント(ANTHROPIC_BASE_URL)で毎ターン HTTP 400 が発生する問題を修正した。原因は Artifact ツールの入力スキーマ内にあり、それらのエンドポイントが拒否する正規表現だった
英語原文を表示
Fixed every turn failing with HTTP 400 on third-party Anthropic-compatible endpoints (ANTHROPIC_BASE_URL) since 2.1.265: a regex in the Artifact tool's input schema that those endpoints reject

関連ドキュメント

v2.1.266(1件)

Fixed
LLM ゲートウェイやプロキシ構成に影響する 2.1.265 のリグレッションを修正した。ドキュメント化されていない CLAUDE_CODE_USE_GATEWAY 環境変数は、以前は ANTHROPIC_BASE_URL と ANTHROPIC_AUTH_TOKEN が両方設定されている場合を除き無視されていたが、2.1.265 ではこの変数が単独で Cloud ゲートウェイへのサインインを強制するようになり、API キー、apiKeyHelper、カスタム認証ヘッダーと併せて設定していた構成では、すべてのリクエストが 'Not signed in to the Cloud gateway' で失敗するようになった。この変数は単独では再び無視されるようになり、設定の変更は不要である。
英語原文を表示
Fixed a 2.1.265 regression affecting LLM-gateway and proxy setups: the undocumented CLAUDE_CODE_USE_GATEWAY environment variable, previously ignored unless ANTHROPIC_BASE_URL and ANTHROPIC_AUTH_TOKEN were both set, began forcing Cloud-gateway sign-in on its own in 2.1.265, so configurations that set it alongside an API key, apiKeyHelper, or custom auth headers failed every request with "Not signed in to the Cloud gateway". The variable on its own is ignored again; no configuration change is needed

v2.1.251(1件)

Changed
アクティブなモデルが既知の Claude モデルでない場合(例: カスタム ANTHROPIC_BASE_URL 経由のサードパーティモデル)、デフォルトのコミットトレーラーを Co-Authored-By: Claude Code に変更した
英語原文を表示
Changed the default commit trailer to Co-Authored-By: Claude Code when the active model isn't a recognized Claude model (e.g. third-party models behind a custom ANTHROPIC_BASE_URL)

変更後

カスタムの ANTHROPIC_BASE_URL 経由で Claude 以外のモデルを使っている場合でも、コミットに付与される Co-Authored-By トレーラーが一貫して Co-Authored-By: Claude Code となり、実際のモデル名が正しく反映されないことによる不自然な署名を避けられる。

v2.1.248(1件)

Added
サーバー管理設定の診断機能を追加した。設定の読み込みに失敗した際の起動時警告、および /doctor と /status に、読み込み失敗や取得されなかった理由(Bedrock/Vertex/サードパーティプロバイダー、カスタム ANTHROPIC_BASE_URL)を説明する行を表示する
英語原文を表示
Added server-managed settings diagnostics: a startup warning when the settings fail to load, and a /doctor and /status line explaining a load failure or why they weren't fetched (Bedrock/Vertex/third-party provider, custom ANTHROPIC_BASE_URL)

変更後

サーバー管理設定が読み込めなかった場合でも、起動時の警告や /doctor・/status の表示からその理由を確認できるようになり、設定が適用されない問題の切り分けが容易になる。Bedrock、Vertex、サードパーティプロバイダーやカスタム ANTHROPIC_BASE_URL の利用で取得がスキップされた場合も、その原因が明示される。

v2.1.246(2件)

Fixed
サードパーティの Anthropic 互換エンドポイント(ANTHROPIC_BASE_URL)が id を持たない tool_use ブロックをストリーミングした際に、最初のツール呼び出しで描画エラーにより UI が停止する問題を修正した
英語原文を表示
Fixed the UI stopping with a render error on the first tool call when a third-party Anthropic-compatible endpoint (ANTHROPIC_BASE_URL) streams a tool_use block without an id
Fixed
Anthropic 宛のテレメトリ・メトリクスのリクエストが、サードパーティのゲートウェイ(ANTHROPIC_BASE_URL)向けに設定された API キーを送る問題を修正した。資格情報は自身のホストにのみ送信されるようになった
英語原文を表示
Fixed telemetry and metrics requests to Anthropic carrying the API key configured for a third-party gateway (ANTHROPIC_BASE_URL); a credential is now only sent to its own host

v2.1.229(1件)

Fixed
カスタムのゲートウェイ(ANTHROPIC_BASE_URL)を経由して接続している claude.ai サブスクライバーに対し、/model コマンドが Sonnet 5 または Opus 5 の 1M コンテキストウィンドウ版を拒否してしまう問題を修正しました。
英語原文を表示
Fixed /model rejecting Sonnet/Opus 1M for claude.ai subscribers using a custom ANTHROPIC_BASE_URL gateway

変更後

プロキシ環境下であっても、モデル制限を受けることなく大容量ファイルを読み込ませて対話できるようになります。

v2.1.222(1件)

Fixed
カスタムの ANTHROPIC_BASE_URL ゲートウェイを使用している際、サーバーからキープアライブのpingが実際に届いているにもかかわらず、ストリームのアイドルタイムアウトが作動してしまう問題を修正しました。
英語原文を表示
Fixed stream idle timeout firing on custom ANTHROPIC_BASE_URL gateways despite server keep-alive pings arriving on the wire

変更後

自社プロキシやゲートウェイを経由している環境でも、途中でClaudeの長い回答生成が途切れることなく処理が進行します。

関連ドキュメント

v2.1.211(1件)

Fixed
LLMゲートウェイ認証を使用しているバックグラウンドジョブが、再起動後に「Not logged in(未ログイン)」状態になる問題を修正した
英語原文を表示
Fixed background jobs on LLM gateway auth (ANTHROPIC_AUTH_TOKEN + ANTHROPIC_BASE_URL) coming back "Not logged in" after the daemon respawns them

変更後

独自のゲートウェイを経由して利用している環境でも、バックグラウンドタスクが途切れることなく安定して動作する。

v2.1.203(1件)

Fixed
バックグラウンドセッションでANTHROPIC_BASE_URLが適切に反映されない問題を修正し、401エラーを防ぐようにしました。
英語原文を表示
Fixed background and agent-view sessions dropping a shell-exported ANTHROPIC_BASE_URL, which sent API keys to the default endpoint and failed with 401

変更後

LLMゲートウェイを利用している環境での認証失敗が解消されます。

v2.1.196(1件)

Changed
ANTHROPIC_BASE_URLが外部ホストを指す場合、セキュリティのためリモートコントロール機能を自動的に無効化
英語原文を表示
Remote Control is now disabled when ANTHROPIC_BASE_URL points at a non-Anthropic host, matching the existing behavior under CLAUDE_CODE_USE_BEDROCK/_VERTEX/_FOUNDRY

変更後

社内プロキシやカスタムゲートウェイを利用するエンタープライズ環境において、意図しない接続によるセキュリティリスクを防止できます。

関連ドキュメント

v2.1.181(1件)

Fixed
特定の環境や Foundry で、プロンプトキャッシュが読み込まれない問題を修正しました
英語原文を表示
Fixed prompt caching not reading on custom ANTHROPIC_BASE_URL and on Foundry due to a per-request attestation token changing every turn

変更後

モデルの応答速度が安定し、API コストの最適化が維持されます。

関連ドキュメント

v2.1.178(1件)

Fixed
カスタム API ゲートウェイ利用時に、バックグラウンドワーカーが認証エラー(401)で失敗する問題を修正しました。
英語原文を表示
Fixed claude agents workers failing with 401 Invalid bearer token when the daemon was started from a shell with a custom API gateway via ANTHROPIC_BASE_URL and ANTHROPIC_AUTH_TOKEN

変更後

独自のプロキシやエンタープライズ向けのゲートウェイを使用している環境でも、バックグラウンドタスクやエージェントビュー機能を制限なく利用できます。

関連ドキュメント

v2.1.144(1件)

Fixed
カスタム ANTHROPIC_BASE_URL 設定や Bedrock Mantle を使用している場合に、バックグラウンドのサイドクエリで Haiku が使われない問題を修正。第一パーティの API キーがある場合などに正しくフォールバックします
英語原文を表示
Fixed background side-queries on custom ANTHROPIC_BASE_URL setups and Bedrock Mantle not using Haiku — now falls back correctly when a first-party API key is configured or no Haiku model is set

変更後

不必要なコストの発生を抑えつつ、バックグラウンドでの要約や整理機能を最適なスピードで利用できます。

関連ドキュメント

v2.1.141(1件)

Fixed
カスタムゲートウェイを使用している際、バックグラウンドジョブにAIが自動で名前を付けられない問題を修正。
英語原文を表示
Fixed background jobs on a custom ANTHROPIC_BASE_URL gateway not getting auto-named — the namer now uses the main model when no Haiku model is configured

変更後

独自のAPIプロキシ環境でも、各ジョブが「何をしていたか」を一目で把握できるようになり、管理性が維持されます。

関連ドキュメント

v2.1.129(1件)

Changed
サードパーティ(Bedrock、Vertex、Foundry、独自ゲートウェイ)利用時に、Anthropic公式サービスへの案内チップが表示されなくなりました
英語原文を表示
Third-party deployments (Bedrock, Vertex, Foundry, or ANTHROPIC_BASE_URL gateway) no longer see spinner tips pointing at first-party Anthropic surfaces

変更後

企業ポリシー等で特定のクラウド環境を利用しているユーザーにとって、ノイズとなる不要な情報を排除し、一貫性のある作業環境を提供します。

関連ドキュメント

v2.1.126(1件)

Changed
ANTHROPIC_BASE_URLが互換ゲートウェイを指している場合、/modelピッカーにゲートウェイの/v1/modelsエンドポイントから取得したモデル一覧が表示されるようになりました
英語原文を表示
The /model picker now lists models from your gateway's /v1/models endpoint when ANTHROPIC_BASE_URL points at an Anthropic-compatible gateway

変更後

プロキシやカスタムゲートウェイ経由で利用可能な特定のモデルを、モデル名を手入力することなく選択メニューから簡単に選べるようになります。

関連ドキュメント

v2.1.118(1件)

Changed
カスタムゲートウェイ使用時、/model の選択肢に環境変数によるモデル名・説明のオーバーライドが適用されるよう改善
英語原文を表示
The /model picker now honors ANTHROPIC_DEFAULT_*_MODEL_NAME/_DESCRIPTION overrides when using a custom ANTHROPIC_BASE_URL gateway

変更後

社内プロキシやゲートウェイを介して特定のモデル構成を運用している開発者が、自分たちの環境に適した正しいモデル情報を確認して選択できます。

関連ドキュメント

v2.1.72(1件)

Fixed
ANTHROPIC_BASE_URL 使用時でも ENABLE_TOOL_SEARCH が設定されていればツール検索が有効になるよう修正
英語原文を表示
Fixed tool search to activate even with ANTHROPIC_BASE_URL as long as ENABLE_TOOL_SEARCH is set.

変更後

カスタムプロキシやゲートウェイを経由するエンタープライズ環境でも、Claude Code の強力なツール検索機能を確実に利用できるようになります。

関連ドキュメント

v2.1.70(1件)

Fixed
サードパーティ製ゲートウェイを介して ANTHROPIC_BASE_URL を使用した際の API 400 エラーを修正しました。ツール検索機能がプロキシエンドポイントを正しく検出し、tool_reference ブロックを無効化するようになりました。
英語原文を表示
Fixed API 400 errors when using ANTHROPIC_BASE_URL with a third-party gateway — tool search now correctly detects proxy endpoints and disables tool_reference blocks

変更後

特定のネットワーク環境やカスタムゲートウェイを利用している開発者でも、接続エラーに悩まされることなく安定してツール機能を利用できるようになります。