Claude Agent SDK (Python): build your own agent on Claude Code's engine

Minimal

import anyio
from claude_agent_sdk import query, ClaudeAgentOptions

async def main():
    opts = ClaudeAgentOptions(
        system_prompt="You are a read-only code reviewer",
        allowed_tools=["Read", "Grep", "Glob"],
        cwd="./my-repo", max_turns=5)
    async for msg in query(prompt="Find error handling without logging", options=opts):
        print(msg)

anyio.run(main)

A custom tool in Python

from claude_agent_sdk import tool, create_sdk_mcp_server, ClaudeAgentOptions

@tool("get_sprint", "Get the current sprint", {"team": str})
async def get_sprint(args):
    data = await jira_client.current_sprint(args["team"])  # your code
    return {"content": [{"type": "text", "text": str(data)}]}

server = create_sdk_mcp_server(name="pm", version="1.0.0", tools=[get_sprint])
opts = ClaudeAgentOptions(mcp_servers={"pm": server},
                          allowed_tools=["mcp__pm__get_sprint"])

Key options

Docs: anthropics/claude-agent-sdk-python · Agent SDK — Python reference