Описание
Рабочая тетрадь агентов — это локальный прокси, который находится между кодирующим агентом, Claude Code или Codex, и основной моделью. Он добавляет один дополнительный вызов инструмента к каждому запросу: место, где модель может «думать вслух» перед тем, как ответить, записывая решение, которое она принимает, альтернативы, которые она рассматривала, и что бы стоило каждое из вариантов. Заявленная цель проекта — позволить разработчику проверить, соответствует ли заявленный план агента тому, что он на самом деле делает.
Читать далее
Прокси работает локально через Docker Compose и предоставляет панель управления по адресу 127.0.0.1:8080, где каждая запись передается по мере ее написания, с отдельными сессиями CLI, размещенными в отдельных строках. Claude Code указывает на прокси, устанавливая ANTHROPIC_BASE_URL на локальный адрес; Codex настраивается через пользовательского поставщика модели. Опциональный режим непрерывности сохраняет предыдущие записи доступными между вызовами инструментов в рамках одного хода (включен по умолчанию для Codex и активируется для Claude Code с явным флагом окружения после проверки с установленной версией Claude Code), с настраиваемыми ограничениями на количество сессий, объем памяти и время бездействия.
Проект явно документирует свои собственные затраты. Поскольку он делает дополнительный вызов к модели для каждого хода и до четырех, когда модель продолжает писать записи, он примерно удваивает использование входных токенов и добавляет сотни до тысяч выходных токенов за ход, и ответ не начинает передаваться, пока не завершится скрытый вызов записи, до 60 секунд. Он также предупреждает, что запись в рабочей тетради является обычным выходом модели, поэтому вставленный API-ключ или секрет могут появиться в одной из них.
Рабочая тетрадь агентов не читает и не раскрывает защищенные внутренние рассуждения модели; записи создаются через обычный вызов инструмента, так же как и любой другой аргумент инструмента, который модель может записать. Ничего не записывается на диск, если оператор не установит путь архива, и документация проекта явно просит пользователей не использовать его для сбора или обучения на следах рассуждений моделей Anthropic или OpenAI. Он выпущен под лицензией Apache 2.0 и заявляет, что не связан ни с одной из компаний.
Это небольшой проект с открытым исходным кодом, разработанный одним разработчиком, нацеленный на разработчиков, которые используют Claude Code или Codex и хотят видеть рассуждения агента во время сеанса кодирования, а не продукт для нетехнических пользователей.
- КатегорияКонструкторы AI-агентов
- Модель ценообразованияОткрытый код
- РазвёртываниеНа своём сервере
- ПлатформыВеб
Основные функции Рабочая тетрадь агентов
Локальный прокси добавляет вызов инструмента "думать вслух" к каждому запросу Claude Code / Codex
Живая панель управления (127.0.0.1:8080), передающая каждую запись по мере ее написания
Отдельные строки для каждой сессии CLI на панели управления
Опциональная непрерывность между запросами, которая сохраняет предыдущие записи доступными в рамках одного хода
Настраиваемые ограничения непрерывности (количество сессий, объем памяти, время бездействия)
Работает как с Claude Code (через ANTHROPIC_BASE_URL), так и с Codex (через настройки пользовательского поставщика)
Полностью работает локально через Docker Compose; ничего не записывается на диск, если не настроено
Лицензия Apache 2.0 с открытым исходным кодом
Начало работы с Рабочая тетрадь агентов
Клонируйте репозиторий: Получите проект с GitHub (softcane/agents-workbook).
Запустите прокси: Выполните docker compose up -d --build.
Откройте панель управления: Перейдите по адресу 127.0.0.1:8080 и оставьте вкладку открытой.
Укажите ваш CLI на прокси: Установите ANTHROPIC_BASE_URL для Claude Code или настройте параметры поставщика модели Codex.
Работайте как обычно: Используйте Claude Code или Codex и следите за тем, как его рассуждения передаются на панель управления.
Включите непрерывность (по желанию): Установите WORKBOOK_CONTINUITY_CLAUDE_ENABLED=true, чтобы сохранить записи доступными между вызовами инструментов для Claude Code.
Варианты использования Рабочая тетрадь агентов
- Аудит плана и действий
- Обзор сеанса кодирования
- Локальная отладка
