# Claude CodeのANTHROPIC_BASE_URLが効かない：症状別の原因と直し方

> ANTHROPIC_BASE_URLは送り先を変えるだけで認証は変えません。/statusの2行とcurl1回で、変数の未到達、ヘッダーの取り違え、ゲートウェイの拒否を見分けます。

- Source: https://www.aifreeapi.com/ja/posts/claude-code-anthropic-base-url-not-working
- Language: ja
- Published: 2026-10-15
- Updated: 2026-10-15
- Publisher: AI Free API (https://www.aifreeapi.com)

`ANTHROPIC_BASE_URL`はリクエストの送り先を変える変数で、認証情報までは変えません。設定したのに効かないときの原因の多くは、変数がClaude Codeのプロセスに届いていない、認証情報を入れた変数（つまり送られるヘッダー）が違う、URLの形が違う、ゲートウェイがClaude Codeの送る内容を拒否している、の4つのどれかです。残りは特定バージョンの不具合と、もともと対応していない使い方です。

最初にClaude Codeの中で`/status`を開き、Statusタブの2行を見てください。

- `Anthropic base URL`の行がない：変数がセッションに届いていません。起動方法と設定場所を確認します。
- その行はあるが、`Login method`としてclaude.aiのアカウントが表示される：認証情報の変数（`ANTHROPIC_AUTH_TOKEN`など）が届いていません。リクエストはゲートウェイへ向かっても、保存済みのclaude.aiログインが使われ、サブスクの上限と課金が適用されます。
- 2行とも正しいのにメッセージが失敗する：エラー文で原因を絞ります。`401`は変数とヘッダーの取り違え、`400`はゲートウェイによるフィールドの拒否、接続エラーやHTMLの応答はURLかネットワーク経路の問題です。

バージョンも確認してください。2026年10月14日公開の2.1.299で、カスタムベースURLに関わる不具合が4件修正されました。一方、2026年10月15日時点でnpmの`stable`は2.1.292のままです。また、DeepSeekやローカルモデルなどClaude以外のモデルにつないでいる場合、AnthropicはどのゲートウェイについてもClaude以外のモデルへの接続をサポートしていません。設定を直しても動かない機能があることを前提に読み進めてください。

## ANTHROPIC_BASE_URLが効かない症状と原因の早見表

見えている症状から、原因と最初に触る場所を選べます。エラー文は[公式のゲートウェイ接続ガイド](https://code.claude.com/docs/en/llm-gateway-connect#troubleshoot-gateway-errors)に載っている表記のままです。

| 見えている症状 | 主な原因 | 最初の対処 |
| --- | --- | --- |
| `/status`に`Anthropic base URL`の行がない | 変数がこのプロセスに届いていない | 起動方法と設定ファイルを確認する |
| curlは通るのにclaude.aiへのログインを求められる | 認証情報の変数がない、またはプロジェクトの`.claude/settings.json`にだけ書いた | `ANTHROPIC_AUTH_TOKEN`をシェルか`~/.claude/settings.json`に入れる |
| ゲートウェイ経由のはずなのにサブスクの上限が減る | `ANTHROPIC_BASE_URL`だけを設定し、保存済みログインが使われている | 認証情報の変数を設定し、`/logout`する |
| `ANTHROPIC_API_KEY`を設定したのに何も聞かれず無視される | 初回の承認で一度拒否した | `/config`の`Use custom API key`で有効にする |
| `401`（トークンが無効・認識できない） | 変数とヘッダーの組み合わせ違い、またはキーの失効 | もう一方の変数に移して再確認する |
| `ConnectionRefused`、`ENOTFOUND` | アドレスの誤り、VPNやファイアウォール | curlで同じ経路を試す |
| `API returned an empty or malformed response (HTTP 200)` | ゲートウェイや途中のプロキシがHTMLのエラーページなどを返した | URLのパスとゲートウェイのルートを確認する |
| HTML本文の`403`で、ゲートウェイのログに記録がない | ゲートウェイ手前のWAFがリクエスト本文を遮断 | `/v1/messages`を本文検査の対象から外す |
| `400`で`Extra inputs are not permitted`や`context_management` | 上流が未対応のフィールドを拒否 | `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1` |
| `400`でコンテキスト上限（ゲートウェイ独自の文言） | 自動圧縮が働かない | `/compact`と`CLAUDE_CODE_AUTO_COMPACT_WINDOW` |
| 長い応答の途中で切れる | 無通信タイムアウト | 2.1.299以降へ更新、`API_FORCE_IDLE_TIMEOUT` |
| ターミナルでは動くがVS Codeやデスクトップ版で効かない | 画面ごとに設定場所が違う | `claudeCode.environmentVariables`、デスクトップ版は専用の設定 |
| `/model`にゲートウェイのモデルが出ない | モデル名が組み込みの一覧にない | `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1` |
| MCPツール検索、Remote Control、音声入力が使えない | Anthropic以外のホストでは仕様でオフ | 不具合ではないため、設定では戻らない |

## /statusの2行とcurl1回で設定側かゲートウェイ側かを分ける

原因を絞る前に、問題がClaude Code側の設定にあるのか、ゲートウェイ側にあるのかを分けます。使うのは`/status`とcurlの2つだけです。

`/status`のStatusタブでは、次の行を見ます。

- `Anthropic base URL`：ゲートウェイのアドレスが設定されているときだけ表示されます。行がなければ、変数がセッションに届いていません。
- `Auth token`または`API key`：`ANTHROPIC_AUTH_TOKEN`、`ANTHROPIC_API_KEY`、`apiKeyHelper`のどれかが表示されれば、ゲートウェイ用の認証情報が有効です。代わりに`Login method`としてclaude.aiのアカウントが出る場合は、認証情報が届いていません。

次に、Claude Codeを通さずにゲートウェイへ1トークンだけのリクエストを送ります。下のコマンドはシェルの変数を読むため、settings.jsonに値を書いている場合でも、同じ値をそのシェルで`export`してから実行してください。

```bash
curl -sS -w '\n%{http_code}\n' -X POST "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-sonnet-4-6", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'
```

Windowsでは公式ドキュメントにあるPowerShell版を使います。

```powershell
Invoke-RestMethod -Method Post -Uri "$env:ANTHROPIC_BASE_URL/v1/messages" `
  -Headers @{ "Authorization" = "Bearer $env:ANTHROPIC_AUTH_TOKEN"; "anthropic-version" = "2023-06-01" } `
  -ContentType "application/json" `
  -Body '{"model": "claude-sonnet-4-6", "max_tokens": 1, "messages": [{"role": "user", "content": "."}]}'
```

ゲートウェイが`x-api-key`ヘッダーでキーを受け取る場合は、`Authorization`の行を`x-api-key: $ANTHROPIC_API_KEY`に置き換えます。結果の読み方は次のとおりです（[公式の確認手順](https://code.claude.com/docs/en/llm-gateway-connect#verify-the-connection)より）。

| curlの結果 | 意味 | 次に見る場所 |
| --- | --- | --- |
| `{"id":"msg_`で始まるJSON | URLも認証情報も正しい | Claude Code側の設定（変数の届き方、送るフィールド） |
| 未知のモデル名を指摘するエラー | URLと認証情報は通っている。モデル名が拒否されただけ | 認証テストとしては成功。モデル名は後で合わせる |
| `401` | 認証情報が拒否された | 変数（ヘッダー）を入れ替える |
| HTML、`404` | 送り先のパスが違う、またはゲートウェイ以外が応答している | ベースURLの形 |
| すぐに接続失敗 | アドレスかネットワーク経路の問題 | URL、VPN、ファイアウォール |

curlが成功するのにClaude Codeで失敗するなら、原因はClaude Code側にあります。curlの時点で失敗するなら、Claude Codeの設定を触る前にURLとキー、ネットワークを直してください。例のモデルIDは`claude-sonnet-4-6`ですが、認証の確認だけならゲートウェイが提供していないモデル名でも判断できます。

![/statusのAnthropic base URL行、認証情報の行、curlの結果（401、HTML・404、接続失敗、msg_で始まるJSON）の順に原因を絞る判定フロー](https://www.aifreeapi.com/posts/ja/claude-code-anthropic-base-url-not-working/img/status-curl-flow.webp)

## claude.aiへのログインを求められる・サブスクのまま使われる

ログインを求められる、あるいはゲートウェイに向けたはずなのにサブスクの上限が減っていくときは、ゲートウェイ用の認証情報がClaude Codeに渡っていません。[公式の説明](https://code.claude.com/docs/en/llm-gateway#subscriptions-and-gateways)では、`ANTHROPIC_BASE_URL`だけを設定してもサブスクは置き換わりません。リクエストはゲートウェイを通りますが、保存済みのclaude.aiログインが使われ続け、その上限と課金が適用されます。サブスクの上限を避けるためにゲートウェイへ切り替えた場合は、この状態だと目的を果たせません（上限の仕組みは「[Claude Codeのレート制限ガイド：5時間・週次上限と429の見分け方](/ja/posts/claude-code-rate-limit)」で確認できます）。

原因と対処は次のとおりです。

- 認証情報の変数がない：ゲートウェイから発行されたキーを`ANTHROPIC_AUTH_TOKEN`（または`ANTHROPIC_API_KEY`）に入れます。認証情報の変数は保存済みのclaude.aiログインより優先されます。
- curlは通るのにログイン画面が出る：Claude Code自体は認証情報を持っていません。到達できるベースURLは認証情報の代わりにならず、さらに対話セッションでは、プロジェクトの`.claude/settings.json`や`.claude/settings.local.json`の`env`は初回ウィザードとフォルダーの信頼確認が済んでから適用されます。`ANTHROPIC_AUTH_TOKEN`は、シェルの`export`、`~/.claude/settings.json`の`env`、または管理設定のように、初回セットアップより前に読まれる場所に置いてください。
- `ANTHROPIC_API_KEY`が黙って無視される：この変数は対話モードで一度だけ承認を求められ、過去に拒否したキーは確認なしで無視されます。`/config`の`Use custom API key`で有効にします。`ANTHROPIC_AUTH_TOKEN`には、この承認はありません。
- 起動時に2つの認証情報の名前と`auth may not work as expected`で終わる警告が出る（古いバージョンでは`Auth conflict: Both a token (SOURCE) and an API key (SOURCE) are set`）：ゲートウェイ用の認証情報と保存済みログインが両方有効です。ゲートウェイを使うなら`/logout`で保存済みログインを消し、claude.aiを使うなら変数を外します。OpenRouterのドキュメントは、この競合が分かりにくいモデル未検出エラーとして現れることがあると説明しています。
- `This machine's managed settings require a first-party login`と表示される：管理設定に`forceLoginMethod`や`forceLoginOrgUUID`が入っており、ゲートウェイ用の認証情報と併用できません。管理者に設定の変更を依頼するしかありません。

認証情報はコミットされるプロジェクトの`.claude/settings.json`に書かないでください。リポジトリを複製した全員に共有されます。

## 変数が届かない：settings.json・VS Code・デスクトップ版

`/status`に`Anthropic base URL`の行がないときは、Claude Codeを起動した経路に変数が渡っていません。どこに書いた値がどの画面に届くかは、次のように決まっています。

### settings.jsonのenvはシェルのexportより優先される

同じ変数をシェルの`export`と設定ファイルの`env`の両方で指定すると、設定ファイルの値が使われます（[公式ドキュメント](https://code.claude.com/docs/en/llm-gateway-connect#set-in-a-settings-file)の規則で、Ollamaのドキュメントにも同じ注意があります）。シェルで新しいURLを`export`しても、`~/.claude/settings.json`や`.claude/settings.local.json`に古い値が残っていれば、そちらが勝ちます。値を変えても反映されないときは、まず設定ファイルの`env`を確認してください。`/status`には、実際に使われているベースURLと認証情報の出どころが表示されます。

なお、モデルの指定については、環境変数`ANTHROPIC_MODEL`が設定項目`model`より先に読まれます。

### シェルのexportは、そのターミナルから起動したものにしか届かない

`export`した値は、そのターミナルと、そこから起動したプログラムにだけ適用されます。DockやスタートメニューからエディターやClaude Codeを起動すると、値は見えません。新しいターミナルでも使うなら`~/.zshrc`や`~/.bashrc`、PowerShellの`$PROFILE`に書きます。バックグラウンドエージェントにはシェルだけの設定が確実には届かないため、常にゲートウェイを通したい場合は設定ファイルの`env`を使います。

ほかに、届かない原因になりやすい書き方が2つあります。

- プロジェクトの`.env`ファイル：ネイティブインストーラー版のClaude Codeは標準の`.env`ファイルを読みません（OpenRouterのドキュメントによる）。
- `ANTHROPIC_AUTH_TOKEN="$OPENROUTER_API_KEY"`のような展開：シェルプロファイルを読み込んだ時点で展開されるため、`OPENROUTER_API_KEY`がそれより後、別ファイル、またはシークレット管理ツールで後から定義されると空文字になり、すべてのリクエストが認証エラーになります。

### VS Code拡張機能はclaudeCode.environmentVariablesに書く

VS Code拡張機能は、起動前にVS Codeのユーザー設定にある`claudeCode.environmentVariables`から認証情報を確認します。`~/.claude/settings.json`の値は起動されたプロセスには届きますが、拡張機能自身のログイン確認には使われません。コマンドパレットの「Preferences: Open User Settings (JSON)」で開き、次のように書きます。

```json
{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://llm-gateway.example.com" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-gateway-key" }
  ]
}
```

### デスクトップ版はANTHROPIC_BASE_URLを読まない

Claudeのデスクトップアプリは、`ANTHROPIC_BASE_URL`もsettings.jsonも読みません。ゲートウェイの経路は、管理者が配布するサードパーティ推論の設定か、アプリ内のフォームで決まります。自分で設定する場合は、Help → Troubleshooting → Enable Developer Modeで再起動し、Developer → Configure Third-Party InferenceにゲートウェイのベースURLを入力します。管理者が配布した設定がある場合はそちらが優先され、フォームは読み取り専用になります。`Gateway was unreachable`と表示されたら、起動時に設定済みのベースURLへ到達できなかったという意味なので、前述のcurlで経路を確かめます。

### GitHub ActionsとAgent SDK

GitHub Actionsの`claude-code-action`は、ワークフローの`env`から`ANTHROPIC_BASE_URL`と`ANTHROPIC_CUSTOM_HEADERS`を読みます。ゲートウェイのキーは`anthropic_api_key`入力で渡し、これは`x-api-key`として送られます。Bearerトークンを読むゲートウェイでは、同じキーを`env`の`ANTHROPIC_AUTH_TOKEN`にも入れてください。Agent SDKのTypeScript版は`options.env`を指定すると環境変数が丸ごと置き換わるため、`...process.env`を展開して既存の変数を残します。Python版は継承した環境変数に上書きで追加されます。

## 401が返る：ANTHROPIC_AUTH_TOKENとANTHROPIC_API_KEYの取り違え

`401`は、認証情報がゲートウェイの読まないヘッダーで届いているか、キーそのものが無効なときに返ります。2つの変数は送られるヘッダーが違います。

| 変数 | 送られるヘッダー | 使う場面 |
| --- | --- | --- |
| `ANTHROPIC_AUTH_TOKEN` | `Authorization: Bearer` | 「Bearerトークン」「Authorizationヘッダー」と案内されたとき。分からない場合もこちら |
| `ANTHROPIC_API_KEY` | `x-api-key` | 「APIキー」「x-api-key」と案内されたとき |
| `apiKeyHelper` | 両方 | キーが定期的に変わる、保管庫から取り出す |

curlで`401`が出たら、もう一方の変数に移して試します。それでも`401`ならキーの失効を疑い、ゲートウェイ側で再発行します。

よく使われる接続先は、提供元のドキュメントで次の値になっています。手順ではなく、自分の設定と照らし合わせるための値です。

| 接続先 | `ANTHROPIC_BASE_URL` | 認証情報 | `ANTHROPIC_API_KEY` |
| --- | --- | --- | --- |
| [OpenRouter](https://openrouter.ai/docs/cookbook/coding-agents/claude-code-integration) | `https://openrouter.ai/api` | `ANTHROPIC_AUTH_TOKEN`にOpenRouterのキー | `""`（明示的に空にする） |
| [Ollama](https://docs.ollama.com/integrations/claude-code)（ローカル） | `http://localhost:11434` | `ANTHROPIC_AUTH_TOKEN=ollama` | `""` |
| Ollama（クラウド） | `https://ollama.com` | `ANTHROPIC_AUTH_TOKEN`に`OLLAMA_API_KEY` | ― |

`ANTHROPIC_API_KEY`を空にするのは、シェルに本物のAnthropic APIキーが残っていると、それが`x-api-key`として送られ、ゲートウェイではなくAnthropic側で認証されてしまう場合があるためです（OpenRouterのドキュメントによる）。プロファイルに残ったこのキーは`/logout`では消えません。プロファイルを直してシェルを読み込み直してください。

## 接続エラー・HTML・403：ベースURLの形とネットワーク経路

### ベースURLは末尾に/v1を付けない

Claude Codeは`ANTHROPIC_BASE_URL`の後ろに`/v1/messages`を付けて送ります。公式の確認コマンドも`$ANTHROPIC_BASE_URL/v1/messages`宛てです。そのため、値にはゲートウェイのルートだけを書きます。OpenRouterは`https://openrouter.ai/api`、Ollamaは`http://localhost:11434`で、どちらも`/v1`を含みません。

ドキュメントに明記はありませんが、パスの組み立て方から考えると、`https://openrouter.ai/api/v1`のように`/v1`まで書くと`/v1/v1/messages`へ送られることになります。そのときに返るのが`404`か、HTMLのページか、別のエラーかはゲートウェイ次第です。

### ConnectionRefused・ENOTFOUND・HTTP 200の不正な応答

- `Connection refused — a firewall or proxy may be blocking it (ConnectionRefused)`：そのアドレスで何も応答していません。URLの誤りか、VPNやファイアウォールが経路を塞いでいます。
- `Can't reach the API server — check your internet or DNS (ENOTFOUND)`：ホスト名が名前解決できません。
- どちらもClaude Codeが自動で再試行するため、表示までしばらく無反応に見えることがあります。curlなら同じ原因ですぐに失敗するので、そちらで確かめます。
- `API returned an empty or malformed response (HTTP 200)`：ゲートウェイや途中のプロキシが、Claude APIの応答ではないもの（HTMLのエラーページやログインページなど）を返しています。curlで中身を見て、該当するルートを直します。

### 403とHTML本文、またはTLSエラー

`403 Forbidden`のようなHTML本文が返り、しかもゲートウェイのログに何も残っていない場合は、ゲートウェイの手前にあるWAFやリバースプロキシがリクエスト本文を遮断しています。Claude Codeのプロンプトにはソースコードや`<tag>`形式の文字列が含まれ、クロスサイトスクリプティング対策の本文ルールに引っかかるためです。短いcurlは通り、実際のセッションだけが失敗するのはこのためです。`/v1/messages`のパスを本文検査の対象から外します。AWS WAFでは`CrossSiteScripting_Body`のマネージドルールが該当します。

curlは通るのに`SSL certificate verification failed`や`Self-signed certificate detected`が出るなら、社内のTLS検査プロキシの証明書をClaude Codeの実行環境が信頼していません。`NODE_EXTRA_CA_CERTS`にCA証明書のパスを設定します。

### ゲートウェイ以外への通信を止めたいネットワーク

外部への通信がゲートウェイだけに制限されたネットワークでは、バージョン確認やテレメトリーなど、ゲートウェイを通らない通信が失敗します。`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1`で止められますが、この設定は自動更新も止めます。後述の2.1.299のような修正を受け取るには、手動で更新する必要があります。

ゲートウェイ経由でも`529`や`500`が表示される場合は、「[Claude 529 overloaded_errorとは？原因と対処法を表示別に整理](/ja/posts/claude-529-overloaded-error)」と「[Claude API 500 エラー：闇雲にリトライする前に request_id を残す](/ja/posts/claude-api-error-500)」で、エラーの意味と記録しておくべき情報を確認できます。

## 400で止まる：ゲートウェイが拒否するフィールドと回避変数

curlの1トークンは通るのに、実際のセッションで`400`が返る場合は、Claude Codeが送るフィールドやベータ機能を、ゲートウェイかその先の上流が受け付けていません。エラー文に含まれる語で変数を選びます。

| `400`のエラー文 | 原因 | 回避方法 |
| --- | --- | --- |
| `context_management`、`Extra inputs are not permitted`、その他の認識できないフィールド | 上流がAnthropic形式のリクエストの一部を拒否 | `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`。この変数で止まらないベータは、対応する`CLAUDE_CODE_USE_*`の変数を設定する |
| `thinking`、`adaptive`（例：`Input tag 'adaptive' found`） | 上流のモデルがadaptive thinkingを受け付けない | ゲートウェイの上流を更新する。Opus 4.6とSonnet 4.6なら`CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1`でも回避できる |
| 構造化出力の拒否（セッションタイトル、メモリーの呼び出し、プロンプトフックが失敗する） | 上流が`output_config.format`を受け付けない | 2.1.288以降で`CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS=1`。ほかのベータ機能は残る |
| `ContextWindowExceededError`、`prompt token count of N exceeds the limit of M`など、ゲートウェイ独自のコンテキスト上限 | Claude Codeが「長すぎる」エラーと認識できず、自動圧縮と再送が働かない | `/compact`で復旧し、予防には`CLAUDE_CODE_AUTO_COMPACT_WINDOW`をゲートウェイの上限に合わせる |

`CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1`はプレリリースのヘッダーとフィールドの大半を取り除くため、MCPツール検索など、それに依存する機能も止まります。構造化出力だけが問題なら、範囲の狭い`CLAUDE_CODE_DISABLE_STRUCTURED_OUTPUTS`を先に試してください。

コンテキスト上限の設定には注意点があります。

- `CLAUDE_CODE_AUTO_COMPACT_WINDOW`は`200000`のような整数で書きます。`200k`と書くと`200`として読まれ、下限の100,000に切り上げられます。
- 値は100,000から、そのモデル本来のコンテキストウィンドウまでの範囲に収められます。ゲートウェイの上限が100,000未満なら合わせられないため、`/compact`で都度復旧するしかありません。
- 出力側も、`CLAUDE_CODE_MAX_OUTPUT_TOKENS`をゲートウェイのモデルの出力上限より小さくします。
- 2.1.285以降、カスタムベースURL経由のセッションでも、1Mコンテキストを持つモデル（Opus 4.7以降、Sonnet 5以降、Fable）では1Mのウィンドウが使われます。ゲートウェイが200Kで止まるなら、セッション内で`/autocompact 200k`を実行します。

### GitHubで報告されている未解決の400

Anthropicが確認したものではありませんが、厳格なゲートウェイで起きる`400`について、2026年10月15日時点で未解決の報告が2件あります。

- [#95087](https://github.com/anthropics/claude-code/issues/95087)：カスタムベースURLでは、セッション最初のリクエストに`tool_addition`ブロック（ベータ`mid-conversation-tool-changes`）が含まれ、厳格なエンドポイントが`400`で拒否します。Claude Codeはそれを外して黙って再送するため、通常は表に出ません。ただし2026年10月13日のコメントでは、2.1.296で再送が働かず、会話が使えなくなったゲートウェイが報告されています。
- [#101897](https://github.com/anthropics/claude-code/issues/101897)（2026年10月13日）：2.1.269から2.1.296に更新した後、セルフホストのモデルでOpenAI形式の`maximum context length`という`400`が出続け、圧縮でも防げず復旧もしないという報告です。報告者は2.1.269に戻して回避しました。

どちらも2.1.299で直るかどうかは公表されていません。コンテキスト上限の`400`には、上の表の`/compact`と`CLAUDE_CODE_AUTO_COMPACT_WINDOW`が公式の対処です。

## 2.1.299で直ったゲートウェイ関連の不具合とstable版の遅れ

2.1.299は日本時間2026年10月14日9時23分にnpmで公開され、同じ日の23時27分に2.1.300が続きました。[CHANGELOG](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md)の2.1.299には、カスタムベースURLに関わる修正が4件あります。

| 修正内容 | 関係する人 |
| --- | --- |
| 機能フラグ、起動時、fast mode、プロフィール、フィードバックのAnthropic宛てリクエストに、`ANTHROPIC_BASE_URL`用に設定した外部ゲートウェイのAPIキーが付いていた（AnthropicのAPIキーは引き続き送られる） | ゲートウェイのキーを使っている全員 |
| 管理設定ファイルで`ANTHROPIC_BASE_URL`を指定している場合に、サーバー管理設定のリクエストにもゲートウェイのキーが付いていた | 管理者が設定を配布している組織 |
| カスタムベースURL経由のストリームが、無通信のまま180秒で打ち切られていた。300秒待つように変更 | 応答が遅いゲートウェイ、ローカルモデル |
| ゲートウェイ固有のモデル名を使うセッションが、200Kトークン付近で`Prompt is too long · automatic compaction failed`で止まっていた | Claude Codeが認識しないモデル名を使う人 |

1件目について、修正前に画面上でどんな症状が出ていたかはCHANGELOGに書かれていません。分かっているのは、修正前はAnthropic宛ての一部のリクエストにゲートウェイのキーが付いていたという事実です。

![2026年10月15日時点でstableは2.1.292、latestは2.1.300で、ゲートウェイ関連の4件の修正を含む2.1.299がstableにまだ届いていないことを示すバージョンの図](https://www.aifreeapi.com/posts/ja/claude-code-anthropic-base-url-not-working/img/fix-version-channels.webp)

### 自分の環境に修正が入っているか確かめて更新する

`claude --version`でバージョンを確認し、2.1.299より前なら更新を検討します。

- ネイティブインストール：`claude update`。ただし設定中のリリースチャンネルに従います。
- npm：`npm install -g @anthropic-ai/claude-code@latest`
- Homebrew：`claude-code`はstable、`claude-code@latest`はlatestを追います。Homebrew、WinGet、aptは自動更新しません。
- 特定のバージョンを入れる：`curl -fsSL https://claude.ai/install.sh | bash -s 2.1.299`

[リリースチャンネル](https://code.claude.com/docs/en/setup)の既定は`latest`で、`stable`は通常1週間ほど前の、大きな不具合のあったリリースを除いたバージョンです。2026年10月15日時点でnpmの`stable`は2.1.292、`latest`は2.1.300です。ここから推測すると、`stable`を使っている人は、`stable`が2.1.299以上に進むか、`latest`への切り替えや版の指定をするまで、上の4件の修正を受け取れません。`stable`がいつ進むかは公表されていません。チャンネルは`/config`の「Auto-update channel」で変えられます。リリースノートの読み方と更新の判断は「[Claude Codeのリリースノートの読み方と更新判断](/ja/posts/claude-code-changelog)」で確認できます。

### 長い応答が途中で切れる：180秒・300秒と5分のタイムアウト

ローカルモデルや遅いゲートウェイで、応答の途中で接続が切れる場合は、無通信のタイムアウトが関係します。

- 2.1.299より前は、カスタムベースURL経由のストリームがデータの届かない状態で180秒続くと打ち切られていました。2.1.299で300秒に延びています。
- 環境変数`API_FORCE_IDLE_TIMEOUT`は、ストリーミング中にバイトが届かないと応答を打ち切る5分間のアイドルタイムアウトを上書きします。Anthropic APIに直接つなぐ場合以外では既定で有効です。チャンクの間が5分以上空くモデルでは`0`にすると無効になります。
- リクエスト全体のタイムアウトは`API_TIMEOUT_MS`で、既定は600000（10分）です。

300秒の制限と`API_FORCE_IDLE_TIMEOUT`がどう関係するかは、[環境変数のリファレンス](https://code.claude.com/docs/en/env-vars)にもCHANGELOGにも書かれていません。300秒より長く無通信になるゲートウェイでは、2.1.299以降でも打ち切られる可能性があります。

## 設定を直しても動かないもの：Claude以外のモデルと一部機能

ここまでの確認で設定に誤りがないのに動かないものは、仕様上の制限であることが多く、設定の調整では解決しません。

- Claude以外のモデル：Anthropicはサードパーティのゲートウェイを保証・保守・監査しておらず、どのゲートウェイについてもClaude CodeをClaude以外のモデルにつなぐ使い方をサポートしていません。OpenRouterも、Claude Codeの動作を保証しているのはAnthropic自身のプロバイダー経由だけです。Ollamaでは、ホスト型のWebSearchや高度なツール制御が完全にはサポートされておらず、ツール呼び出しに対応したモデルを選ぶ必要があります。大きめのリポジトリでは64k以上のコンテキストを設定するよう案内されています。
- MCPツール検索：Anthropic以外のホストを指定すると既定でオフになり、MCPツールは最初からすべて読み込まれます。ゲートウェイが`tool_reference`ブロックを転送できる場合に限り、`ENABLE_TOOL_SEARCH=true`で有効にできます。
- Remote Control：2.1.196以降、`ANTHROPIC_BASE_URL`が`api.anthropic.com`以外を指していると無効です。ゲートウェイ用の認証情報が有効な間は、Remote Controlと音声入力のどちらも使えません。
- fast mode：利用可否の確認は`ANTHROPIC_BASE_URL`に従わず、`api.anthropic.com`へ直接送られます。直接の通信が塞がれていると`/fast`が使えない旨を表示します。
- `/model`の一覧：ゲートウェイのモデル名はClaude Codeの組み込み一覧にないため表示されません。`CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1`を設定すると、起動時にゲートウェイから一覧を取得して追加します。特定のモデルが出ない原因の切り分けは「[Claude CodeでFable 5.1が出ない・使えない原因](/ja/posts/claude-code-fable-5-1-not-available)」も参考になります。

Claude以外のモデルで、必要な機能がこれらの制限に当たっている場合は、設定をいじり続けても結果は変わりません。その機能をあきらめるか、Claudeのモデルを提供する経路に戻すかを決める段階です。

## ANTHROPIC_BASE_URLについてのよくある質問

### ANTHROPIC_BASE_URLの末尾に/v1は付けますか？

付けません。Claude Codeが`/v1/messages`を自動で付け足すため、ゲートウェイのルートだけを書きます。OpenRouterなら`https://openrouter.ai/api`です。

### settings.jsonとexportでは、どちらの値が使われますか？

同じ変数が両方にある場合は、settings.jsonの`env`の値が使われます。シェルで値を変えても反映されないときは、`~/.claude/settings.json`とプロジェクトの`.claude/settings.local.json`に古い値が残っていないか確認してください。

### ゲートウェイをやめてclaude.aiのログインに戻すには？

シェルのプロファイルと設定ファイルの`env`から、`ANTHROPIC_BASE_URL`と認証情報の変数（`ANTHROPIC_AUTH_TOKEN`、`ANTHROPIC_API_KEY`、`apiKeyHelper`）を外します。claude.aiのログインは変数を設定している間も保存されたまま使われていないだけなので、変数を外せば元に戻ります。`/logout`済みの場合は再ログインが必要です。ログインで`500`や`403`が出る場合は「[Claude Codeにログインできないときの対処法：500・403・Invalid code](/ja/posts/claude-code-oauth-error)」を参照してください。

### 更新したら直りますか？

2.1.299で修正された内容（Anthropic宛てリクエストへのゲートウェイのキーの付与、180秒での打ち切り、200K付近の圧縮失敗）に当てはまる症状なら、2.1.299以降で直ります。変数の届き方、ヘッダーの取り違え、URLの形、ゲートウェイ側の拒否は設定の問題なので、更新では直りません。`stable`チャンネルでは、2026年10月15日時点でまだ2.1.299に届いていません。