Central de ajuda

Se algo deu errado na instalação

As mensagens de erro mais comuns da instalação, no Windows e no Mac, e o que fazer em cada uma.

Atualizado em 17 de novembro de 2026

Ache a frase que apareceu na sua tela. Depois de resolver, volte ao Claude e diga continua a instalação: ele retoma de onde parou.

Os passos citados aqui são os do guia do seu computador: Instalação no Windows ou Instalação no Mac.

No Windows e no Mac

"A conta ainda não tem acesso"

A instalação confere no GitHub se a sua conta foi liberada. Sem isso, ela para e não baixa o produto.

  1. Envie o seu usuário do GitHub pelo formulário de liberação. O passo a passo está em Antes de instalar: as duas contas e o acesso.
  2. Você recebe um e-mail avisando que o pedido entrou. O GitHub limita quantos convites saem por dia; quando o seu sair, chega outro e-mail.
  3. Abra o convite e clique em Join Agency Machine, com a mesma conta do GitHub que você informou. O convite vale por 7 dias.
  4. Volte ao Claude e diga "continua a instalação".

Entrou no GitHub com outra conta? No terminal, rode o comando abaixo e peça ao Claude para continuar: ele abre o login de novo.

Para copiar
gh auth logout

O login do GitHub não abre ou não termina

O Claude mostra um código de uso único e o endereço github.com/login/device. Abra esse endereço em qualquer navegador, entre na sua conta, digite o código e clique em Autorizar. Se o código venceu, peça ao Claude para tentar de novo: ele gera outro.

"Não consegui baixar do GitHub"

Quase sempre é a internet, ou a rede de uma empresa bloqueando o GitHub. Teste abrir github.com no navegador. Com a internet de volta, diga "continua a instalação".

"Não é a pasta do Agency Machine"

O terminal foi aberto na pasta errada. Ele tem de estar dentro da pasta Agency-Machine que tem o arquivo CLAUDE.md. Volte ao passo 3 e abra o terminal na pasta certa.

Instalei uma ferramenta e o terminal não acha o programa

O terminal aberto ainda não enxerga o que acabou de ser instalado. Saia do Claude com /exit, feche a janela, abra outra dentro da mesma pasta, abra o Claude de novo (no Windows, digite claude; no Mac, cole o comando 2 do passo 4) e diga "continua a instalação".

A conferência final não apareceu, ou fechei o terminal antes

Abra o terminal dentro da pasta (passo 3), abra o Claude (no Windows, digite claude; no Mac, cole o comando 2 do passo 4) e diga confere a instalação. O Claude mostra a conferência inteira de novo.

"A instalação com a conta não pode ser feita neste computador"

Fale com o suporte e informe a sua conta do GitHub. É o suporte que resolve esse caso.

Só no Windows

winget não é reconhecido

Abra a Microsoft Store, procure Instalador de Aplicativo e atualize. Feche o terminal, abra de novo dentro da pasta (passo 3) e cole o comando outra vez.

Não sei abrir o terminal, ou não aparece "Abrir no Terminal"

No passo 3, veja Não achou? Outras formas de abrir o terminal. O jeito que funciona em qualquer Windows: clique na barra de endereço da pasta, digite powershell e aperte Enter.

irm não é reconhecido

A janela aberta não é o PowerShell. A linha tem de começar com PS. Feche e volte ao passo 3.

claude não é reconhecido, ou o comando 4 não abre o Claude

Ao digitar claude numa janela nova: cole o comando 4 do passo 4. Ele abre o Claude pelo endereço completo.

O comando 4 deu erro: o comando 2 não terminou. Cole o comando 2 de novo, espere a linha com PS voltar e cole o comando 4.

A instalação de uma ferramenta falhou e a pergunta de permissão não apareceu

Sinal: a instalação do Git, do Node, do GitHub CLI ou do ffmpeg falha em poucos segundos, com um aviso de código de saída (em inglês, Installer failed with exit code), e a janela "Deseja permitir…" não apareceu.

No comando 1 do passo 4: faça à mão, como está no fim desta resposta, com o comando 1. Depois volte à janela do passo 3 e siga do comando 2.

Durante o passo 6: diga ao Claude: a pergunta de permissão não apareceu. Ele abre uma janela azul do PowerShell como administrador: clique em Sim e espere terminar.

Se a janela não abrir, faça à mão: menu Iniciar, digite PowerShell, clique com o botão direito em Windows PowerShell, escolha Executar como administrador, cole a linha winget install ... que falhou e aperte Enter. No aviso do Windows, clique em Sim. Se o Windows pedir a senha de outra conta e você não a tem, fale com o suporte.

Abriu a Microsoft Store quando rodou o Python

É normal em Windows sem o Python instalado. O Claude instala o Python e cria o comando certo. Só feche a janela da loja.

O antivírus bloqueou um download

Não desligue o antivírus. Anote o nome do arquivo que ele bloqueou e mande ao suporte.

Só no Mac

Não aparece "Novo Terminal na Pasta"

No passo 3, veja Não achou? Outro jeito de abrir o Terminal na pasta. O jeito que funciona em qualquer Mac: abrir o Terminal, digitar cd e um espaço, arrastar a pasta para a janela e apertar Enter.

O Claude abre com "Not logged in" toda vez, ou o navegador do login não abre

Sinais: ao abrir o Claude aparece um erro com bash: No such file or directory, o login mostra um endereço em vez de abrir o navegador, e o login não fica guardado. Acontece quando um comando foi colado quebrado em duas linhas, e aquela janela do Terminal ficou sem enxergar os programas do Mac.

O conserto: feche essa janela do Terminal. Abra outra dentro da pasta (passo 3) e cole o comando 2 do passo 4. Se ele pedir, entre na sua conta de novo. Nada do que já foi instalado se perde.

command not found: claude

O Claude Code está instalado, mas esta janela do Terminal ainda não sabe onde ele mora. Cole o comando 2 do passo 4: ele abre o Claude pelo endereço completo.

Se o comando 2 der erro, o comando 1 não terminou. Cole o comando 1 de novo, espere a linha voltar e cole o comando 2.

Abriu uma janela da Apple pedindo para instalar "Ferramentas de Linha de Comando"

Clique em Instalar e espere terminar (de 5 a 15 minutos). Depois diga ao Claude "continua a instalação".

Não resolveu

Fale com o suporte: agencymachine.com.br/suporte. Mande o print da mensagem que apareceu. Nunca mande senha, chave nem código de verificação.