“Git is not in PATH” no Claude Code: o que é e como resolver

Git is not in PATH

Esse mesmo aviso pode aparecer escrito de várias formas diferentes, dependendo de qual programa sentiu falta do Git primeiro. Independentemente do texto na tela, todos eles se resolvem com o mesmo passo a passo:

• No Prompt de Comando do Windows: 'git' não é reconhecido como um comando interno ou externo, um programa operável ou um arquivo em lotes.
• No PowerShell do Windows: O termo 'git' não é reconhecido como nome de cmdlet, função, arquivo de script ou programa operável.
• No Terminal do Mac: zsh: command not found: git ou xcrun: error: invalid active developer path.
• Em versões anteriores da extensão do Claude Code no Windows: Claude Code on Windows requires git-bash, acompanhado de “If installed but not in PATH”.
• Nas versões atuais, quando o Windows não encontra nem o Git Bash nem o PowerShell: Claude Code on Windows requires either Git for Windows (for bash) or PowerShell.
• Ao rodar uma skill que exige o terminal Bash no Windows: Skill … requires bash … but Git Bash was not found.

O que quer dizer

Quem está abrindo o editor pela primeira vez costuma assustar quando dá de cara com um aviso em vermelho falando em PATH ou cmdlet, mas pode ficar tranquilo: não há nada quebrado no seu computador. Essa mensagem só avisa que falta instalar o Git na máquina ou reiniciar o VS Code para que ele enxergue a instalação.

Na prática, o Git é o programa que registra o histórico de versões dos seus arquivos e envia o backup do projeto para o GitHub. Já o PATH é simplesmente a lista de pastas onde o Windows ou o Mac procuram um programa quando alguém chama esse programa pelo nome. Se o Git não está em nenhuma pasta dessa lista, para o computador é como se ele não estivesse instalado.

Nas versões mais novas para Windows, o Claude Code até consegue abrir sem o Git, usando o PowerShell no lugar do Git Bash. Mesmo assim, vale muito a pena instalar o Git logo de início, porque o controle de versão do VS Code, o envio de backups para o GitHub e várias skills dependem dele. No Mac, o Git já faz parte do pacote de ferramentas de desenvolvedor da Apple, que só precisa ser ativado uma vez.

Por que acontece

• O Git ainda não foi instalado. O Windows não traz o Git de fábrica, então em qualquer computador que nunca foi usado para programação esse é o motivo mais comum.
• Você instalou o Git com o VS Code aberto. Qualquer programa que já estava aberto antes da instalação continua enxergando a lista antiga do PATH. Como o terminal integrado do VS Code herda o PATH do próprio editor, você precisa fechar todas as janelas do VS Code e abri-lo novamente.
• A opção do PATH foi desmarcada no instalador. O instalador do Git for Windows tem uma etapa chamada Adjusting your PATH environment. Se você escolheu a primeira opção (Use Git from Git Bash only), ele não adiciona o Git ao PATH do Windows. Como o instalador memoriza a última escolha quando você reinstala, vale conferir essa tela com atenção.
• Faltam as ferramentas de desenvolvedor no Mac. Ou elas nunca foram ativadas na máquina, ou precisaram ser reativadas após uma grande atualização do macOS, momento em que costuma surgir o aviso xcrun: error.
• O Git foi instalado numa pasta que o Claude Code ignora. Por segurança, no Windows o Claude Code procura o Git nas pastas padrão (C:\Program Files\Git) e no PATH do sistema, ignorando qualquer executável do Git que esteja solto dentro da própria pasta do projeto.

Como resolver no Windows

1. 1Baixe o instalador oficial do Git for Windows em git-scm.com/install/windows. O link principal no topo da página já baixa a versão de 64 bits (x64), ideal para a maioria dos PCs. Se o seu notebook usa processador ARM (como a linha Snapdragon), escolha o link Git for Windows/ARM64 Setup.
2. 2Abra o arquivo baixado e avance clicando em Next. Quando chegar na tela Adjusting your PATH environment, confirme se a opção do meio, Git from the command line and also from 3rd-party software (Recommended), está selecionada. É ela que registra o Git no PATH do Windows.
3. 3Ao concluir a instalação, feche todas as janelas abertas do VS Code e abra o programa de novo para que ele carregue a lista atualizada do sistema.
4. 4No VS Code, abra um terminal novo pelo menu Terminal > Novo Terminal (ou Terminal > New Terminal) e rode o comando abaixo. Se aparecer o número da versão instalada, como git version 2.56.0.windows.2, o problema está resolvido.

Se você preferir fazer a instalação direto pelo terminal do Windows, também dá para usar o winget, o gerenciador de pacotes oficial da Microsoft. Vale apenas saber que o site oficial do Git avisa que esse pacote do winget é mantido pela comunidade e pode demorar alguns dias a mais para receber a última atualização. Assim que o comando terminar, feche e reabra o VS Code da mesma forma:

Se o Git já está instalado e o erro continua no Windows

Se você tem certeza de que já instalou o Git e o aviso persiste mesmo após reiniciar o editor, o primeiro passo é descobrir onde o Windows guardou o programa. Abra o PowerShell e rode este comando:

Se o PowerShell não devolver nenhuma linha, o Git ficou de fora do PATH. Nesse caso, basta rodar o instalador novamente e marcar a opção do meio na tela Adjusting your PATH environment, como mostrei no passo a passo acima.

Já se o comando devolver um endereço como C:\Program Files\Git\cmd\git.exe, significa que o Git está no PATH, mas o Claude Code não encontrou o terminal bash.exe dele sozinho. Para resolver de vez, você só precisa indicar o caminho exato do bash.exe na variável CLAUDE_CODE_GIT_BASH_PATH, dentro do bloco env do arquivo de configurações ~/.claude/settings.json (que no Windows fica na sua pasta de usuário, em C:\Users\seu-usuario\.claude\settings.json), apontando para C:\Program Files\Git\bin\bash.exe. Cuide para apontar sempre para o arquivo bash.exe, pois o Claude Code ignora o git-bash.exe. Se o chat do Claude Code já estiver abrindo pelo PowerShell, você pode pedir para ele mesmo escrever essa configuração no seu settings.json; depois, basta fechar e reabrir o VS Code.

Como resolver no Mac

No Mac, o Git já vem integrado às ferramentas de linha de comando da Apple (Xcode Command Line Tools), e você ativa tudo com um único comando no Terminal.

1. 1Abra o aplicativo Terminal (em Aplicativos > Utilitários ou buscando no Spotlight), cole o comando acima e aperte Enter.
2. 2O macOS vai exibir uma janela na tela perguntando se você quer instalar as ferramentas de comando para desenvolvedores. Clique em Instalar e aguarde o download terminar, o que costuma levar poucos minutos.
3. 3Quando a instalação concluir, feche o VS Code por completo usando o atalho Cmd + Q e abra o editor novamente.
4. 4Abra o terminal do VS Code e digite git --version. Se o número da versão aparecer na tela, está tudo pronto.

Muitas vezes, na primeira vez que algum programa tenta chamar o Git no Mac, o próprio sistema operacional já abre essa janela de instalação automaticamente. E, se você já costuma usar o gerenciador de pacotes Homebrew no seu Mac, também pode instalar pelo comando brew install git, que é o segundo método oficial listado na página do Git.

Como evitar

• Instale o Git antes de configurar o Claude Code. No Windows, a própria documentação da Anthropic recomenda instalar o Git for Windows logo no início para liberar o uso completo do Git Bash.
• Durante a instalação no Windows, mantenha a opção padrão recomendada na tela do PATH sem trocá-la para o uso restrito ao Git Bash.
• Sempre que instalar um programa novo que será usado pelo terminal ou pelo Claude Code, feche todas as janelas do VS Code e abra novamente.
• No Mac, sempre que atualizar o sistema operacional para uma versão nova do macOS, rode um git --version rápido no Terminal; se aparecer o erro xcrun, basta rodar xcode-select --install mais uma vez.

Se você usa o MazyOS

Dentro do MazyOS, o Git é a peça que faz o comando /salvar funcionar para enviar a cópia de segurança dos seus projetos para o GitHub. Sem o Git configurado, o /salvar trava, e é justamente esse backup que permite voltar atrás se o Claude apagar ou bagunçar algum arquivo. Assim que o teste do git --version responder normalmente, crie o hábito de rodar o /salvar ao final de cada sessão e confira os demais passos em como instalar o MazyOS.

Se nada funcionou

Quando instalei o Claude Code pela primeira vez no computador de um cliente, sem nunca ter configurado um terminal antes, o que me salvou de qualquer trava foi simples: sempre que aparecia uma linha vermelha na tela, eu tirava um print e mandava para o próprio Claude me explicar o que fazer no meu sistema. Se o erro ainda persistir aí, siga este roteiro:

• Tire um print da janela inteira mostrando o erro, informe se você está no Windows ou no Mac e envie para o Claude pelo navegador em claude.ai, contando quais passos já testou.
• Se o chat do Claude Code já estiver abrindo, digite /doctor. Esse comando faz um raio-X automático da instalação, das variáveis e das extensões e já sugere a correção na tela para você aprovar.
• Se você é aluno do MazyOS, poste o print no grupo da comunidade dizendo em qual passo parou. E lembre que, se você travar na instalação e o seu primeiro site não sair, você conta com a Garantia de Destrave Técnico, em que alguém da minha equipe entra numa chamada com você para deixar tudo configurado.

Com o Git rodando redondo na máquina, veja no guia completo sobre o que é o Claude Code como abrir a sua pasta de trabalho e colocar o primeiro site no ar.