Para instalar o Claude Code, use o comando oficial correspondente ao seu terminal, abra uma nova janela e confirme a versão. Em seguida, entre na pasta do projeto, inicie a sessão e conclua o acesso. Windows usa um percurso próprio no PowerShell; macOS, Linux e WSL compartilham o instalador indicado no guia oficial.
As etapas abaixo tratam do comando disponível no terminal. A extensão do VS Code possui uma instalação própria. Escolha primeiro onde você pretende trabalhar para evitar confundir o painel do editor com um comando que deveria estar disponível fora dele.
1. Identifique o sistema e o terminal
Use o início rápido oficial como referência para os instaladores e a autenticação. Não misture instruções de PowerShell e CMD na mesma sequência.
Antes da instalação, anote em qual ambiente você está. Em um computador Windows, por exemplo, é possível trabalhar no PowerShell ou em um ambiente WSL; o comando deve corresponder ao terminal escolhido.
Tenha também a localização do projeto que será usado na primeira sessão. Uma pasta de trabalho bem identificada facilita reconhecer quais arquivos pertencem à tarefa e evita iniciar a atividade em um diretório sem relação com o objetivo.
2. Instale no macOS, Linux ou WSL
No terminal correspondente, o instalador nativo documentado é:
curl -fsSL https://claude.ai/install.sh | bash
Aguarde a conclusão e leia as orientações exibidas pelo instalador. Depois, abra um terminal novo para a conferência da instalação.
Se você usa mais de um ambiente no mesmo computador, registre onde realizou a etapa. Uma instalação feita dentro do WSL deve ser avaliada naquele contexto, sem presumir que a mesma configuração já está pronta em outra janela de terminal.
Mantenha a primeira conferência simples. O objetivo dessa rodada é reconhecer o comando instalado e chegar ao acesso, antes de acrescentar configurações específicas do projeto.
3. Instale no Windows com PowerShell
No PowerShell, o comando nativo confirmado pelo guia é:
irm https://claude.ai/install.ps1 | iex
Conclua o percurso apresentado e abra uma janela nova. Não adapte esse comando para outro shell por tentativa: retorne às instruções correspondentes ao ambiente que decidiu usar.
Caso a organização controle a instalação de aplicativos, siga o procedimento interno para disponibilizar a ferramenta. Isso ajuda a manter a identificação de quem administra o computador e de onde devem vir as configurações compartilhadas.
A instalação deve deixar um resultado reconhecível. Se a etapa foi interrompida, registre o ponto em que parou, em vez de considerar que o comando já está disponível.
4. Confira a versão e abra o projeto
Em um terminal novo, execute:
claude --version
Depois, navegue até a pasta do projeto em que pretende trabalhar e inicie:
claude
O primeiro acesso inclui autenticação pelo navegador. As opções dependem da conta e do percurso oficial escolhido, como uma assinatura elegível ou o Console. Uma chave de API não é uma exigência universal desse início.
Confira a conta apresentada durante o login. Essa identificação é especialmente útil quando você participa de mais de uma organização e precisa saber em qual contexto o trabalho será realizado.
5. Faça uma primeira atividade de leitura
Comece com uma tarefa que permita reconhecer o projeto sem solicitar uma mudança extensa. Um pedido próprio pode ser:
Identifique a estrutura principal deste projeto. Explique onde ficam a interface, as regras do produto e as verificações existentes. Aponte o que não pode ser concluído pela leitura. Não altere arquivos nesta primeira atividade.
Compare a explicação com os arquivos disponíveis. O objetivo é obter um mapa que você consegue usar para escolher a próxima tarefa.
Se a descrição estiver ampla demais, delimite uma parte do produto. Pergunte sobre um fluxo, uma mensagem ou uma tela específica. A próxima solicitação pode então se apoiar em contexto que a equipe reconhece.
6. Se algo não corresponder ao esperado
Separe o problema por etapa. O comando não aparece? O acesso não foi concluído? A sessão abriu, mas a pasta está errada? Essas situações exigem investigações diferentes.
Registre sistema, terminal, etapa e mensagem observada. Esse conjunto é mais útil para pedir ajuda do que uma descrição genérica de falha na instalação.
Evite acumular novas tentativas com comandos de origens diferentes. Primeiro, compare o que foi realizado com o percurso oficial do ambiente escolhido. Se a instalação está disponível apenas em outra interface, retorne à distinção entre o terminal e a extensão do editor.
Ao finalizar, você deve conseguir confirmar a versão, identificar a conta e iniciar uma tarefa na pasta correta. Para projetos que também atendem clientes, a integração Claude da Nextags é uma etapa própria da operação, separada da instalação do Code.
Fontes e referências
Regras e recursos dos canais podem mudar. Confira as condições atuais nas fontes oficiais antes de colocar sua operação no ar.
Conteúdo de Angelo Sebastião Silva Goncalves. Preparado com apoio de IA. Consulte as fontes e os critérios editoriais. Conheça nossos critérios editoriais e como solicitar uma correção.
