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

Разработчик 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: [].
Дальше
Grok Imagine Video 1.5 доступна через API
xAI выпустила Grok Imagine Video 1.5 Preview через API. Модель сразу заняла первое место в слепом тестировании на платформе Video Arena.
Читайте также
- Anthropic приостанавливает изменения в кредитной системе Claude Agent SDK
- Доски задач для агентов тестируют в Claude Code
- Сессии Claude Code научились обмениваться сообщениями
- Четыре типа циклов в Claude Code: /goal, /loop, /schedule
- Фильтрация вывода инструментов подняла Opus 4.6 до 61,6%
- Скрытая инструкция запрещает Opus 5 звать субагентов
Комментарии
Пока никто не написал. Будьте первым.
Присоединяйтесь к разговору
Войдите, чтобы оставить комментарий. Он появится после модерации.

