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

Documentación de AX Code

Estado: Activo Alcance: público, estado actual Última revisión: 2026-10-09 Responsable: mantenedores de AX Code

AX Code es un entorno de ejecución de agente de programación para trabajo revisable y reversible: cada sesión se registra como un registro estructurado de eventos con instantáneas de archivos, las implementaciones candidatas se pueden verificar contra las comprobaciones propias del repositorio y nada se fusiona de forma automática. Por qué AX Code explica para qué optimiza eso, a quién va dirigido y qué no afirma de forma deliberada.

El README raíz es el camino más corto para instalar y arrancar AX Code. Usa este centro cuando necesites configurar un flujo, entender un límite del entorno de ejecución o integrar AX Code con otro sistema.

Los registros de proceso internos (PRD, ADR, especificaciones, hojas de ruta, planes de implementación, revisiones competitivas y archivos de trabajo de auditoría) viven bajo .internal/, no en este árbol público: consulta «Límites de la documentación» más abajo. Las páginas públicas son las que se enlazan aquí.

Sitio web público: ax-code.app/es/docs/. Para instalaciones existentes, empieza por Actualización y recuperación. El acceso al código fuente y las descargas públicas van aparte; consulta Acceso al código fuente.

Elige por tarea

Para la navegación compartida y optativa de la terminal mediante un cliente MCP externo, consulta Compartir una TUI en vivo mediante MCP.

Para el puente experimental del navegador (leer páginas y, de forma opcional, hacer clic y rellenar), consulta Puente de navegador WebMCP.

Para preguntas autónomas sobre archivos elegidos mediante la caché de AX Trust, consulta Preguntas de contexto fijo.

Quiero…	Empieza aquí
Decidir si AX Code encaja con mi trabajo	Por qué AX Code
Entender AX Code antes de instalarlo	Empieza aquí
Revisar, comparar o deshacer lo que hizo un agente	Evidencia de ejecución
Hacer que varios modelos intenten el mismo cambio	Cambios verificados de varios modelos
Elegir un canal de instalación o de entorno	Canales de instalación y del entorno de ejecución
Conectar un proveedor alojado, de CLI, personalizado o local	Proveedores y modelos compatibles
Activar la inferencia local gestionada en Apple Silicon	Selección de modelos de AX Engine
Leer las cifras actuales de velocidad de Tiel frente a MTPLX	Resumen comparativo de Tiel (20 September 2026)
Probar AX Code con una API de modelo de nivel gratuito	Inicio rápido de API de nivel gratuito
Ejecutar un agente con límites seguros de archivos y de red	Modo sandbox
Administrar infraestructura de nube o de red con seguridad	Modo de operaciones en la nube
Ejecutar sin supervisión o en CI	Modo autónomo
Llamar a la CLI de un solo uso `ax-code run` desde scripts o CI	CLI sin interfaz
Ejecutar prompts recurrentes o programar tareas duraderas	Modo de bucle y tareas programadas
Oír un sonido o un aviso hablado cuando una ejecución necesita atención	Notificaciones de audio
Mantener el trabajo programado tras salidas del proceso o del host	Operaciones de larga duración
Elegir ejecución local, en la nube, híbrida, council o arena	Modos de ejecución
Conectar herramientas y datos externos	Integraciones MCP
Dejar que el agente lea y actúe en Chrome mediante WebMCP	Puente de navegador WebMCP
Integrar AX Code en una aplicación	`@defai-digital/ax-code-sdk`
Generar un cliente para otro lenguaje	Compatibilidad HTTP y OpenAPI
Construir un host de escritorio o nativo	Transporte del SDK nativo

Primeros pasos

Standard y Business: Standard de código abierto, uso comercial gratuito, Business propietario previsto y estado del acceso público.
Por qué AX Code: para qué optimiza AX Code, su público previsto, en qué se diferencia y qué no afirma.
Empieza aquí: modelo mental del producto y los caminos más cortos por caso de uso.
Canales de instalación y del entorno de ejecución: plataformas admitidas, paquetes, actualizaciones y lanzadores para colaboradores.

Guías del entorno de ejecución

Visualización de evidencia de la wiki: abre un grafo local de relaciones registradas entre páginas y fuentes de la wiki, o exporta HTML sin conexión. Incluye capturas radiales, de fuerza y de foco de página de la propia wiki de AX Code.
Resumen de la conversación: ponte al día del trabajo reciente con /recap y configura los avisos de inactividad.
Notificaciones de audio: sonidos del sistema y avisos hablados optativos cuando una ejecución necesita tu atención.
Evidencia de ejecución: grafo, comparación, reproducción, riesgo, reversión, rama, traza y exportación de auditoría.
Cambios verificados de varios modelos: el flujo de council y arena de extremo a extremo.
Modo sandbox: modos de aislamiento, rutas protegidas, controles de red y precedencia.
Modo de operaciones en la nube: flujo de planificar, aprobar y aplicar, tokens de aprobación y la postura del agente cloudops.
Modo autónomo: ejecución sin supervisión, aprobaciones, uso sin interfaz y salvaguardas.
CLI sin interfaz: el comando de un solo uso ax-code run para scripts, CI y quienes llaman desde un agente.
Idiomas y configuración de la TUI: idiomas de la interfaz y de la conversación, y la primera configuración.
Animaciones de la TUI: pares de apertura y de cierre, capacidades de la terminal y reservas de representación.
Modo de bucle y tareas programadas: prompts recurrentes, programaciones duraderas y límites de ejecución larga.
Operaciones de larga duración: ejemplos de servicio supervisado, semántica de recuperación y comprobaciones operativas.
Modos de ejecución: comportamiento de agente, híbrido, council y arena.
Buenas prácticas de enrutado de varios modelos: separa el razonamiento de primer nivel y el trabajo de apoyo de menor coste sin debilitar en silencio las tareas sensibles a la corrección.
Recuperación de modelos: selección exacta de modelo, configuración explícita de reserva y diagnósticos.
Auto-Route: enrutado de especialistas y enrutado opcional por complejidad.
Esfuerzo del modelo: niveles de pensamiento y comportamiento específico del proveedor.
Rendimiento: perfiles de herramientas de programación y diagnósticos locales de tiempo de solicitud.
Uso de memoria: perfiles de memoria, retención de caché y límites de salida en segundo plano.
Caché local de evidencia: reutilización opcional de evidencia en SQLite y RocksDB, cualificación y reversión.
Hooks de ciclo de vida: eventos de hook y paquetes de política incluidos.
Informe de ejecución: uso del espacio de trabajo, actividad, desgloses de modelo y de herramienta, e informes por sesión.

Proveedores

Proveedores y modelos compatibles: ID de proveedor, credenciales y descubrimiento de modelos.
Inicio rápido de API de nivel gratuito: caminos compatibles sin coste, restricciones y evaluación segura.
Proveedores personalizados y de pasarela: endpoints compatibles con OpenAI y con Anthropic.
Configuración de MTPLX y oMLX: ajustes locales de la copia de trabajo, descubrimiento, herramientas y autenticación.
Resumen comparativo de Tiel (20 September 2026): cifras actuales de la API nativa de Tiel y Cyber-Tiel frente a MTPLX; completado predeterminado 194.88, pico de decode 249.01.
Repetición de prueba de clientes AX Code/OpenCode: seis combinaciones de cliente y entorno, MTP activo, tiempos de primera vez y de repetición, y comprobaciones de código.
Mediciones de inferencia local: pruebas fechadas de AX Code, OpenCode y del entorno, con límites de tiempo y de comparabilidad.
Selección de modelos de AX Engine: clasificación de modelos locales y orientación de memoria.

Integraciones

Integraciones MCP: confianza, permisos, recursos y seguridad del servidor.
ACP: el camino feliz de Agent Client Protocol para hosts de IDE.
AX Wiki: conocimiento del repositorio respaldado por la fuente y flujo de CI.
Integración con VS Code: comandos del editor, ajustes y flujos. Instálala desde la ficha del mercado.

SDK y límites del servicio

@defai-digital/ax-code-sdk: integración de primera parte en TypeScript y JavaScript.
Transporte del SDK nativo: límite de escritorio y nativo con forma de gRPC, y comportamiento de reserva.
Compatibilidad HTTP y OpenAPI: modo servidor y clientes generados para otros lenguajes.
Instantánea de OpenAPI: contrato autorizado de rutas HTTP y de esquema.

Arquitectura y fiabilidad

Capa semántica: procedencia de grafo y de LSP, auditoría y límites de reproducción.
Arquitectura del motor local: por qué AX Code usa un sidecar de AX Engine.
Estabilidad del entorno de ejecución: contratos de cancelación, fallo, flujo, tiempo de espera y fiabilidad de la TUI.

Referencia

Esquema JSON de configuración: contrato generado de entrada de configuración.
Soporte nativo de TypeScript: compilador de código fuente, servicio de lenguaje, diagnósticos y compatibilidad.
Catálogo de skills y plugins: skills incluidas, skills de proyecto, plugins y evaluaciones.
Paquetes de política de aislamiento: ejemplos de política legibles por máquina.
Verificación de versiones: clave pública canónica de Minisign y comando de verificación.
Integridad del entorno de ejecución en Windows: firmas, verificación de archivos instalados y evidencia de antivirus.
Política de seguridad: modelo de amenazas, almacenamiento de credenciales y versiones admitidas.

Límites de la documentación

docs/ contiene orientación pública del comportamiento que existe en un entorno de ejecución publicado. El material de planificación, los objetivos de versión, la política de implementación y el análisis temporal no pertenecen aquí:

Contenido	Ubicación
Decisiones de arquitectura	`.internal/adr/`
Requisitos de producto y especificaciones técnicas	`.internal/prd/` y `.internal/spec/`
Hojas de ruta, planes de implementación, objetivos de versión, revisiones y auditorías	`.internal/reports/`
Comportamiento publicado y orientación pública de integración	`docs/`

Cada página Markdown pública debe declarar cerca del inicio su estado, alcance, fecha de última revisión y responsable. Prefiere enlaces a contratos generados o a fuentes de implementación antes que listas de rutas copiadas y otras instantáneas que cambian mucho.

Lista de mantenimiento

Antes de una versión o de un cambio sustancial de documentación:

Verifica comandos, valores predeterminados, indicadores, ID de proveedor y etiquetas de entorno frente a su implementación.
Actualiza la guía autorizada más estrecha en lugar de repetir el mismo comportamiento en varias páginas de entrada.
Ejecuta pnpm run test:scripts para detectar enlaces locales rotos, páginas huérfanas y metadatos de página ausentes.
Actualiza el manifiesto de exportación aprobado y ejecuta node script/export-public-docs.mjs --website /path/to/ax-code.app, y luego las comprobaciones del sitio, la compilación y las pruebas de humo de Workers. Las compilaciones del sitio usan la instantánea confirmada y no exigen acceso al código fuente. Las páginas y los activos públicos nuevos deben aprobarse de forma explícita en el manifiesto.
Mantén las propuestas, las notas de desarrollo del proyecto, los objetivos de versión y los registros históricos de decisiones bajo .internal/, no en la navegación pública.