CLAUDE LABEN
PRICING — 本日9月1日は Sonnet 5 の値上げ予定日でしたが、引き上げは実施されませんでした。導入価格の $2/$10 per MTok がそのまま標準価格として確定していますPARTNER — Salesforce と Anthropic が拡張提携「Claudeforce」を発表しました。Salesforce in Claude プラグインは商談準備やパイプライン管理など37のセールススキルを同梱しますTRUST — Claudeforce の推論は Amazon Bedrock 経由で Salesforce Trust Boundary の内側に留まります。データが境界の外へ出ない構成が、規制業種への回答になっていますBETA — Salesforce in Claude は現在は選抜パイロット顧客向けです。9月中のオープンベータ移行が予告されていますLIMITS — 週次上限の50%増は9月13日までです。9月14日からはプロモ前比+25%が恒久水準になります。今日の水準と比べると約17%の削減にあたりますRELEASE — Claude Code は v2.1.251(8月28日)から新しいリリースが出ていません。約0.8日に1本というペースからすると、4日の間隔は最長クラスですPRICING — 本日9月1日は Sonnet 5 の値上げ予定日でしたが、引き上げは実施されませんでした。導入価格の $2/$10 per MTok がそのまま標準価格として確定していますPARTNER — Salesforce と Anthropic が拡張提携「Claudeforce」を発表しました。Salesforce in Claude プラグインは商談準備やパイプライン管理など37のセールススキルを同梱しますTRUST — Claudeforce の推論は Amazon Bedrock 経由で Salesforce Trust Boundary の内側に留まります。データが境界の外へ出ない構成が、規制業種への回答になっていますBETA — Salesforce in Claude は現在は選抜パイロット顧客向けです。9月中のオープンベータ移行が予告されていますLIMITS — 週次上限の50%増は9月13日までです。9月14日からはプロモ前比+25%が恒久水準になります。今日の水準と比べると約17%の削減にあたりますRELEASE — Claude Code は v2.1.251(8月28日)から新しいリリースが出ていません。約0.8日に1本というペースからすると、4日の間隔は最長クラスです
記事一覧/API & SDK
API & SDK/2026-03-04中級

Claude API クイックスタート — 最初のAPI呼び出しまで5分

Claude APIの基本的な使い方を解説。APIキーの取得からPython/TypeScript SDKでの最初のリクエスト、エラーハンドリングとコストの目安まで、5分で始めるためのクイックスタートです。

API27SDK4Python17TypeScript24開発3

Claude API は、最初の1回さえ通してしまえば驚くほど扱いやすくなります。難しいのは仕組みの理解よりも「最小構成で確実に動かす順番」を知ることだと、個人開発でいくつものサービスをつないできて感じます。ここでは API キーの取得から Python / TypeScript SDK の最初のリクエストまでを、寄り道せず5分で通せるように並べました。後半では、動かした直後につまずきやすいエラー処理とコストの見積もりも添えています。

Claude API とは

Claude API は、自分のアプリケーションに Claude の能力を組み込むためのインターフェースです。Anthropic の開発者プラットフォームを通じて、テキスト生成、コード生成、分析、要約などの機能をプログラムから利用できます。

ℹ️
API の利用には Anthropic アカウントと API キーが必要です。無料クレジットが付与されるため、小規模な実験はすぐに始められます。

API キーの取得

  1. console.anthropic.com にアクセス
  2. アカウントを作成またはログイン
  3. 「API Keys」セクションで新しいキーを作成
  4. キーを安全な場所に保存(一度しか表示されません)
# 環境変数に設定
export ANTHROPIC_API_KEY="YOUR_API_KEY"

キーをソースコードに直書きしないことだけは、最初に徹底しておくと後で困りません。環境変数から読む形にしておけば、リポジトリへの誤コミットを防げます。

Python SDK

インストール

pip install anthropic

最初のリクエスト

import anthropic
 
client = anthropic.Anthropic()  # 環境変数 ANTHROPIC_API_KEY を自動で読み込む
 
message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Pythonで素数判定関数を書いてください"}
    ]
)
 
print(message.content[0].text)

model に渡す文字列は、公式のモデル一覧に載っている正確な名前を使います。ここを1文字でも間違えると 404 相当のエラーになるため、最初のつまずきはたいていここです。

ストリーミングレスポンス

リアルタイムに応答を受け取りたい場合:

with client.messages.stream(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "機械学習の基本概念を説明して"}
    ]
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

TypeScript SDK

インストール

npm install @anthropic-ai/sdk

最初のリクエスト

import Anthropic from "@anthropic-ai/sdk";
 
const client = new Anthropic(); // 環境変数 ANTHROPIC_API_KEY を自動で読み込む
 
const message = await client.messages.create({
  model: "claude-sonnet-5",
  max_tokens: 1024,
  messages: [
    { role: "user", content: "TypeScriptでFizzBuzzを実装して" }
  ],
});
 
console.log(message.content[0].text);

主要パラメータ

パラメータ説明
model使用モデルclaude-opus-4-8, claude-sonnet-5
max_tokens最大出力トークン数1024, 4096
temperatureランダム性(0〜1)0 = 決定的, 1 = 創造的
systemシステムプロンプト"あなたはPythonの専門家です"
stop_sequences停止文字列(この列に達すると生成を止める)["<END>"]

システムプロンプトの活用

message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    system="あなたはシニアソフトウェアエンジニアです。回答には必ずコード例を含め、パフォーマンスについてもコメントしてください。",
    messages=[
        {"role": "user", "content": "効率的なキャッシュ戦略について教えて"}
    ]
)
💡
システムプロンプトは Claude の振る舞いを一貫して制御する強力な手段です。専門家ペルソナの設定、出力形式の統一、ドメイン固有のルール適用などに活用してください。

エラーハンドリングの最小形

最初のサンプルが通ると、次に必ず出会うのがエラーです。実運用では「落ちたときにどう振る舞うか」まで決めて初めて、安心してリクエストを投げられます。SDK は例外の型を分けてくれているので、少なくともレート制限・入力エラー・その他の通信エラーの3種類は分けて受け止めておくと、原因の切り分けが速くなります。

import anthropic
 
client = anthropic.Anthropic()
 
try:
    message = client.messages.create(
        model="claude-sonnet-5",
        max_tokens=1024,
        messages=[{"role": "user", "content": "こんにちは"}],
    )
    print(message.content[0].text)
except anthropic.RateLimitError:
    # 429: 少し待って再試行する。指数バックオフが定石
    print("レート制限に達しました。時間を空けて再試行してください")
except anthropic.BadRequestError as e:
    # 400: モデル名の誤り・max_tokens 超過など、こちら側の入力ミス
    print(f"リクエストが不正です: {e}")
except anthropic.APIStatusError as e:
    # その他のサーバー側エラー。status_code で挙動を分ける
    print(f"APIエラー({e.status_code}): {e.message}")

私自身、Dolice Labs のサイト群を個人開発で回すなかで痛い目を見たのは、RateLimitError を握りつぶして即リトライし、かえって制限を悪化させたときでした。429 を受け取ったら「待ってから再試行」を必ず挟む。この一手間だけで、夜間に自動で回すバッチが安定します。

Tool Use(関数呼び出し)

Claude API は外部関数の呼び出しに対応しています:

import json
 
message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    tools=[
        {
            "name": "get_weather",
            "description": "指定された都市の天気を取得する",
            "input_schema": {
                "type": "object",
                "properties": {
                    "city": {
                        "type": "string",
                        "description": "都市名(例: 東京)"
                    }
                },
                "required": ["city"]
            }
        }
    ],
    messages=[
        {"role": "user", "content": "東京の天気を教えて"}
    ]
)

モデルの選び方

モデル特徴推奨用途
Claude Opus 4.8最高性能、深い推論複雑な分析、高品質コード生成
Claude Sonnet 5バランス型、高速日常的なタスク、チャットボット
Claude Haiku 4.5最速、低コスト大量処理、分類、要約

最初の1本は、まず Sonnet 5 で組むのが素直です。速度と品質のバランスがよく、動かしながら手応えを掴めます。精度が足りなければ Opus 4.8 へ上げ、逆に分類や要約を大量に回すなら Haiku 4.5 へ下げる——このように、動かしてから用途に合わせて調整するのが結局いちばん早い、というのが私の実感です。

コストの目安を最初に掴んでおく

API はトークン単位の従量課金です。最初の実験では無料クレジットで足りますが、本番に載せる前に単価の感覚を持っておくと、後で請求に驚かずに済みます。

Sonnet 5 は導入価格として入力100万トークンあたり2ドル・出力10ドルが設定されており、この価格は 2026年8月31日まで(以降は3ドル・15ドルに戻る予定)とされています。たとえば入力5万トークン・出力1万トークンのリクエストなら、おおよそ 0.1ドル + 0.1ドル = 0.2ドル前後という桁感です。

⚠️
本番環境では `max_tokens` を必要な分だけに絞り、レート制限の管理も併せて行ってください。出力トークンは入力より単価が高いため、長い応答を無制限に許すとコストが伸びやすくなります。

動かした直後につまずきやすい点

いちばん多いのが、先ほど触れたモデル名の指定ミスです。バージョン表記は更新されるため、記事や古いサンプルのモデル名をそのまま貼らず、公式ドキュメントで最新の文字列を確認してから渡すのが安全です。

次に出会いやすいのが max_tokens の扱いです。これは「出力」の上限であって入力の長さではありません。応答が途中で切れると感じたら、まず max_tokens を疑ってください。逆に大きくしすぎると、無駄な出力にコストを払うことになります。

環境変数の読み込み漏れも定番です。Anthropic()ANTHROPIC_API_KEY を自動で探しますが、ターミナルを開き直すと export が消えていることがあります。認証エラーが出たら、まず echo $ANTHROPIC_API_KEY で値が入っているかを確認するのが早道です。

次のステップ

  • Vision(画像入力) — 画像の分析や説明を API で実行
  • Tool Use の応用 — 複雑なワークフローの自動化
  • バッチ処理 — 大量のリクエストを効率的に処理
  • MCP 連携 — Model Context Protocol でサービス統合

まずは公式の最小サンプルをそのまま動かし、通ったら自分のユースケースの最小形に書き換える。エラー処理を1つ足し、コストの桁感を掴む。この順番で進めれば、5分で動いた最初の呼び出しが、そのまま本番で使える足場になります。お読みいただき、ありがとうございました。

シェア

お読みいただきありがとうございます

Claude Lab は広告なしで運営しており、サーバー費用などの運営コストはメンバーシップのご支援で賄っています。実装コード・ベンチマーク・本番設計パターンなど、実務でお役立ていただける記事を毎日更新しています。もし読んでよかったと感じていただけましたら、ぜひご覧ください。

  • コピー&ペーストで使える実装コード付き
  • 毎日新しい上級ガイドを追加
  • ¥580/月 または ¥2,480 の永久アクセス
メンバーシップを見る →

もしこの記事がお役に立ちましたら、チップ(¥150)で応援いただけると大変励みになります。広告なしでの運営を続けるため、皆さまのご支援が大きな力になっています。

関連記事

API & SDK2026-07-12
非ストリーミングの長い応答が10分の壁で黙って二重課金されていた — SDK既定のタイムアウトと自動リトライを設計し直す
Anthropic SDK の既定タイムアウト10分と自動リトライ2回が、長い非ストリーミング応答を裏で二重に走らせて課金することがあります。発生の仕組みと、ストリーミング切替・明示的な timeout/max_retries・ローカル台帳で止める実装を、実測値とともにまとめました。
API & SDK2026-04-11
OpenAIからClaude APIへ移行する:コード変換から本番ロールアウトまでの実践アーキテクチャ(2026)
OpenAI GPT-4からClaude APIへ移行する手順を、認証・メッセージ形式・ストリーミング・ツール使用の変換パターンからエラーハンドリング、ダウンタイムゼロの段階的ロールアウトまで実装コード付きで整理します。
API & SDK2026-03-15
Claude APIでAIチャットボットを実装する — ストリーミング・会話履歴・コスト最適化まで
Claude APIでAIチャットボットをゼロから実装する手順を、最小構成から順に積み上げて解説します。会話履歴の管理、ストリーミング応答、FastAPIでのWeb API公開、履歴のコスト最適化、エラーハンドリングとリトライまで、実際に動くPythonコードで完成形のクラスまで到達します。
📚RECOMMENDED BOOKS
大規模言語モデル入門
山田育矢
LLM開発
生成AIプロンプトエンジニアリング入門
我妻幸長
プロンプト
Claude CodeによるAI駆動開発入門
平川知秀
AI駆動開発
※ アフィリエイトリンクを含みます
もっと見る →