Claude Agent SDK Quickstart

A hands-on tutorial for building intelligent agents with the Claude Agent SDK.

Prerequisites

• Python 3.8+
• Anthropic API key
• Claude Code CLI: npm install -g @anthropic-ai/claude-code

Installation

pip install claude-agent-sdk

What's Inside

This repository contains an interactive Jupyter notebook that teaches you how to:

• Use query() for one-off tasks and ClaudeSDKClient for continuous conversations
• Configure agents with custom behaviors and permission modes
• Work with built-in tools (Read, Write, Bash, etc.)
• Create specialized agents with AgentDefinition
• Build custom tools using the @tool decorator and MCP servers

Quick Start

1. Clone the repository
2. Open claude_agent_sdk.ipynb in Jupyter
3. Follow the walkthrough from Part 1 to Part 8

Learn More

• Claude Agent SDK Documentation
• Anthropic API Reference