Claude Code ガイド

Appearance

原文（日本語に翻訳） ​

ENABLE_PROMPT_CACHING_1H が設定されている場合のBedrockおよびVertex 400エラーを修正しました。

原文（英語） ​

Fixed Bedrock and Vertex 400 errors when ENABLE_PROMPT_CACHING_1H is set

概要 ​

AWS BedrockおよびGoogle Cloud Vertex AIを通じてClaude Codeを使用している際に、1時間のプロンプトキャッシュを有効にする環境変数 ENABLE_PROMPT_CACHING_1H を設定すると、HTTP 400エラーが発生する問題がありました。この修正により、BedrockおよびVertex AI環境でも1時間のプロンプトキャッシュが正常に動作するようになります。コスト削減と応答速度の向上が期待できます。

基本的な使い方 ​

ENABLE_PROMPT_CACHING_1H 環境変数を設定することで、1時間のプロンプトキャッシュが有効になります（修正後はBedrock/Vertexでも正常動作）。

bash
# 1時間のプロンプトキャッシュを有効にしてClaude Codeを起動

# AWS Bedrockを使用する場合
export ANTHROPIC_API_KEY=""  # Bedrockでは不要
export AWS_REGION="us-east-1"
export ENABLE_PROMPT_CACHING_1H=true
claude

# Google Cloud Vertex AIを使用する場合
export CLOUD_ML_REGION="us-central1"
export ANTHROPIC_VERTEX_PROJECT_ID="your-project-id"
export ENABLE_PROMPT_CACHING_1H=true
claude

実践例 ​

AWS BedrockでのClaude Code設定 ​

bash
# AWS認証情報の設定
export AWS_ACCESS_KEY_ID="your-access-key"
export AWS_SECRET_ACCESS_KEY="your-secret-key"
export AWS_REGION="us-east-1"

# BedrockのClaudeモデルを指定
export ANTHROPIC_BEDROCK_BASE_URL="https://bedrock-runtime.us-east-1.amazonaws.com"

# 1時間のプロンプトキャッシュを有効化（修正後は正常動作）
export ENABLE_PROMPT_CACHING_1H=true

# Claude Codeを起動
claude

# 確認: プロンプトキャッシュが有効かどうか確認
/status

Google Cloud Vertex AIでのClaude Code設定 ​

bash
# Google Cloudの認証
gcloud auth application-default login

# Vertex AI設定
export ANTHROPIC_VERTEX_PROJECT_ID="your-gcp-project-id"
export CLOUD_ML_REGION="us-central1"

# 1時間のプロンプトキャッシュを有効化（修正後は正常動作）
export ENABLE_PROMPT_CACHING_1H=true

# Claude Codeを起動
claude

# 確認: Vertex AI接続とキャッシュ設定を確認
/status

.envファイルでの設定管理 ​

bash
# プロジェクトの.envファイルに設定を記述
cat > .env << 'EOF'
# AWS Bedrockの設定
AWS_REGION=us-east-1
ANTHROPIC_BEDROCK_BASE_URL=https://bedrock-runtime.us-east-1.amazonaws.com

# プロンプトキャッシュの有効化（修正後はBedrockでも動作）
ENABLE_PROMPT_CACHING_1H=true
EOF

# .envを読み込んでClaude Codeを起動
source .env && claude

プロンプトキャッシュの効果確認 ​

# 同じコンテキストで複数回リクエストを送ることでキャッシュの効果を確認

# 1回目のリクエスト（キャッシュなし）
> 大規模なコードベースを分析してください
# → 応答時間: 通常通り

# 2回目以降（同じプロンプトプレフィックスを使用）
> さらに詳しく説明してください
# → キャッシュが有効な場合、応答時間が短縮される

# /usage でトークン使用量とキャッシュ効果を確認
/usage

注意点 ​

  • ENABLE_PROMPT_CACHING_1H はプロンプトキャッシュの有効期限を通常の5分から1時間に延長します。長時間の作業セッションでコスト削減に効果的です。
  • この機能はすべてのBedrockリージョンおよびVertex AIリージョンで利用できるわけではありません。対応状況はAWSおよびGCPの公式ドキュメントを確認してください。
  • プロンプトキャッシュの料金体系はBedrockとVertex AIによって異なります。利用前にコストを確認してください。
  • 修正前に400エラーが発生していた場合、v2.1.132以降にアップデートすることで解消されます。

関連情報 ​