Claude Code ガイド

Appearance

修正：CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETASがVertex/Bedrockプロキシで400エラーを起こす問題 ​

原文（日本語に翻訳） ​

CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS が structured-outputs ベータヘッダーを抑制できず、Vertex/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_DISABLE_EXPERIMENTAL_BETAS 環境変数を設定していても、structured-outputs ベータヘッダーが送信され続けていました。このヘッダーが Vertex AI や Amazon Bedrock にリクエストを転送するプロキシゲートウェイに到達すると、これらのサービスがヘッダーを認識できずに 400 エラーを返すという問題がありました。修正後は、この環境変数が正しくすべてのベータヘッダーを抑制します。

基本的な使い方 ​

bash
# Vertex AI / Bedrock 経由でClaude Codeを使用する場合
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1
claude

または設定ファイルで：

json
{
  "env": {
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

実践例 ​

### Vertex AI プロキシ経由での利用 ​

Google Cloud の Vertex AI を通じてClaude APIを使用する企業環境：

bash
export ANTHROPIC_API_KEY="your-key"
export ANTHROPIC_BASE_URL="https://your-vertex-proxy.example.com"
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1

claude -p "コードレビューをしてください"

### Amazon Bedrock プロキシ経由での利用 ​

AWS Bedrock を通じてClaude APIを使用する場合：

bash
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1
export ANTHROPIC_BASE_URL="https://your-bedrock-proxy.example.com"

claude

### CI/CD での設定 ​

yaml
# .github/workflows/claude-review.yml
env:
  CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS: "1"
  ANTHROPIC_BASE_URL: ${{ vars.BEDROCK_PROXY_URL }}
  ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

注意点 ​

  • この修正は Vertex AI や Bedrock へのプロキシ経由でClaude Codeを使用している場合に特に重要
  • CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS を設定すると、すべての実験的ベータ機能のヘッダーが無効になる
  • 一部のベータ機能が利用できなくなる可能性があるが、プロキシ互換性のためには必要な設定

関連情報 ​