Imersão Claude na Prática 2026

CLAUDE CODE

Manual Completo de Instalação

Windows e Mac — À Prova de Falhas

v2.0 • standalone • pdf-ready
Role
Navegação Rápida

Índice do Manual


Seção 01

O Que É o Claude Code?

O Claude Code é uma CLI (Command Line Interface) — em português, Interface de Linha de Comando. Isso significa que você interage com ele digitando comandos de texto em uma janela chamada terminal (no Mac) ou PowerShell (no Windows).

Diferente do Claude Web (acessado pelo navegador) ou do Claude Desktop, o Claude Code é uma ferramenta instalada diretamente no seu computador. Isso lhe dá poderes que os outros modos não têm:

  • Ler e editar arquivos do seu computador diretamente
  • Executar comandos no sistema operacional
  • Trabalhar dentro de projetos de código
  • Criar, mover, renomear e deletar arquivos
  • Buscar informações na web em tempo real
  • Lembrar instruções entre sessões usando arquivos CLAUDE.md
💡
Por que usar o Claude Code?

Se você trabalha com criação de conteúdo, o Claude Code pode editar dezenas de arquivos de uma vez, organizar pastas inteiras, criar estruturas de projetos complexos e automatizar tarefas repetitivas — tudo com um único comando em linguagem natural.

Ferramentas Integradas (Built-in Tools)

O Claude Code vem com ferramentas nativas que ele usa automaticamente conforme a necessidade:

  • Bash — Executa comandos no terminal (instalar pacotes, rodar scripts, manipular arquivos)
  • Editor de texto — Lê e edita arquivos de código com precisão cirúrgica
  • Busca na web — Pesquisa documentação e informações atualizadas
  • Memória — Salva contexto entre sessões usando arquivos CLAUDE.md

Ele decide sozinho qual ferramenta usar. Você pede "corrija o bug nesse arquivo" e ele lê o código, identifica o problema, edita e testa — tudo automaticamente.

Quando Usar Cada Ferramenta Claude

Ferramenta O Que Faz Melhor Para
Claude Web Conversar pelo navegador Pesquisar, brainstorming, perguntas rápidas
Claude Desktop Trabalhar com arquivos locais Criar documentos, editar textos, organizar
Claude Code Executar no terminal Programar, automatizar, integrar sistemas

Seção 02

Pré-requisitos Antes de Instalar

Antes de começar a instalação, verifique os seguintes itens:

Sistema Operacional Mínimo

  • Windows: Windows 10 ou superior
  • Mac: macOS 10.15 Catalina ou superior

Hardware Mínimo

  • 4 GB de RAM (recomendado: 16 GB)
  • 500 MB de espaço em disco disponível
  • Conexão com a internet (obrigatório)

Conta na Anthropic

Você precisará de uma conta ativa na Anthropic com um dos seguintes planos:

  • Claude Pro
  • Claude Max
  • Claude Teams
  • Claude Enterprise
  • Conta no Console com créditos de API
⚠️
Atenção: Plano gratuito NÃO funciona!

O plano gratuito do Claude.ai NÃO inclui acesso ao Claude Code. Você precisa de um plano pago (Pro, Max, Teams ou Enterprise) para usar. Sem plano pago, a autenticação falhará.


Seção 03

Como Criar Sua Conta na Anthropic

  1. Acesse claude.ai no seu navegador
  2. Clique em "Sign up" (Cadastrar)
  3. Escolha entre cadastro por Google, Apple ou e-mail
  4. Confirme seu e-mail se escolheu cadastro por e-mail
  5. Faça o upgrade para um plano pago: clique no seu perfil → "Upgrade plan"
  6. Escolha o plano Pro (mais comum para uso individual)
  7. Insira os dados de pagamento e confirme
Pronto!

Com a conta criada e o plano ativo, você está pronto para instalar o Claude Code. Não é necessário criar uma chave de API separada — a autenticação é feita via login.


Seção 04

Instalação no Windows

Siga este guia passo a passo. Leia tudo antes de começar.

4.1 Como Abrir o PowerShell

O PowerShell é o terminal moderno do Windows — é por onde você instalará o Claude Code. Existem 3 formas de abri-lo:

Método 1 — Pelo Menu Iniciar (recomendado para iniciantes)

  1. Clique no botão Iniciar (ícone do Windows no canto inferior esquerdo)
  2. Digite: PowerShell
  3. Clique com o botão direito em "Windows PowerShell"
  4. Selecione "Executar como administrador"
  5. Se aparecer uma janela perguntando "Deseja permitir...", clique em "Sim"

Método 2 — Pelo atalho de teclado

  1. Pressione as teclas Windows + R ao mesmo tempo
  2. Digite: powershell
  3. Pressione Ctrl + Shift + Enter para abrir como administrador
  4. Clique em "Sim" se aparecer a confirmação

Método 3 — Clicando com o botão direito

  1. Vá até a pasta onde quer trabalhar
  2. Segure a tecla Shift e clique com o botão direito do mouse
  3. Selecione "Abrir janela do PowerShell aqui"
💡
Como reconhecer que o PowerShell abriu corretamente

Você verá uma tela escura (ou azul) com texto branco. A linha começa com: PS C:\Users\SeuNome>. Se estiver como administrador, o título da janela dirá "Administrador: Windows PowerShell".

4.2 Instalando o Git for Windows (obrigatório)

O Claude Code no Windows depende do Git Bash para funcionar. Sem ele, a instalação pode falhar.

  1. Acesse: git-scm.com/download/win
  2. Clique em "Click here to download" — o download começa automaticamente
  3. Abra o arquivo baixado (.exe) e clique em "Next" em todas as telas
  4. Mantenha todas as opções padrão — não mude nada
  5. Na última tela, clique em "Finish"
  6. Feche e reabra o PowerShell após a instalação do Git
⚠️
Por que o Git é necessário?

O Claude Code usa o Git Bash internamente para executar comandos no Windows. Sem o Git instalado, você pode receber o erro: git bash not found ou a instalação pode travar sem mensagem de erro clara.

4.3 Comando de Instalação

Com o PowerShell aberto como administrador e o Git instalado, copie e cole o comando abaixo:

PowerShell — Administrador
PS C:\Users\Voce> irm https://claude.ai/install.ps1 | iex

Pressione Enter e aguarde. A instalação pode levar de 1 a 5 minutos dependendo da sua internet.

O que deve aparecer durante a instalação

Downloading Claude Code...
Installing...
Claude Code installed successfully!
Se você ver essas mensagens, a instalação foi bem-sucedida.

⚠️
Se aparecer erro de política de execução (Execution Policy)

Cole este comando antes do comando de instalação:

PowerShell — Correção
PS> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser # Pressione S (de Sim) e Enter quando solicitado # Depois execute o comando de instalação novamente

4.4 Autenticação Após Instalar

Após instalar, execute o Claude Code pela primeira vez digitando:

PowerShell
PS C:\Users\Voce> claude

Na primeira execução, ele pedirá que você faça login. Siga os passos:

  1. Aparecerá a opção: "Login with Claude.ai account"
  2. Pressione Enter para selecionar esta opção
  3. Uma aba abrirá no seu navegador
  4. Faça login com o mesmo e-mail da sua conta paga
  5. Copie o código de autenticação exibido na página
  6. Cole o código no PowerShell e pressione Enter
  7. Pronto — você está autenticado!
💡
Não feche o navegador antes de copiar o código!

O código de autenticação expira em poucos minutos. Se demorar muito, feche o Claude Code com Ctrl+C e tente novamente.

4.5 Verificando se Funcionou

Digite o comando abaixo para confirmar que tudo está funcionando:

PowerShell — Verificação
PS C:\Users\Voce> claude --version claude/1.x.x
Teste rápido de funcionamento

Digite: claude "olá, você está funcionando?"
Se o Claude responder normalmente, tudo certo! Se aparecer um erro, vá para a seção 4.6.

4.6 Erros Comuns no Windows e Soluções

Erro: 'claude' não é reconhecido como comando interno

Este é o erro mais comum. Significa que o sistema não encontra o Claude Code na variável PATH.

Solução:

  1. Pressione Windows + R, digite sysdm.cpl e pressione Enter
  2. Clique em "Avançado""Variáveis de Ambiente"
  3. Em "Variáveis do usuário", clique em "Path" e depois "Editar"
  4. Clique em "Novo" e adicione: %USERPROFILE%\.local\bin
  5. Clique em OK em todas as janelas
  6. Feche TODOS os terminais abertos e abra um novo PowerShell
  7. Digite claude --version para testar

Erro: Execution Policy ou 'não é possível carregar'

O Windows bloqueou a execução do script por política de segurança.

PowerShell — Solução
PS> Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser # Pressione S e Enter quando solicitado # Depois execute o comando de instalação novamente: PS> irm https://claude.ai/install.ps1 | iex

Erro: git bash not found ou could not find git

O Git não está instalado ou não foi detectado.

Solução:

  1. Baixe e instale o Git em: git-scm.com/download/win
  2. Durante a instalação, garanta que "Add Git to PATH" está marcado
  3. Feche e reabra o PowerShell
  4. Tente a instalação do Claude Code novamente

Erro: Timeout ou instalação travada

A instalação pode ter travado por problema de internet ou servidor.

Solução:

  1. Pressione Ctrl + C para cancelar
  2. Aguarde 1 minuto
  3. Execute o comando de instalação novamente
  4. Se continuar falhando, tente em horário diferente

4.7 Pedindo Ajuda ao Claude.ai

Se você encontrou um erro que não está neste manual, o Claude.ai pode te ajudar:

  1. Abra claude.ai no navegador
  2. Tire um print da tela do PowerShell com o erro
  3. Use o modelo de mensagem abaixo:
Template para copiar Estou tentando instalar o Claude Code no Windows [versão do Windows]. Quando executo o comando de instalação, aparece este erro: [COLE O TEXTO DO ERRO AQUI ou anexe o print] O que devo fazer para resolver?
💡
Dicas para obter melhor ajuda

Sempre informe: versão do Windows, o comando que usou e a mensagem de erro completa. Copie o texto do erro (selecione no PowerShell e pressione Ctrl+C). Quanto mais detalhes você der, mais precisa será a solução.

4.8 Principais Comandos do PowerShell

Conhecer estes comandos vai te ajudar a navegar e trabalhar com o Claude Code:

Navegação entre pastas

ComandoO Que Faz
cd NomeDaPastaEntrar em uma pasta
cd ..Voltar uma pasta acima
cd ~Ir para a pasta do usuário (home)
cd C:\Users\Voce\DocumentosIr para um caminho específico
dirListar arquivos e pastas da pasta atual
lsAlternativa ao dir (também funciona)
pwdMostrar em qual pasta você está

Criar e manipular pastas

ComandoO Que Faz
mkdir NomeDaPastaCriar uma nova pasta
mkdir Pasta1\Pasta2Criar pastas aninhadas
Remove-Item NomeDaPasta -RecurseDeletar uma pasta e todo seu conteúdo
Copy-Item origem destinoCopiar um arquivo
Move-Item origem destinoMover ou renomear um arquivo

Arquivos e conteúdo

ComandoO Que Faz
cat arquivo.txtVer o conteúdo de um arquivo de texto
notepad arquivo.txtAbrir um arquivo no Bloco de Notas
New-Item arquivo.txtCriar um arquivo vazio
del arquivo.txtDeletar um arquivo
Clear-HostLimpar a tela do terminal

Comandos especiais com Claude Code

ComandoO Que Faz
claudeIniciar o Claude Code interativo
claude "sua pergunta"Fazer uma pergunta rápida sem modo interativo
claude -cContinuar a última conversa
cat arquivo.txt | claude "resuma"Enviar conteúdo de arquivo para o Claude
claude --versionVer a versão instalada
💡
Dica de ouro: use Tab para autocompletar!

No PowerShell, ao digitar parte de um nome de pasta ou arquivo, pressione Tab. O sistema completará automaticamente o nome. Pressione Tab várias vezes para alternar entre opções.


Seção 05

Instalação no Mac

O Mac é a plataforma onde o Claude Code funciona de forma mais simples — a instalação é direta e raramente apresenta problemas.

5.1 Como Abrir o Terminal

O Terminal é o equivalente ao PowerShell no Mac. Existem 3 formas de abri-lo:

Método 1 — Pelo Spotlight (mais rápido)

  1. Pressione Command (⌘) + Barra de espaço
  2. Digite: Terminal
  3. Pressione Enter quando aparecer o app Terminal

Método 2 — Pelo Finder

  1. Abra o Finder (ícone de pasta colorida no Dock)
  2. Vá em Aplicativos → Utilitários
  3. Dê um duplo clique em "Terminal"

Método 3 — Pelo Launchpad

  1. Clique no Launchpad (ícone de foguete no Dock)
  2. Digite Terminal na barra de busca
  3. Clique no ícone Terminal
💡
Como reconhecer que o Terminal abriu corretamente

Você verá uma janela com texto. A linha termina com $ ou % e um cursor piscando.
No Mac com Apple Silicon (M1/M2/M3): NomeDoMac %
No Mac com Intel: NomeDoMac:~ NomeDeUsuario$

5.2 Comando de Instalação

Com o Terminal aberto, copie e cole exatamente o comando abaixo:

Terminal — macOS
$ curl -fsSL https://claude.ai/install.sh | bash

Pressione Enter e aguarde. O processo pode levar de 1 a 3 minutos.

O que deve aparecer

Downloading Claude Code...
Installing...
Claude Code installed successfully!
Se você ver estas mensagens, a instalação foi um sucesso.

Alternativa via Homebrew

Se você já usa o Homebrew:

Terminal — Homebrew
$ brew install --cask claude-code

5.3 Autenticação Após Instalar

Após instalar, inicie o Claude Code digitando:

Terminal
$ claude

Na primeira execução, siga os passos de login:

  1. Aparecerá a opção: "Login with Claude.ai account"
  2. Pressione Enter
  3. Uma aba abrirá no seu navegador
  4. Faça login com sua conta paga do Claude
  5. Copie o código de autenticação exibido
  6. Cole o código no Terminal e pressione Enter
  7. Autenticação concluída!

5.4 Verificando se Funcionou

Terminal — Verificação
$ claude --version claude/1.x.x
Teste rápido

Digite: claude "olá, você está funcionando?"
Se o Claude responder, tudo está perfeito!

5.5 Erros Comuns no Mac e Soluções

Erro: command not found: claude

O terminal não encontrou o Claude Code no PATH.

Solução:

  1. Feche o Terminal completamente
  2. Reabra o Terminal
  3. Digite: source ~/.zshrc e pressione Enter (ou source ~/.bashrc se usar Bash)
  4. Tente novamente com: claude --version

Se ainda não funcionar:

Terminal — Correção PATH
$ echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc $ source ~/.zshrc

Erro: Permission denied (permissão negada)

Você não tem permissão para instalar na pasta de destino.

🚫
Nunca use sudo com o instalador do Claude Code!

Em vez disso, crie a pasta manualmente e execute a instalação novamente:

Terminal — Correção Permissão
$ mkdir -p ~/.local/bin $ curl -fsSL https://claude.ai/install.sh | bash

Erro: curl: command not found

O curl não está disponível (raro em Macs modernos).

Solução: Instale o Homebrew primeiro:

Terminal — Instalar Homebrew
$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" # Após instalar o Homebrew: $ brew install --cask claude-code

Erro durante a autenticação — código inválido

O código expirou antes de ser colado.

Solução:

  1. Pressione Ctrl + C para sair do Claude Code
  2. Digite claude novamente
  3. Repita o processo de login mais rapidamente
  4. Tenha o navegador já aberto na aba do Claude antes de começar

5.6 Pedindo Ajuda ao Claude.ai

Se encontrar um erro não listado aqui, use este modelo no Claude.ai:

Template para copiar Estou tentando instalar o Claude Code no Mac [versão do macOS]. Quando executo o comando de instalação, aparece este erro: [COLE O TEXTO DO ERRO AQUI] O que devo fazer para resolver?
💡
Como copiar o erro no Mac

No Terminal, selecione o texto do erro com o mouse. Pressione Command + C para copiar. Cole no Claude.ai com Command + V.

5.7 Principais Comandos do Terminal (Mac)

Estes são os comandos mais usados no Terminal. São idênticos aos do Linux:

Navegação entre pastas

ComandoO Que Faz
cd NomeDaPastaEntrar em uma pasta
cd ..Voltar uma pasta acima
cd ~Ir para a pasta do usuário (home)
cd ~/DocumentsIr para Documentos
lsListar arquivos e pastas
ls -laListar tudo, incluindo arquivos ocultos
pwdMostrar o caminho completo da pasta atual

Criar e manipular pastas

ComandoO Que Faz
mkdir NomeDaPastaCriar uma nova pasta
mkdir -p Pasta1/Pasta2Criar pastas aninhadas
rm -rf NomeDaPastaDeletar uma pasta e todo seu conteúdo
cp origem destinoCopiar um arquivo
mv origem destinoMover ou renomear arquivo

Arquivos e conteúdo

ComandoO Que Faz
cat arquivo.txtVer o conteúdo de um arquivo
open arquivo.txtAbrir arquivo no app padrão
open .Abrir a pasta atual no Finder
touch arquivo.txtCriar um arquivo vazio
rm arquivo.txtDeletar um arquivo
clearLimpar a tela do terminal

Comandos especiais com Claude Code

ComandoO Que Faz
claudeIniciar o Claude Code interativo
claude "sua pergunta"Pergunta rápida sem modo interativo
claude -cContinuar a última conversa
cat arquivo.txt | claude "resuma"Enviar conteúdo de arquivo ao Claude
claude --versionVer versão instalada
💡
Dica de ouro: autocompletar no Terminal

Pressione Tab para autocompletar nomes de pastas e arquivos. Pressione as setas para cima/baixo para navegar entre comandos anteriores. Digite history para ver todos os comandos que você já usou.


Seção 06

Primeiros Passos Após Instalar

Com o Claude Code instalado e autenticado, aqui estão os primeiros passos recomendados:

Passo 1 — Abra o Claude Code em uma pasta de trabalho

Sempre abra o Claude Code dentro da pasta do projeto em que quer trabalhar:

Terminal / PowerShell
# Mac / Linux: $ cd ~/Documents/MeuProjeto $ claude # Windows: PS> cd ~\Documents\MeuProjeto PS> claude
⚠️
Atenção: acesso aos arquivos

O Claude Code terá acesso a todos os arquivos e subpastas da pasta onde foi aberto. Nunca abra o Claude Code na raiz do seu disco (C:\ ou /). Sempre use uma pasta específica.

Passo 2 — Faça uma pergunta simples

Teste o funcionamento com uma pergunta básica:

Claude Code — Interativo
claude> Qual é a estrutura de arquivos desta pasta?

Passo 3 — Explore os modos de permissão

O Claude Code tem 3 níveis de autonomia:

ModoComportamentoQuando Usar
Padrão Pede permissão para cada ação importante Quando está aprendendo ou com arquivos sensíveis
Auto-edit Edita arquivos automaticamente, pede permissão para comandos Quando confia no Claude para editar
YOLO Faz tudo automaticamente sem pedir permissão Confiança total na tarefa (use com cuidado!)

Seção 07

Comandos Essenciais Dentro do Claude Code

Estes comandos funcionam dentro do Claude Code (não no terminal externo):

ComandoO Que Faz
/helpMostra todos os comandos disponíveis
/compactCompacta o contexto quando a conversa fica longa
/memoryEdita as instruções permanentes do projeto (CLAUDE.md)
/costMostra quanto custou a sessão atual
/clearLimpa a conversa atual
/quitSai do Claude Code
Ctrl + CCancela a ação atual ou sai do modo interativo

O Arquivo CLAUDE.md — Sua Memória Permanente

Você pode criar um arquivo chamado CLAUDE.md na pasta do seu projeto. O Claude Code lê esse arquivo automaticamente toda vez que é iniciado naquela pasta.

Use para guardar:

  • Instruções de como o Claude deve se comportar no projeto
  • Estilo de escrita e convenções de código
  • Regras e preferências específicas
  • Contexto importante sobre o projeto
💡
Dica: use /memory para editar

O comando /memory dentro do Claude Code abre o arquivo CLAUDE.md para edição rápida, sem precisar sair do modo interativo.


Seção 08

Como Atualizar e Desinstalar

Atualizar o Claude Code

O instalador nativo atualiza automaticamente em segundo plano. Para atualizar manualmente:

Windows:

PowerShell — Atualizar
PS> winget upgrade Anthropic.ClaudeCode

Mac:

Terminal — Atualizar
$ claude update

Desinstalar o Claude Code

Windows:

PowerShell — Desinstalar
PS> Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force PS> Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

Mac / Linux:

Terminal — Desinstalar
$ rm -f ~/.local/bin/claude $ rm -rf ~/.local/share/claude $ rm -rf ~/.claude $ rm -f ~/.claude.json
⚠️
Atenção ao desinstalar

Remover os arquivos de configuração apagará todas as suas configurações, ferramentas permitidas, servidores MCP e histórico de sessões. Faça backup se necessário.


Seção 09

Glossário para Iniciantes

Se algum termo deste manual pareceu desconhecido, aqui está uma explicação simples:

TermoO Que Significa
TerminalJanela de texto para digitar comandos no computador (Mac/Linux)
PowerShellEquivalente ao Terminal no Windows — versão moderna
CMD / PromptVersão antiga do terminal do Windows
CLICommand Line Interface — programa controlado por texto
PATHLista de pastas onde o sistema busca programas instalados
BashLinguagem/interpretador de comandos usado no Mac e Linux
GitSistema de controle de versão de código — necessário no Windows
Git BashTerminal no estilo Linux que o Git instala no Windows
WSLWindows Subsystem for Linux — Linux dentro do Windows
curlComando para baixar arquivos da internet pelo terminal
npmGerenciador de pacotes do Node.js (não necessário para Claude Code nativo)
API KeyChave secreta para autenticar em serviços — não necessária aqui
MCPModel Context Protocol — protocolo para conectar Claude a outros serviços
CLAUDE.mdArquivo de instruções permanentes lido pelo Claude Code
/helpComando interno do Claude Code para ver opções disponíveis
Pipe ( | )Operador que envia o resultado de um comando como entrada para outro