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.
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.
- 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.
- 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.
- Abra o convite e clique em Join Agency Machine, com a mesma conta do GitHub que você informou. O convite vale por 7 dias.
- 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.
gh auth logoutO 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.
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.