初めての API 呼び出し

初級

API は、あなたのプログラムから Claude と対話できるようにするものです。手順は 3 つ: キーを取得し、SDK をインストールし、メッセージを送信します。

1. API キーを取得する

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

export ANTHROPIC_API_KEY="sk-ant-..."

:::warning キーを絶対にコミットしないキーは環境変数またはシークレットマネージャーに保管してください — バージョン管理に入れてはいけません。セキュリティを参照。 :::

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

Python
TypeScript
cURL

pip install anthropic

npm install @anthropic-ai/sdk

インストールするものはありません — curl があれば十分です。

3. 呼び出しを行う

すべてのリクエストは messages のリストです。モデルは content で応答します。

Python
TypeScript
cURL

import anthropic

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

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

print(message.content[0].text)

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic(); // reads ANTHROPIC_API_KEY from the environment

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

console.log(message.content[0].text);

curl https://api.anthropic.com/v1/messages \
  --header "x-api-key: $ANTHROPIC_API_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --data '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "In one sentence, what is an API?"}
    ]
  }'

いま何が起きたのか

model — どの Claude を使うか。むやみにハードコードしないこと。モデルの選び方を参照。
max_tokens — 応答の長さの上限（トークン単位）。コンテキストウィンドウを設定するものではありません。
messages — これまでの会話。API はステートレスです。チャットを継続するには、毎回履歴全体を送り返します。
system（任意） — その呼び出しにおける Claude の役割を設定する、トップレベルの指示。

適切なモデルを選び、コストを見積もる → モデルの選び方 · トークン & 料金
応答をストリーミングし、会話を維持する → ストリーミング & マルチターン
Claude にあなたの関数を呼び出させる → ツールの利用
本番対応のスニペット → API スニペット

1. API キーを取得する​

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

3. 呼び出しを行う​

いま何が起きたのか​

次へ​

1. API キーを取得する

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

3. 呼び出しを行う

いま何が起きたのか

次へ