Перейти к содержанию

Anthropic

Anthropic выпустила Claude Agent SDK для создания ИИ-агентов

4 мин чтения

Текст написан ИИ-моделью по источникам, на которые ведут ссылки, и сверен с ними второй моделью. Как мы работаем

Всё о теме: Claude Code: версии и изменения →
Изображение: mager.co

Разработчик Mager в посте от 14 марта собрал на Claude Agent SDK собственный терминальный интерфейс примерно в 80 строк TypeScript. Агентский цикл Claude Code в нём работает внутри программы, которую вы контролируете сами. Демо лежит в репозитории mager/claude-tui-demo, и самое полезное в разборе находится не в интерфейсе, а в том, что SDK берёт на себя: цикл вызова инструментов, хуки и сессии.

Главное отличие от обычного клиента Anthropic API Mager показывает на коде. С клиентским SDK цикл вы пишете сами: отправляете запрос, и пока stop_reason равен "tool_use", исполняете инструмент своим кодом и возвращаете результат следующим запросом. В Agent SDK вместо этого есть вызов query() с промптом и списком allowedTools, а по ответу вы идёте через for await и получаете сообщения по мере работы агента. Исполнителя инструментов писать не нужно. В комплекте те же инструменты, что у Claude Code: Read, Write, Edit, Bash, Glob, Grep, WebSearch и WebFetch.

Раньше библиотека называлась Claude Code SDK. Пакет для TypeScript переехал с @anthropic-ai/claude-code на @anthropic-ai/claude-agent-sdk, для Python с claude-code-sdk на claude-agent-sdk, а тип ClaudeCodeOptions стал ClaudeAgentOptions. В руководстве по миграции Anthropic объясняет переименование тем, что SDK годится для агентов далеко за пределами программирования.

Формулу Mager «тот же движок, что у Claude Code» стоит читать с поправкой из той же документации. С версии 0.1.0 SDK по умолчанию не подставляет системный промпт Claude Code: агент запускается с минимальным промптом, а пресет Claude Code нужно запросить явно. Инструменты у вас те же, но вести себя «как Claude Code» агент без этого пресета не обязан.

Сам интерфейс написан на Ink, библиотеке, которая рендерит React-компоненты в терминал: Box работает как div, Text как span, хуки useState и useEffect те же. Две практические детали из поста сэкономят время. Запускать лучше через tsx, а не ts-node: он без настройки понимает JSX и ESM. И в package.json обязательно должен стоять "type": "module", потому что движок раскладки Ink, yoga-layout, использует await на верхнем уровне модуля, и без ESM вы получите, по словам автора, «невнятную ошибку».

Поток сообщений оборачивается в асинхронный генератор, который отдаёт сообщения по одному, так что вызовы инструментов появляются на экране сразу, а не после завершения задачи. SDK присылает несколько типов: assistant с ответом Claude, result с итогом, system с событием инициализации и ID сессии, user с эхом ввода. В демо вызов инструмента выводится жёлтым, например ⚙ Bash({"command":"ls"}), ответ белым, итог зелёным. Точка входа занимает семь строк, весь интерфейс уже работает примерно на 80.

Память между запросами устроена через ID сессии. Его забирают из события system с подтипом init и передают в следующий query() параметром resume. В примере Mager первый запрос просит прочитать модуль авторизации, а второй, «теперь найди всё, что его вызывает», проходит без единого вызова инструмента: файл уже в контексте. На том же механизме построен режим REPL, обычный цикл while (true), где каждый новый ввод продолжает сессию.

Хуки, колбэки на этапах жизненного цикла агента, Mager считает главным аргументом в пользу своего интерфейса. В демо хук PostToolUse с matcher: ".*" пишет каждый вызов инструмента с отметкой времени в audit.log; если интересуют только изменения файлов, матчер сужают до "Edit|Write". PreToolUse блокирует операцию до запуска, Stop ловит завершение работы агента, UserPromptSubmit проверяет или дополняет ввод. Отсюда и список того, ради чего автор предлагает писать свой TUI: заранее подгруженные архитектурные документы и стайлгайды команды, ревьюер с правами только на чтение, который не сможет случайно править прод, запуск всего набора тестов одной клавишей и вывод в CI/CD или систему логирования.

Тот же шаблон, по словам Mager, использует эталонный почтовый агент Anthropic из репозитория anthropics/claude-agent-sdk-demos. Он читает входящие, готовит ответы и отправляет их: PreToolUse требует подтверждения перед отправкой, PostToolUse логирует каждое действие, а продолжение сессии держит контекст в многошаговой разборке почты.

Если возможностей Ink не хватает, автор предлагает Rezi: тот же TypeScript и Node.js, но рендеринг через нативный движок на C и больше 50 готовых виджетов, включая таблицы, модальные окна, графики и палитру команд. Модель другая: вместо дерева компонентов там чистая функция, которая превращает состояние в интерфейс, а состояние меняется через app.update(), примерно как в Elm-архитектуре Bubble Tea. Спиннер встроен, цвета задаются семантическими вариантами вроде info и warning под одну из шести тем. Версия демо на Rezi лежит в rezi/rezi-app.ts.

Где что использовать, Mager разводит просто: для повседневной разработки и разовых задач остаётся CLI Claude Code, а для CI/CD, внутренних инструментов команды, автоматизации в проде и задач, где нужны аудит и контроль прав, берут SDK. Кроме инструментов и хуков в SDK есть делегирование субагентам и поддержка MCP, а для Python ставится pip install claude-agent-sdk.

Для CI тот же «движок Claude Code» тянет за собой одну деталь. Если не передать settingSources, SDK, как и CLI, загрузит пользовательские, проектные и локальные настройки: ~/.claude/settings.json, .claude/settings.json, .claude/settings.local.json, файлы CLAUDE.md и пользовательские команды. Документация советует изоляцию для CI/CD, задеплоенных приложений, тестовых окружений и мультитенантных систем, где локальные настройки не должны протекать в работу агента, и делается она одним параметром: settingSources: [].

Пока никто не написал. Будьте первым.

Присоединяйтесь к разговору

Войдите, чтобы оставить комментарий. Он появится после модерации.