Claude API 使い方ガイド|Python・TypeScript対応

🟣

Claude API 使い方ガイド

Anthropic が提供する Claude API の基本から実践まで。Python / TypeScript 対応。このページは最新情報に合わせて随時更新します。

最終更新: 2026年3月

目次

  1. アカウント作成とAPIキー取得
  2. SDK インストール
  3. 最初のAPI呼び出し
  4. モデル一覧と選び方
  5. 主要パラメータ
  6. ストリーミング
  7. 画像入力(Vision)
  8. Tool Use(関数呼び出し)
  9. 料金体系
  10. 実践Tips

1. アカウント作成とAPIキー取得

  1. console.anthropic.com でアカウント作成
  2. Settings → API Keys → Create Key をクリック
  3. 生成されたキー(sk-ant-…)を安全な場所に保存
  4. 環境変数に設定: export ANTHROPIC_API_KEY=”sk-ant-…”

⚠️ APIキーは絶対にGitHubなどの公開リポジトリにコミットしないでください。.env ファイルと .gitignore を使いましょう。

2. SDK インストール

Python

pip install anthropic

TypeScript / Node.js

npm install @anthropic-ai/sdk

3. 最初のAPI呼び出し

Python
import anthropic

client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "日本語で自己紹介してください"}]
)

print(message.content[0].text)
TypeScript
import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic();

const message = await client.messages.create({
  model: "claude-sonnet-4-6",
  max_tokens: 1024,
  messages: [{role: "user", content: "日本語で自己紹介してください"}],
});

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

4. モデル一覧と選び方

モデル ID 特徴 用途
Opus 4.6 claude-opus-4-6 最高性能、複雑な推論 高度な分析、コード生成
Sonnet 4.6 claude-sonnet-4-6 性能とコストのバランス 汎用、チャット、要約
Haiku 4.5 claude-haiku-4-5-20251001 高速・低コスト 分類、軽量タスク

💡 まずSonnetで試して、品質が足りなければOpus、コストを下げたければHaikuに切り替えるのが実践的です。

5. 主要パラメータ

パラメータ 説明 デフォルト
model 使用モデル(必須)
max_tokens 最大出力トークン数(必須)
temperature ランダム性(0.0-1.0) 1.0
system システムプロンプト なし

6. ストリーミング

with client.messages.stream(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "短い物語を書いて"}]
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

7. 画像入力(Vision)

import base64

with open("image.png", "rb") as f:
    image_data = base64.standard_b64encode(f.read()).decode()

message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{
        "role": "user",
        "content": [
            {"type": "image", "source": {
                "type": "base64",
                "media_type": "image/png",
                "data": image_data
            }},
            {"type": "text", "text": "この画像を説明してください"}
        ]
    }]
)

8. Tool Use(関数呼び出し)

tools = [{
    "name": "get_weather",
    "description": "指定された都市の現在の天気を取得します",
    "input_schema": {
        "type": "object",
        "properties": {
            "city": {"type": "string", "description": "都市名"}
        },
        "required": ["city"]
    }
}]

message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    tools=tools,
    messages=[{"role": "user", "content": "東京の天気は?"}]
)

9. 料金体系

モデル 入力 / 1M tokens 出力 / 1M tokens
Opus 4.6 $15 $75
Sonnet 4.6 $3 $15
Haiku 4.5 $0.80 $4

※ Prompt Cachingで入力コスト最大90%削減。バッチAPIで50%割引。

10. 実践Tips

システムプロンプトを活用する — 一貫した出力形式や専門知識の制約を設定。JSON出力が必要なら明記。

temperatureを下げる — 事実・コード生成では temperature: 0 を推奨。創造的タスクでは0.7-1.0。

Prompt Cachingを使う — 長いシステムプロンプトは自動キャッシュされ、2回目以降のコストが大幅に下がります。

上部へスクロール