Índice do Manual
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
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 |
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
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á.
Como Criar Sua Conta na Anthropic
- Acesse claude.ai no seu navegador
- Clique em "Sign up" (Cadastrar)
- Escolha entre cadastro por Google, Apple ou e-mail
- Confirme seu e-mail se escolheu cadastro por e-mail
- Faça o upgrade para um plano pago: clique no seu perfil → "Upgrade plan"
- Escolha o plano Pro (mais comum para uso individual)
- Insira os dados de pagamento e confirme
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.
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)
- Clique no botão Iniciar (ícone do Windows no canto inferior esquerdo)
- Digite:
PowerShell - Clique com o botão direito em "Windows PowerShell"
- Selecione "Executar como administrador"
- Se aparecer uma janela perguntando "Deseja permitir...", clique em "Sim"
Método 2 — Pelo atalho de teclado
- Pressione as teclas Windows + R ao mesmo tempo
- Digite:
powershell - Pressione Ctrl + Shift + Enter para abrir como administrador
- Clique em "Sim" se aparecer a confirmação
Método 3 — Clicando com o botão direito
- Vá até a pasta onde quer trabalhar
- Segure a tecla Shift e clique com o botão direito do mouse
- Selecione "Abrir janela do PowerShell aqui"
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.
- Acesse: git-scm.com/download/win
- Clique em "Click here to download" — o download começa automaticamente
- Abra o arquivo baixado (.exe) e clique em "Next" em todas as telas
- Mantenha todas as opções padrão — não mude nada
- Na última tela, clique em "Finish"
- Feche e reabra o PowerShell após a instalação do Git
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:
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.
Downloading Claude Code...Installing...Claude Code installed successfully!
Se você ver essas mensagens, a instalação foi bem-sucedida.
Cole este comando antes do comando de instalaçã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:
PS C:\Users\Voce> claude
Na primeira execução, ele pedirá que você faça login. Siga os passos:
- Aparecerá a opção: "Login with Claude.ai account"
- Pressione Enter para selecionar esta opção
- Uma aba abrirá no seu navegador
- Faça login com o mesmo e-mail da sua conta paga
- Copie o código de autenticação exibido na página
- Cole o código no PowerShell e pressione Enter
- Pronto — você está autenticado!
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:
PS C:\Users\Voce> claude --version
claude/1.x.x
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:
- Pressione Windows + R, digite
sysdm.cple pressione Enter - Clique em "Avançado" → "Variáveis de Ambiente"
- Em "Variáveis do usuário", clique em "Path" e depois "Editar"
- Clique em "Novo" e adicione:
%USERPROFILE%\.local\bin - Clique em OK em todas as janelas
- Feche TODOS os terminais abertos e abra um novo PowerShell
- Digite
claude --versionpara testar
Erro: Execution Policy ou 'não é possível carregar'
O Windows bloqueou a execução do script por política de segurança.
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:
- Baixe e instale o Git em: git-scm.com/download/win
- Durante a instalação, garanta que "Add Git to PATH" está marcado
- Feche e reabra o PowerShell
- 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:
- Pressione Ctrl + C para cancelar
- Aguarde 1 minuto
- Execute o comando de instalação novamente
- 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:
- Abra claude.ai no navegador
- Tire um print da tela do PowerShell com o erro
- Use o modelo de mensagem abaixo:
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
| Comando | O Que Faz |
|---|---|
cd NomeDaPasta | Entrar em uma pasta |
cd .. | Voltar uma pasta acima |
cd ~ | Ir para a pasta do usuário (home) |
cd C:\Users\Voce\Documentos | Ir para um caminho específico |
dir | Listar arquivos e pastas da pasta atual |
ls | Alternativa ao dir (também funciona) |
pwd | Mostrar em qual pasta você está |
Criar e manipular pastas
| Comando | O Que Faz |
|---|---|
mkdir NomeDaPasta | Criar uma nova pasta |
mkdir Pasta1\Pasta2 | Criar pastas aninhadas |
Remove-Item NomeDaPasta -Recurse | Deletar uma pasta e todo seu conteúdo |
Copy-Item origem destino | Copiar um arquivo |
Move-Item origem destino | Mover ou renomear um arquivo |
Arquivos e conteúdo
| Comando | O Que Faz |
|---|---|
cat arquivo.txt | Ver o conteúdo de um arquivo de texto |
notepad arquivo.txt | Abrir um arquivo no Bloco de Notas |
New-Item arquivo.txt | Criar um arquivo vazio |
del arquivo.txt | Deletar um arquivo |
Clear-Host | Limpar a tela do terminal |
Comandos especiais com Claude Code
| Comando | O Que Faz |
|---|---|
claude | Iniciar o Claude Code interativo |
claude "sua pergunta" | Fazer uma pergunta rápida sem modo interativo |
claude -c | Continuar a última conversa |
cat arquivo.txt | claude "resuma" | Enviar conteúdo de arquivo para o Claude |
claude --version | Ver a versão instalada |
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.
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)
- Pressione Command (⌘) + Barra de espaço
- Digite:
Terminal - Pressione Enter quando aparecer o app Terminal
Método 2 — Pelo Finder
- Abra o Finder (ícone de pasta colorida no Dock)
- Vá em Aplicativos → Utilitários
- Dê um duplo clique em "Terminal"
Método 3 — Pelo Launchpad
- Clique no Launchpad (ícone de foguete no Dock)
- Digite
Terminalna barra de busca - Clique no ícone Terminal
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:
$ curl -fsSL https://claude.ai/install.sh | bash
Pressione Enter e aguarde. O processo pode levar de 1 a 3 minutos.
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:
$ brew install --cask claude-code
5.3 Autenticação Após Instalar
Após instalar, inicie o Claude Code digitando:
$ claude
Na primeira execução, siga os passos de login:
- Aparecerá a opção: "Login with Claude.ai account"
- Pressione Enter
- Uma aba abrirá no seu navegador
- Faça login com sua conta paga do Claude
- Copie o código de autenticação exibido
- Cole o código no Terminal e pressione Enter
- Autenticação concluída!
5.4 Verificando se Funcionou
$ claude --version
claude/1.x.x
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:
- Feche o Terminal completamente
- Reabra o Terminal
- Digite:
source ~/.zshrce pressione Enter (ousource ~/.bashrcse usar Bash) - Tente novamente com:
claude --version
Se ainda não funcionar:
$ 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.
sudo com o instalador do Claude Code!
Em vez disso, crie a pasta manualmente e execute a instalação novamente:
$ 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:
$ /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:
- Pressione Ctrl + C para sair do Claude Code
- Digite
claudenovamente - Repita o processo de login mais rapidamente
- 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:
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
| Comando | O Que Faz |
|---|---|
cd NomeDaPasta | Entrar em uma pasta |
cd .. | Voltar uma pasta acima |
cd ~ | Ir para a pasta do usuário (home) |
cd ~/Documents | Ir para Documentos |
ls | Listar arquivos e pastas |
ls -la | Listar tudo, incluindo arquivos ocultos |
pwd | Mostrar o caminho completo da pasta atual |
Criar e manipular pastas
| Comando | O Que Faz |
|---|---|
mkdir NomeDaPasta | Criar uma nova pasta |
mkdir -p Pasta1/Pasta2 | Criar pastas aninhadas |
rm -rf NomeDaPasta | Deletar uma pasta e todo seu conteúdo |
cp origem destino | Copiar um arquivo |
mv origem destino | Mover ou renomear arquivo |
Arquivos e conteúdo
| Comando | O Que Faz |
|---|---|
cat arquivo.txt | Ver o conteúdo de um arquivo |
open arquivo.txt | Abrir arquivo no app padrão |
open . | Abrir a pasta atual no Finder |
touch arquivo.txt | Criar um arquivo vazio |
rm arquivo.txt | Deletar um arquivo |
clear | Limpar a tela do terminal |
Comandos especiais com Claude Code
| Comando | O Que Faz |
|---|---|
claude | Iniciar o Claude Code interativo |
claude "sua pergunta" | Pergunta rápida sem modo interativo |
claude -c | Continuar a última conversa |
cat arquivo.txt | claude "resuma" | Enviar conteúdo de arquivo ao Claude |
claude --version | Ver versão instalada |
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.
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:
# Mac / Linux:
$ cd ~/Documents/MeuProjeto
$ claude
# Windows:
PS> cd ~\Documents\MeuProjeto
PS> claude
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> Qual é a estrutura de arquivos desta pasta?
Passo 3 — Explore os modos de permissão
O Claude Code tem 3 níveis de autonomia:
| Modo | Comportamento | Quando 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!) |
Comandos Essenciais Dentro do Claude Code
Estes comandos funcionam dentro do Claude Code (não no terminal externo):
| Comando | O Que Faz |
|---|---|
/help | Mostra todos os comandos disponíveis |
/compact | Compacta o contexto quando a conversa fica longa |
/memory | Edita as instruções permanentes do projeto (CLAUDE.md) |
/cost | Mostra quanto custou a sessão atual |
/clear | Limpa a conversa atual |
/quit | Sai do Claude Code |
Ctrl + C | Cancela 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
/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.
Como Atualizar e Desinstalar
Atualizar o Claude Code
O instalador nativo atualiza automaticamente em segundo plano. Para atualizar manualmente:
Windows:
PS> winget upgrade Anthropic.ClaudeCode
Mac:
$ claude update
Desinstalar o Claude Code
Windows:
PS> Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
PS> Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force
Mac / Linux:
$ rm -f ~/.local/bin/claude
$ rm -rf ~/.local/share/claude
$ rm -rf ~/.claude
$ rm -f ~/.claude.json
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.
Glossário para Iniciantes
Se algum termo deste manual pareceu desconhecido, aqui está uma explicação simples:
| Termo | O Que Significa |
|---|---|
| Terminal | Janela de texto para digitar comandos no computador (Mac/Linux) |
| PowerShell | Equivalente ao Terminal no Windows — versão moderna |
| CMD / Prompt | Versão antiga do terminal do Windows |
| CLI | Command Line Interface — programa controlado por texto |
| PATH | Lista de pastas onde o sistema busca programas instalados |
| Bash | Linguagem/interpretador de comandos usado no Mac e Linux |
| Git | Sistema de controle de versão de código — necessário no Windows |
| Git Bash | Terminal no estilo Linux que o Git instala no Windows |
| WSL | Windows Subsystem for Linux — Linux dentro do Windows |
| curl | Comando para baixar arquivos da internet pelo terminal |
| npm | Gerenciador de pacotes do Node.js (não necessário para Claude Code nativo) |
| API Key | Chave secreta para autenticar em serviços — não necessária aqui |
| MCP | Model Context Protocol — protocolo para conectar Claude a outros serviços |
| CLAUDE.md | Arquivo de instruções permanentes lido pelo Claude Code |
| /help | Comando interno do Claude Code para ver opções disponíveis |
| Pipe ( | ) | Operador que envia o resultado de um comando como entrada para outro |