Anthropic SDK の基礎

SDK とは何か

SDK(Software Development Kit)は、API を簡単に利用するためのライブラリです。 Anthropic の公式 SDK を使うと、HTTP リクエストの組み立て・認証ヘッダーの付与・ エラーハンドリング・リトライ処理を SDK が肩代わりしてくれます。

公式 SDK は Python と TypeScript / JavaScript の 2 言語が提供されており、 どちらも Anthropic がメンテナンスしています 出典。

インストール

# Python
pip install anthropic

# TypeScript / JavaScript (Node.js)
npm install @anthropic-ai/sdk

Python — 最小コード例

以下は公式ドキュメントのコード例に準拠した最小構成です 出典。

from anthropic import Anthropic

client = Anthropic()  # ANTHROPIC_API_KEY 環境変数を自動読み込み

message = client.messages.create(
    model="claude-opus-4-7",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "こんにちは、Claude!"}
    ]
)

print(message.content[0].text)

TypeScript — 最小コード例

TypeScript(ES Modules)での最小構成です 出典。

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

const client = new Anthropic();  // ANTHROPIC_API_KEY 環境変数を自動読み込み

const message = await client.messages.create({
  model: "claude-opus-4-7",
  max_tokens: 1024,
  messages: [
    { role: "user", content: "こんにちは、Claude!" }
  ]
});

console.log(message.content);

レスポンスの構造

messages.create() が返す Message オブジェクトには主に以下のフィールドがあります。

• content — テキスト生成結果の配列。通常 content[0].text で本文を取得する。
• model — 使用されたモデル名。
• stop_reason — 生成停止理由("end_turn" / "max_tokens" / "tool_use" 等)。
• usage — 入力・出力トークン数。コスト計算に使う。

必須パラメータの解説

詳細記事

セットアップ全体の流れと実例は 「Claude API はじめ方 — Python / TypeScript 実例 5 分」 で解説しています。