Esta página es una traducción de la documentación en inglés. Los comandos, identificadores y ejemplos no cambian. Runtime 7.24.4 · SDK 2.6.7. Original en inglés

Canales de instalación y del entorno de ejecución

Estado: Activo Alcance: estado actual Última revisión: 2026-10-09 Responsable: runtime de ax-code

El README raíz conserva el camino de instalación principal. Esta página es la fuente de verdad de los canales de instalador de CLI admitidos, las etiquetas de entorno ax-code doctor, el comportamiento del lanzador local y el comportamiento público de actualización.

Disponibilidad pública

Los instaladores de versión pública y los archivos firmados del entorno de ejecución se distribuyen mediante download.ax-code.com. La instalación no exige credenciales privadas de GitHub.

AX Code y el SDK admiten solo Node.js 26 o posterior. Los instaladores autónomos incluyen un entorno Node verificado. Las copias de trabajo del código fuente y las aplicaciones del SDK basadas en Node deben aportar Node.js 26+; la instalación de paquetes rechaza versiones de Node más antiguas.

AX Code Standard sigue siendo gratuito para uso personal y comercial bajo su licencia existente. El acceso al código fuente de desarrollo se gestiona aparte de la distribución pública. Los componentes propietarios previstos de Business tienen una licencia aparte; esto no cambia la licencia de Standard. Consulta Standard y Business para los detalles y la guía del sitio web para las actualizaciones públicas de instalación. Los instaladores públicos y sus activos firmados deben ser accesibles y estar verificados antes de que el sitio anuncie un comando de instalación de una línea.

Disponibilidad de la versión

Enviar una etiqueta Git vMAJOR.MINOR.PATCH inicia el flujo de trabajo de Release. El índice público de versiones solo muestra una versión después de que ese flujo haya firmado los activos y los haya publicado. Hasta entonces, Latest permanece en la etiqueta publicada anterior. Después de que validate tenga éxito, los mantenedores pueden ver un borrador de la etiqueta nueva; no es el Latest público.

Para las instalaciones existentes, sigue Actualización y recuperación.

Camino recomendado

Usa un instalador empaquetado admitido salvo que desarrolles desde una copia de trabajo. El instalador de versión es el camino principal de la CLI en macOS y Linux; usa el instalador nativo de PowerShell en Windows.

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 sigue siendo una alternativa admitida para la CLI de macOS:

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

Homebrew exige una confianza explícita para los taps no oficiales. Esta confianza de todo el tap cubre todas las fórmulas actuales y futuras, los casks y los comandos externos publicados en defai-digital/tap. El tap compartido contiene tanto la fórmula de la CLI como el cask de Desktop, y Homebrew puede cargar ambas definiciones al resolver una instalación. Usa el instalador de versión si la confianza de todo el tap no es aceptable.

Mover una instalación existente desde el tap heredado

defai-digital/ax-code es ahora un tap solo de migración. Las versiones de AX Code actualizan solo defai-digital/tap. Si instalaste desde el tap heredado, añade el tap compartido antes de actualizar para que Homebrew pueda mover la propiedad del tap del paquete instalado:

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

Después de confirmar que la instalación usa el tap compartido, quita el tap heredado:

brew untap defai-digital/ax-code

Si Homebrew sigue informando del tap antiguo, ejecuta brew reinstall defai-digital/tap/ax-code antes de retirarlo. El repositorio heredado sigue siendo accesible para que las instalaciones existentes descubran la migración.

Verificar un instalador Unix fijado a una versión

Para una instalación Unix inspeccionada y fijada a una versión, descarga primero el instalador y su firma de la misma versión. Con un minisign de confianza ya disponible:

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

La firma del archivo no autentica el script de arranque antes de la ejecución. Un resumen descargado del mismo origen detecta la corrupción, pero no es una comprobación independiente de la identidad del publicador. El camino de una línea se apoya en el endpoint de distribución HTTPS.

La ejecución remota de una línea es un camino de comodidad. El instalador de Windows verifica el ZIP de la CLI descargado con minisign después de arrancar, pero irm | iex no verifica install.ps1 antes de la ejecución.

Si minisign no está ya en PATH, el instalador de PowerShell descarga el archivo fijado de minisign 0.12 desde download.ax-code.com, comprueba su SHA-256 y vuelve a comprobar el ejecutable extraído antes de guardarlo en caché. No necesitas instalar minisign a mano para el camino de instalación predeterminado. Un binario minisign que ya esté en PATH se usa tal cual.

En entornos sensibles a la seguridad, descarga el instalador, verifícalo con minisign, inspecciónalo y fija la versión de publicación que usa 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

Define AX_CODE_SKIP_MINISIGN_VERIFY=1 solo cuando aceptes a propósito una descarga de versión que no se pueda verificar.

Verifica el entorno de ejecución instalado:

ax-code doctor

Las instalaciones de usuario admitidas deben informar Runtime: Node vX.Y.Z (node-bundled) en macOS, Windows y Linux (glibc).

Estos instaladores distribuyen el entorno de ejecución de la CLI y la TUI. La propiedad de la versión de Desktop está en AX Coder, y las versiones nuevas de Desktop están congeladas por ahora. Esta guía no ofrece un canal de instalación ni de actualización de Desktop.

Matriz de canales

node-bundled y source son modos del entorno de ejecución, no nombres de gestores de paquetes. Describen qué ejecutable carga el código de la aplicación:

• node-bundled: Node.js carga el entorno de ejecución de la versión empaquetada (todos los canales de instalación de usuario admitidos).
• source: Node carga los archivos directamente desde una copia de trabajo.

compiled y bun-bundled son modos de entorno de la época de Bun, ya retirados, y se conservan solo para diagnósticos heredados. No son canales de instalación de usuario admitidos.

pnpm dev y pnpm cli compilan el SDK del espacio de trabajo (packages/sdk/js) a dist con el TypeScript del repositorio antes de arrancar, así que una copia de trabajo nueva se ejecuta sin una compilación manual del SDK. El paso invoca typescript/bin/tsc mediante node directamente, así que no depende de que node_modules/.bin esté enlazado. Los caminos empaquetados (pnpm run setup:cli y pnpm --dir packages/ax-code run build) siguen necesitando pnpm --dir packages/sdk/js run build primero.

Política de plataformas

• macOS: usa el instalador de versión bash como camino principal documentado de la CLI. Se instala bajo ~/.ax-code, prepara Minisign fijado cuando hace falta, verifica el archivo de la versión y no exige Homebrew. El archivo darwin-arm64 incluye un sidecar autónomo de AX Engine para inferencia local. Las compilaciones de colaboradores usan pnpm run setup:cli.
• El camino de Homebrew admitido hace tap y confía de forma explícita en defai-digital/tap antes de usar comandos de instalación totalmente cualificados. La confianza de todo el tap incluye todas las fórmulas, casks y comandos externos actuales y futuros del tap compartido; usa el instalador de versión bash cuando ese alcance de confianza no es aceptable.
• CLI de Linux: usa el instalador bash para Ubuntu Desktop/Server 24.04 LTS y posteriores en amd64 y arm64 (glibc). Las compilaciones de versión producen ax-code-linux-x64.tar.gz y ax-code-linux-arm64.tar.gz en ejecutores de Ubuntu 24.04 para que la línea base de glibc siga siendo compatible con 24.04+. Musl (Alpine) no está admitido por los archivos de versión actuales.
• Archivos de CLI de macOS: las compilaciones de versión publican solo darwin-arm64 (Apple Silicon). macOS de Intel no es un destino de instalación admitido para los paquetes actuales de CLI y Desktop.
• CLI de Windows: usa el instalador nativo de PowerShell. Instala el activo de versión de GitHub en un directorio local de usuario y actualiza el PATH del usuario salvo que se proporcione -NoModifyPath. Verifica el ZIP descargado con la clave pública fijada antes de extraerlo y falla cerrado salvo que AX_CODE_SKIP_MINISIGN_VERIFY=1 se defina a propósito. Si falta minisign, el instalador descarga el archivo fijado de minisign 0.12 desde download.ax-code.com en %LOCALAPPDATA%\ax-code\tools\minisign y comprueba el ejecutable extraído antes de guardarlo en caché. Un binario minisign que ya esté en PATH se usa tal cual. Usa -Uninstall para quitar la instalación local de usuario y la entrada de PATH.
• Desktop de Windows: usa el instalador Electron firmado de GitHub Releases, llamado AX-Code-<version>-win-x64.exe o AX-Code-<version>-win-arm64.exe. El publicador Authenticode esperado es DEFAI Private Limited. No describas install.ps1 como un instalador de Desktop. Instalación silenciosa: .\AX-Code-<version>-win-x64.exe /S (NSIS).
• Winget: los manifiestos del paquete se generan con pnpm exec tsx tools/winget/generate-manifests.ts --version <ver> y se envían a microsoft/winget-pkgs (consulta tools/winget/README.md). Hasta que se publiquen aguas arriba, GitHub Releases sigue siendo la fuente de verdad de la instalación en Windows.
• npm: no es un canal de instalación ni de actualización admitido.

La ejecución remota de una línea es un camino de comodidad, no el único. Conserva en la documentación un flujo de instalador inspeccionable (y, en Windows, verificado con minisign), usa versiones fijadas en CI y documenta los instaladores de plataforma solo con cobertura de la matriz de instalación que verifique ax-code --version y verifique que ax-code doctor informa del modo de entorno esperado para esa plataforma.

Instalaciones de empresa y sin supervisión

CLI de Windows (local de usuario, sin administrador)

# 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 (local de usuario / Homebrew / MDM)

Usa el instalador de versión para una instalación de CLI local de usuario sin Homebrew:

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

Los Mac gestionados pueden usar la fórmula de Homebrew para que las actualizaciones de la CLI sigan el tap:

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

Para instalaciones DMG empaquetadas por MDM, usa el AX-Code-*-mac-arm64.dmg notarizado de GitHub Releases y verifica el .minisig separado cuando la política exija comprobaciones de cadena de suministro.

Disponibilidad de Winget

Usa el instalador público salvo que haya un paquete de CLI de la comunidad verificado. No supongas que los lotes de manifiestos alojados en GitHub son accesibles de forma anónima.

Actualización

Elige el canal que posee la instalación activa:

Quienes usen el tap heredado deben seguir la migración al tap compartido. Una segunda instalación puede ocultar la primera en PATH; usa which -a ax-code, ax-code --version y ax-code doctor antes de cambiar de canal. Instalar la versión autónoma no desinstala Homebrew. Cambia de canal solo de forma deliberada y conserva tus datos de sesión y de configuración.

Las autoactualizaciones de Unix obtienen el instalador de la versión de destino y exigen su sidecar SHA-256. Un instalador o un resumen ausentes detienen la actualización; no hay una reserva de la rama principal mutable. Para instalar un archivo más antiguo de una versión sin activos de instalador, descarga y verifica un instalador publicado actual y luego ejecútalo con --version <older-version>.

Las instalaciones Unix autónomas usan ~/.ax-code/bin/ax-code como enlace simbólico estable hacia una generación única del entorno bajo ~/.ax-code/versions/. El instalador verifica el árbol nuevo completo antes de cambiar ese enlace. Reinstalar una versión crea una generación nueva. Conserva las generaciones antiguas y los archivos de entorno heredados para que los agentes que ya se ejecutan puedan seguir cargando sus propios módulos. No reinicia los agentes en ejecución. Inicia un cliente o entorno nuevo para usar la versión nueva; detén el trabajo activo de forma explícita antes de un reinicio del entorno. Los archivos de Homebrew siguen gestionados por Homebrew.

Para volver atrás, usa un instalador verificado con --version <previous-version>. El archivo version de cada generación conservada identifica su versión. Las generaciones antiguas no se podan de forma automática; después de detener todos los procesos que las usan, puedes quitar las generaciones no usadas. Durante la desinstalación, conserva las sesiones y la configuración con --keep-data --keep-config si hace falta; sigue la orientación de retirada del binario y quita por separado las generaciones de entorno no usadas solo después de que sus procesos se detengan. No borres toda la carpeta .ax-code si has guardado allí otra configuración o archivos personales.

Una instalación Unix concurrente falla con la ubicación del directorio .install-lock. Un instalador matado de forma abrupta puede dejar ese directorio vacío. Comprueba si hay instaladores activos antes de quitar un bloqueo obsoleto y reintentar; no lo quites mientras una instalación está en curso.

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

En Windows esto actualiza la CLI. Para quitar la instalación de la CLI y su entrada de PATH de usuario:

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

Comportamiento del lanzador para colaboradores

Esta sección exige una copia de trabajo autorizada del código fuente. No hace falta para la instalación pública ni para las actualizaciones; consulta Acceso al código fuente.

pnpm run setup:cli es, a propósito, de ruta compilada de forma predeterminada. Compila o reutiliza el binario local empaquetado bajo packages/ax-code/dist/... e instala un lanzador global que apunta a ese binario. Así las comprobaciones locales del entorno empaquetado se acercan a lo que ejecutan quienes usan Homebrew y el instalador por curl.

Ese lanzador suele quedar en ~/.local/bin o PNPM_HOME, que normalmente está antes en PATH que Homebrew. Si Homebrew ya proporciona ax-code, setup:cli instala la copia de trabajo como ax-code-src y quita un envoltorio ax-code escrito antes para que brew upgrade ax-code siga actualizando el comando ax-code. Usa pnpm run setup:cli -- --override-homebrew solo cuando quieras a propósito que la copia de trabajo tome ax-code. ax-code doctor sigue avisando de esa anulación como PATH launchers.

Después de cambios de código fuente que deban afectar al entorno empaquetado, refresca el binario empaquetado antes de probar el lanzador global:

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

Usa el lanzador de código fuente solo cuando quieras a propósito que el comando de la copia de trabajo ejecute esta copia mediante Node a partir de los archivos fuente:

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

El lanzador de código fuente debe informar Runtime: Node vX.Y.Z (source).

Requisitos de la cadena de herramientas

El repositorio exige pnpm@10.33.4 mediante el campo raíz packageManager y only-allow pnpm: el hook preinstall bloquea las instalaciones que no son de pnpm, y los hooks raíz pre<script> bloquean npm run <script> con el mismo requisito. Node.js debe coincidir con el motor raíz package.json (>=26), que también aporta --experimental-ffi para los comandos de TUI en modo de código fuente.

No uses el pnpm test raíz; el script raíz sale a propósito con do not run tests from root. Para packages/ax-code, ejecuta las pruebas desde packages/ax-code/.

Las instalaciones de Homebrew reciben avisos de actualización sin actualizaciones automáticas en segundo plano. Termina las ejecuciones activas del agente antes de actualizar de forma explícita o de limpiar kegs antiguos de Homebrew.