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:

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

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

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

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

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

Установите SDK
Установите ваш API ключ
Получите API ключ из Console, затем установите его как переменную окружения:
export ANTHROPIC_API_KEY=your-api-key
SDK также поддерживает аутентификацию через сторонних поставщиков API:
- Amazon Bedrock: установите переменную окружения CLAUDE_CODE_USE_BEDROCK=1 и настройте учетные данные AWS
- Google Vertex AI: установите переменную окружения CLAUDE_CODE_USE_VERTEX=1 и настройте учетные данные Google Cloud
- Microsoft Azure: установите переменную окружения CLAUDE_CODE_USE_FOUNDRY=1 и настройте учетные данные Azure
Подробнее см. в руководствах по настройке для Bedrock, Vertex AI или Azure AI Foundry.
Если не одобрено ранее, Anthropic не разрешает сторонним разработчикам предлагать вход в 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"])
    ):
        if hasattr(message, "result"):
            print(message.result)

asyncio.run(main())

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

Возможности

Все, что делает 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`

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

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

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

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

TypeScript SDK: просмотр CHANGELOG.md
Python SDK: просмотр CHANGELOG.md

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

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

TypeScript SDK: сообщить об ошибках на GitHub
Python SDK: сообщить об ошибках на GitHub

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

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

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

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

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

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

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

TypeScript SDK

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

Python SDK

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

Was this page helpful?

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())

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

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

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

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

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

Установите SDK
Установите ваш API ключ
Получите API ключ из Console, затем установите его как переменную окружения:
export ANTHROPIC_API_KEY=your-api-key
SDK также поддерживает аутентификацию через сторонних поставщиков API:
- Amazon Bedrock: установите переменную окружения CLAUDE_CODE_USE_BEDROCK=1 и настройте учетные данные AWS
- Google Vertex AI: установите переменную окружения CLAUDE_CODE_USE_VERTEX=1 и настройте учетные данные Google Cloud
- Microsoft Azure: установите переменную окружения CLAUDE_CODE_USE_FOUNDRY=1 и настройте учетные данные Azure
Подробнее см. в руководствах по настройке для Bedrock, Vertex AI или Azure AI Foundry.
Если не одобрено ранее, Anthropic не разрешает сторонним разработчикам предлагать вход в 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"])
    ):
        if hasattr(message, "result"):
            print(message.result)

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`

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

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

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

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

TypeScript SDK: просмотр CHANGELOG.md
Python SDK: просмотр CHANGELOG.md

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

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

TypeScript SDK: сообщить об ошибках на GitHub
Python SDK: сообщить об ошибках на GitHub

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

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

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

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

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

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

TypeScript SDK

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

Python SDK

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

Was this page helpful?

Обзор Agent SDK

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

Возможности

Функции Claude Code

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

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

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

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

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

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

Обзор Agent SDK

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

Возможности

Функции Claude Code

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

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

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

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

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

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