🟣
Claude API 使い方ガイド
Anthropic が提供する Claude API の基本から実践まで。Python / TypeScript 対応。このページは最新情報に合わせて随時更新します。
最終更新: 2026年3月
目次
- アカウント作成とAPIキー取得
- SDK インストール
- 最初のAPI呼び出し
- モデル一覧と選び方
- 主要パラメータ
- ストリーミング
- 画像入力(Vision)
- Tool Use(関数呼び出し)
- 料金体系
- 実践Tips
1. アカウント作成とAPIキー取得
- console.anthropic.com でアカウント作成
- Settings → API Keys → Create Key をクリック
- 生成されたキー(sk-ant-…)を安全な場所に保存
- 環境変数に設定: 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回目以降のコストが大幅に下がります。