Agent SDK入門 — Python / TypeScriptで最小エージェントを組む

# Python
pip install claude-agent-sdk
 
# TypeScript
npm install @anthropic-ai/claude-agent-sdk zod

import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions
from claude_agent_sdk.types import AssistantMessage, TextBlock, ResultMessage
 
async def main() -> None:
    options = ClaudeAgentOptions(
        allowed_tools=["Read", "Glob", "Grep"],
        permission_mode="default",
    )
 
    async for message in query(
        prompt="このディレクトリの TypeScript ファイルを 5 つまで挙げて",
        options=options,
    ):
        if isinstance(message, AssistantMessage):
            for block in message.content:
                if isinstance(block, TextBlock):
                    print(block.text)
        elif isinstance(message, ResultMessage) and message.subtype == "success":
            print(f"[done] cost={message.total_cost_usd}")
 
asyncio.run(main())

import { query } from "@anthropic-ai/claude-agent-sdk";
 
async function main() {
  for await (const message of query({
    prompt: "このディレクトリの TypeScript ファイルを 5 つまで挙げて",
    options: {
      model: "claude-opus-4-1",
      maxTurns: 5,
      permissionMode: "default",
      allowedTools: ["Read", "Glob", "Grep"],
    },
  })) {
    if (message.type === "assistant") {
      for (const block of message.message.content) {
        if (block.type === "text") console.log(block.text);
      }
    } else if (message.type === "result" && message.subtype === "success") {
      console.log(`[done] cost=${message.total_cost_usd}`);
    }
  }
}
 
main();

from typing import Any
import httpx
from claude_agent_sdk import tool, create_sdk_mcp_server
 
@tool(
    "get_temperature",
    "指定した緯度経度の現在気温を取得する",
    {"latitude": float, "longitude": float},
)
async def get_temperature(args: dict[str, Any]) -> dict[str, Any]:
    async with httpx.AsyncClient() as client:
        res = await client.get(
            "https://api.open-meteo.com/v1/forecast",
            params={
                "latitude": args["latitude"],
                "longitude": args["longitude"],
                "current": "temperature_2m",
            },
        )
    data = res.json()
    return {
        "content": [
            {"type": "text", "text": f"気温: {data['current']['temperature_2m']}°C"}
        ]
    }
 
weather_server = create_sdk_mcp_server(
    name="weather",
    version="1.0.0",
    tools=[get_temperature],
)

import { tool, createSdkMcpServer } from "@anthropic-ai/claude-agent-sdk";
import { z } from "zod";
 
const getTemperature = tool(
  "get_temperature",
  "指定した緯度経度の現在気温を取得する",
  {
    latitude: z.number().describe("緯度"),
    longitude: z.number().describe("経度"),
  },
  async ({ latitude, longitude }) => {
    const res = await fetch(
      `https://api.open-meteo.com/v1/forecast?latitude=${latitude}&longitude=${longitude}&current=temperature_2m`,
    );
    const data: any = await res.json();
    return {
      content: [{ type: "text", text: `気温: ${data.current.temperature_2m}°C` }],
    };
  },
  { annotations: { readOnlyHint: true } },
);
 
export const weatherServer = createSdkMcpServer({
  name: "weather",
  version: "1.0.0",
  tools: [getTemperature],
});

import asyncio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions
 
async def main() -> None:
    options = ClaudeAgentOptions(allowed_tools=["Read", "Edit", "Glob", "Grep"])
    async with ClaudeSDKClient(options=options) as client:
        await client.query("auth モジュールを読んで設計上の問題点を挙げて")
        async for _ in client.receive_response():
            pass
        # ↑ と同じセッション
        await client.query("今指摘してくれた点のうち最優先のものを直して")
        async for _ in client.receive_response():
            pass
 
asyncio.run(main())

import { query } from "@anthropic-ai/claude-agent-sdk";
 
await consume(query({ prompt: "auth モジュールを読んで問題点を挙げて" }));
await consume(
  query({
    prompt: "今指摘してくれた点のうち最優先のものを直して",
    options: { continue: true, allowedTools: ["Read", "Edit"] },
  }),
);
 
async function consume(q: AsyncIterable<unknown>) {
  for await (const _ of q) {
    // ドロップ
  }
}