CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS

環境変数

1 を設定すると、リリース前の anthropic-beta リクエストヘッダー、それに対応するボディフィールド、defer_loading や eager_input_streaming などのベータ版ツールスキーマフィールドが API リクエストから取り除かれる。プロキシゲートウェイが anthropic-beta ヘッダーに対する Unexpected value(s) エラーや Extra inputs are not permitted エラーでリクエストを拒否する場合に使用する。pre-release capabilities の無効化に関するページに、この変数が削除するもの(MCP ツール検索を含む)と Claude Code が送信し続けるものの一覧が記載されている。

使い方・用途

  • プロキシゲートウェイが anthropic-beta ヘッダーを理由に Unexpected value(s) エラーでリクエストを拒否する場合に、リリース前のヘッダーを取り除いてリクエストを通すために使う。
  • Vertex/Bedrock に転送するプロキシゲートウェイがペアとなるボディフィールドを理由に Extra inputs are not permitted エラーを返す場合に、エラーを解消するために使う。
  • LLM ゲートウェイ経由で利用していて、リリース前のベータ機能を下流のインフラが受け付けられないときに、これらの機能を無効化して互換性を保つために使う。
英語原文

Set to 1 to strip pre-release anthropic-beta request headers, the body fields that pair with them, and beta tool-schema fields such as defer_loading and eager_input_streaming from API requests. Use this when a proxy gateway rejects requests with an Unexpected value(s) error for the anthropic-beta header or an Extra inputs are not permitted error. Disable pre-release capabilities lists what the variable removes, including MCP tool search, and what Claude Code keeps sending

関連ドキュメント

関連する変更履歴

v2.1.319(1件)

LLM ゲートウェイ経由の auto mode の挙動を変更した: CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS が設定されていても CLAUDE_CODE_AUTO_MODE_SERVER=1 を指定するとサーバー側の検証が有効になる。managed settings で後者が設定されている場合、ゲートウェイ側も 1 を設定する必要がある
英語原文を表示
Changed auto mode behind an LLM gateway: CLAUDE_CODE_AUTO_MODE_SERVER=1 turns on the server-side check even with CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS set; if managed settings set the latter, they must set the 1 too

変更後

LLM ゲートウェイ経由で CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS が管理設定で設定されている環境でも、CLAUDE_CODE_AUTO_MODE_SERVER=1 を設定すればサーバー側のレビューを有効化できるようになる。これにより、サーバー側のチェックが無効化されることでサーバー判定が得られずアクションが拒否される事態を避けられる。

関連ドキュメント

v2.1.287(1件)

Bedrock バックエンドのゲートウェイが拒否する原因となる、CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS を設定してもセッションタイトルや prompt-hook リクエストから structured-output 形式が除去されない問題を修正した
英語原文を表示
Fixed CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS not removing the structured-output format from session-title and prompt-hook requests, which Bedrock-backed gateways reject

関連ドキュメント

v2.1.123(1件)

CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 が設定されている場合に OAuth 認証が 401 再試行ループで失敗する問題を修正しました
英語原文を表示
Fixed OAuth authentication failing with a 401 retry loop when CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 is set

変更後

社内プロキシや LLM ゲートウェイを利用するためにベータ機能をオフにしている環境でも、OAuth を通じて安全かつ確実にログインできるようになります。

関連ドキュメント

v2.1.81(1件)

CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS を設定しても構造化出力のベータヘッダーが抑制されず、Vertex AI や Bedrock のプロキシで 400 エラーが発生する問題を修正しました。
英語原文を表示
Fixed CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS not suppressing the structured-outputs beta header, causing 400 errors on proxy gateways forwarding to Vertex/Bedrock

変更後

独自のセキュリティポリシーを持つエンタープライズ環境のプロキシを介しても、Claude Code を支障なく利用できるようになります。

関連ドキュメント

v2.1.77(1件)

CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS 有効時、プロキシ経由でツールスキーマのベータフィールドが拒絶される問題を修正しました
英語原文を表示
Fixed CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS not stripping beta tool-schema fields, causing proxy gateways to reject requests

変更後

独自の LLM ゲートウェイを使用している企業環境でも、接続エラーを回避して安定して利用できます。

関連ドキュメント

v2.1.27(1件)

ゲートウェイユーザー向けのコンテキスト管理バリデーションエラーを修正し、CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1を設定することでエラーが回避されるようになりました。
英語原文を表示
Fixed context management validation error for gateway users, ensuring CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 avoids the error

関連ドキュメント

v2.1.25(1件)

BedrockおよびVertexのゲートウェイユーザーにおいて、ベータヘッダーの検証エラーを修正しました。これにより、CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1を設定することでエラーを回避できるようになります。
英語原文を表示
Fixed beta header validation error for gateway users on Bedrock and Vertex, ensuring CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 avoids the error

関連ドキュメント