Claude Agent Toolkit

Claude Agent Toolkit

claude-code-sdk wrapper for enhanced developer experience with easy setup and runtime isolation using Docker

A Python framework that wraps claude-code-sdk to provide better developer experience through decorator-based tools, runtime isolation, and simplified agent development. Built for production safety with Docker containers that ensure controlled tool execution and consistent behavior across all environments.

Table of Contents

- Why Claude Agent Toolkit?
- When Should You Use This?
- Quick Start
- Installation & Setup
- Usage Examples
- Core Features
- Architecture
- Built-in Tools
- Creating Custom Tools
- FAQ
- Testing
- Contributing
- License

Why Claude Agent Toolkit?

The Problem
Working directly with claude-code-sdk presents two major challenges:
1. Complex Tool Integration - Manual MCP server setup, connection handling, and tool registration
2. Runtime Safety - Need for controlled tool execution with clean, isolated environments

The Solution
Claude Agent Toolkit solves these issues through:
- 🎯 Decorator-Based Tools - Simple @tool decorator converts any Python function into a Claude-compatible tool
- 🐳 Runtime Isolation - Docker containers provide safe, controlled execution with only your specified tools
- ⚡ Zero Configuration - Automatic MCP server management and tool discovery

*"An intuitive and stable development experience similar to Google's ADK"*

See the Difference

Before (Direct claude-code-sdk):

After (Claude Agent Toolkit):

Comparison Table

Quick Start

Installation & Setup

Prerequisites

- Python 3.12+ with uv package manager
- Docker Desktop (required for Docker executor, recommended)
- Claude Code OAuth Token - Get from Claude Code

Install the Package

Set Your OAuth Token

Get your token by running claude…