いよいよAnthropic Python SDKを実際に使って、Vertex AI経由でClaudeに初めてのリクエストを送信する時が来ました。ここでは、SDKのインストール、クライアントの作成、最初のAPI呼び出しという3つの重要なステップを順に見ていきます。
Anthropic Python SDKのインストール
まず、Vertex AIサポート付きのAnthropic SDKをインストールする必要があります。Jupyterノートブックで、次のマジックコマンドを実行してください。
%pip install "anthropic[vertex]<1"[vertex]の部分によって、Google CloudのVertex AIプラットフォームへの接続に必要な特定のコンポーネントが確実に取得されます。
APIクライアントの作成
次に、Vertex AI専用に設計されたクライアントインスタンスをインポートして作成します。
from anthropic import AnthropicVertex
client = AnthropicVertex(region="global", project_id="your-project-id")
model = "claude-haiku-4-5@20251001"このモデルとパッケージのバージョンはコース全体を通して維持してください。より新しいバージョンでは、temperatureや事前入力されたアシスタントメッセージなど、後のレッスンで学ぶ設定が拒否されてしまいます。
"your-project-id"の部分は、実際のGoogle CloudプロジェクトIDに置き換える必要があります。このIDはGoogle Cloud Consoleのプロジェクトセレクターで確認できます。モデルを変数として設定しておくと、ノートブック全体で繰り返し入力する手間が省けます。
create関数を理解する
Claudeへのリクエストを行う上で中心となるのがcreate関数で、3つの主要なパラメータを必要とします。

- model - 使用したいClaudeモデルの名前
- max_tokens - 応答の長さに対する安全上の上限(Claudeはこの値に到達しようとはしませんが、これを超えることはありません)
- messages - Claudeに送信する会話履歴
max_tokensは目標値ではなく、予算のようなものだと考えてください。1000に設定した場合、Claudeは適切だと判断した応答を書きますが、1000トークンを超えそうになると途中で止まります。
メッセージを理解する
メッセージは、チャットアプリケーションと同じように、あなたとClaudeとの間で交わされるやり取りの会話を表します。

メッセージには2つの種類があります。
- ユーザーメッセージ - Claudeに渡したい、人間が書いたコンテンツ
- アシスタントメッセージ - Claudeが生成して返してきたコンテンツ
最初のリクエストを送信する
基本的なリクエストの組み立て方は次のとおりです。
message = client.messages.create(
model=model,
max_tokens=1000,
messages=[
{
"role": "user",
"content": "What is quantum computing? Answer in one sentence"
}
]
)各メッセージは、role(「user」または「assistant」)とcontent(実際のテキスト)を持つ辞書です。
レスポンスからテキストを抽出する
リクエストを実行すると、多数のメタデータを含む複雑なレスポンスオブジェクトが返ってきます。Claudeが生成したテキストだけを取得するには、次のようにします。
message.content[0].textこれにより、技術的な詳細をすべて含む完全なレスポンスオブジェクトの代わりに、すっきりとした読みやすい出力が得られます。Claudeのレスポンスを扱う際には、このパターンを頻繁に使用することになります。