Diego Brito
Morreremos e nunca saberemos o que é a vida!
Membro da equipe
Administrador
Parceiros
Melhor pôster do mês
Como instalar o Claude Code no VS Code e em uma VPS
O Claude Code é uma ferramenta de programação da Anthropic que funciona diretamente no terminal e também pode ser utilizada dentro do VS Code.
Com ele é possível analisar projetos, criar e editar arquivos, executar comandos, encontrar problemas e auxiliar no desenvolvimento de aplicações.
Neste guia você verá como instalar o Claude Code no Windows, Linux, macOS, VS Code e em uma VPS Linux.
REQUISITOS
Windows PowerShell:
Windows CMD:
Também existem outras formas de instalação:
macOS usando Homebrew:
Windows usando Winget:
Usando npm, com Node.js 22 ou superior:
Evite utilizar "sudo npm install -g", pois isso pode causar problemas de permissão. Quando possível, prefira o instalador nativo.
Para verificar possíveis problemas:
Para iniciar o Claude Code:
Na primeira utilização será solicitado o login com sua conta Anthropic. O navegador será aberto para realizar a autenticação.
Ela permite utilizar o Claude diretamente no editor, visualizar alterações, trabalhar com arquivos do projeto e revisar as modificações antes de aplicá-las.
No VS Code:
Caso a extensão não apareça corretamente, pressione:
E execute:
Depois execute o instalador:
O executável normalmente ficará em:
Se o comando não for encontrado, adicione o diretório ao PATH:
Agora teste:
Outra alternativa é utilizar npm:
Como a VPS normalmente não possui navegador gráfico, o terminal poderá apresentar uma URL para autenticação.
Copie a URL, abra no navegador do seu computador, faça login e retorne ao terminal da VPS.
Também é possível utilizar uma chave de API:
O VS Code abrirá uma nova janela conectada ao servidor.
A partir desse momento, o terminal, os arquivos e os comandos executados estarão relacionados à VPS.
Abra o projeto localizado no servidor e utilize o Claude Code normalmente.
Isso permite, por exemplo, pedir para o Claude analisar arquivos, corrigir problemas, criar funcionalidades e executar comandos diretamente no ambiente da VPS.
Verifique se o diretório ~/.local/bin está no PATH:
Se necessário:
Erro de rede, TLS ou SSL durante a instalação
Verifique se a VPS consegue acessar os serviços da Anthropic e se não existe bloqueio de firewall, proxy ou DNS.
"Illegal instruction"
Pode ocorrer em VPS antigas ou em determinadas arquiteturas. Nesse caso, uma alternativa é tentar a instalação através do npm.
Instalação travando ou processo sendo encerrado
Verifique a memória disponível:
VPS com pouca RAM pode apresentar problemas durante instalações ou ao trabalhar com projetos maiores.
Login não abre navegador na VPS
Isso é normal em servidores sem interface gráfica. Copie a URL exibida no terminal e abra no navegador do seu computador.
Ícone do Claude não aparece no VS Code
Verifique se a extensão está instalada, abra um arquivo e execute:
Claude funciona no terminal normal, mas não no terminal integrado do VS Code
A exte
ensão do VS Code não necessariamente instala o CLI no PATH do sistema. Instale o Claude Code separadamente usando um dos métodos apresentados neste artigo.
Para diagnóstico:
Verificar:
Iniciar:
CONCLUSÃO
Com o Claude Code instalado, você pode trabalhar com projetos diretamente pelo terminal ou integrá-lo ao VS Code.
Em uma VPS, o uso combinado do Claude Code com o VS Code Remote - SSH permite acessar os arquivos do servidor e utilizar o Claude diretamente no ambiente remoto.
Como o Claude Code recebe atualizações frequentes, recomenda-se consultar a documentação oficial da Anthropic caso algum comando ou procedimento tenha sido alterado.
O Claude Code é uma ferramenta de programação da Anthropic que funciona diretamente no terminal e também pode ser utilizada dentro do VS Code.
Com ele é possível analisar projetos, criar e editar arquivos, executar comandos, encontrar problemas e auxiliar no desenvolvimento de aplicações.
Neste guia você verá como instalar o Claude Code no Windows, Linux, macOS, VS Code e em uma VPS Linux.
REQUISITOS
- Conta Claude com acesso ao Claude Code (Pro, Max, Team ou Enterprise), ou acesso via API/Console.
- Conexão com a internet.
- Para VPS, recomenda-se pelo menos 4 GB de RAM para trabalhar com projetos maiores.
- INSTALAÇÃO NO WINDOWS, LINUX, MACOS E WSL
Bash:
curl -fsSL [URL]https://claude.ai/install.sh[/URL] | bashWindows PowerShell:
Código:
irm [URL]https://claude.ai/install.ps1[/URL] | iexWindows CMD:
Código:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdTambém existem outras formas de instalação:
macOS usando Homebrew:
Bash:
brew install --cask claude-codeWindows usando Winget:
Código:
winget install Anthropic.ClaudeCodeUsando npm, com Node.js 22 ou superior:
Bash:
npm install -g @anthropic-ai/claude-codeEvite utilizar "sudo npm install -g", pois isso pode causar problemas de permissão. Quando possível, prefira o instalador nativo.
- VERIFICAR A INSTALAÇÃO
Bash:
claude --versionPara verificar possíveis problemas:
Bash:
claude doctorPara iniciar o Claude Code:
Bash:
claudeNa primeira utilização será solicitado o login com sua conta Anthropic. O navegador será aberto para realizar a autenticação.
- INSTALAR O CLAUDE CODE NO VS CODE
Ela permite utilizar o Claude diretamente no editor, visualizar alterações, trabalhar com arquivos do projeto e revisar as modificações antes de aplicá-las.
No VS Code:
- Pressione Ctrl + Shift + X no Windows/Linux ou Cmd + Shift + X no macOS.
- Pesquise por "Claude Code".
- Instale a extensão oficial da Anthropic.
- Abra um arquivo do projeto.
- Clique no ícone do Claude Code.
- Faça login quando solicitado.
- Digite o que deseja que o Claude faça.
Caso a extensão não apareça corretamente, pressione:
Código:
Ctrl + Shift + PE execute:
Código:
Developer: Reload Window- MODOS DE PERMISSÃO
- Auto
- Manual
- Plan
- Edit
- INSTALAR O CLAUDE CODE EM UMA VPS LINUX
Bash:
ssh usuario@ip-da-sua-vpsDepois execute o instalador:
Bash:
curl -fsSL [URL]https://claude.ai/install.sh[/URL] | bashO executável normalmente ficará em:
Bash:
~/.local/bin/claudeSe o comando não for encontrado, adicione o diretório ao PATH:
Bash:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrcAgora teste:
Bash:
claude --version
claude doctor- INSTALAÇÃO VIA APT
Bash:
sudo apt install curl gnupg
sudo install -d -m 0755 /etc/apt/keyrings
sudo curl -fsSL [URL]https://downloads.claude.ai/keys/claude-code.asc[/URL]
-o /etc/apt/keyrings/claude-code.asc
echo "deb [signed-by=/etc/apt/keyrings/claude-code.asc] [URL]https://downloads.claude.ai/claude-code/apt/stable[/URL] stable main"
| sudo tee /etc/apt/sources.list.d/claude-code.list
sudo apt update
sudo apt install claude-codeOutra alternativa é utilizar npm:
Bash:
npm install -g @anthropic-ai/claude-code- LOGIN NA VPS
Bash:
claudeComo a VPS normalmente não possui navegador gráfico, o terminal poderá apresentar uma URL para autenticação.
Copie a URL, abra no navegador do seu computador, faça login e retorne ao terminal da VPS.
Também é possível utilizar uma chave de API:
Bash:
export ANTHROPIC_API_KEY="sua-chave-aqui"- UTILIZAR O CLAUDE CODE PELO VS CODE CONECTADO À VPS
- Instale a extensão "Remote - SSH", da Microsoft.
- Pressione Ctrl + Shift + P.
- Execute "Remote-SSH: Connect to Host...".
- Informe o acesso da VPS, por exemplo:
Código:
usuario@ip-da-sua-vpsO VS Code abrirá uma nova janela conectada ao servidor.
A partir desse momento, o terminal, os arquivos e os comandos executados estarão relacionados à VPS.
Abra o projeto localizado no servidor e utilize o Claude Code normalmente.
Isso permite, por exemplo, pedir para o Claude analisar arquivos, corrigir problemas, criar funcionalidades e executar comandos diretamente no ambiente da VPS.
- PROBLEMAS COMUNS
Verifique se o diretório ~/.local/bin está no PATH:
Bash:
echo $PATHSe necessário:
Bash:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrcErro de rede, TLS ou SSL durante a instalação
Verifique se a VPS consegue acessar os serviços da Anthropic e se não existe bloqueio de firewall, proxy ou DNS.
"Illegal instruction"
Pode ocorrer em VPS antigas ou em determinadas arquiteturas. Nesse caso, uma alternativa é tentar a instalação através do npm.
Instalação travando ou processo sendo encerrado
Verifique a memória disponível:
Bash:
free -hVPS com pouca RAM pode apresentar problemas durante instalações ou ao trabalhar com projetos maiores.
Login não abre navegador na VPS
Isso é normal em servidores sem interface gráfica. Copie a URL exibida no terminal e abra no navegador do seu computador.
Ícone do Claude não aparece no VS Code
Verifique se a extensão está instalada, abra um arquivo e execute:
Código:
Developer: Reload WindowClaude funciona no terminal normal, mas não no terminal integrado do VS Code
A exte
ensão do VS Code não necessariamente instala o CLI no PATH do sistema. Instale o Claude Code separadamente usando um dos métodos apresentados neste artigo.
Para diagnóstico:
Bash:
claude doctor- COMANDOS RÁPIDOS
Bash:
curl -fsSL [URL]https://claude.ai/install.sh[/URL] | bashVerificar:
Bash:
claude --version
claude doctorIniciar:
Bash:
claudeCONCLUSÃO
Com o Claude Code instalado, você pode trabalhar com projetos diretamente pelo terminal ou integrá-lo ao VS Code.
Em uma VPS, o uso combinado do Claude Code com o VS Code Remote - SSH permite acessar os arquivos do servidor e utilizar o Claude diretamente no ambiente remoto.
Como o Claude Code recebe atualizações frequentes, recomenda-se consultar a documentação oficial da Anthropic caso algum comando ou procedimento tenha sido alterado.