Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

APIプロキシ、Bedrock、またはVertexを通じた細粒度ツールストリーミング使用時の400エラーを修正しました

原文（英語） ​

Fixed 400 errors when using fine-grained tool streaming through API proxies, Bedrock, or Vertex

概要 ​

Claude CodeをAWS BedrockやGoogle Vertex AI、またはAPIプロキシ経由で使用している場合、細粒度のツールストリーミング（fine-grained tool streaming）実行時に400エラー（Bad Request）が発生する問題がありました。ストリーミングフォーマットの違いによりリクエストが正しく処理されず、特定のクラウドプロバイダーやプロキシ設定での動作に問題が生じていました。この修正により、これらの環境でも細粒度ツールストリーミングが正常に動作します。

基本的な使い方 ​

この修正は自動的に適用されます。AWS Bedrock、Google Vertex AI、またはAPIプロキシを通じてClaude Codeを使用している場合、ツールストリーミングが正常に動作するようになります。

bash
# AWS Bedrock経由でClaude Codeを使用
export ANTHROPIC_API_URL=https://bedrock-runtime.us-east-1.amazonaws.com/...
claude

# Google Vertex AI経由で使用
export ANTHROPIC_API_URL=https://...vertex...
claude

# APIプロキシ経由で使用
export ANTHROPIC_API_URL=https://your-proxy.example.com
claude

実践例 ​

AWS Bedrock環境での設定 ​

bash
# AWS Bedrockを経由してClaude Codeを使用する環境設定
export AWS_REGION=us-east-1
export ANTHROPIC_API_URL=https://bedrock-runtime.${AWS_REGION}.amazonaws.com

# 修正後: ツールストリーミングを使用した操作が正常に動作
claude

# ファイル操作やコード実行など、ツールを多用する操作を実行
# 修正前: "400 Bad Request" エラーが発生することがあった
# 修正後: エラーなく正常に動作

Google Vertex AI環境での設定 ​

bash
# Vertex AI経由でClaude Codeを使用
export ANTHROPIC_API_URL=https://us-east5-aiplatform.googleapis.com/v1/...
export GOOGLE_APPLICATION_CREDENTIALS=/path/to/credentials.json

claude

# ツールを使う操作（コード実行、ファイル読み書きなど）が正常に動作

企業プロキシ環境での使用 ​

bash
# 企業のAPIゲートウェイやプロキシを経由する場合
export ANTHROPIC_API_URL=https://api.company.com/claude-proxy

claude

# 修正後: プロキシ環境でもツールストリーミングが正常に機能

注意点 ​

  • 影響環境: AWS Bedrock、Google Vertex AI、またはAPIプロキシを使用している環境が対象です。Anthropic APIに直接接続している場合は影響なし
  • ツールストリーミング: 細粒度ツールストリーミングはClaudeがツールを呼び出す際の詳細なストリーミング情報を提供する機能です
  • エラーの種類: 400エラー（Bad Request）はリクエスト形式の問題を示します。今回の修正でリクエスト形式が各環境に合わせて適切に処理されます
  • レガシープロキシ: 一部の古いプロキシ実装では追加の設定が必要な場合があります

関連情報 ​