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

Каналы установки и среды выполнения

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

Корневой README хранит основной путь установки. Эта страница — источник истины для поддерживаемых каналов установщика CLI, подписей среды выполнения ax-code doctor, поведения локального запускателя и публичного обновления.

Публичная доступность

Публичные установщики выпусков и подписанные архивы среды выполнения распространяются через download.ax-code.com. Для установки не нужны частные учётные данные GitHub.

AX Code и SDK поддерживают только Node.js 26 или новее. Автономные установщики включают проверенную среду Node. Рабочие копии исходников и приложения SDK на Node должны предоставить Node.js 26+; установка пакета отвергает более старые версии Node.

AX Code Standard остаётся бесплатным для личного и коммерческого использования по существующей лицензии. Доступ к исходникам разработки управляется отдельно от публичного распространения. Запланированные собственнические компоненты Business лицензируются отдельно; лицензия Standard от этого не меняется. Подробности см. в Standard и Business, а публичные обновления установки — в руководстве на сайте. Публичные установщики и их подписанные ресурсы должны быть доступны и проверены, прежде чем сайт рекламирует однострочную команду установки.

Доступность выпуска

Отправка git-тега vMAJOR.MINOR.PATCH запускает рабочий процесс Release. Список публичного указателя выпусков показывает версию только после того, как этот процесс подписал ресурсы и опубликовал их. До тех пор Latest остаётся на предыдущем опубликованном теге. После успеха проверки сопровождающие могут видеть Draft нового тега; это не публичный Latest.

Для уже установленных копий следуйте Обновлению и восстановлению.

Рекомендуемый путь

Используйте поддерживаемый упакованный установщик, если вы не разрабатываете из рабочей копии. Установщик выпуска — основной путь CLI в macOS и Linux; в Windows используйте нативный установщик PowerShell.

macOS (Apple Silicon)

curl -fsSL https://download.ax-code.com/install | bash

Windows

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://download.ax-code.com/install.ps1 | iex"

Ubuntu 24.04+

curl -fsSL https://download.ax-code.com/install | bash

Homebrew остаётся поддерживаемой альтернативой для CLI macOS:

brew tap defai-digital/tap
brew trust defai-digital/tap
brew install defai-digital/tap/ax-code

Homebrew требует явного доверия к неофициальным tap. Это доверие ко всему tap покрывает все текущие и будущие формулы, cask и внешние команды, опубликованные в defai-digital/tap. Общий tap содержит и формулу CLI, и cask Desktop, и Homebrew может загрузить оба определения, разрешая установку. Используйте установщик выпуска, если доверие ко всему tap неприемлемо.

Перенос существующей установки со старого tap

defai-digital/ax-code теперь tap только для миграции. Выпуски AX Code обновляют только defai-digital/tap. Если вы ставили со старого tap, добавьте общий tap перед обновлением, чтобы Homebrew мог перенести владение tap установленного пакета:

brew tap defai-digital/tap
brew trust --formula defai-digital/tap/ax-code
brew update
brew upgrade defai-digital/tap/ax-code
brew info defai-digital/tap/ax-code

Подтвердив, что установка использует общий tap, удалите старый tap:

brew untap defai-digital/ax-code

Если Homebrew всё ещё сообщает старый tap, выполните brew reinstall defai-digital/tap/ax-code, прежде чем отвязывать его. Старый репозиторий остаётся доступным, чтобы существующие установки обнаружили миграцию.

Проверка установщика Unix, закреплённого на версии

Для осмотренной установки Unix, закреплённой на версии, сначала скачайте установщик и его подпись из того же выпуска. Если доверенный minisign уже доступен:

AX_INSTALL_VERSION="<release>"
AX_INSTALL_BASE="https://download.ax-code.com/releases/download/v${AX_INSTALL_VERSION}"
curl -fsSL "$AX_INSTALL_BASE/install" -o ax-code-install
curl -fsSL "$AX_INSTALL_BASE/install.minisig" -o ax-code-install.minisig
minisign -Vm ax-code-install -x ax-code-install.minisig -P 'RWSlDu++afxCz01OqhYWhfo8+L8pVbSYXJBEb2zoWBuK0WACIzbGVZRO'
# Inspect ax-code-install before running it.
bash ax-code-install --version "$AX_INSTALL_VERSION" --no-modify-path

Подпись архива не удостоверяет скрипт начальной загрузки до выполнения. Дайджест, скачанный с того же источника, ловит порчу, но не является независимой проверкой личности издателя. Однострочный путь опирается на конечную точку распространения HTTPS.

Удалённое выполнение одной строкой — путь удобства. Установщик Windows проверяет скачанный ZIP CLI с помощью minisign после старта, но irm | iex не проверяет сам install.ps1 до выполнения.

Если minisign ещё нет в PATH, установщик PowerShell скачивает закреплённый архив minisign 0.12 с download.ax-code.com, проверяет его SHA-256 и снова проверяет извлечённый исполняемый файл перед кэшированием. Для пути установки по умолчанию ставить minisign вручную не нужно. Двоичный файл minisign, уже лежащий в PATH, используется как есть.

В средах, чувствительных к безопасности, скачайте установщик, проверьте его с помощью minisign, осмотрите и закрепите версию выпуска, которую использует CI:

$AX_CODE_VERSION = "<release>"
$AxCodeMinisignPublicKey = "RWSlDu++afxCz01OqhYWhfo8+L8pVbSYXJBEb2zoWBuK0WACIzbGVZRO"
irm https://download.ax-code.com/install.ps1 -OutFile ax-code-install.ps1
irm https://download.ax-code.com/install.ps1.minisig -OutFile ax-code-install.ps1.minisig
# Optional: use a preinstalled minisign, or let install.ps1 bootstrap one when verifying the archive.
minisign -Vm ax-code-install.ps1 -x ax-code-install.ps1.minisig -P $AxCodeMinisignPublicKey
Get-Content .\ax-code-install.ps1
.\ax-code-install.ps1 -Version $AX_CODE_VERSION -NoModifyPath

Задавайте AX_CODE_SKIP_MINISIGN_VERIFY=1, только когда сознательно принимаете загрузку выпуска, которую нельзя проверить.

Проверьте установленную среду выполнения:

ax-code doctor

Поддерживаемые пользовательские установки должны сообщать Runtime: Node vX.Y.Z (node-bundled) в macOS, Windows и Linux (glibc).

Эти установщики распространяют среду выполнения CLI/TUI. Владение выпуском Desktop — у AX Coder, а новые выпуски Desktop сейчас заморожены. Это руководство не даёт канала установки или обновления Desktop.

Матрица каналов

node-bundled и source — режимы среды выполнения, а не имена менеджеров пакетов. Они описывают, какой исполняемый файл загружает код приложения:

• node-bundled: Node.js загружает комплектную среду выполнения выпуска (все поддерживаемые каналы пользовательской установки).
• source: Node загружает файлы напрямую из рабочей копии.

compiled и bun-bundled — выведенные режимы эпохи Bun, сохранённые только для устаревшей диагностики. Это не поддерживаемые каналы пользовательской установки.

pnpm dev и pnpm cli компилируют SDK рабочей области (packages/sdk/js) в dist репозиторным TypeScript до запуска, поэтому свежая рабочая копия запускается без ручной сборки SDK. Шаг вызывает typescript/bin/tsc через node напрямую и не зависит от того, связан ли node_modules/.bin. Комплектным путям (pnpm run setup:cli и pnpm --dir packages/ax-code run build) всё ещё сначала нужен pnpm --dir packages/sdk/js run build.

Политика платформ

• macOS: используйте установщик выпуска bash как основной документированный путь CLI. Он ставится в ~/.ax-code, при необходимости поднимает закреплённый Minisign, проверяет архив выпуска и не требует Homebrew. Архив darwin-arm64 включает самостоятельный sidecar AX Engine для локального вывода. Сборки участников используют pnpm run setup:cli.
• Поддерживаемый путь Homebrew явно добавляет tap и доверяет defai-digital/tap до полностью квалифицированных команд установки. Доверие ко всему tap включает все текущие и будущие формулы, cask и внешние команды общего tap; используйте установщик выпуска bash, когда такая область доверия неприемлема.
• CLI Linux: используйте установщик bash для Ubuntu Desktop/Server 24.04 LTS и новее на amd64 и arm64 (glibc). Сборки выпуска порождают ax-code-linux-x64.tar.gz и ax-code-linux-arm64.tar.gz на исполнителях Ubuntu 24.04, чтобы базовая линия glibc оставалась совместимой с 24.04+. Musl (Alpine) текущими архивами выпуска не поддерживается.
• Архивы CLI macOS: сборки выпуска публикуют только darwin-arm64 (Apple Silicon). Intel macOS не является поддерживаемой целью установки текущих пакетов CLI и Desktop.
• CLI Windows: используйте нативный установщик PowerShell. Он ставит ресурс выпуска GitHub в каталог пользователя и обновляет PATH пользователя, если не задан -NoModifyPath. Он проверяет скачанный ZIP закреплённым публичным ключом до распаковки и закрыто отказывает, если AX_CODE_SKIP_MINISIGN_VERIFY=1 не задан сознательно. Если нет minisign, установщик скачивает закреплённый архив minisign 0.12 с download.ax-code.com в %LOCALAPPDATA%\ax-code\tools\minisign и проверяет извлечённый исполняемый файл перед кэшированием. Двоичный файл minisign, уже лежащий в PATH, используется как есть. Используйте -Uninstall, чтобы удалить локальную для пользователя установку и запись PATH.
• Desktop Windows: используйте подписанный установщик Electron из GitHub Releases с именем AX-Code-<version>-win-x64.exe или AX-Code-<version>-win-arm64.exe. Ожидаемый издатель Authenticode — DEFAI Private Limited. Не описывайте install.ps1 как установщик Desktop. Тихая установка: .\AX-Code-<version>-win-x64.exe /S (NSIS).
• Winget: манифесты пакетов порождаются через pnpm exec tsx tools/winget/generate-manifests.ts --version <ver> и отправляются в microsoft/winget-pkgs (см. tools/winget/README.md). Пока они не опубликованы выше, GitHub Releases остаются источником истины установки Windows.
• npm: не является поддерживаемым каналом установки или обновления.

Удалённое выполнение одной строкой — путь удобства, не единственный путь. Держите в документации поток установщика, который можно осмотреть (а в Windows — проверить minisign), используйте закреплённые версии в CI и документируйте установщики платформ только с покрытием матрицы установки, которая проверяет ax-code --version и то, что ax-code doctor сообщает ожидаемый режим среды выполнения для этой платформы.

Установки предприятия и без присмотра

CLI Windows (локально для пользователя, без прав администратора)

# Pin version in CI/images
$env:AX_CODE_VERSION = "7.9.4"
irm https://download.ax-code.com/releases/download/v$env:AX_CODE_VERSION/install.ps1 -OutFile install.ps1
# Optional: verify install.ps1.minisig first (see SECURITY.md)
.\install.ps1 -Version $env:AX_CODE_VERSION -NoModifyPath
# Then add %USERPROFILE%\.ax-code\bin to the machine/user PATH via your MDM.

macOS (локально для пользователя / Homebrew / MDM)

Для локальной для пользователя установки CLI без Homebrew используйте установщик выпуска:

curl -fsSL https://download.ax-code.com/install | bash

Управляемые Mac могут использовать формулу Homebrew, чтобы обновления CLI следовали tap:

brew tap defai-digital/tap
brew trust defai-digital/tap
brew install defai-digital/tap/ax-code

Для установок DMG, упакованных MDM, используйте нотариально заверенный AX-Code-*-mac-arm64.dmg из GitHub Releases и проверяйте отсоединённый .minisig, когда политика требует проверок цепочки поставки.

Доступность Winget

Используйте публичный установщик, если нет проверенного общинного пакета CLI. Не считайте, что комплекты манифестов, размещённые на GitHub, доступны анонимно.

Обновление

Выберите канал, которому принадлежит активная установка:

Пользователям старого tap следует следовать миграции на общий tap. Вторая установка может затенить первую в PATH; перед сменой канала используйте which -a ax-code, ax-code --version и ax-code doctor. Установка автономной версии не удаляет Homebrew. Переходите между каналами только сознательно и сохраняйте данные сессий и конфигурации.

Самообновления Unix берут установщик из целевого выпуска и требуют его сопроводительный файл SHA-256. Отсутствующий установщик или дайджест останавливает обновление; запасного пути на изменяемую основную ветвь нет. Чтобы поставить более старый архив из выпуска без ресурсов установщика, скачайте и проверьте текущий выпущенный установщик, затем запустите его с --version <older-version>.

Автономные установки Unix используют ~/.ax-code/bin/ax-code как устойчивую символическую ссылку на уникальное поколение среды выполнения в ~/.ax-code/versions/. Установщик проверяет полное новое дерево, прежде чем переключить эту ссылку. Повторная установка версии создаёт свежее поколение. Оно сохраняет старые поколения и устаревшие файлы среды выполнения, чтобы уже работающие агенты могли продолжать загружать свои модули. Работающих агентов оно не перезапускает. Запустите новый клиент или среду выполнения, чтобы пользоваться новой версией; явно остановите активную работу перед перезапуском среды выполнения. Файлами Homebrew по-прежнему управляет Homebrew.

Для отката используйте проверенный установщик с --version <previous-version>. Файл version в каждом сохранённом поколении называет его выпуск. Старые поколения не подчищаются автоматически; остановив все процессы, которые их используют, вы можете удалить неиспользуемые поколения. При удалении сохраните сессии и конфигурацию через --keep-data --keep-config, если нужно; следуйте указаниям по удалению двоичного файла и отдельно удаляйте неиспользуемые поколения среды выполнения только после остановки их процессов. Не удаляйте весь каталог .ax-code, если там хранятся другая конфигурация или личные файлы.

Одновременная установка Unix завершается ошибкой с расположением каталога .install-lock. Резко убитый установщик может оставить этот пустой каталог. Проверьте активные установщики, прежде чем удалять устаревшую блокировку и повторять; не удаляйте её, пока установка идёт.

powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://download.ax-code.com/install.ps1 | iex"

В Windows это обновляет CLI. Чтобы удалить установку CLI и её запись PATH пользователя:

irm https://download.ax-code.com/install.ps1 -OutFile ax-code-install.ps1
.\ax-code-install.ps1 -Uninstall

Поведение запускателя участника

Этот раздел требует разрешённой рабочей копии исходников. Для публичной установки или обновления он не нужен; см. Доступ к исходникам.

pnpm run setup:cli по умолчанию намеренно идёт по скомпилированному пути. Он собирает или переиспользует локальный комплектный двоичный файл в packages/ax-code/dist/... и ставит глобальный запускатель, который указывает на этот двоичный файл. Так локальные проверки упакованной среды выполнения остаются близки к тому, что запускают пользователи Homebrew и установщика curl.

Этот запускатель обычно оказывается в ~/.local/bin или PNPM_HOME, что обычно раньше в PATH, чем Homebrew. Если Homebrew уже предоставляет ax-code, setup:cli ставит рабочую копию как ax-code-src и удаляет ранее записанную обёртку ax-code, чтобы brew upgrade ax-code продолжал обновлять команду ax-code. Используйте pnpm run setup:cli -- --override-homebrew, только когда сознательно хотите, чтобы рабочая копия заняла ax-code. ax-code doctor всё ещё предупреждает об этом перекрытии как о PATH launchers.

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

pnpm --dir packages/ax-code run build -- --single
pnpm run setup:cli -- --rebuild
ax-code-src --version   # or `ax-code` if Homebrew is not installed

Используйте запускатель исходников, только когда сознательно хотите, чтобы команда рабочей копии выполняла эту копию через Node из файлов исходников:

pnpm run setup:cli -- --source
ax-code-src doctor      # or `ax-code doctor` if Homebrew is not installed

Запускатель исходников должен сообщать Runtime: Node vX.Y.Z (source).

Требования цепочки инструментов

Репозиторий принуждает pnpm@10.33.4 через корневое поле packageManager и only-allow pnpm: хук preinstall блокирует установки не через pnpm, а корневые хуки pre<script> блокируют npm run <script> с тем же требованием. Node.js должен совпадать с корневым движком package.json (>=26), который также даёт --experimental-ffi для команд TUI в режиме исходников.

Не используйте корневой pnpm test; корневой скрипт намеренно завершается с do not run tests from root. Для packages/ax-code запускайте тесты из packages/ax-code/.

Установки Homebrew получают уведомления об обновлениях без автоматических фоновых обновлений. Завершите активные запуски агента, прежде чем явно обновлять или чистить старые keg Homebrew.