Material grátis · sem cadastro

Manual do Claude Code, do zero ao primeiro teste.

Pra quem nunca abriu um terminal. Mac e Windows, lado a lado. Cada passo de instalação termina com um jeito de conferir se deu certo. Os comandos foram conferidos na documentação oficial da Anthropic em setembro de 2026.

SistemasMac e Windows
Instalação5 passos
Precisa deConta paga do Claude
Cadastro aquiNenhum

Parte 1 · Instalar

seção 01 · o que é

O que é o Claude Code

É o Claude trabalhando dentro de uma pasta do seu computador. Ele lê os arquivos, cria, edita e roda comando. Você pede em português.

No Claude do site, você cola texto e recebe texto. No Claude Code, ele mexe nos arquivos de verdade. Dependendo do modo de permissão da sessão, ele pergunta antes de agir ou faz a maior parte sozinho. Não precisa saber programar pra usar. Você descreve o que quer, e ele propõe como fazer.

Este manual usa o terminal. Existe também um aplicativo de desktop e uma extensão pro VS Code, mas o terminal é o caminho que funciona igual em qualquer computador.

seção 02 · passo 1 de 5

A conta que ele exige

O Claude Code pede uma conta Pro, Max, Team, Enterprise ou Console. O plano gratuito do claude.ai não inclui o Claude Code. Se você já assina o Pro, este passo está feito.

Confere também o computador:

Mac: macOS 13 ou mais novo
Windows: Windows 10 versão 1809 ou mais novo
Memória: 4 GB de RAM ou mais
Internet: ligada o tempo todo, porque o Claude trabalha online

Como saber que deu certo

Você entra em claude.ai e o seu plano aparece como pago. Guarda o e-mail da conta: ele volta na seção 05.

seção 03 · passo 2 de 5

Abrir o terminal

O terminal é a janela onde você digita comando em vez de clicar. Já vem no computador.

Mac

Aperta Command + Espaço, digita Terminal e aperta Enter.

Como saber que deu certo

Abre uma janela com uma linha que termina em % ou $ e um cursor piscando.

Windows

Abre o menu Iniciar, digita PowerShell e clica em Windows PowerShell. Não precisa abrir como administrador.

Como saber que deu certo

A linha começa com PS C:\Users\SeuNome>. O PS no começo é o que confirma que é PowerShell. Sem o PS, você está no CMD, e o comando da seção 04 muda.

seção 04 · passo 3 de 5

Instalar

Copia o comando do seu sistema, cola no terminal e aperta Enter. Leva um ou dois minutos.

Mac

terminal do mac

curl -fsSL https://claude.ai/install.sh | bash

Usa Homebrew? Dá pra instalar com brew install --cask claude-code. Nesse caso ele não se atualiza sozinho: você roda brew upgrade claude-code de vez em quando.

Windows

No PowerShell:

powershell

irm https://claude.ai/install.ps1 | iex

Se você está no CMD, sem o PS no começo da linha, o comando é este:

cmd

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Recomendado no Windows: instalar o Git for Windows. Com ele, o Claude Code usa o Git Bash pra rodar comando. Sem ele, usa o PowerShell. Funciona dos dois jeitos.

Se aparecer um destes erros

The token '&&' is not a valid statement separator: você está no PowerShell e colou o comando do CMD. Usa o de cima.

'irm' is not recognized: você está no CMD e colou o comando do PowerShell. Usa o de baixo.

Quando terminar, fecha o terminal e abre de novo. Depois roda:

mac ou windows

claude --version

Como saber que deu certo

Aparece um número de versão seguido de (Claude Code). O número muda a cada atualização, então não se preocupa se for diferente do de outra pessoa.

Se aparecer "command not found" ou "not recognized"

A instalação funcionou, mas o terminal não sabe onde ela ficou. É o PATH. A correção está na seção 11, e leva um minuto.

seção 05 · passo 4 de 5

Entrar na conta

Cria uma pasta de teste, entra nela com cd e digita claude. Os três comandos abaixo fazem isso de uma vez. A pasta fica dentro da pasta do seu usuário.

Mac

terminal do mac

mkdir -p ~/teste-claude
cd ~/teste-claude
claude

Windows

powershell

New-Item -ItemType Directory -Force "$env:USERPROFILE\teste-claude"
cd "$env:USERPROFILE\teste-claude"
claude

Na primeira vez, ele abre o navegador pra você entrar com a conta da seção 02. Segue as telas e volta pro terminal. O login fica salvo. Se um dia precisar trocar de conta, digita /login dentro do Claude Code.

Como saber que deu certo

O terminal mostra a tela do Claude Code, com a versão, o modelo e a pasta em que você está, e um campo esperando você digitar.

seção 06 · passo 5 de 5

Primeiro teste

Com o Claude Code aberto na pasta de teste, cola este pedido:

dentro do claude code

cria um arquivo chamado teste.md com três ideias de post sobre o meu trabalho. eu trabalho com [o que você faz, numa frase].

Se ele pedir licença antes de criar o arquivo, lê o que ele vai fazer e aprova. Depois digita /exit e abre a pasta: open . no Mac, explorer . no Windows.

Como saber que deu certo

O arquivo teste.md está na pasta, com as três ideias dentro. Pronto: o Claude Code escreveu no seu computador.

Pra voltar depois, abre o terminal, entra na mesma pasta com cd e digita claude de novo.

Parte 2 · Usar bem

seção 07 · como pedir

Como pedir

Diz o que é e pra quê. "Arruma o texto" rende pouco. "Encurta a legenda do arquivo post.md pra caber em três linhas, sem perder o convite pra comentar" rende muito.

Quebra o trabalho em etapas. Primeiro a lista de ideias. Depois o roteiro de uma. Depois a legenda. Cada etapa você confere antes da próxima.

Deixa ele olhar antes de mexer. Pede "lê a pasta e me diz o que tem aqui" antes de pedir mudança em arquivo que ele ainda não viu.

Revisa num chat separado. No mesmo chat, ele tende a defender o texto que acabou de escrever. Os 3 prompts de revisão resolvem isso.

Repara

Shift + Tab troca o modo de permissão da sessão, ou seja, o quanto ele faz sem te perguntar. Nos planos Pro, Max e Team a sessão costuma começar num modo automático, em que ele faz a maioria das ações sozinho. Começando, vale trocar pra um modo que pergunta. Você aprende o que ele faz lendo cada pedido de licença.

seção 08 · comandos

Comandos essenciais

Os que começam com claude você digita no terminal. Os que começam com / você digita dentro do Claude Code. Digitar só / mostra a lista inteira.

Comando	O que faz
`claude`	Abre o Claude Code na pasta em que você está
`claude "tarefa"`	Abre já com um primeiro pedido
`claude -c`	Continua a conversa mais recente desta pasta
`claude -r`	Retoma uma conversa anterior
`claude -p "pergunta"`	Responde uma vez e fecha, sem abrir a sessão
`/help`	Lista os comandos disponíveis
`/clear`	Começa uma conversa nova, do zero
`/compact`	Resume a conversa até aqui pra liberar espaço
`/context`	Mostra quanto do espaço da conversa já foi usado, e quais arquivos de memória foram lidos
`/resume`	Retoma uma conversa anterior, de dentro da sessão
`/model`	Troca o modelo do Claude
`/init`	Cria um CLAUDE.md inicial olhando a pasta
`/memory`	Abre os arquivos de memória pra editar
`/skills`	Lista as skills instaladas
`/permissions`	Mostra e edita as regras do que ele pode fazer, com ou sem perguntar
`/login`	Entra com outra conta
`/exit`	Sai do Claude Code. Ctrl + D duas vezes faz o mesmo

seção 09 · memória

CLAUDE.md, a memória do projeto

Toda sessão começa sem lembrar da anterior. O CLAUDE.md é o arquivo que ele lê sempre ao abrir. O que você escreve ali vale pra todas as conversas daquela pasta.

Do projeto: CLAUDE.md na raiz da pasta, ou .claude/CLAUDE.md
Seu, pra todos os projetos: ~/.claude/CLAUDE.md

O jeito mais rápido de começar: dentro do Claude Code, na pasta do projeto, digita /init. Ele olha a pasta e escreve um primeiro CLAUDE.md. Depois você completa com o que ele não tinha como adivinhar.

Um exemplo pra quem produz conteúdo:

claude.md de exemplo

# Quem sou
[Seu nome], [o que você faz]. Falo com [quem é o seu público].

# Como escrevo
- Frase curta. Uso "pra", não "para".
- Sem travessão.
- Uma chamada pra ação por peça, e ela vai no fim.

# O que nunca fazer
- Inventar número. Sem fonte, não entra.
- Prometer resultado.

# Onde ficam as coisas
- Rascunhos na pasta rascunhos/
- Peças aprovadas na pasta aprovadas/

Repara

A documentação oficial recomenda manter cada CLAUDE.md abaixo de 200 linhas. Arquivo grande ocupa espaço da conversa e é seguido com menos cuidado. Pra conferir se ele foi lido, digita /context.

seção 10 · skills

Instalar uma skill

Skill é um arquivo de instruções que o Claude Code segue quando você chama pelo nome, ou quando o pedido combina com a descrição dela. Toda skill é uma pasta com um arquivo SKILL.md dentro.

Pra usar em todos os projetos: ~/.claude/skills/<nome>/SKILL.md
Só neste projeto: .claude/skills/<nome>/SKILL.md

O nome do arquivo precisa ser exatamente SKILL.md. Arquivo solto dentro de skills/, sem a pasta própria, não é encontrado.

1. Cria a pasta. O exemplo usa o nome revisor.

Mac

terminal do mac

mkdir -p ~/.claude/skills/revisor

Windows

powershell

New-Item -ItemType Directory -Force "$env:USERPROFILE\.claude\skills\revisor"

2. Salva o SKILL.md dentro dela. O começo do arquivo, entre as linhas de ---, diz o nome e quando usar. O resto é a instrução.

skill.md de exemplo

---
name: revisor
description: Revisa um texto procurando problema, não aprovação. Use quando eu pedir pra revisar legenda, roteiro, proposta ou página.
---

Trate o texto como se tivesse vindo de um fornecedor. Você não sabe quem escreveu.
Procure o que impede o objetivo do texto: frase confusa, promessa sem sustentação,
número sem fonte, trecho que pode sair.
Devolva uma lista numerada, do mais grave pro menos grave, com o trecho exato e o conserto.
Não elogie. No fim, diga qual correção fazer primeiro.

Salva com o editor que você já usa. No Windows, confere se o nome ficou SKILL.md e não SKILL.md.txt: o Bloco de Notas às vezes acrescenta o .txt sem avisar.

3. Usa. Dentro do Claude Code, digita /revisor e o que você quer revisar. Se a pasta skills acabou de ser criada, sai com /exit e abre o claude de novo: ele só acompanha a pasta que já existia quando a sessão abriu. Depois disso, skill nova ou editada aparece sem reiniciar.

Como saber que deu certo

Digita /skills. O revisor aparece na lista, com a descrição que você escreveu.

Parte 3 · Apoio

seção 11 · erros

Deu erro?

"command not found: claude" ou "'claude' is not recognized". O instalador põe o Claude Code numa pasta que o terminal ainda não conhece. Você só avisa o terminal onde ela fica.

Mac

Primeiro confere. Se não aparecer nada, a pasta está fora do PATH:

terminal do mac

echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin"

Pra corrigir no terminal padrão do Mac, que é o zsh:

terminal do mac

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Windows

Primeiro confere no PowerShell. Se não aparecer nada, a pasta está fora do PATH:

powershell

$env:PATH -split ';' | Select-String '\.local\\bin'

Pra corrigir, só pro seu usuário:

powershell

$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

Como saber que deu certo

Fecha o terminal, abre de novo e roda claude --version. O número de versão aparece.

"running scripts is disabled on this system" no Windows. Esse erro aparece em quem instalou pelo npm. O PowerShell bloqueia os scripts que o npm cria. Duas saídas: instalar pelo comando da seção 04, que não depende disso, ou liberar scripts locais só pro seu usuário:

powershell

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Outra saída sem mexer na política: chamar claude.cmd em vez de claude.

Mais de uma instalação. Se você já instalou de outro jeito antes, pode ter duas. Pra ver quais existem:

Mac

terminal do mac

which -a claude

Windows

powershell

where.exe claude

Se aparecer mais de um caminho, fica com a instalação da seção 04 e remove a outra.

Qualquer outro erro. Roda o diagnóstico. Ele só lê, não muda nada, e aponta o que está errado com a sugestão de conserto:

mac ou windows

claude doctor

seção 12 · manutenção

Atualizar e desinstalar

Atualizar. Quem instalou pela seção 04 recebe atualização sozinho, em segundo plano. Pra forçar na hora:

mac ou windows

claude update

Instalou pelo Homebrew? brew upgrade claude-code. Pelo WinGet? winget upgrade Anthropic.ClaudeCode. Esses dois não se atualizam sozinhos.

Desinstalar a instalação da seção 04. Isto remove o programa e mantém as suas configurações e skills em ~/.claude:

Mac

terminal do mac

rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

Windows

powershell

Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force
Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force

Homebrew: brew uninstall --cask claude-code. WinGet: winget uninstall Anthropic.ClaudeCode.

seção 13 · glossário

Glossário

Terminal: A janela onde você digita comando em vez de clicar. No Mac se chama Terminal. No Windows, PowerShell ou CMD.
PowerShell e CMD: Os dois terminais do Windows. Cada um tem o seu comando de instalação. O PowerShell mostra PS no começo da linha.
Pasta do projeto: A pasta em que você abre o Claude Code. É nela que ele lê e escreve.
cd: O comando que entra numa pasta pelo terminal. Vem de "change directory".
PATH: A lista de pastas onde o terminal procura programa. Se a pasta do Claude Code não está nela, aparece "command not found".
Sessão: Uma conversa com o Claude Code, do claude até o /exit.
Comando de barra: Tudo que começa com / dentro do Claude Code, como /help e /clear.
CLAUDE.md: O arquivo de memória. O Claude Code lê no começo de toda sessão.
Skill: Uma pasta com um SKILL.md dentro. Ensina o Claude Code a fazer uma tarefa do seu jeito, e você chama pelo nome.
Subagente: Um Claude separado, que o Claude Code abre pra uma tarefa. Nasce sem a conversa principal, por isso serve pra revisar.
Permissão: O pedido de licença antes de uma ação. Shift + Tab muda o quanto ele pergunta.
Git for Windows: Programa gratuito que traz o Git Bash pro Windows. Recomendado, não obrigatório.
Política de execução: A trava do PowerShell que bloqueia scripts. Só atrapalha quem instalou pelo npm.
~: Atalho pra pasta do seu usuário. No Windows, o equivalente é %USERPROFILE% ou $env:USERPROFILE.

Instalou. E agora?

O primeiro uso que eu recomendo é revisar.

Os três prompts de revisão fazem o Claude procurar problema no texto em vez de aprovar. Um deles usa subagente, que está no glossário logo acima.

Pegar os 3 prompts de revisão Ver as skills do FX Estrategista Magnético

Fonte dos comandos: documentação oficial do Claude Code em code.claude.com/docs. Se algum comando mudar, a de lá vale mais que esta página.