Claude API 入門：アプリにClaude を組み込む方法

Claude APIとは何か

Claude APIは、Anthropicの生成AIモデルを自社アプリや業務ツールに組み込むための開発者向けインターフェースです。2025年時点では、Messages APIが基本となっており、チャット、要約、分類、コード補助、社内ナレッジ検索の応答生成などを比較的シンプルに実装できます。

初心者が最初に押さえるべきポイントは次の3つです。

• APIキーを安全に管理する：ソースコードへ直書きしない
• Messages APIで最小構成を作る：まずは1往復の応答から始める
• ストリーミングとトークン管理を理解する：体感速度とコストに直結する

この記事では、Python/TypeScriptの導入から、最小チャットボット、ストリーミング、料金の考え方までを実装目線で整理します。

始め方：APIキー取得と安全な設定

まずAnthropicの開発者コンソールでAPIキーを発行します。発行後は環境変数で管理するのが基本です。GitHubへ誤ってコミットすると即リスクになるため、.envやクラウドのシークレット管理を使いましょう。

Pythonでの設定例

export ANTHROPIC_API_KEY="your_api_key_here"

Node.js/TypeScriptでの設定例

export ANTHROPIC_API_KEY="your_api_key_here"

ローカル開発では python-dotenv や dotenv を使っても構いませんが、本番ではVercel、AWS Secrets Manager、Google Secret Managerなどの利用をおすすめします。

SDKのインストール

Claude APIはHTTPで直接呼べますが、最初は公式SDKを使うほうが速いです。

Python

pip install anthropic

TypeScript / Node.js

npm install @anthropic-ai/sdk

HTTP直叩きよりSDKの利点は、認証設定、ストリーミング処理、型補完の扱いやすさにあります。特にTypeScriptではレスポンス構造を追いやすく、保守性が上がります。

Messages APIの基本

Claude APIの中心はMessages APIです。概念はシンプルで、model、max_tokens、messagesを指定して応答を取得します。会話履歴も自前で保持して毎回送る形が基本です。

Pythonの最小例

from anthropic import Anthropic
import os

client = Anthropic(api_key=os.environ["ANTHROPIC_API_KEY"])

response = client.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=300,
    system="あなたは簡潔で実務的な日本語アシスタントです。",
    messages=[
        {"role": "user", "content": "ECサイトの商品説明文を100文字で作ってください。防水バッグです。"}
    ]
)

print(response.content[0].text)

TypeScriptの最小例