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

Comece aqui

Status: Ativo Escopo: estado atual Última revisão: 2026-09-16 Responsável: ax-code runtime

Se o README da raiz é o caminho mais rápido para instalar o AX Code, esta página é o caminho mais rápido para entendê-lo.

Edições e disponibilidade

Comece pelo AX Code Standard, a edição de código aberto gratuita para uso pessoal e comercial. Use modelos locais ou na nuvem; o AX Engine oferece um caminho nativo de inferência local em Macs Apple Silicon com suporte. Permissões existentes, revisão de alterações e evidência local de execução continuam sendo capacidades centrais.

Business é uma oferta proprietária planejada para a governança da organização pelo AX Trust e para fluxos de negócio pela AutomatosX. Usar o Standard no trabalho não exige, por si só, uma licença Business. Veja Standard e Business para os detalhes.

Instaladores assinados e arquivos de runtime estão disponíveis de forma anônima em download.ax-code.com. Leia o guia de instalação e o guia de atualização e recuperação. A documentação técnica pública fica em ax-code.app/pt-BR/docs/, independente do acesso ao código-fonte. Já instalou? Abra um terminal no projeto, execute ax-code e depois use /connect dentro da TUI para escolher um provedor. Comece com uma pergunta sobre o projeto, peça uma alteração pequena e revise o diff e as checagens do projeto antes de fazer o commit. Use ax-code doctor se o runtime instalado precisar de diagnóstico.

O que é o AX Code

O AX Code é um runtime de programação com IA. Ele combina:

• agentes para tarefas diferentes de código
• execução explícita de ferramentas
• seleção de modelo e de provedor
• estado persistente de sessão
• isolamento e permissões configuráveis
• superfícies de integração como a TUI, o SDK, o modo servidor e o MCP

Isso importa porque programar com IA só é útil em repositórios reais quando você controla o que o agente pode fazer, preserva o contexto entre sessões e reutiliza o mesmo fluxo fora de uma única janela de conversa.

De onde vem o valor

O AX Code otimiza o momento depois que o agente termina: decidir se vale a pena ficar com o que ele produziu.

• Evidência. Cada sessão é registrada como um log de eventos tipado mais instantâneos de arquivo, para que ax-code graph, compare, replay, risk e audit possam reconstruir o que aconteceu depois que a conversa acaba.
• Verificação. Onde uma barreira pode ser imposta — candidatos da arena, aplicação de refatoração com barreira — os próprios comandos de verificação de tipos, de lint e de teste do repositório decidem se um resultado é aceito.
• Reversibilidade. Os instantâneos são recuperáveis por passo, não só por sessão, a partir de um armazenamento de objetos Git mantido fora do repositório.
• A sua decisão. O AX Code classifica, pontua e informa. Ele não faz o merge por você.

Apoiam isso: ferramentas explícitas com regras de permissão e modos de isolamento, sessões duráveis, AGENTS.md para convenções do repositório, portabilidade de provedor e um só runtime por trás da TUI, da CLI, da extensão do VS Code, do SDK, do servidor headless e das integrações MCP. São fundamentos, e não o motivo para escolher o AX Code — veja Por que o AX Code.

Para os próprios comandos, veja Evidência de execução.

Modelo mental

Pense no AX Code como cinco camadas:

1. Camada de provedor: escolha o backend de modelo contra o qual quer executar.
2. Camada de agente: escolha o agente certo para a tarefa, ou deixe o roteamento ajudar.
3. Camada de ferramenta: o agente age por ferramentas explícitas, e não por capacidades ocultas.
4. Camada de sessão: a conversa, as decisões e o estado persistem.
5. Camada de controle: isolamento, permissões e comportamento de auditoria definem a fronteira.

O resto da documentação se mapeia nessas camadas.

Escolha o próximo caminho

Quero experimentar rápido

• Comece pelo README da raiz para instalar e fazer o primeiro lançamento.
• Os caminhos de instalação com suporte usam o runtime compilado:
  • Instalador de versão em Bash para macOS Apple Silicon e 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 Homebrew para a CLI no macOS: brew tap defai-digital/tap && brew trust defai-digital/tap && brew install defai-digital/tap/ax-code
  • Instalador de versão do GitHub para o PowerShell no Windows: powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://download.ax-code.com/install.ps1 | iex"
• O instalador Bash não é o caminho canônico de configuração no Windows.
• Pacotes npm deixaram de ser canais com suporte de instalação ou de atualização. Veja Canais de instalação e de runtime para a política de plataforma, os rótulos de runtime e a matriz do lançador local.
• Use /connect ou ax-code providers login para definir um modelo. Veja Provedores e modelos com suporte para provedores de API na nuvem, provedores de CLI, AX Engine e IDs de modelo. Para um caminho de avaliação sem custo, use o Início rápido das APIs de nível gratuito.
• Execute ax-code init depois de abrir um projeto real, para que AGENTS.md capture as convenções locais.
• Se quiser fronteiras de segurança mais estreitas, ative o Modo sandbox antes de edições mais amplas.

Quero usá-lo com segurança num repositório de equipe ou de empresa

• O AX Code inicia com o modo autônomo ligado e o modo sandbox desligado: full-access com sistema de arquivos e acesso à rede sem restrição.
• Para trabalho de equipe, de empresa, não confiável ou sem supervisão, ative --sandbox workspace-write (ou read-only) antes de começar a tarefa.
• Leia Modo sandbox para as fronteiras de execução.
• Leia Modo autônomo se o agente for executar sem supervisão.
• Leia Política de segurança para o modelo de ameaça e os detalhes de armazenamento de credenciais.
• Leia Camada semântica se proveniência e reprodução importarem para o fluxo.

Quero incorporá-lo ou automatizá-lo

• Use os pontos de entrada headless ou gRPC de @defai-digital/ax-code-sdk para integração com aplicativos TypeScript.
• Use Compatibilidade de HTTP e OpenAPI para uma fronteira de serviço, clientes gerados e o contrato OpenAPI autoritativo.
• Use ax-code mcp add quando o agente precisar de ferramentas ou serviços externos.

Quero entender o repositório ou contribuir com retorno

• Leia o Hub de documentação para o restante da documentação pública.
• Leia CONTRIBUTING.md para a política atual de contribuição externa.

Quando o AX Code pode não servir

O AX Code é, de propósito, mais do que autocompletar ou uma caixa de conversa hospedada. Pode ser demais se:

• Você só precisa de sugestões de código no próprio texto e não quer agentes executando ferramentas.
• Você precisa de uma experiência só de SaaS hospedado, sem runtime local.
• Você não precisa de persistência de sessão, de reprodução, de integração com SDK ou servidor, nem de instruções no nível do repositório.
• Você trabalha num ambiente em que nenhum processo local de CLI é permitido.

Nesses casos, um assistente de editor mais leve pode ser mais simples. O AX Code é mais forte quando o agente precisa operar dentro de fluxos reais de desenvolvimento, com controle, continuidade e fronteiras de integração.

Primeiros comandos comuns

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

O Grok executa exclusivamente por Grok Build CLI. Selecione grok-build-cli em /connect; o AX Code invoca o comando local grok e reutiliza o login e a sessão dessa CLI. O antigo provedor direto de API na nuvem xai deixou de ter suporte.

Mapa da documentação