Esta página é uma tradução da documentação em inglês. Comandos, identificadores e exemplos permanecem iguais. Runtime 7.24.4 · SDK 2.6.7. Original em inglês

Idiomas da TUI e configuração inicial

Status: Ativo

Escopo: estado atual

Última revisão: 2026-09-14

Responsável: runtime do ax-code

A TUI do AX Code suporta inglês (en), chinês tradicional (zh-TW), chinês simplificado (zh-CN), japonês (ja), coreano (ko), espanhol (es), português brasileiro (pt-BR), francês (fr), alemão (de), russo (ru), indonésio (id), turco (tr), vietnamita (vi) e italiano (it). As superfícies localizadas incluem configuração, navegação, comandos comuns, ajuda de teclado, controles do prompt, escolhas de provedor, decisões de permissão, diálogos de sessão, status do runtime e a apresentação de Council e Arena.

Execute /language (alias /lang) para escolher, de forma independente, o idioma da interface e o idioma da conversa. O seletor de idioma mostra cada idioma na própria escrita. Mudanças de interface valem na hora. Mudanças de conversa valem para os prompts seguintes e para os comandos de barra apoiados em modelo, inclusive pedidos de Council e de Arena. Auto preserva o comportamento já existente da conversa. Instruções explícitas do usuário e regras do projeto têm precedência sobre a preferência. Comandos de shell são enviados sem alteração.

A mensagem original do usuário é preservada. As preferências de conversa seguem à parte; o AX Code não traduz a tarefa antes da execução. Comentários de código, commits e documentos seguem as regras do projeto, com inglês pedido por padrão quando uma preferência explícita de conversa está selecionada. Identificadores técnicos, caminhos, comandos, saída bruta de ferramenta e evidência citada permanecem inalterados.

Configuração inicial

Uma instalação interativa nova, sem provedor nem sessão configurados, oferece a configuração rápida depois da inicialização:

Escolha o idioma da interface. Os catorze idiomas estão disponíveis juntos; use as setas para rolar a lista em terminais curtos.
Conecte um provedor e selecione um modelo pelos diálogos de conexão já existentes. Escolha, conforme o caso, uma CLI de programação instalada, uma API de nuvem, um runtime local, um endpoint de GPU privada ou um gateway AX Trust.
Comece uma tarefa. Uma revisão somente leitura é uma boa primeira tarefa; inspecione os comandos e o escopo deles antes de aprovar.

Você pode pular a configuração e reabri-la com /setup. Cancelar a configuração do provedor volta à lista de verificação. Usuários já configurados, sessões retomadas e inicializações explícitas de --prompt não são interrompidos. Erros de carga e de conexão continuam separados de uma instalação ainda sem configuração. Selecionar um modelo estabelece que a configuração está pronta; o primeiro pedido confere a conexão ao vivo. A configuração não concede permissões, não instala runtimes e não baixa modelos automaticamente.

Configuração

Padrões opcionais ficam em tui.json, não na configuração legada language do runtime:

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

Valores de interface: en, zh-TW, zh-CN, ja, ko, es, pt-BR, fr, de, ru, id, tr, vi e it. A conversa também aceita auto. Os padrões são en e auto. Escolhas feitas por /language ficam salvas no estado local da TUI e substituem estes padrões do arquivo. Use /language para mudá-las de novo. As escolhas de idioma não alteram credenciais nem a política do servidor.

A localização de Council e de Arena muda apenas os rótulos de apresentação. A evidência dos membros, as contagens de apoio, a ordem de classificação, o estado de verificação e os erros brutos permanecem intactos. Texto de autorização fornecido pelo provedor, saída especializada de ferramenta e superfícies especializadas de diagnóstico ainda podem aparecer no idioma original. Saída bruta de ferramenta, identificadores técnicos, conteúdo do usuário e a documentação não são traduzidos.

Para quem contribui, pnpm --dir packages/ax-code run check:tui-locales valida catálogos completos, espaços reservados, normalização NFC, grafias compartilhadas já revisadas, proteções no código-fonte do menu central e a renderização de diálogos nativos com mudanças de idioma ao vivo. Mantenha catálogos revisados separados para cada idioma; não derive o chinês tradicional apenas por conversão de caracteres.

Os catálogos em vietnamita usam NFC. O truncamento da exibição preserva agrupamentos de grafema, inclusive entrada decomposta. As verificações de renderização nativa cobrem terminais de 36 e de 80 colunas. Terminais configurados para desenhar caracteres de largura ambígua como duas células exigem qualificação específica desse terminal; o renderizador atual não expõe um modo de teste para largura ambígua.