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

Idiomas de la TUI y configuración inicial

Estado: Activo

Alcance: estado actual

Última revisión: 2026-09-14

Responsable: entorno de ejecución de ax-code

La TUI de AX Code admite inglés (en), chino tradicional (zh-TW), chino simplificado (zh-CN), japonés (ja), coreano (ko), español (es), portugués de Brasil (pt-BR), francés (fr), alemán (de), ruso (ru), indonesio (id), turco (tr), vietnamita (vi) e italiano (it). Las superficies localizadas incluyen la configuración, la navegación, los comandos habituales, la ayuda del teclado, los controles del prompt, las elecciones de proveedor, las decisiones de permiso, los diálogos de sesión, el estado del entorno de ejecución y la presentación de Council y Arena.

Ejecuta /language (alias /lang) para elegir por separado el idioma de la interfaz y el idioma de la conversación. El selector de idioma muestra cada idioma en su propia escritura. Los cambios de interfaz se aplican de inmediato. Los cambios de conversación se aplican a los prompts posteriores y a los comandos de barra respaldados por el modelo, incluidas las solicitudes de Council y Arena. Auto conserva el comportamiento existente de la conversación. Las instrucciones explícitas del usuario y las reglas del proyecto tienen precedencia sobre la preferencia. Los comandos de shell se envían sin cambios.

El mensaje original del usuario se conserva. Las preferencias de conversación se transportan aparte; AX Code no traduce la tarea antes de ejecutarla. Los comentarios del código, los commits y los documentos siguen las reglas del proyecto, y se pide inglés de forma predeterminada cuando se selecciona una preferencia explícita de conversación. Los identificadores técnicos, las rutas, los comandos, la salida bruta de las herramientas y la evidencia citada permanecen sin cambios.

Configuración inicial

Una instalación interactiva nueva, sin proveedor ni sesión configurados, ofrece una configuración rápida después de la inicialización:

1. Elige el idioma de la interfaz. Los catorce idiomas están disponibles a la vez; usa las teclas de flecha para desplazar la lista en terminales cortos.
2. Conecta un proveedor y selecciona un modelo mediante los diálogos de conexión existentes. Elige, según convenga, una CLI de programación instalada, una API en la nube, un entorno de ejecución local, un endpoint de GPU privada o una puerta de enlace AX Trust.
3. Empieza una tarea. Una revisión de solo lectura es una primera tarea útil; inspecciona los comandos y su alcance antes de aprobar.

Puedes omitir la configuración y volver a abrirla con /setup. Cancelar la configuración del proveedor vuelve a la lista de comprobación. Los usuarios ya configurados, las sesiones reanudadas y los lanzamientos explícitos de --prompt no se interrumpen. Los errores de carga y de conexión siguen siendo distintos de una instalación sin configurar. Seleccionar un modelo establece que la configuración está lista; la primera solicitud comprueba la conexión en vivo. La configuración no concede permisos, no instala entornos de ejecución ni descarga modelos de forma automática.

Configuración

Los valores predeterminados opcionales van en tui.json, no en el ajuste heredado language del entorno de ejecución:

{
  "interface_language": "zh-TW",
  "conversation_language": "ja"
}

Valores de interfaz: en, zh-TW, zh-CN, ja, ko, es, pt-BR, fr, de, ru, id, tr, vi, it. La conversación también acepta auto. Los valores predeterminados son en y auto. Las elecciones hechas mediante /language se guardan en el estado local de la TUI y anulan estos valores predeterminados del archivo. Usa /language para cambiarlas de nuevo. Las elecciones de idioma no cambian las credenciales ni la política del servidor.

La localización de Council y Arena cambia solo las etiquetas de presentación. La evidencia de los miembros, los recuentos de apoyo, el orden de clasificación, el estado de verificación y los errores brutos permanecen intactos. El texto de autorización aportado por el proveedor, la salida de herramientas especializadas y las superficies de diagnóstico especializadas pueden seguir apareciendo en su idioma original. No se traducen la salida bruta de las herramientas, los identificadores técnicos, el contenido del usuario ni la documentación.

Para quienes contribuyen, pnpm --dir packages/ax-code run check:tui-locales valida catálogos completos, marcadores de posición, la normalización NFC, las grafías compartidas revisadas, las protecciones del código fuente del menú principal y el renderizado de diálogos nativos con cambios de idioma en vivo. Mantén catálogos revisados aparte para cada idioma; no derives el chino tradicional solo mediante conversión de caracteres.

Los catálogos de vietnamita usan NFC. El truncamiento de la visualización conserva los clústeres de grafemas, incluida la entrada descompuesta. Las comprobaciones de renderizado nativo cubren terminales de 36 y 80 columnas. Los terminales configurados para renderizar los caracteres de ancho ambiguo como dos celdas exigen una cualificación específica del terminal; el renderizador actual no expone un modo de prueba de ancho ambiguo.