メインコンテンツまでスキップ

初めての API 呼び出し

初級

API を使うと、あなたのプログラムが Claude と通信できます。このレッスンを終える頃には、実際のリクエストを実行し、その各部分が何をしているのかを正確に理解しているはずです。

What you'll learn
  • API キーを作成し、環境変数として安全に保管する
  • Python または TypeScript の公式 SDK をインストールする（あるいは素の cURL を使う）
  • 初めての messages リクエストを送信し、Claude の返信を読む
  • 4つの中核フィールド——model、max_tokens、messages、system——を理解する

全行程を3ステップで​

以下のすべては、1つのシンプルな流れに収まります。進めながらこの地図を念頭に置いてください。

Guided walkthrough1 of 3
  1. Anthropic Console でキーを作成し、環境変数としてエクスポートして、コード内に残らないようにします。

1. API キーを取得する​

Anthropic Console で作成します。次に環境変数として設定し、コード内に残らないようにします：

API キーをエクスポートする

export ANTHROPIC_API_KEY="sk-ant-..."
Watch out
  • キーは絶対にコミットしないこと。キーは環境変数かシークレットマネージャーに保管し、決してソース管理に入れないこと。セキュリティのページ（/docs/security）を参照。

2. SDK をインストールする​

言語を選びます。SDK は、いま設定した環境変数からキーを自動的に読み取ります。

インストール（Python）

pip install anthropic

3. 呼び出す​

どのリクエストも messages のリストです。モデルは content で返信します。自分の言語のスニペットを実行すると、Claude が質問に答えるのが見えます。

import anthropic

client = anthropic.Anthropic()  # reads ANTHROPIC_API_KEY from the environment

message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "In one sentence, what is an API?"}
    ],
)

print(message.content[0].text)

いま何が起きたのか​

あなたは4つの情報を送りました。それぞれが何を制御するかは次のとおりです：

  • model — どの Claude を使うか。やみくもにハードコードしないこと。モデルの選び方を参照。
  • max_tokens — 返信の長さの上限（トークン単位）。コンテキストウィンドウを設定するものではありません。
  • messages — これまでの会話。API はステートレスです。チャットを続けるには、毎回履歴全体を送り返します。
  • system（任意）— 呼び出しに対する Claude の役割を設定するトップレベルの指示。
4つの中核フィールド
Enter キーまたはスペースキーでカードを裏返します。左右の矢印キーでカードを移動できます。用語を表示しました。
1 / 4
Pro tip
  • API はステートレスなので、マルチターンのチャットは増えていく messages 配列にすぎません。各返信を追加し、次の呼び出しでリスト全体を送り直します。

理解度チェック

0/3
  1. max_tokens は何を制御しますか？
  2. API でマルチターンの会話をどう続けますか？
  3. API キーはどこに置くべきですか？
Key takeaways
  • 3ステップ：キーを取得し、SDK をインストールし、messages リクエストを送る。
  • キーを ANTHROPIC_API_KEY に保管すれば、SDK が自動で読み取り、コードに入らない。
  • リクエストは messages のリストで、返信は content で返ってくる。
  • API はステートレス：チャットを続けるには会話履歴全体を送り直す。
  • model、max_tokens、messages、system が、最初に手を伸ばすフィールド。

次へ​