Instale o Grok Build no macOS, Linux ou Windows em dois minutos

Antes de instalar

O Grok Build é um app de terminal da SpaceXSI (antiga xAI). Há binários prontos para macOS, Linux e Windows. Você precisa de:

• Um terminal: Terminal ou iTerm no macOS, qualquer shell no Linux, PowerShell ou Git Bash no Windows.
• Um navegador para o primeiro login, ou uma chave de API se estiver configurando em um servidor.
• Uma conta. O Grok Build é grátis para experimentar, e o plano Plus da X Subscription ($8 por mês) e os planos superiores acrescentam mais uso.

Comandos de instalação

1. macOS, Linux ou Git Bash: rode curl -fsSL https://x.ai/cli/install.sh | bash
2. Windows PowerShell: rode irm https://x.ai/cli/install.ps1 | iex
3. Confira se funcionou: rode grok --version. Se aparecer um número de versão, a instalação deu certo.

Os dois comandos vêm da página oficial do Grok Build e do repositório no GitHub. O instalador coloca o programa em ~/.grok/bin, segundo um guia de instalação de terceiros.

Desenvolvedores também podem compilar a partir do código-fonte. Isso exige uma toolchain Rust (instalada e fixada pelo rustup), o DotSlash (cargo install dotslash) e o protoc. macOS e Linux são os sistemas de compilação suportados. As compilações no Windows são feitas “no melhor esforço”, então usuários de Windows devem usar o binário pronto.

Primeira execução e login

1. Abra um terminal na pasta do seu projeto, não na sua pasta pessoal.
2. Rode grok.
3. Uma janela do navegador se abre para você fazer login, normalmente em grok.com.
4. Depois do login, a interface do terminal começa. As credenciais ficam salvas em ~/.grok/auth.json.

Por que a pasta do projeto importa: em julho de 2026, rodar o Grok Build podia enviar todo o diretório atual para o armazenamento em nuvem da empresa. A SpaceXSI desativou isso no mesmo dia e diz que agora o Build pode rodar totalmente local. Começar pela pasta do projeto continua sendo o hábito mais seguro, porque o agente consegue ler e editar arquivos onde ele roda.

Por padrão, o Grok Build usa o plan mode: ele propõe um plano e não faz nenhuma edição até você aprovar.

Atualizando e verificando sua configuração

• grok update atualiza o Grok Build para a versão mais recente.
• grok doctor verifica a configuração do seu terminal e relata problemas.
• grok --version mostra a versão instalada.

Atualize com frequência. A SpaceXSI lança recursos rapidamente, e novos modelos como o Grok 4.7 chegam ao Grok Build no dia do lançamento.

Usando uma chave de API em CI

O login pelo navegador não funciona em servidores de build. Para CI, defina a variável de ambiente XAI_API_KEY e use o modo headless para scripts e pipelines.

1. Crie uma conta em console.x.ai.
2. Carregue créditos. A API é pré-paga, e as requisições são recusadas quando os créditos acabam.
3. Gere uma chave na página API Keys.
4. Guarde-a como segredo no seu sistema de CI e exponha-a como XAI_API_KEY.

O uso por chave de API é cobrado pelas tarifas da API, e não sai do pacote da sua assinatura. O modelo grok-build-0.1 custa $1 por milhão de tokens de entrada e $2 por milhão de tokens de saída.

Arquivo de configuração e permissões

O Grok Build guarda suas configurações em ~/.grok/config.toml. É ali que os servidores MCP são configurados, para conexões com ferramentas como Linear, Sentry ou Postgres.

As convenções de cada projeto ficam em um arquivo AGENTS.md em cada diretório. Um guia de terceiros lista estes modos de permissão: default, acceptEdits, auto, dontAsk, bypassPermissions e plan. Flags úteis incluem --worktree, --no-plan e --no-subagents. Evite o bypassPermissions, a menos que rode o Build em um sandbox.

Problemas comuns

• “grok: command not found”: abra um novo terminal para o shell recarregar o path e confira se ~/.grok/bin está no seu PATH.
• A tela parece quebrada: rode grok doctor para verificar o suporte do terminal.
• A janela de login não abre: em uma máquina remota, use a XAI_API_KEY.
• Chave de API recusada: confira se sua conta no console tem créditos carregados.
• O Grok 4.7 Fast não aparece: o Fast não faz parte do plano gratuito.
• O uso acabou: os planos pagos dividem um único pacote semanal com o chat do Grok e o Cursor. Uso intenso em um lugar deixa menos para os outros.

Perguntas frequentes