Claude Code ガイド

Appearance

原文（日本語） ​

Bedrock、Vertex、Foundryのユーザー向けに、モデルエラーメッセージを改善し、フォールバックの提案を追加しました。

原文（英語） ​

Improved model error messages for Bedrock/Vertex/Foundry users with fallback suggestions

概要 ​

Claude Code v2.1.41では、AWS Bedrock、Google Cloud Vertex AI、IBM watsonx.ai Foundryを使用しているユーザーがモデル関連のエラーに遭遇した際、より詳細でわかりやすいエラーメッセージと、代替モデルへのフォールバック提案が表示されるようになりました。これにより、問題解決が容易になり、作業の中断を最小限に抑えられます。

改善内容 ​

より詳細なエラーメッセージ ​

従来の一般的なエラーメッセージから、プラットフォーム固有の問題を明確に示すメッセージに改善されました。

修正前:

text
❌ Model error occurred

修正後:

text
❌ Model 'anthropic.claude-3-5-sonnet-20241022-v2:0' not available in your Bedrock region (us-west-2)
💡 Suggestion: Try using 'anthropic.claude-3-sonnet-20240229-v1:0' or change region to us-east-1

フォールバック提案の追加 ​

エラー発生時に、利用可能な代替モデルや解決策が自動的に提案されます。

基本的な使い方 ​

エラーメッセージの確認 ​

モデルが利用できない場合、詳細な情報と提案が表示されます。

bash
# Bedrock環境でモデルエラーが発生した場合
❌ Model not available in your region
💡 Available alternatives:
  - anthropic.claude-3-sonnet-20240229-v1:0
  - anthropic.claude-3-haiku-20240307-v1:0

💡 Or try changing your region:
  export AWS_REGION=us-east-1

フォールバックモデルの使用 ​

提案されたモデルに切り替えて作業を継続します。

bash
# 設定ファイルでモデルを変更
> /settings

# model設定を提案されたモデルに変更
{
  "model": "anthropic.claude-3-sonnet-20240229-v1:0"
}

実践例 ​

Bedrockでのリージョン固有の問題 ​

特定のリージョンでモデルが利用できない場合の対処法です。

bash
# us-west-2で最新モデルを使用しようとした場合
export AWS_REGION=us-west-2
claude

❌ Model 'claude-3-5-sonnet-20241022' not available in us-west-2
💡 This model is available in: us-east-1, eu-west-1
💡 To change region: export AWS_REGION=us-east-1

# 提案に従ってリージョンを変更
export AWS_REGION=us-east-1
claude
✓ Successfully connected with claude-3-5-sonnet-20241022

Vertex AIでのモデルアクセス権限の問題 ​

Google Cloudプロジェクトでモデルへのアクセス権限がない場合です。

bash
# Vertex AIでモデルアクセスエラー
❌ Access denied to model 'claude-3-5-sonnet@20241022'
💡 This model requires Model Garden access in your GCP project
💡 Alternative models available:
  - claude-3-sonnet@20240229
  - claude-3-haiku@20240307

💡 To enable access:
  1. Go to Vertex AI Model Garden
  2. Enable Claude models for your project

Foundryでのモデル設定の問題 ​

IBM watsonx.ai環境で、モデル設定が正しくない場合です。

bash
# Foundryでモデル設定エラー
❌ Invalid model configuration for watsonx.ai
💡 Expected format: 'anthropic/claude-3-5-sonnet'
💡 Your configuration: 'claude-3-5-sonnet'

💡 To fix, update your model setting:
  "model": "anthropic/claude-3-5-sonnet"

複数環境での自動フォールバック ​

CI/CD環境など、複数のクラウドプラットフォームで動作させる場合です。

bash
# 環境に応じて適切なモデルを提案
# Bedrock環境
❌ Primary model unavailable
💡 Falling back to: anthropic.claude-3-sonnet-20240229-v1:0

# Vertex AI環境
❌ Primary model unavailable
💡 Falling back to: claude-3-sonnet@20240229

クォータ制限エラーの対処 ​

レート制限やクォータ超過時の代替案提示です。

bash
❌ Rate limit exceeded for claude-3-5-sonnet
💡 You've reached your quota for this model
💡 Suggestions:
  1. Wait 60 seconds and retry
  2. Use a smaller model: claude-3-haiku
  3. Increase your quota in the AWS Console

この改善の利点 ​

問題解決の迅速化 ​

  • エラーの原因が明確に示される
  • 具体的な解決策が提案される
  • 代替モデルの情報がすぐに得られる

ユーザー体験の向上 ​

  • 専門知識がなくても対処可能
  • 作業の中断時間を最小化
  • プラットフォーム固有の問題を理解しやすい

開発効率の改善 ​

  • トラブルシューティングの時間削減
  • マルチクラウド環境での運用が容易
  • 自動フォールバックによる継続性確保

注意点 ​

  • フォールバックモデルは、元のモデルと異なる性能や機能を持つ場合があります
  • リージョン変更は、レイテンシーやコストに影響する可能性があります
  • プラットフォーム固有のクォータ制限に注意してください
  • 各クラウドプロバイダーの料金体系を事前に確認することを推奨します

モデル選択のベストプラクティス ​

  • 開発環境: 高速で低コストなHaikuモデルを使用
  • 本番環境: 要件に応じてSonnetまたはOpusを選択
  • コスト最適化: タスクの複雑さに応じてモデルを使い分ける

関連情報 ​