Обзор Claude Agent SDK 2026

SDK для создания AI-агентов на базе Claude: tool use, computer use, MCP, multi-agent

📝 2088 words
Обзор Claude Agent SDK 2026 — фреймворк для AI-агентов от Anthropic

Обзор Claude Agent SDK 2026

Claude Agent SDK — официальный фреймворк от Anthropic для создания AI-агентов на базе Claude (Opus 4, Sonnet 4, Haiku). Выпущен в конце 2024 года и с тех пор активно развивается. Предоставляет инструменты для function calling, компьютерного зрения (computer use), долгоживущих задач и MCP-серверов (Model Context Protocol).

Сайт Документация
INPUT LAYER User Prompt / Task Многошаговые инструкции System Prompt + Rules Constitutional AI constraints MCP Servers External context providers AGENT CORE Claude Model (Opus/Sonnet/Haiku) Anthropic API | reasoning + tool use 200K context | Opus 4 = top reasoning Memory & State Conversation history | Context cache Agent Loop (Tool-Use Cycle) Think → Act → Observe → Repeat Computer Use (Screenshot + Action) {click, type, scroll, screenshot} OUTPUT / TOOLS Function Calls (tool_use) JSON Schema → ваши функции Text/JSON Responses Final answer after tool chain Computer Use Actions Docker sandbox → OS GUI ops MCP Server Integration Filesystem | DB | Web | GitHub Logging & Observability Step traces | Token counts Runtime: Python 3.10+ | TypeScript 5.x | Docker (Computer Use) | Anthropic API (api.anthropic.com) CYCLE: Prompt → Claude thinks → tool_use block → execute function → append result → Claude thinks → ... → final_text

Архитектура Claude Agent SDK

Ключевые возможности

🔧Function Calling (Tool Use): Определяете JSON-схемы инструментов — Claude решает, какой инструмент вызвать и с какими параметрами. SDK автоматически обрабатывает цикл «вызов → выполнение → передача результата обратно».
🖥️Computer Use: Claude может управлять компьютером: видит скриншот, отдаёт команды click/type/scroll. Запускается в Docker-песочнице. Прорывная фича для автоматизации GUI-задач.
🔌Model Context Protocol (MCP): Открытый протокол Anthropic для подключения внешнего контекста — файловые системы, базы данных, API, GitHub. MCP-серверы предоставляют Claude данные без необходимости писать кастомные интеграции.
🧵Многошаговые агенты: SDK поддерживает долгоживущие сессии с сохранением контекста. Агент может работать минуты и часы, выполняя цепочки из десятков tool calls.
📦Python и TypeScript: Два официальных SDK — anthropic (Python) и @anthropic-ai/sdk (TypeScript). Оба поддерживают streaming, tool use и computer use.
🛡️Constitutional AI встроен: Каждый вызов Claude проходит через встроенные ограничения Claude (безопасность, честность, отказ от вредных инструкций). Не нужно добавлять guardrails отдельно.
Prompt Caching: Claude автоматически кеширует system prompt и повторяющиеся блоки. Снижает latency и стоимость на 90% для повторяющихся запросов в рамках одной сессии.

Характеристики и тарифы (модели + SDK)

МодельКонтекстСтоимость (вход / выход)Tool UseComputer UsePrompt Caching
Claude Opus 4200K токенов$15 / $75 за 1M
Claude Sonnet 4200K токенов$3 / $15 за 1M
Claude Haiku 3.5200K токенов$0.80 / $4 за 1M⚠️ Beta

SDK — бесплатный, open-source (MIT). Платите только за API-вызовы к моделям Claude.

Prompt Caching (write): +25% к стоимости записи, чтение из кеша — 10% от полной стоимости. Экономия до 90%.

Установка и первые шаги

Шаг 1: Установка SDK

# Python
pip install anthropic

# TypeScript
npm install @anthropic-ai/sdk

# API-ключ
export ANTHROPIC_API_KEY="sk-ant-..."

Шаг 2: Простейший агент с Tool Use

import anthropic

client = anthropic.Anthropic()

tools = [{
    "name": "get_weather",
    "description": "Get weather for a city",
    "input_schema": {
        "type": "object",
        "properties": {
            "city": {"type": "string"}
        },
        "required": ["city"]
    }
}]

response = client.messages.create(
    model="claude-sonnet-4-20250514",
    max_tokens=1024,
    tools=tools,
    messages=[{"role": "user",
               "content": "Какая погода в Берлине?"}]
)

# Claude вернёт tool_use блок:
# {"name": "get_weather", "input": {"city": "Berlin"}}

Шаг 3: Computer Use (Docker)

# Запуск Docker-контейнера с песочницей
docker run -d -p 5900:5900 --name claude-computer anthropics/computer-use-demo

# Python: агент видит скриншоты и управляет ОС
from anthropic import ComputerUse

agent = ComputerUse(model="claude-sonnet-4-20250514")
result = agent.run("Open Firefox, go to wikipedia.org, search for 'AI'")

Шаг 4: MCP-сервер

# Файл: .mcp.json (конфигурация MCP-серверов)
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-filesystem", "/home/user"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-github"]
    }
  }
}

Сравнение с аналогами

КритерийClaude Agent SDKOpenAI Agents SDKLangChain/LangGraphCrewAI
ВендорAnthropic (офиц.)OpenAI (офиц.)Open-source / LangChainOpen-source
Tool Use / Function Call✅ Нативный✅ Нативный✅ Через модели✅ Через модели
Computer Use✅ Уникальная фича❌ Нет❌ Нет❌ Нет
MCP-протокол✅ Стандарт Anthropic❌ Нет⚠️ Частично❌ Нет
Мультиагентность⚠️ Вручную✅ Swarm/Handoff✅ LangGraph✅ Из коробки
Prompt Caching✅ Автоматически✅ Automatic (новое)❌ Ручное❌ Ручное
ЯзыкиPython, TypeScriptPython (TS — нет)Python, JSPython
Контекстное окно200K токенов128K токеновЗависит от моделиЗависит от модели
ЛицензияMIT (SDK)Apache 2.0MITMIT

Ключевые метрики

200K

Макс. контекстное окно (токенов)

90%

Экономия с Prompt Caching

$0.80–$75

Стоимость за 1M токенов

~2.5 сек

Time-to-First-Token (Sonnet 4)

10K+

MCP-серверов в экосистеме

v0.50+

Версия SDK (июнь 2025)

Плюсы и минусы

Плюсы

  • Computer Use — уникальная возможность управления GUI
  • MCP-протокол как открытый стандарт для контекста агентов
  • Prompt Caching — огромная экономия для production-нагрузок
  • Официальная поддержка и документация от Anthropic
  • Контекст 200K — лучший в классе
  • Constitutional AI из коробки — безопасность без лишних настроек
  • Python + TypeScript — покрытие двух главных экосистем

Минусы

  • SDK относительно молодой (меньше года) — API может меняться
  • Нет встроенной мультиагентности (как у CrewAI или Swarm)
  • Привязка к одному вендору (Anthropic) — нельзя подставить open-source модель
  • Opus 4 дорогой ($75/M выходных токенов) — production может быть затратным
  • Computer Use требует Docker и работает медленно (скриншоты)
  • Меньше интеграций «из коробки» чем у LangChain (500+ интеграций)
★★★★☆
4.3 / 5

Claude Agent SDK — лучший выбор, если вы строите агентов на Claude. MCP-протокол и Computer Use — две killer features, которых нет ни у кого. Для простых RAG и tool-calling агентов — берите Sonnet 4, это лучший баланс цена/качество на рынке. Для сложных reasoning-задач — Opus 4. Главный минус — вендор-лок: если вам нужна мульти-модельная стратегия, смотрите LangChain. Но для экосистемы Anthropic это must-have инструмент.

Начните с Claude Agent SDK

SDK бесплатен и опенсорсен. Нужен только API-ключ Anthropic.

Документация и Quickstart

Обзор подготовлен Qantcore Labs — июнь 2025