Главная › Claude Code › SDK агента
ОбзорУстановкаСправочник CLIЦены и лимитыAgent SDKНавыки и плагиныGitHubВеб, настольное приложение и IDEМоделиОшибкиОткрытый исходный код?Практическое руководствоДля студентовАвтоматизация QAСравнение с CursorСравнение с Codex и OpenCodeСубагентыХукиMCPЭкосистемаVS CodeOpenRouterОграничения частоты запросовРуководство на китайском языке
Последнее обновление: 11 октября 2026

Claude Code SDK, теперь Claude Agent SDK

Тот же цикл работы агента, который выполняется в вашем терминале, доступен в виде библиотеки. Anthropic переименовала Claude Code SDK в Claude Agent SDK, когда стало ясно, что люди создают с его помощью далеко не только инструменты для написания кода.

TLDR

  • Python: pip install claude-agent-sdk; TypeScript: npm install @anthropic-ai/claude-agent-sdk.
  • Вы получаете полноценного агента — инструменты для работы с файлами, bash, субагенты, MCP — с управлением из кода и функциями обратного вызова для проверки разрешений.
  • SDK считывает ANTHROPIC_BASE_URL и ANTHROPIC_API_KEY так же, как CLI, поэтому применяется тарификация шлюза.

Два способа автоматизировать Claude Code

Самый простой вариант — режим вывода CLI — claude -p из любого языка, с выводом в формате JSON. Полный набор возможностей предоставляет Agent SDK: он позволяет управлять циклом работы, набором инструментов, хуками и разрешениями через объекты.

Python

import anyio
from claude_agent_sdk import query, ClaudeAgentOptions

async def main():
    options = ClaudeAgentOptions(
        allowed_tools=["Read", "Edit", "Bash"],
        max_turns=8,
    )
    async for message in query(
        prompt="add type hints to utils.py and run the tests",
        options=options,
    ):
        print(message)

anyio.run(main)

TypeScript

import { query } from "@anthropic-ai/claude-agent-sdk";

for await (const message of query({
  prompt: "find and fix the flaky test in this repo",
  options: { allowedTools: ["Read", "Edit", "Bash"], maxTurns: 8 },
})) {
  console.log(message);
}

Запуск через шлюз

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_gateway_key
python agent.py

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

Что SDK добавляет к режиму печати

  • Обработчики разрешений — одобряйте или отклоняйте каждый вызов инструмента из собственного кода.
  • Пользовательские инструменты через MCP-серверы внутри процесса, позволяющие агенту вызывать ваши функции.
  • Хуки для событий инструментов, жизненного цикла сессии и ошибок.
  • Субагенты и структурированный вывод без запуска внешних команд и разбора текста.

Сначала попробуйте бесплатно

Новые аккаунты получают $5 бесплатного баланса для API по коду CLAUDECODE — этого хватит на вечер работы с Claude Code на Sonnet — затем кредиты с балансом в 7.69231 раза больше номинала.

export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key

Создать аккаунт с кодом CLAUDECODE

Часто задаваемые вопросы

Claude Code SDK — это то же самое, что Anthropic SDK?

Нет. Anthropic SDK напрямую вызывает Messages API. Claude Agent SDK (ранее Claude Code SDK) запускает поверх него полноценного агента — с инструментами, файлами, bash и субагентами.

Какие языки поддерживает Agent SDK?

Официально — Python и TypeScript; из любого другого языка можно управлять режимом печати CLI с выводом в формате JSON.

Работает ли SDK с пользовательским базовым URL?

Да. Он наследует ANTHROPIC_BASE_URL и ANTHROPIC_API_KEY из окружения, точно так же, как CLI.

Запускайте Claude Code через шлюз

Те же модели, две переменные окружения, кредиты с балансом в 7.69231 раза больше номинала — или безлимитный тариф с фиксированной оплатой. Для новых аккаунтов: $5 бесплатного баланса для API по коду CLAUDECODE.

Получить API-ключ Посмотреть безлимитные тарифы

AI Prime Tech — независимый API-шлюз, который не связан с Anthropic, не одобрен и не спонсируется этой компанией. «Claude» и «Claude Code» — товарные знаки Anthropic. Описанные здесь возможности Claude Code соответствуют публичной документации Anthropic на момент написания и часто меняются; цены и списки моделей на этой странице берутся из текущих настроек шлюза.

Другие руководства по Claude Code

Claude Code: полное руководствоКак установить Claude CodeДокументация CLI Claude Code: команды и флагиЦены и лимиты Claude Code: подробное объяснениеНавыки и плагины Claude CodeClaude Code в GitHub: App, Action и @claudeЕсть ли у Claude Code веб-интерфейс? Веб-версия, настольное приложение и IDEКакую модель использует Claude Code и как её изменитьОшибки Claude Code и способы их исправленияОткрыт ли исходный код Claude Code?Практическое руководство по Claude Code: ваш первый полноценный сеансClaude для студентов: Claude Code, API и что на самом деле дают образовательные программыКак использовать Claude Code для автоматизации QAClaude Code и Cursor: что и когда выбрать — и как использовать оба инструментаClaude Code, Codex и OpenCode: сравнение терминальных агентовСубагенты Claude Code: как они работают, как их определять и как устроены команды агентовХуки Claude Code: детерминированный контроль над действиями агентаMCP в Claude Code: подключение серверов, области действия, удалённый MCP и реальные примерыЭкосистема Claude Code: маршрутизаторы, фреймворки, плагины и списки, в которых они собраныClaude Code в VS Code: расширение, работа через терминал и ошибкиКак использовать OpenRouter в Claude Code и когда этого делать не стоитОшибка ограничения частоты запросов Claude: что означает «API error: rate limit reached» и как её исправитьКак пользоваться Claude Code: от установки до повседневной работы