Instalando Claude Code e Conectando Seu Primeiro Projeto

O Claude Code é instalado uma vez a partir do seu terminal, e depois iniciado de dentro de qualquer diretório de projeto em que você queira que ele funcione.

Esta página detalha essa configuração completa: instalação, conexão com um projeto real e execução de uma primeira solicitação.

Resumo

Instalar o Claude Code é um único comando CLI, semelhante à instalação de qualquer outra ferramenta de desenvolvedor global.

Uma vez instalado, o CLI não tem conexão persistente com um projeto até que você o inicie de dentro do diretório desse projeto.

Cada sessão começa do zero na pasta em que você estava quando digitou o comando de inicialização.

A primeira sessão em um novo projeto é um bom momento para permitir que o Claude Code se oriente antes de solicitar algo complexo.

Acertar essa configuração inicial evita a maioria das confusões que os novos usuários encontram em sua primeira semana.

Receita

Cartão de receita de referência rápida - pronto para copiar e colar.

# 1. Install the CLI globally
npm install -g @anthropic-ai/claude-code
 
# 2. Confirm it installed
claude --version
 
# 3. Move into the project you want help with
cd ~/projects/my-app
 
# 4. Launch the interactive session
claude

Quando usar isso:

Na primeira vez que você configurar o Claude Code em uma nova máquina.
Conectando o Claude Code a um projeto em que ele ainda não trabalhou antes.
Integrando um novo desenvolvedor a uma equipe que já usa o Claude Code.
Reinstalando após trocar de máquina ou atualizar sua cadeia de ferramentas Node.js.

Exemplo de Trabalho

# A full first-session walkthrough, from a clean terminal
 
# Install the CLI (Node.js and npm must already be installed)
npm install -g @anthropic-ai/claude-code
 
# Verify the install
claude --version
 
# Navigate into the project you want to connect
cd ~/projects/my-app
 
# Launch Claude Code in that project
claude
 
# At the prompt that opens, describe your first task in plain language
> Summarize what this project does and list its main dependencies

O que isso demonstra:

A etapa de instalação é uma ação global única, independente de qualquer projeto específico.
Conectar-se a um projeto é apenas uma questão de cd-ing para dentro dele antes de iniciar.
Uma boa primeira solicitação pede ao Claude Code para resumir ou orientar, o que permite verificar se ele leu o projeto corretamente.
A sessão abre um prompt REPL (>) onde cada solicitação subsequente é digitada.

Mergulho Profundo

Como Funciona

O próprio CLI é um pequeno binário; o trabalho real do agente acontece em uma sessão que começa assim que você executa claude de um diretório.
Ao iniciar, o Claude Code lê o diretório de trabalho atual como a raiz do projeto e começa a construir contexto sobre ele.
Não há uma etapa de "conexão" separada além de iniciar do diretório correto; o CLI não exige que você registre um projeto com antecedência.
A autenticação ocorre uma vez por máquina (ou sessão, dependendo da sua configuração) e é separada da etapa de conexão por projeto.

Checklist da Primeira Sessão

Etapa	Por que é importante
Confirmar que `claude --version` funciona	Confirma que a instalação e o `PATH` estão corretos antes de você depender dele
`cd` para a raiz real do projeto	O Claude Code lê do diretório atual, não de um caminho que você digita depois
Fazer uma pergunta de orientação primeiro	Confirma que ele leu o projeto corretamente antes de você entregar trabalho real
Escolher um modo de permissão inicial	Decida de antemão se você deseja prompts de aprovação nesta primeira sessão

Notas do CLI

# Update to the latest version later on
npm update -g @anthropic-ai/claude-code
 
# Check where the binary is installed if `claude` is not found
npm root -g

Armadilhas

Iniciar do diretório errado - O Claude Code lê o diretório de trabalho atual como a raiz do projeto, portanto, iniciá-lo a partir do seu diretório home em vez do diretório do projeto fornece o contexto errado. Correção: sempre cd para a raiz real do projeto antes de executar claude.
Assumir que a instalação o conecta a um projeto automaticamente - a instalação do CLI é global e agnóstica ao projeto; ele não se lembra nem se anexa a nenhum projeto específico até que você o inicie de dentro de um deles. Correção: trate cada inicialização de claude como uma nova conexão com escopo para o diretório atual.
Pular a verificação de versão - um PATH quebrado após a instalação pode silenciosamente fazer com que claude não resolva nada ou resolva uma versão antiga em cache. Correção: execute claude --version imediatamente após a instalação, antes de iniciar o trabalho real.
Saltar direto para uma solicitação complexa - pedir uma grande alteração em vários arquivos antes que o Claude Code tenha qualquer contexto sobre o projeto produz um plano mais fraco. Correção: comece com uma solicitação de orientação pequena para que ele leia os arquivos relevantes primeiro.
Esquecer que o Node.js é um pré-requisito - o CLI instala via npm, portanto, uma instalação ausente ou muito antiga do Node.js fará com que o comando de instalação falhe completamente. Correção: confirme que node --version e npm --version funcionam antes de instalar o Claude Code.

Alternativas

Alternativa	Use Quando	Não Use Quando
Iniciar com `claude` e sem flags	Você quer seus padrões configurados para o modo de permissão	Você precisa de um modo de permissão específico apenas para esta sessão
Iniciar com uma flag de permissão explícita	Você quer ter certeza do modo para uma sessão única	Você já tem um padrão em nível de projeto em que confia
Reinstalar do zero	Sua instalação está quebrada ou muito desatualizada	Um simples `npm update -g` corrigiria o mesmo problema mais rapidamente

FAQs

Preciso instalar o Claude Code separadamente para cada projeto?

Não. A instalação é global, feita uma vez por máquina. Conectar-se a um projeto específico significa apenas iniciar claude de dentro do diretório desse projeto.

O que preciso ter instalado antes de poder instalar o Claude Code?

Node.js e npm, já que o CLI é instalado como um pacote global do npm.
Um terminal onde você possa executar comandos.
Uma conta Anthropic com acesso ao Claude Code para autenticação.

Como sei que a instalação realmente funcionou?

Execute claude --version logo após a instalação. Um número de versão de retorno confirma que tanto a instalação quanto o seu PATH estão corretos.

O que acontece se eu iniciar `claude` da pasta errada?

O Claude Code trata o diretório de onde você iniciou como a raiz do projeto, então ele lerá e raciocinará sobre os arquivos errados. Saia, cd para o projeto correto e reinicie.

Qual deve ser minha primeira solicitação em um novo projeto?

Algo de baixo risco e orientador, como pedir para resumir o projeto ou listar suas dependências. Isso confirma que ele leu o projeto corretamente antes de você entregar trabalho real.

Existe um arquivo de configuração em nível de projeto, ou tudo é por sessão?

A configuração em nível de projeto existe para coisas como padrões de permissão, mas a etapa central de conexão é simplesmente iniciar do diretório do projeto a cada vez; não há uma etapa de registro separada.

Posso usar o Claude Code em mais de um projeto ao mesmo tempo?

Sim, mas cada sessão está limitada ao diretório de onde você a iniciou. Trabalhar em dois projetos ao mesmo tempo significa executar duas sessões separadas, geralmente em duas abas de terminal.

Preciso escolher um modo de permissão antes da minha primeira sessão?

Ajuda. Decidir de antemão se você quer perguntar a cada vez ou aceitar automaticamente para essa primeira sessão evita surpresas, especialmente em uma base de código desconhecida ou importante.

Como atualizo o Claude Code depois de instalado?

npm update -g @anthropic-ai/claude-code

Execute claude --version depois para confirmar que a atualização entrou em vigor.

E se `claude` não for encontrado após a instalação?

Isso geralmente significa que o diretório binário global do npm não está no PATH do seu shell. Execute npm root -g para encontrar onde os pacotes globais são instalados e confirme que o diretório bin correspondente está no seu PATH.

A instalação do Claude Code requer sudo ou direitos de administrador?

Depende de como suas instalações globais do npm estão configuradas em sua máquina. Se você encontrar erros de permissão, isso é um sinal de que seu diretório global do npm precisa ser ajustado, em vez de algo específico do Claude Code.

Relacionados

Noções Básicas do Claude Code 101 - um conjunto mais completo de exemplos da primeira sessão além da instalação e conexão.
O Modelo Mental do Claude Code: Agente, Não Autocompletar - o que esperar assim que sua primeira sessão estiver em execução.
Navegando no REPL do Claude Code: Prompts e Comandos de Barra - como usar a sessão depois que ela estiver conectada.
Modos de Permissão Explicados: Aceitar Automaticamente vs. Perguntar a Cada Vez - decida seu modo inicial antes de sua primeira solicitação real.

Versões do Stack: Escrito contra a linha de modelos Claude atual em ~junho de 2026 - Claude Fable 5, Claude Opus 4.8, Claude Sonnet 5 (o padrão) e Claude Haiku 4.5. Nomes de modelos, preços e recursos do produto mudam rapidamente - verifique os detalhes atuais em platform.claude.com/docs antes de confiar neles.