Эта страница переведена с английской документации. Команды, идентификаторы и примеры не изменены. Среда выполнения 7.24.4 · SDK 2.6.7. Английский оригинал

Почему AX Code

Статус: активно Область: текущее состояние Последняя проверка: 2026-08-25 Владелец: сопровождающие AX Code

Большинство кодирующих агентов оптимизируют момент написания кода. AX Code оптимизирует момент после: решение, оставлять ли то, что произвёл агент.

На что оптимизирован AX Code

Вывод агента дёшев в порождении и дорог в рецензии. Когда агент затрагивает двадцать файлов в трёх модулях, проблема рецензента не в том, «верна ли эта строка», а в том, «что он на самом деле сделал, проходит ли это и что будет, если мне нужно это отменить».

AX Code построен вокруг этой проблемы:

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

Для кого это

Основная аудитория:

• старшие инженеры и staff-инженеры, которые вносят существенные изменения
• сопровождающие открытого кода и внутренних платформ
• команды, которые ведут средние и крупные репозитории Git
• инженеры, оценивающие рефакторинги, миграции и исправления через модули
• все, кто запускает работу агента без присмотра или по расписанию, которую человек должен потом проверить

Не основная аудитория:

• тот, кому нужно встроенное автодополнение
• пользователь, который делает одну быструю одноразовую правку
• команда, чей приоритет — полностью управляемое облачное делегирование
• тот, кто не готов пользоваться Git или запускать проверки репозитория

В этих случаях более лёгкий помощник редактора действительно лучше, и эта страница скорее скажет об этом, чем будет преувеличивать.

Чем отличается

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

Несколько возможностей, которые поставляет AX Code, на 2026 год широко доступны и в других местах: песочница, контрольные точки и восстановление, MCP, хуки, навыки, субагенты, изоляция worktree, планирование, выбор провайдера и запуск одного запроса на нескольких моделях. Ни одна из них сама по себе не является причиной выбрать AX Code.

Сочетание, которое труднее собрать в другом месте: изолированная реализация кандидата, закрытая собственными проверками репозитория, с ранжированием, где проверка идёт первой, с полной записью выполнения, сохранённой локально и доступной для экспорта, — и без автоматического слияния.

Чего мы не утверждаем

Позиционирование полезно, только если оно выдерживает встречу с продуктом. Явно:

• replay восстанавливает; он не выполняет заново. Он пересобирает и проверяет записанный поток событий. Он не перезапускает модели, инструменты и внешний мир.
• risk — детерминированная эвристика, вычисленная по обороту, состоянию проверки, сбоям инструментов, затронутым путям и шаблонам файлов, чувствительных к безопасности. Это не вероятность, не калиброванная уверенность и не гарантия безопасности.
• branch ветвит состояние сессии, а не ветвь Git и не worktree. Arena — путь реализации через Git worktree.
• compare сравнивает запуски, а не исходный код. Он сообщает риск, путь решения и число событий — это не средство просмотра diff кода.
• Шлюзы проверки не универсальны. Они применяются к кандидатам арены и к применению рефакторинга под шлюзом. Обычные интерактивные правки не проверяются автоматически.
• Проза AX Wiki порождена моделью из цитируемых источников. Каркас планирования, проверки, пошагового обновления и защищённых разделов вокруг неё детерминирован.
• Видимость моста CLI частична. AX Code полностью записывает собственное выполнение инструментов; работа внутри процесса вендорского CLI видна только через вывод этого моста.
• Некоторые возможности включаются по согласию. Среде выполнения workflow нужен AX_CODE_WORKFLOW_RUNTIME=1.

Происхождение, прямо

AX Code начался с кодовой базы OpenCode под лицензией MIT. Это сохранено в NOTICE и сказано в README, а не спрятано.

Что DEFAI построил на этом основании — предмет этой страницы: слой свидетельств выполнения, детерминированный движок отладки и рефакторинга с проверкой в теневом worktree, граф понимания кода и анализ влияния, режимы выполнения council и arena, компилятор AX Wiki, песочница уровня ОС и AX Code Desktop.

Интеграция с проектом — не производная от него. Раздел происхождения в README и NOTICE существуют, чтобы нести лицензионные обязанности по Apache-2.0, раздел 4(d): там перечислены только вышестоящие проекты, чей код AX Code действительно копирует и распространяет. Проекты, с которыми AX Code лишь общается, там не перечислены, как бы внимательно их ни изучали при построении моста. CLI-провайдеры — самый ясный случай: Claude Code, Codex CLI, Grok Build CLI и Muse Code CLI названы в таблицах провайдеров, потому что AX Code вызывает эти локальные двоичные файлы и переиспользует их сессии входа, а не потому что какой-либо их код поставляется здесь. Шаблоны идентификаторов моделей, таблицы возможностей и разбор, специфичный для вендора, в packages/ax-code/src/provider/ — собственная логика совместимости AX Code. Файлы, которые действительно являются дословными производными, несут однострочный заголовок происхождения с именем вышестоящего проекта, чтобы аудит отличал намеренное переиспользование от пропущенной очистки.

Дальше

• Свидетельства выполнения — команды, которые делают запуск доступным для рецензии
• Проверенные изменения нескольких моделей — council и arena
• Начните здесь — ментальная модель продукта