基本的なセットアップと構造を理解していれば、Anthropic APIに初めてリクエストを送るのは簡単です。このガイドでは、Pythonを使ってClaudeにプロンプトへ応答させるために必要な基本手順を説明します。
環境のセットアップ
APIを呼び出す前に、必要なパッケージをインストールし、APIキーを安全に設定する必要があります。
まず、Jupyterノートブックに必要な依存関係をインストールします。
%pip install "anthropic<1" python-dotenv次に、ノートブックと同じディレクトリに.envファイルを作成し、APIキーを安全に保存します。
ANTHROPIC_API_KEY="your-api-key-here"この方法により、APIキーをコードの外に置くことができ、誤ってバージョン管理にコミットしてしまうことを防げます。.envは必ず.gitignoreに追加してください。
環境変数を読み込み、APIクライアントを作成します。
from dotenv import load_dotenv
load_dotenv()
from anthropic import Anthropic
client = Anthropic()
model = "claude-haiku-4-5"このモデルとパッケージのバージョンは、コース全体を通してそのまま使用してください。新しいバージョンでは、後のレッスンで扱うtemperatureやプリフィルされたアシスタントメッセージなどの設定が拒否されることがあります。
Create関数
APIリクエストを行う中心となるのが、client.messages.create()関数です。この関数には3つの重要なパラメータが必要です。

- model - 使用したいClaudeモデルの名前
- max_tokens - 応答の長さに対する安全上の上限(目標値ではない)
- messages - Claudeに送信する会話履歴
max_tokensパラメータは安全機構として機能します。これを1000に設定すると、Claudeはまだ話すべきことが残っていても1000トークンに達した時点で生成を停止します。Claudeはこの上限に到達しようとするわけではなく、適切だと判断した内容を書き、上限に達したら停止するだけです。
メッセージを理解する
メッセージは、チャットアプリケーションと同様に、あなたとClaudeの間の会話を表します。メッセージには2種類あります。

- ユーザーメッセージ - Claudeに送信したいコンテンツ(人間が書いたもの)
- アシスタントメッセージ - Claudeが生成した応答
各メッセージは、role(「user」または「assistant」のいずれか)とcontent(実際のテキスト)を持つ辞書です。
初めてのリクエストを送信する
Claudeにリクエストを送信する完全な例を次に示します。
message = client.messages.create(
model=model,
max_tokens=1000,
messages=[
{
"role": "user",
"content": "What is quantum computing? Answer in one sentence"
}
]
)このコードを実行すると、Claudeはリクエストを処理し、生成されたテキストとリクエストに関するメタデータを含む応答オブジェクトを返します。
応答を抽出する
応答オブジェクトには多くの情報が含まれていますが、通常は生成されたテキストだけが必要です。次の方法でアクセスします。
message.content[0].textこれにより、次のようなきれいで読みやすい出力が得られます。「量子コンピューティングは、重ね合わせやエンタングルメントといった量子力学の原理を活用し、量子ビット(qubit)を使って情報を処理する計算の一種であり、特定の複雑な問題を古典的なコンピューターよりも指数関数的に高速に解決できる可能性があります。」
これらの基本を押さえたら、さまざまなプロンプトを試したり、Claudeとのより複雑なやり取りを構築したりし始めることができます。