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

Empieza aquí

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

Si el README raíz es la forma más rápida de instalar AX Code, esta página es la forma más rápida de entenderlo.

Ediciones y disponibilidad

Empieza por AX Code Standard, la edición de código abierto gratuita para uso personal y comercial. Usa modelos locales o en la nube; AX Engine aporta un camino de inferencia local nativa en Mac con Apple Silicon compatibles. Los permisos existentes, la revisión de cambios y la evidencia local de ejecución siguen siendo capacidades centrales.

Business es una oferta propietaria prevista para el gobierno de la organización mediante AX Trust y para los flujos de negocio mediante AutomatosX. Usar Standard en el trabajo no exige por sí mismo una licencia de Business. Consulta Standard y Business para los detalles.

Los instaladores firmados y los archivos del entorno de ejecución están disponibles de forma anónima en download.ax-code.com. Lee la guía de instalación y la guía de actualización y recuperación. La documentación técnica pública se aloja en ax-code.app/es/docs/, con independencia del acceso al código fuente. ¿Ya está instalado? Abre una terminal en tu proyecto, ejecuta ax-code y luego usa /connect dentro de la TUI para elegir un proveedor. Empieza con una pregunta sobre el proyecto, pide un cambio pequeño y revisa el diff y las comprobaciones del proyecto antes de confirmar. Usa ax-code doctor si el entorno instalado necesita diagnóstico.

Qué es AX Code

AX Code es un entorno de ejecución de programación con IA. Combina:

• agentes para distintas tareas de programación
• ejecución explícita de herramientas
• selección de modelo y de proveedor
• estado de sesión persistente
• aislamiento y permisos configurables
• superficies de integración como la TUI, el SDK, el modo servidor y MCP

Eso importa porque la programación con IA solo es útil en repositorios reales cuando puedes controlar lo que el agente tiene permitido hacer, conservar el contexto entre sesiones y reutilizar el mismo flujo fuera de una sola ventana de chat.

De dónde sale el valor

AX Code optimiza el momento después de que el agente termina: decidir si conservar lo que produjo.

• Evidencia. Cada sesión se registra como un registro de eventos tipado más instantáneas de archivos, así que ax-code graph, compare, replay, risk y audit pueden reconstruir lo que ocurrió después de que termine la conversación.
• Verificación. Donde una compuerta es aplicable — candidatos de arena, aplicación de refactorización con compuerta — los comandos propios de comprobación de tipos, lint y pruebas del repositorio deciden si un resultado se acepta.
• Reversibilidad. Las instantáneas se pueden recuperar por paso, no solo por sesión, desde un almacén de objetos Git que se mantiene fuera de tu repositorio.
• Tu decisión. AX Code clasifica, puntúa e informa. No fusiona por ti.

Lo sostienen: herramientas explícitas con reglas de permisos y modos de aislamiento, sesiones duraderas, AGENTS.md para las convenciones del repositorio, portabilidad de proveedores y un solo entorno detrás de la TUI, la CLI, la extensión de VS Code, el SDK, el servidor sin interfaz y las integraciones MCP. Son cimientos, no el motivo para elegir AX Code: consulta Por qué AX Code.

Para los comandos en sí, consulta Evidencia de ejecución.

Modelo mental

Piensa en AX Code como cinco capas:

1. Capa de proveedor: elige el backend de modelo contra el que quieres ejecutar.
2. Capa de agente: elige el agente adecuado para la tarea, o deja que el enrutado ayude.
3. Capa de herramientas: el agente actúa mediante herramientas explícitas, no mediante capacidades ocultas.
4. Capa de sesión: la conversación, las decisiones y el estado persisten.
5. Capa de control: el aislamiento, los permisos y el comportamiento de auditoría definen el límite.

El resto de la documentación se corresponde con esas capas.

Elige el camino siguiente

Quiero probarlo rápido

• Empieza por el README raíz para la instalación y el primer arranque.
• Los caminos de instalación admitidos usan el entorno de ejecución compilado:
  • Instalador de versión Bash para macOS Apple Silicon y Linux: curl -fsSL -H "Accept: application/vnd.github.raw+json" "https://api.github.com/repos/defai-digital/ax-code/contents/install?ref=main" | bash
  • Alternativa de Homebrew para la CLI de macOS: brew tap defai-digital/tap && brew trust defai-digital/tap && brew install defai-digital/tap/ax-code
  • Instalador de versión de GitHub para PowerShell de Windows: powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://download.ax-code.com/install.ps1 | iex"
• El instalador Bash no es el camino canónico de configuración en Windows.
• Los paquetes npm ya no son canales de instalación ni de actualización admitidos. Consulta Canales de instalación y del entorno de ejecución para la política de plataformas, las etiquetas de entorno y la matriz del lanzador local.
• Usa /connect o ax-code providers login para definir un modelo. Consulta Proveedores y modelos compatibles para proveedores de API en la nube, proveedores CLI, AX Engine e ID de modelo. Para un camino de evaluación sin coste, usa el Inicio rápido de API de nivel gratuito.
• Ejecuta ax-code init después de abrir un proyecto real para que AGENTS.md capture las convenciones locales.
• Si quieres límites de seguridad más estrictos, activa el Modo sandbox antes de ediciones más amplias.

Quiero usarlo con seguridad en un repositorio de equipo o de empresa

• AX Code arranca con el modo autónomo activado y el modo sandbox desactivado: full-access con acceso sin restricciones al sistema de archivos y a la red.
• Para trabajo de equipo, de empresa, no confiable o sin supervisión, activa --sandbox workspace-write (o read-only) antes de empezar la tarea.
• Lee Modo sandbox para los límites de ejecución.
• Lee Modo autónomo si el agente se ejecutará sin supervisión.
• Lee Política de seguridad para el modelo de amenazas y los detalles de almacenamiento de credenciales.
• Lee Capa semántica si la procedencia y la reproducción importan en tu flujo.

Quiero integrarlo o automatizarlo

• Usa los puntos de entrada sin interfaz o gRPC de @defai-digital/ax-code-sdk para la integración en aplicaciones TypeScript.
• Usa Compatibilidad HTTP y OpenAPI para un límite de servicio, clientes generados y el contrato OpenAPI autorizado.
• Usa ax-code mcp add cuando el agente necesite herramientas o servicios externos.

Quiero entender el repositorio o aportar comentarios

• Lee el centro de documentación para el resto de la documentación pública.
• Lee CONTRIBUTING.md para la política actual de contribución externa.

Cuándo AX Code puede no encajar

AX Code es, a propósito, más que el autocompletado o un cuadro de chat alojado. Puede ser demasiado si:

• Solo necesitas sugerencias de código en línea y no quieres que los agentes ejecuten herramientas.
• Necesitas una experiencia solo SaaS alojada, sin entorno de ejecución local.
• No necesitas persistencia de sesión, reproducción, integración de SDK o servidor, ni instrucciones a nivel de repositorio.
• Trabajas en un entorno donde no se permite ningún proceso de CLI local.

En esos casos, un asistente de editor más ligero puede ser más sencillo. AX Code es más fuerte cuando el agente necesita operar dentro de flujos de desarrollo reales, con control, continuidad y límites de integración.

Primeros comandos habituales

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 se ejecuta exclusivamente mediante Grok Build CLI. Elige grok-build-cli en /connect; AX Code invoca el comando local grok y reutiliza el inicio de sesión de su CLI. El antiguo proveedor directo de API en la nube xai ya no se admite.

Mapa de la documentación