Agent SDK

Обзор Agent SDK

Создавайте производственные AI-агентов с Claude Code как библиотеку

Claude Code SDK был переименован в Claude Agent SDK. Если вы переходите со старого SDK, см. Руководство по миграции.

Создавайте AI-агентов, которые автономно читают файлы, выполняют команды, ищут в веб-сети, редактируют код и многое другое. Agent SDK дает вам те же инструменты, цикл агента и управление контекстом, которые питают Claude Code, программируемые на Python и TypeScript.

import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions

async def main():
    async for message in query(
        prompt="Find and fix the bug in auth.py",
        options=ClaudeAgentOptions(allowed_tools=["Read", "Edit", "Bash"])
    ):
        print(message)  # Claude reads the file, finds the bug, edits it

asyncio.run(main())

Agent SDK включает встроенные инструменты для чтения файлов, выполнения команд и редактирования кода, поэтому ваш агент может начать работу немедленно без необходимости реализации выполнения инструментов. Ознакомьтесь с быстрым стартом или изучите реальных агентов, созданных с помощью SDK:

Быстрый старт

Создайте агента по исправлению ошибок за несколько минут

Примеры агентов

Помощник по электронной почте, исследовательский агент и многое другое

Возможности

Все, что делает Claude Code мощным, доступно в SDK:

Функции Claude Code

SDK также поддерживает конфигурацию на основе файловой системы Claude Code. Чтобы использовать эти функции, установите setting_sources=["project"] (Python) или settingSources: ['project'] (TypeScript) в ваших опциях.

Функция	Описание	Расположение
Skills	Специализированные возможности, определенные в Markdown	`.claude/skills/SKILL.md`
Slash commands	Пользовательские команды для обычных задач	`.claude/commands/*.md`
Memory	Контекст проекта и инструкции	`CLAUDE.md` или `.claude/CLAUDE.md`
Plugins	Расширяйте пользовательскими командами, агентами и MCP серверами	Программно через опцию `plugins`

Начало работы

Установите Claude Code
SDK использует Claude Code как свою среду выполнения:
См. Claude Code setup для Windows и других опций.
Установите SDK
Установите ваш API ключ
export ANTHROPIC_API_KEY=your-api-key
Получите ваш ключ из Console.
SDK также поддерживает аутентификацию через поставщиков API третьих сторон:
- Amazon Bedrock: Установите переменную окружения CLAUDE_CODE_USE_BEDROCK=1 и настройте учетные данные AWS
- Google Vertex AI: Установите переменную окружения CLAUDE_CODE_USE_VERTEX=1 и настройте учетные данные Google Cloud
- Microsoft Foundry: Установите переменную окружения CLAUDE_CODE_USE_FOUNDRY=1 и настройте учетные данные Azure
Если не одобрено ранее, мы не разрешаем разработчикам третьих сторон предлагать вход Claude.ai или ограничения скорости для своих продуктов, включая агентов, созданных на Claude Agent SDK. Вместо этого используйте методы аутентификации с API ключом, описанные в этом документе.

Запустите вашего первого агента

Этот пример создает агента, который выводит список файлов в вашем текущем каталоге, используя встроенные инструменты.

import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions

async def main():
    async for message in query(
        prompt="What files are in this directory?",
        options=ClaudeAgentOptions(allowed_tools=["Bash", "Glob"])
    ):
        print(message)

asyncio.run(main())

Готовы создавать? Следуйте Быстрому старту, чтобы создать агента, который находит и исправляет ошибки за несколько минут.

Сравните Agent SDK с другими инструментами Claude

Платформа Claude предлагает несколько способов создания с Claude. Вот как Agent SDK вписывается:

Журнал изменений

Просмотрите полный журнал изменений для обновлений SDK, исправлений ошибок и новых функций:

TypeScript SDK: View CHANGELOG.md
Python SDK: View CHANGELOG.md

Сообщение об ошибках

Если вы столкнулись с ошибками или проблемами с Agent SDK:

TypeScript SDK: Report issues on GitHub
Python SDK: Report issues on GitHub

Лицензия и условия

Использование Claude Agent SDK регулируется Коммерческими условиями обслуживания Anthropic, включая случаи, когда вы используете его для питания продуктов и услуг, которые вы предоставляете своим собственным клиентам и конечным пользователям, за исключением случаев, когда конкретный компонент или зависимость покрыты другой лицензией, как указано в файле LICENSE этого компонента.

Следующие шаги

Быстрый старт

Создайте агента, который находит и исправляет ошибки за несколько минут

Примеры агентов

Помощник по электронной почте, исследовательский агент и многое другое

TypeScript SDK

Полная справка API TypeScript и примеры

Python SDK

Полная справка API Python и примеры

Agent SDK

Обзор Agent SDK

Создавайте производственные AI-агентов с Claude Code как библиотеку

Claude Code SDK был переименован в Claude Agent SDK. Если вы переходите со старого SDK, см. Руководство по миграции.

import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions

async def main():
    async for message in query(
        prompt="Find and fix the bug in auth.py",
        options=ClaudeAgentOptions(allowed_tools=["Read", "Edit", "Bash"])
    ):
        print(message)  # Claude reads the file, finds the bug, edits it

asyncio.run(main())

Быстрый старт

Создайте агента по исправлению ошибок за несколько минут

Примеры агентов

Помощник по электронной почте, исследовательский агент и многое другое

Возможности

Все, что делает Claude Code мощным, доступно в SDK:

Функции Claude Code

Функция	Описание	Расположение
Skills	Специализированные возможности, определенные в Markdown	`.claude/skills/SKILL.md`
Slash commands	Пользовательские команды для обычных задач	`.claude/commands/*.md`
Memory	Контекст проекта и инструкции	`CLAUDE.md` или `.claude/CLAUDE.md`
Plugins	Расширяйте пользовательскими командами, агентами и MCP серверами	Программно через опцию `plugins`

Начало работы

Установите Claude Code
SDK использует Claude Code как свою среду выполнения:
См. Claude Code setup для Windows и других опций.
Установите SDK
Установите ваш API ключ
export ANTHROPIC_API_KEY=your-api-key
Получите ваш ключ из Console.
SDK также поддерживает аутентификацию через поставщиков API третьих сторон:
- Amazon Bedrock: Установите переменную окружения CLAUDE_CODE_USE_BEDROCK=1 и настройте учетные данные AWS
- Google Vertex AI: Установите переменную окружения CLAUDE_CODE_USE_VERTEX=1 и настройте учетные данные Google Cloud
- Microsoft Foundry: Установите переменную окружения CLAUDE_CODE_USE_FOUNDRY=1 и настройте учетные данные Azure
Если не одобрено ранее, мы не разрешаем разработчикам третьих сторон предлагать вход Claude.ai или ограничения скорости для своих продуктов, включая агентов, созданных на Claude Agent SDK. Вместо этого используйте методы аутентификации с API ключом, описанные в этом документе.

Запустите вашего первого агента

import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions

async def main():
    async for message in query(
        prompt="What files are in this directory?",
        options=ClaudeAgentOptions(allowed_tools=["Bash", "Glob"])
    ):
        print(message)

asyncio.run(main())

Сравните Agent SDK с другими инструментами Claude

Платформа Claude предлагает несколько способов создания с Claude. Вот как Agent SDK вписывается:

Журнал изменений

Просмотрите полный журнал изменений для обновлений SDK, исправлений ошибок и новых функций:

TypeScript SDK: View CHANGELOG.md
Python SDK: View CHANGELOG.md

Сообщение об ошибках

Если вы столкнулись с ошибками или проблемами с Agent SDK:

TypeScript SDK: Report issues on GitHub
Python SDK: Report issues on GitHub

Лицензия и условия

Следующие шаги

Быстрый старт

Создайте агента, который находит и исправляет ошибки за несколько минут

Примеры агентов

Помощник по электронной почте, исследовательский агент и многое другое

TypeScript SDK

Полная справка API TypeScript и примеры

Python SDK

Полная справка API Python и примеры

Обзор Agent SDK

Возможности

Функции Claude Code

Начало работы

Сравните Agent SDK с другими инструментами Claude

Журнал изменений

Сообщение об ошибках

Рекомендации по брендингу

Лицензия и условия

Следующие шаги

Обзор Agent SDK

Возможности

Функции Claude Code

Начало работы

Сравните Agent SDK с другими инструментами Claude

Журнал изменений

Сообщение об ошибках

Рекомендации по брендингу

Лицензия и условия

Следующие шаги