สร้าง Autonomous AI Agent ด้วย Claude Agent SDK — คู่มือครบ

pip install claude-agent-sdk

npm install -g @anthropic-ai/claude-code

curl -fsSL https://claude.ai/install.sh | bash

export ANTHROPIC_API_KEY=your_key_here

# app.py
import asyncio
from claude_agent_sdk import query, AssistantMessage, TextBlock, ResultMessage

async def main():
    async for message in query(prompt="Hello, how are you?"):
        if isinstance(message, AssistantMessage):
            for block in message.content:
                if isinstance(block, TextBlock):
                    print(block.text)
        if isinstance(message, ResultMessage):
            print(f"Cost: ${message.total_cost_usd}")
            print(f"Usage: {message.usage}")

asyncio.run(main())

import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions

async def main():
    options = ClaudeAgentOptions(
        allowed_tools=["Read", "Write", "Bash"],
        permission_mode="acceptEdits",
        cwd="/path/to/your/project"
    )
    async for message in query(
        prompt="Create a file called greeting.txt with 'Hello, World!' and verify its contents",
        options=options
    ):
        if isinstance(message, AssistantMessage):
            for block in message.content:
                if isinstance(block, TextBlock):
                    print(block.text)

asyncio.run(main())

import asyncio
from typing import Any
from claude_agent_sdk import query, ClaudeAgentOptions, tool, create_sdk_mcp_server

@tool("greet", "Greet a user by name", {"name": str})
async def greet(args: dict[str, Any]) -> dict[str, Any]:
    name = args["name"]
    return {"content": [{"type": "text", "text": f"Hello {name}! Welcome to the system."}]}

@tool("calculate", "Perform basic arithmetic", {"operation": str, "a": float, "b": float})
async def calculate(args: dict[str, Any]) -> dict[str, Any]:
    operation = args["operation"]
    a, b = args["a"], args["b"]
    operations = {
        "add": a + b, "subtract": a - b, "multiply": a * b,
        "divide": a / b if b != 0 else "Error: Division by zero"
    }
    result = operations.get(operation, "Unknown operation")
    return {"content": [{"type": "text", "text": f"Result: {result}"}]}

server = create_sdk_mcp_server(name="my_tools", version="1.0.0", tools=[greet, calculate])

async def main():
    options = ClaudeAgentOptions(
        mcp_servers={"my": server},
        allowed_tools=["mcp__my__greet", "mcp__my__calculate"],
    )
    async for message in query(
        prompt="Greet Mason, then calculate 15 multiplied by 4",
        options=options
    ):
        if isinstance(message, AssistantMessage):
            for block in message.content:
                if isinstance(block, TextBlock):
                    print(block.text)

asyncio.run(main())

options = ClaudeAgentOptions(
    system_prompt={
        "type": "preset",
        "preset": "claude_code",
        "append": "You are an expert Python developer specializing in FastAPI."
    },
    setting_sources=["project"],  # Load CLAUDE.md and project configs
    allowed_tools=["Read", "Write", "Edit", "Bash"],
    permission_mode="acceptEdits",
    cwd="/path/to/repo",
    model="claude-sonnet-4-5-20250929"
)

import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions

async def main():
    options = ClaudeAgentOptions(
        system_prompt="You are an expert Python web developer.",
        allowed_tools=["Read", "Write", "Bash"],
        permission_mode="acceptEdits",
        cwd="./projects/web-server"
    )
    prompt = """
    Create a production-ready FastAPI web server with:
    - Health check endpoint at /health
    - User registration endpoint at /users
    - Proper error handling
    - Environment variable configuration
    - Basic logging setup
    Also create a requirements.txt file.
    """
    async for message in query(prompt=prompt, options=options):
        if isinstance(message, AssistantMessage):
            for block in message.content:
                if isinstance(block, TextBlock):
                    print(block.text)

asyncio.run(main())