Эта страница переведена с английской документации. Команды, идентификаторы и примеры не изменены. Среда выполнения 7.24.4 · SDK 2.6.7. Английский оригинал
Документация AX Code
Статус: активно Область: публично, текущее состояние Последняя проверка: 2026-10-09 Владелец: сопровождающие AX Code
AX Code — среда выполнения кодирующего агента для работы, которую можно рецензировать и обратить: каждая сессия записывается как структурированный журнал событий со снимками файлов, реализации кандидатов можно проверить собственными проверками вашего репозитория, и ничего не сливается автоматически. Почему AX Code объясняет, на что это оптимизировано, для кого это и чего продукт намеренно не утверждает.
Корневой README — самый короткий путь установить и запустить AX Code. Пользуйтесь этим центром, когда нужно настроить процесс, понять границу среды выполнения или интегрировать AX Code с другой системой.
Внутренние записи процесса (PRD, ADR, спецификации, дорожные карты, планы реализации, конкурентные рецензии и рабочие
файлы аудита) живут в .internal/, а не в этом публичном дереве — см. «Границы документации» ниже. Публичные
страницы — те, на которые есть ссылки здесь.
Публичный сайт: ax-code.app/ru/docs/. Для уже установленных копий начните с Обновления и восстановления. Доступ к исходникам и публичные загрузки разделены; см. Доступ к исходникам.
Выбор по задаче
Совместную навигацию по терминалу через внешнего клиента MCP по согласию см. в Общем доступе к живому TUI через MCP.
Экспериментальный мост браузера (чтение страниц, по желанию щелчки и заполнение) см. в Мосте браузера WebMCP.
Отдельные вопросы о выбранных файлах через кэш AX Trust см. в Вопросах с фиксированным контекстом.
| Я хочу… | Начните здесь |
|---|---|
| Решить, подходит ли AX Code моей работе | Почему AX Code |
| Понять AX Code до установки | Начните здесь |
| Рецензировать, сравнить или отменить то, что сделал агент | Свидетельства выполнения |
| Заставить несколько моделей попытаться сделать одно изменение | Проверенные изменения нескольких моделей |
| Выбрать канал установки или среды выполнения | Каналы установки и среды выполнения |
| Подключить размещённого, CLI, пользовательского или локального провайдера | Поддерживаемые провайдеры и модели |
| Включить управляемый локальный вывод на Apple Silicon | Выбор модели AX Engine |
| Прочитать текущие числа скорости Tiel и MTPLX | Сводка сравнения Tiel (20 сентября 2026) |
| Попробовать AX Code с API модели бесплатного уровня | Быстрый старт API бесплатного уровня |
| Запустить агента с безопасными границами файловой системы и сети | Режим песочницы |
| Безопасно администрировать облачную или сетевую инфраструктуру | Режим облачных операций |
| Запускать без присмотра или в CI | Автономный режим |
Вызывать разовый CLI ax-code run из скриптов или CI |
Безголовый CLI |
| Запускать повторяющиеся запросы или планировать долговечные задачи | Режим цикла и запланированные задачи |
| Слышать звук или голосовое оповещение, когда запуску нужно внимание | Звуковые уведомления |
| Держать запланированную работу запущенной после выхода процесса или хоста | Долгие операции |
| Выбрать выполнение локально, в облаке, гибридом, council или arena | Режимы выполнения |
| Подключить внешние инструменты и данные | Интеграции MCP |
| Дать агенту читать и действовать в Chrome через WebMCP | Мост браузера WebMCP |
| Встроить AX Code в приложение | @defai-digital/ax-code-sdk |
| Породить клиента для другого языка | Совместимость HTTP и OpenAPI |
| Собрать настольный или нативный хост | Нативный транспорт SDK |
Начало работы
-
Standard и Business — открытый Standard, бесплатное коммерческое использование, запланированный собственнический Business и статус публичного доступа.
-
Почему AX Code — на что оптимизирован AX Code, предполагаемая аудитория, чем он отличается и чего не утверждает.
-
Начните здесь — ментальная модель продукта и самые короткие пути по сценариям.
-
Каналы установки и среды выполнения — поддерживаемые платформы, пакеты, обновления и запускатели для участников.
Руководства по среде выполнения
- Визуализация свидетельств вики — откройте локальный граф записанных связей страниц и источников вики или экспортируйте офлайн HTML. Включены снимки радиального вида, силового вида и фокуса страницы из собственной вики AX Code.
- Пересказ разговора — догоните недавнюю работу через
/recapи настройте баннеры простоя. - Звуковые уведомления — системные звуки и голосовые оповещения по согласию, когда запуску нужно ваше внимание.
- Свидетельства выполнения — граф, сравнение, воспроизведение, риск, откат, ветвь, трассировка и экспорт аудита.
- Проверенные изменения нескольких моделей — процесс council и arena от начала до конца.
- Режим песочницы — режимы изоляции, защищённые пути, управление сетью и приоритет.
- Режим облачных операций — процесс план/одобрение/применение, токены одобрения и позиция агента
cloudops. - Автономный режим — выполнение без присмотра, одобрения, безголовое использование и защиты.
- Безголовый CLI — разовая команда
ax-code runдля скриптов, CI и вызывающих агентов. - Языки и настройка TUI — языки интерфейса и разговора, первая настройка.
- Анимации TUI — пары открытия и завершения, возможности терминала и запасные варианты отрисовки.
- Режим цикла и запланированные задачи — повторяющиеся запросы, долговечные расписания и пределы долгого запуска.
- Долгие операции — примеры управляемой службы, семантика восстановления и операционные проверки.
- Режимы выполнения — поведение agent, hybrid, council и arena.
- Лучшие практики маршрутизации нескольких моделей — разделите дорогое рассуждение и более дешёвую вспомогательную работу, не ослабляя молча задачи, чувствительные к правильности.
- Восстановление модели — точный выбор модели, явная конфигурация запасного варианта и диагностика.
- Автомаршрут — маршрутизация специалистов и необязательная маршрутизация по сложности.
- Усилие модели — уровни рассуждения и поведение, специфичное для провайдера.
- Производительность — профили инструментов кодирования и локальная диагностика времени запроса.
- Использование памяти — профили памяти, удержание кэша и пределы фонового вывода.
- Локальный кэш свидетельств — необязательное переиспользование свидетельств SQLite и RocksDB, квалификация и откат.
- Хуки жизненного цикла — события хуков и комплектные пакеты политик.
- Отчёт о запуске — использование рабочей области, активность, разбивки моделей и инструментов и отчёты по сессиям.
Провайдеры
- Поддерживаемые провайдеры и модели — идентификаторы провайдеров, учётные данные и обнаружение моделей.
- Быстрый старт API бесплатного уровня — совместимые пути без платы, ограничения и безопасная оценка.
- Пользовательские провайдеры и шлюзы — конечные точки, совместимые с OpenAI и Anthropic.
- Настройка MTPLX и oMLX — локальные пресеты из рабочей копии исходников, обнаружение, инструменты и аутентификация.
- Сводка сравнения Tiel (20 сентября 2026) — текущие числа нативного API Tiel / Cyber-Tiel и MTPLX; завершение по умолчанию 194.88, пик декодирования 249.01.
- Повторная проверка клиента AX Code/OpenCode — шесть сочетаний клиента и среды выполнения, активный MTP, время первого и повторного прохода и проверки кода.
- Измерения локального вывода — датированное тестирование AX Code/OpenCode и среды выполнения с пределами времени и сопоставимости.
- Выбор модели AX Engine — ранжирование локальных моделей и рекомендации по памяти.
Интеграции
- Интеграции MCP — доверие, разрешения, ресурсы и безопасность сервера.
- ACP — штатный сценарий Agent Client Protocol для хостов IDE.
- AX Wiki — знание репозитория с опорой на источники и процесс CI.
- Интеграция VS Code — команды редактора, параметры и процессы. Установите из записи маркетплейса.
SDK и границы служб
@defai-digital/ax-code-sdk— собственное встраивание TypeScript и JavaScript.- Нативный транспорт SDK — граница рабочего стола и нативного кода в форме gRPC и поведение запасного пути.
- Совместимость HTTP и OpenAPI — режим сервера и порождённые клиенты для других языков.
- Снимок OpenAPI — авторитетный контракт маршрутов HTTP и схем.
Архитектура и надёжность
- Семантический слой — происхождение графа и LSP, аудит и границы воспроизведения.
- Архитектура локального движка — почему AX Code использует sidecar AX Engine.
- Устойчивость среды выполнения — контракты отмены, сбоя, потока, тайм-аута и надёжности TUI.
Справочник
-
Схема JSON конфигурации — порождённый контракт ввода конфигурации.
-
Нативная поддержка TypeScript — исходный компилятор, языковая служба, диагностика и совместимость.
-
Каталог навыков и плагинов — комплектные навыки, навыки проекта, плагины и оценки.
-
Пакеты политик изоляции — машиночитаемые примеры политик.
-
Проверка выпуска — канонический публичный ключ Minisign и команда проверки.
-
Целостность среды выполнения Windows — подписи, проверка установленных файлов и свидетельства антивируса.
-
Политика безопасности — модель угроз, хранение учётных данных и поддерживаемые версии.
Границы документации
docs/ содержит публичные указания для поведения, которое есть в выпущенной среде выполнения. Материал планирования, цели выпуска,
политика реализации и временный анализ сюда не относятся:
| Содержимое | Расположение |
|---|---|
| Архитектурные решения | .internal/adr/ |
| Требования к продукту и технические спецификации | .internal/prd/ и .internal/spec/ |
| Дорожные карты, планы реализации, цели выпуска, рецензии и аудиты | .internal/reports/ |
| Выпущенное поведение и публичные указания по интеграции | docs/ |
Каждая публичная страница Markdown должна рядом с началом объявлять статус, область, дату последней проверки и владельца. Предпочитайте ссылки на порождённые контракты или источники реализации, а не скопированные списки маршрутов и другие снимки, которые быстро устаревают.
Контрольный список сопровождения
Перед выпуском или существенным изменением документации:
- Сверьте команды, значения по умолчанию, флаги, идентификаторы провайдеров и подписи среды выполнения с их реализацией.
- Обновляйте самое узкое авторитетное руководство, а не повторяйте одно поведение на нескольких входных страницах.
- Выполните
pnpm run test:scripts, чтобы поймать сломанные локальные ссылки, осиротевшие страницы и недостающие метаданные страниц. - Обновите одобренный манифест экспорта и выполните
node script/export-public-docs.mjs --website /path/to/ax-code.app, затем выполните проверку сайта, сборку и дымовые проверки Workers. Сборки сайта используют зафиксированный снимок и не требуют доступа к исходникам. Новые публичные страницы и ресурсы нужно явно одобрить в манифесте. - Предложения, заметки о развитии проекта, цели выпуска и исторические записи решений держите в
.internal/, а не в публичной навигации.