Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

ANTHROPIC_BASE_URL をサードパーティゲートウェイと共に使用した際のAPI 400エラーを修正しました。ツール検索がプロキシエンドポイントを正しく検出し、tool_reference ブロックを無効化するようになりました。また、カスタムBedrockの推論プロファイルや標準のClaudeの命名パターンに一致しない他のモデル識別子を使用した際の API Error: 400 This model does not support the effort parameter エラーも修正しました。

原文（英語） ​

  • 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
  • Fixed API Error: 400 This model does not support the effort parameter when using custom Bedrock inference profiles or other model identifiers not matching standard Claude naming patterns

概要 ​

2.1.70では、サードパーティゲートウェイやカスタムBedrockプロファイルを使用している環境でのAPI 400エラーが修正されました。ANTHROPIC_BASE_URL でプロキシ経由のアクセスを設定している場合に、Claude CodeのツールサーチがプロキシエンドポイントをAnthropicのAPIと誤認し、tool_reference ブロックを送信してエラーが発生していた問題が解消されます。

基本的な使い方 ​

修正により、サードパーティゲートウェイ経由の設定が以下のように正常動作するようになりました：

bash
# 環境変数でサードパーティゲートウェイを設定
export ANTHROPIC_BASE_URL=https://your-gateway.example.com/v1
export ANTHROPIC_API_KEY=your-api-key

# Claude Codeを起動（以前は400エラーが発生していた）
claude

実践例 ​

AWSプロキシゲートウェイ経由の使用 ​

企業のセキュリティポリシーでAWS API GatewayなどのプロキシをAnthropicのAPIの前段に置く構成：

bash
# プロキシゲートウェイの設定
export ANTHROPIC_BASE_URL=https://api-gateway.company.com/anthropic
export ANTHROPIC_API_KEY=your-key

# 以前: tool_referenceブロックを含むリクエストで400エラー発生
# 修正後: プロキシを正しく検出し、互換性のあるリクエスト形式を使用
claude "コードをレビューしてください"

カスタムBedrockプロファイルの使用 ​

標準の命名規則（claude-*）に一致しないカスタムBedrockの推論プロファイルを利用する場合：

bash
# カスタムBedrockプロファイルの設定
export ANTHROPIC_BEDROCK_BASE_URL=https://bedrock-runtime.us-east-1.amazonaws.com
export CLAUDE_CODE_USE_BEDROCK=1

# カスタムプロファイルIDを指定（標準のClaudeパターンに一致しないもの）
# 以前: "This model does not support the effort parameter" エラー発生
# 修正後: effortパラメーターが正しく制御される
claude --model arn:aws:bedrock:us-east-1:123456789012:inference-profile/custom-profile

セルフホストAPIサーバーとの接続 ​

Ollamaやvllmなど、Anthropic互換APIを持つセルフホストモデルサーバーを使用する場合：

bash
# セルフホストサーバーへの接続
export ANTHROPIC_BASE_URL=http://localhost:8080/v1
export ANTHROPIC_API_KEY=dummy-key

# 以前はAPIエラーが頻繁に発生
# 修正後: ツール機能が正常に動作
claude

注意点 ​

  • ANTHROPIC_BASE_URL を設定する場合、エンドポイントがAnthropicのAPIと互換性を持つ必要があります
  • カスタムBedrockプロファイルを使用する場合、AWS認証情報が正しく設定されている必要があります
  • サードパーティゲートウェイによっては、一部のClaude Code機能が制限される場合があります
  • この修正はClaude Code 2.1.70以降で有効です

関連情報 ​