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

Начните здесь

Статус: активно Область: текущее состояние Последняя проверка: 2026-09-16 Владелец: среда выполнения ax-code

Если корневой README — самый быстрый способ установить AX Code, эта страница — самый быстрый способ его понять.

Редакции и доступность

Начните с AX Code Standard, открытой редакции, бесплатной для личного и коммерческого использования. Пользуйтесь локальными или облачными моделями; AX Engine даёт нативный путь локального вывода на поддерживаемых Mac с Apple Silicon. Существующие разрешения, рецензия изменений и локальные свидетельства выполнения остаются базовыми возможностями.

Business — запланированное собственническое предложение для управления организацией через AX Trust и деловых процессов через AutomatosX. Использование Standard на работе само по себе не требует лицензии Business. Подробности см. в Standard и Business.

Подписанные установщики и архивы среды выполнения доступны анонимно с download.ax-code.com. Прочитайте руководство по установке и руководство по обновлению и восстановлению. Публичная техническая документация размещена на ax-code.app/ru/docs/ независимо от доступа к исходникам. Уже установлено? Откройте терминал в проекте, выполните ax-code, затем внутри TUI используйте /connect, чтобы выбрать провайдера. Начните с вопроса о проекте, попросите небольшое изменение и просмотрите diff и проверки проекта, прежде чем фиксировать. Используйте ax-code doctor, если установленную среду выполнения нужно диагностировать.

Что такое AX Code

AX Code — среда выполнения для кодирования с ИИ. Она соединяет:

• агентов для разных задач кодирования
• явное выполнение инструментов
• выбор модели и провайдера
• постоянное состояние сессии
• настраиваемые изоляцию и разрешения
• поверхности интеграции, такие как TUI, SDK, режим сервера и MCP

Это важно, потому что кодирование с ИИ полезно в настоящих репозиториях, только когда можно контролировать, что агенту позволено делать, сохранять контекст между сессиями и переиспользовать тот же процесс вне одного окна чата.

Откуда берётся ценность

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

• Свидетельства. Каждая сессия записывается как типизированный журнал событий плюс снимки файлов, поэтому ax-code graph, compare, replay, risk и audit могут восстановить, что произошло, после конца разговора.
• Проверка. Там, где шлюз можно принудить — кандидаты арены, применение рефакторинга под шлюзом — собственные команды проверки типов, линтера и тестов вашего репозитория решают, принят ли результат.
• Обратимость. Снимки восстанавливаются по шагам, а не только по сессии, из хранилища объектов Git, которое лежит вне вашего репозитория.
• Ваше решение. AX Code ранжирует, оценивает и сообщает. Он не сливает изменения за вас.

Это поддерживают: явные инструменты с правилами разрешений и режимами изоляции, долговечные сессии, AGENTS.md для соглашений репозитория, переносимость провайдеров и одна среда выполнения за TUI, CLI, расширением VS Code, SDK, безголовым сервером и интеграциями MCP. Это основания, а не причина выбрать AX Code — см. Почему AX Code.

Сами команды см. в Свидетельствах выполнения.

Ментальная модель

Думайте об AX Code как о пяти слоях:

1. Слой провайдера: выберите бэкенд модели, против которого хотите работать.
2. Слой агента: выберите подходящего агента для задачи или позвольте маршрутизации помочь.
3. Слой инструментов: агент действует через явные инструменты, а не через скрытые возможности.
4. Слой сессии: разговор, решения и состояние сохраняются.
5. Слой управления: изоляция, разрешения и поведение аудита задают границу.

Остальная документация ложится на эти слои.

Выберите следующий путь

Хочу попробовать быстро

• Начните с корневого README для установки и первого запуска.
• Поддерживаемые пути установки используют скомпилированную среду выполнения:
  • установщик выпуска Bash для macOS Apple Silicon и Linux: curl -fsSL -H "Accept: application/vnd.github.raw+json" "https://api.github.com/repos/defai-digital/ax-code/contents/install?ref=main" | bash
  • альтернатива Homebrew для CLI macOS: brew tap defai-digital/tap && brew trust defai-digital/tap && brew install defai-digital/tap/ax-code
  • установщик выпуска GitHub для Windows PowerShell: powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://download.ax-code.com/install.ps1 | iex"
• Установщик Bash — не канонический путь настройки Windows.
• Пакеты npm больше не являются поддерживаемыми каналами установки или обновления. Политику платформ, подписи среды выполнения и матрицу локального запуска см. в Каналах установки и среды выполнения.
• Используйте /connect или ax-code providers login, чтобы задать модель. Облачных провайдеров API, CLI-провайдеров, AX Engine и идентификаторы моделей см. в Поддерживаемых провайдерах и моделях. Путь оценки без платы см. в Быстром старте API бесплатного уровня.
• После открытия настоящего проекта выполните ax-code init, чтобы AGENTS.md зафиксировал локальные соглашения.
• Если нужны более тесные границы безопасности, включите Режим песочницы до более широких правок.

Хочу безопасно пользоваться в репозитории команды или компании

• AX Code начинает с включённого автономного режима и выключенной песочницы: full-access с неограниченным доступом к файловой системе и сети.
• Для работы команды, компании, недоверенной или без присмотра включите --sandbox workspace-write (или read-only) до начала задачи.
• Границы выполнения см. в Режиме песочницы.
• Если агент будет работать без присмотра, прочитайте Автономный режим.
• Модель угроз и хранение учётных данных см. в Политике безопасности.
• Если для процесса важны происхождение и воспроизведение, прочитайте Семантический слой.

Хочу встроить или автоматизировать

• Используйте безголовые точки входа или gRPC @defai-digital/ax-code-sdk для интеграции приложения на TypeScript.
• Используйте Совместимость HTTP и OpenAPI для границы службы, порождённых клиентов и авторитетного контракта OpenAPI.
• Используйте ax-code mcp add, когда агенту нужны внешние инструменты или службы.

Хочу понять репозиторий или передать отзыв

• Остальную публичную документацию см. в Центре документации.
• Текущую политику внешнего вклада см. в CONTRIBUTING.md.

Когда AX Code может не подойти

AX Code намеренно больше, чем автодополнение или размещённое окно чата. Его может быть слишком много, если:

• Вам нужны только встроенные подсказки кода, и вы не хотите, чтобы агенты выполняли инструменты.
• Вам нужен только размещённый опыт SaaS без локальной среды выполнения.
• Вам не нужны постоянство сессии, воспроизведение, интеграция SDK или сервера и инструкции уровня репозитория.
• Вы работаете в среде, где локальный процесс CLI запрещён.

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

Обычные первые команды

ax-code
ax-code providers login
ax-code models
ax-code run --model qwen -- "Review this change"
ax-code init
ax-code index
ax-code mcp add
ax-code doctor

Grok работает исключительно через Grok Build CLI. Выберите grok-build-cli в /connect; AX Code вызывает локальную команду grok и переиспользует её вход и сессию CLI. Прежний прямой облачный провайдер API xai больше не поддерживается.

Карта документов