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

Documentação do AX Code

Status: Ativo Escopo: público, estado atual Última revisão: 2026-10-09 Responsável: mantenedores do AX Code

O AX Code é um runtime de agente de código para trabalho revisável e reversível: cada sessão é registrada como um log estruturado de eventos com instantâneos de arquivo, implementações candidatas podem ser verificadas contra as próprias checagens do repositório, e nada faz merge sozinho. Por que o AX Code explica o que isso otimiza, para quem é e o que, de propósito, não afirma.

O README da raiz é o caminho mais curto para instalar e iniciar o AX Code. Use este hub quando precisar configurar um fluxo, entender uma fronteira de runtime ou integrar o AX Code a outro sistema.

Registros internos de processo (PRDs, ADRs, especificações, roteiros, planos de implementação, revisões competitivas e arquivos de trabalho de auditoria) ficam em .internal/, não nesta árvore pública — veja “Fronteiras da documentação” abaixo. As páginas públicas são as ligadas aqui.

Site público: ax-code.app/pt-BR/docs/. Para instalações já existentes, comece por Atualização e recuperação. O acesso ao código-fonte e os downloads públicos são separados; veja Acesso ao código-fonte.

Escolha pela tarefa

Para navegação compartilhada e opcional do terminal por um cliente MCP externo, veja Compartilhar uma TUI ao vivo pelo MCP.

Para a ponte experimental de navegador (ler páginas e, se quiser, clicar e preencher), veja Ponte de navegador WebMCP.

Para perguntas isoladas sobre arquivos selecionados, com cache do AX Trust, veja Perguntas de contexto fixo.

Primeiros passos

• Standard e Business — Standard de código aberto, uso comercial gratuito, Business proprietário planejado e o estado do acesso público.

• Por que o AX Code — o que o AX Code otimiza, o público pretendido, em que difere e o que não afirma.

• Comece aqui — o modelo mental do produto e os caminhos mais curtos por caso de uso.

• Canais de instalação e de runtime — plataformas com suporte, pacotes, atualizações e lançadores de quem contribui.

Guias de runtime

• Visualização de evidência da wiki — abra um grafo local das relações registradas entre página e fonte da wiki, ou exporte HTML offline. Inclui capturas radial, de força e de foco de página da própria wiki do AX Code.
• Recapitulação da conversa — atualize-se sobre o trabalho recente com /recap e configure faixas de ociosidade.
• Notificações de áudio — sons do sistema e alertas falados opcionais quando uma execução precisa da sua atenção.
• Evidência de execução — grafo, comparação, reprodução, risco, reversão, ramo, rastreio e exportação de auditoria.
• Alterações verificadas com vários modelos — o fluxo de council e de arena de ponta a ponta.
• Modo sandbox — modos de isolamento, caminhos protegidos, controles de rede e precedência.
• Modo de operações na nuvem — fluxo de planejar, aprovar e aplicar, tokens de aprovação e a postura do agente cloudops.
• Modo autônomo — execução sem supervisão, aprovações, uso headless e proteções.
• CLI headless — o comando de uma vez ax-code run para scripts, CI e quem chama o agente.
• Idiomas e configuração da TUI — idiomas da interface e da conversa, configuração da primeira vez.
• Animações da TUI — pares de abertura e de encerramento, capacidades do terminal e reservas de renderização.
• Modo de laço e tarefas agendadas — prompts recorrentes, agendas duráveis e limites de execução longa.
• Operações de longa duração — exemplos de serviço supervisionado, semântica de recuperação e checagens operacionais.
• Modos de execução — comportamento de agente, híbrido, council e arena.
• Boas práticas de roteamento entre vários modelos — separe raciocínio premium e trabalho de apoio de menor custo sem enfraquecer em silêncio tarefas sensíveis à correção.
• Recuperação de modelo — seleção exata de modelo, configuração explícita de alternativa e diagnóstico.
• Rota automática — roteamento de especialista e roteamento opcional por complexidade.
• Esforço do modelo — níveis de raciocínio e comportamento específico do provedor.
• Desempenho — perfis de ferramenta de código e diagnóstico local de tempo de solicitação.
• Uso de memória — perfis de memória, retenção de cache e limites de saída em segundo plano.
• Cache local de evidência — reutilização opcional de evidência em SQLite e RocksDB, qualificação e reversão.
• Hooks de ciclo de vida — eventos de hook e pacotes de política empacotados.
• Relatório de execução — uso do workspace, atividade, divisões de modelo e de ferramenta, e relatórios por sessão.

Provedores

• Provedores e modelos com suporte — IDs de provedor, credenciais e descoberta de modelo.
• Início rápido das APIs de nível gratuito — caminhos compatíveis sem custo, restrições e avaliação segura.
• Provedores personalizados e gateways — endpoints compatíveis com OpenAI e com Anthropic.
• Configuração de MTPLX e oMLX — presets locais de checkout do código, descoberta, ferramentas e autenticação.
• Resumo entre pares do Tiel (20 de setembro de 2026) — números atuais da API nativa de Tiel e Cyber-Tiel contra o MTPLX; padrão de conclusão 194.88, pico de decodificação 249.01.
• Reteste de cliente AX Code e OpenCode — seis combinações de cliente e runtime, MTP ativo, tempos da primeira vez e da repetição, e checagens de código.
• Medições de inferência local — testes datados de AX Code, OpenCode e runtime, com limites de tempo e de comparabilidade.
• Seleção de modelo do AX Engine — classificação de modelo local e orientação de memória.

Integrações

• Integrações MCP — confiança, permissões, recursos e segurança do servidor.
• ACP — o caminho feliz do Agent Client Protocol para hosts de IDE.
• AX Wiki — conhecimento do repositório apoiado na fonte e fluxo de CI.
• Integração com o VS Code — comandos do editor, configurações e fluxos. Instale a partir da listagem do marketplace.

SDK e fronteiras de serviço

• @defai-digital/ax-code-sdk — incorporação de primeira parte em TypeScript e JavaScript.
• Transporte nativo do SDK — fronteira de área de trabalho e nativa no formato gRPC, e comportamento de reserva.
• Compatibilidade de HTTP e OpenAPI — modo servidor e clientes gerados para outras linguagens.
• Instantâneo OpenAPI — contrato autoritativo de rotas HTTP e de esquema.

Arquitetura e confiabilidade

• Camada semântica — proveniência de grafo e de LSP, auditoria e fronteiras de reprodução.
• Arquitetura do motor local — por que o AX Code usa um sidecar do AX Engine.
• Estabilidade do runtime — contratos de cancelamento, falha, fluxo, tempo limite e confiabilidade da TUI.

Referência

• Esquema JSON de configuração — contrato gerado de entrada de configuração.

• Suporte nativo a TypeScript — compilador do código-fonte, serviço de linguagem, diagnósticos e compatibilidade.

• Catálogo de skills e plugins — skills empacotadas, skills de projeto, plugins e avaliações.

• Pacotes de política de isolamento — exemplos de política legíveis por máquina.

• Verificação de versão — chave pública canônica do Minisign e comando de verificação.

• Integridade do runtime no Windows — assinaturas, verificação de arquivos instalados e evidência de antivírus.

• Política de segurança — modelo de ameaça, armazenamento de credenciais e versões com suporte.

Fronteiras da documentação

docs/ contém orientação pública para comportamento que existe num runtime lançado. Material de planejamento, alvos de versão, política de implementação e análise temporária não pertencem a este lugar:

Cada página pública em Markdown deve declarar, perto do topo, o status, o escopo, a data da última revisão e o responsável. Prefira ligações para contratos gerados ou para fontes de implementação, em vez de listas copiadas de rotas e de outros instantâneos que envelhecem rápido.

Lista de manutenção

Antes de uma versão ou de uma mudança substancial de documentação:

1. Confira comandos, padrões, marcas, IDs de provedor e rótulos de runtime contra a implementação.
2. Atualize o guia autoritativo mais estreito, em vez de repetir o mesmo comportamento em várias páginas de entrada.
3. Execute pnpm run test:scripts para apanhar ligações locais quebradas, páginas órfãs e metadados de página ausentes.
4. Atualize o manifesto de exportação aprovado e execute node script/export-public-docs.mjs --website /path/to/ax-code.app, depois execute a checagem do site, a compilação e os testes de fumaça dos Workers. As compilações do site usam o instantâneo enviado e não exigem acesso ao código-fonte. Páginas e ativos públicos novos precisam ser aprovados de forma explícita no manifesto.
5. Mantenha propostas, notas de desenvolvimento do projeto, alvos de versão e registros históricos de decisão em .internal/, não na navegação pública.