ИИ агенты

Как устроен наиболее широко используемый ИИ-агент для написания кода и выполнения задач?

Когда Claude Code был опубликован в npm, в комплекте шли карты исходного кода. Мы изучили каждый файл. Эта книга излагает архитектуру, проектные решения и применимые паттерны в 18 главах, которые вы можете изучить и применить в своих системах.

Начать чтение

Что вы узнаете

Цикл агента

Как асинхронный генератор управляет всей системой — потоковая передача вывода модели, выполнение инструментов, восстановление после ошибок и сжатие контекста на 4 уровнях.

Масштабируемое выполнение инструментов

14-этапный конвейер от запроса модели до результата инструмента. Разрешение прав, спекулятивное выполнение, параллельное пакетирование по классификации безопасности.

Оркестрация мультиагентных систем

Как субагенты совместно используют префиксы кэша запросов для сокращения затрат на 95%. Агенты-форки, режим координатора, команды «роения» с обменом сообщениями через почтовые ящики.

Память без базы данных

Файловая память с системой извлечения на основе LLM. Четыре типа памяти, предупреждения об устаревании и дополнительный запрос Sonnet, превосходящий поиск по встраиваниям.

Инженерия производительности

Запуск за 240 мс через параллельный ввод-вывод. Резервирование слотов, сохраняющее контекст в 99% запросов. Битмап-фильтры для нечеткого поиска. Учтена каждая миллисекунда.

Расширяемость и безопасность

Двухфазная загрузка навыков (метаданные при запуске, содержимое по запросу). 27 хуков жизненного цикла со снимками конфигурации, замороженными при запуске для предотвращения инъекций.

Изучите архитектуру

Шесть ключевых абстракций лежат в основе Claude Code. Перетаскивайте узлы для перестановки, наведите курсор для получения деталей, нажмите, чтобы прочитать главу.

Для кого эта книга

Инженеры, создающие агентные системы. Каждая глава завершается разделом «Примените это» — 5 применимых паттернов с конкретными советами по адаптации. Используйте архитектуру, избегайте ошибок.

Технические руководители, оценивающие архитектуры. Следуйте повествованию, не читая каждый блок кода. Поймите, почему были приняты те или иные решения, а не только то, что было создано.

Любопытные о том, как работают продакшн-инструменты ИИ. Claude Code используется сотнями тысяч разработчиков. Это описание его внутреннего устройства.

Оглавление

Часть 1

Основы

Прежде чем агент сможет думать, процесс должен существовать.

1
Архитектура ИИ-агента

6 ключевых абстракций, поток данных, система разрешений, система сборки

2
Быстрый старт — Конвейер начальной загрузки

5-фазная инициализация, параллелизм ввода-вывода на уровне модуля, граница доверия

3
Состояние — Двухуровневая архитектура

Синглтон начальной загрузки, хранилище AppState, липкие защелки, отслеживание затрат

4
Общение с Claude — API-слой

Многопользовательский клиент, кэш промптов, потоковая передача, восстановление после ошибок

Часть 2

Основной цикл

Сердцебиение агента: поток, действие, наблюдение, повторение.

5
Цикл агента

Глубокое погружение в query.ts, 4-слойное сжатие, восстановление после ошибок, бюджеты токенов

6
Инструменты — От определения к выполнению

Интерфейс инструмента, 14-шаговый конвейер, система разрешений

7
Параллельное выполнение инструментов

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

Часть 3

Многоагентная оркестровка

Один агент силен. Множество агентов, работающих вместе, преобразуют.

8
Порождение побочных агентов

AgentTool, 15-шаговый жизненный цикл runAgent, встроенные типы агентов

9
Форк-агенты и кэш промптов

Трюк с байт-идентичным префиксом, совместное использование кэша, оптимизация затрат

10
Задачи, координация и рои

Конечный автомат задач, режим координатора, роевая переписка

Часть 4

Постоянство и интеллект

Агент без памяти совершает одни и те же ошибки вечно.

11
Память — Обучение в ходе разговоров

Файловая память, таксономия 4-х типов, вызов LLM, устаревание

12
Расширяемость — Навыки и хуки

Двухфазная загрузка навыков, хуки жизненного цикла, безопасность моментальных снимков

Часть 5

Интерфейс

Все, что видит пользователь, проходит через этот слой.

13
Пользовательский интерфейс терминала

Пользовательский форк Ink, конвейер рендеринга, двойной буфер, пулы

14
Ввод и взаимодействие

Разбор клавиш, привязки клавиш, поддержка аккордов, режим vim

Часть 6

Связь

Агент выходит за пределы localhost.

15
MCP — Универсальный протокол инструментов

8 транспортов, OAuth для MCP, обертывание инструментов

16
Удаленное управление и облачное выполнение

Bridge v1/v2, CCR, восходящий прокси

Часть 7

Инженерия производительности

Делая все достаточно быстро, чтобы люди не замечали механизма.

17
Производительность — Каждая миллисекунда и количество токенов имеют значение

Запуск, окно контекста, кэш промптов, рендеринг, поиск

18
Эпилог — Что мы узнали

5 архитектурных ставок, что передается, куда движутся агенты

Как создавалась эта книга

Исходный код был извлечен из source map в npm — файлы .js.map, поставлявшиеся с Claude Code, содержали поле sourcesContent с полным оригинальным TypeScript-кодом. Почти две тысячи файлов, составляющих полную архитектуру.

36 ИИ-агентов проанализировали и написали всю книгу в четыре этапа:

Исследование 6 параллельных агентов прочитали каждый файл в дереве исходного кода
Анализ 12 агентов написали 494 КБ сырой технической документации
Написание 15 агентов переписали все с нуля в виде повествовательных глав
Рецензирование и доработка 3 рецензента подготовили 900 строк обратной связи; 3 агента применили все исправления

Весь процесс — от извлечения исходного кода до финальной отредактированной книги — занял приблизительно 12 часов. Окончательная проверка гарантировала отсутствие дословного исходного кода — каждый блок кода был переписан как псевдокод с другими именами переменных.

10 паттернов, обеспечивающих работу системы

Если вы ничего больше не прочитаете, то эти архитектурные решения определяют Claude Code.

1
AsyncGenerator как цикл агента — возвращает сообщения (Messages), типизированный вывод терминала (Terminal return), естественное противодавление (backpressure) и отмену (cancellation)
2
Спекулятивное выполнение инструментов — запуск инструментов только для чтения во время потоковой передачи модели, до завершения ответа
3
Потокобезопасная пакетная обработка — разделение инструментов по безопасности, параллельный запуск операций чтения, сериализация операций записи
4
Агенты-форки для совместного использования кэша — параллельные дочерние процессы совместно используют байт-идентичные префиксы запросов, экономя ~95% входных токенов
5
4-уровневое сжатие контекста — обрезка (snip), микросжатие (microcompact), схлопывание (collapse), автосжатие (autocompact) — каждый последующий легче предыдущего
6
Файловая память с извлечением на основе LLM — дополнительный запрос Sonnet выбирает релевантные воспоминания, а не просто совпадение по ключевым словам
7
Двухфазная загрузка навыков — только метаданные при запуске, полное содержимое по вызову
8
Механизмы «липких защелок» для стабильности кэша — после отправки бета-заголовка он никогда не сбрасывается в середине сессии
9
Резервирование слотов — ограничение вывода по умолчанию 8K, увеличение до 64K при превышении (экономит контекст в 99% запросов)
10
Снимок конфигурации хуков — заморозка при запуске для предотвращения атак инъекции во время выполнения

Исключительно в образовательных целях. Эта книга не содержит исходного кода Claude Code — каждый блок кода является оригинальным псевдокодом, написанным для иллюстрации архитектурных паттернов. Цель — помочь инженерам понять, как создаются продакшн-ИИ-агенты, а не воспроизводить проприетарное программное обеспечение.