Claude Agent SDK 入门
Claude Agent SDK を使用して AI Agent アプリケーションを構築する方法を学ぶ
Claude Agent SDK 入門¶
Claude Agent SDK は、Claude モデルに基づいた AI Agent アプリケーションを構築するための Anthropic 公式開発キットです。Claude Code（CLI ツール）とは異なり、SDK は開発者を対象としており、Claude の能力を自分のアプリケーションに統合できます。
Claude Agent SDK とは？¶
Claude Agent SDK は、以下を作成できるアプリケーションを構築するためのビルディングブロックを提供します：
- 自然言語の指示を理解し、複雑なタスクを実行
- ツールを使用（検索、コード実行、ファイル操作など）
- マルチターン対話のコンテキストを維持
- 外部サービスに接続（MCP サーバー経由）
SDK のインストール¶
Python SDK¶
pip install anthropic
TypeScript SDK¶
npm install @anthropic-ai/sdk
クイックスタート¶
基本的なメッセージ呼び出し¶
from anthropic import Anthropic
# QCode.cc API 経由
client = Anthropic(
base_url="https://api.qcode.cc/claude/v1",
api_key="cr_your_api_key"
)
message = client.messages.create(
model="claude-opus-4-7-20250514",
max_tokens=4096,
messages=[
{"role": "user", "content": "RESTful API について説明してください"}
]
)
print(message.content[0].text)
ストリーミング応答¶
with client.messages.stream(
model="claude-opus-4-7-20250514",
max_tokens=1024,
messages=[
{"role": "user", "content": "Python のクイックソート関数を書いてください"}
]
) as stream:
for text in stream.text_stream:
print(text, end="", flush=True)
ツールの使用（Tool Use）¶
Tool Use は Agent のコア機能で、モデルが外部ツールを呼び出すことを可能にします。
ツールの定義¶
from anthropic import Anthropic
client = Anthropic(
base_url="https://api.qcode.cc/claude/v1",
api_key="cr_your_api_key"
)
# 検索ツールを定義
tools = [
{
"name": "search_web",
"description": "ウェブで検索して情報を取得",
"input_schema": {
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "検索キーワード"
}
},
"required": ["query"]
}
}
]
# ツール付きでメッセージを送信
message = client.messages.create(
model="claude-opus-4-7-20250514",
max_tokens=4096,
messages=[
{"role": "user", "content": "(15 + 25) * 2 を計算してください"}
],
tools=tools
)
# ツール呼び出しを処理
for content in message.content:
if content.type == "text":
print(content.text)
elif content.type == "tool_use":
print(f"ツール呼び出し: {content.name}")
QCode.cc 設定¶
import os
# 方法 1: 環境変数
os.environ["ANTHROPIC_BASE_URL"] = "https://api.qcode.cc/claude/v1"
os.environ["ANTHROPIC_API_KEY"] = "cr_your_key"
client = Anthropic() # 環境変数を自動読み取り
# 方法 2: 深圳直結（中国推奨）
client = Anthropic(
base_url="http://103.236.53.153/api/claude/v1",
api_key="cr_your_key"
)
次のステップ¶
- API リファレンス - 完全な API パラメータ説明
- モデル選択ガイド - 適切なモデルの