O Claude Code é a ferramenta da Anthropic que coloca o Claude para trabalhar dentro de uma pasta do seu computador. Em vez de copiar e colar texto num chat, você aponta uma pasta, descreve o que quer, e ele lê os arquivos, propõe mudanças e executa. Nasceu para programadores, mas hoje existe um caminho que dispensa o terminal: o app de desktop. Este tutorial mostra a instalação e a configuração inicial no Mac e no Windows, para quem trabalha com negócios digitais e nunca abriu uma tela preta.
Resumo: há dois jeitos de instalar o Claude Code. O recomendado para quem não é desenvolvedor é o app Claude para desktop, que traz o Claude Code na aba Code, com interface gráfica. O outro é o terminal, com um comando de instalação. Os dois exigem plano pago (Pro, Max, Team ou Enterprise); o plano gratuito não inclui o Claude Code. No Mac e no Windows o fluxo do app é o mesmo. Depois de instalar, três ajustes fazem diferença: escolher uma pasta de trabalho segura, começar no modo de permissão que pede aprovação e criar o arquivo de instruções do projeto.
Neste artigo
- Antes de começar: o que você precisa
- App ou terminal: qual escolher
- Caminho 1: instalar pelo app de desktop
- Sua primeira sessão na aba Code
- O que muda no Windows
- Caminho 2: instalar pelo terminal (opcional)
- Três ajustes para começar bem
- Erros comuns e como resolver
- Perguntas frequentes
Antes de começar: o que você precisa
- Um plano pago do Claude. O Claude Code funciona nos planos Pro, Max, Team e Enterprise. O plano gratuito do claude.ai não dá acesso.
- Um computador compatível. macOS 13 ou mais recente, ou Windows 10 (versão 1809 em diante). O mínimo é 4 GB de memória.
- Conexão com a internet. O Claude Code roda no seu computador, mas o modelo responde pela nuvem.
- Uma pasta para trabalhar. Pode ser uma pasta com planilhas, textos, o site da empresa ou um projeto novo e vazio.
Um aviso antes do primeiro clique. O Claude Code mexe em arquivos de verdade. Por isso, no começo, trabalhe numa cópia da pasta, e não na original. Volto a esse ponto na parte de configuração.
App ou terminal: qual escolher
A própria documentação da Anthropic indica o app para quem prefere interface gráfica. A tabela resume a diferença:
| Ponto | App de desktop (aba Code) | Terminal |
|---|---|---|
| Para quem | Quem não é desenvolvedor | Quem já usa linha de comando |
| Instalação | Baixar e abrir o instalador | Colar um comando |
| Como você vê as mudanças | Tela de comparação, com botões de aceitar e recusar | Texto no próprio terminal |
| Precisa instalar algo antes | Não | Não, mas exige familiaridade com o terminal |
Se você está em dúvida, vá de app. Tudo o que este blog ensinou na série Operação IA funciona nos dois. O capítulo de entrada é Saia do chat: seu primeiro agente de IA de verdade.
Caminho 1: instalar pelo app de desktop
Passo 1: baixe o app
Acesse claude.com/download e escolha a versão do seu sistema. No Mac, o instalador é único e serve para processadores Intel e Apple Silicon.
Passo 2: instale e abra
Abra o arquivo baixado e siga o instalador. Depois, abra o Claude pela pasta Aplicativos, no Mac, ou pelo menu Iniciar, no Windows.
Passo 3: entre na sua conta
Faça login com a mesma conta do plano pago.
Passo 4: abra a aba Code
O app tem três abas. Chat é a conversa comum, sem acesso a arquivos. Cowork é um agente que trabalha em segundo plano. Code é o Claude Code. Clique em Code, no topo da janela.
Se o app pedir upgrade ao clicar em Code, a conta está no plano gratuito. Se pedir para entrar pela web, conclua o login e reinicie o app.
Sua primeira sessão na aba Code
Com a aba aberta, são quatro passos até o primeiro resultado. A documentação usa os nomes em inglês. Na interface em português, o seletor de modo mostra Automático, Aceitar edições e Plano.
- Escolha o ambiente e a pasta. Selecione Local para o Claude trabalhar nos arquivos do seu computador. Clique em Select folder e aponte a pasta de trabalho.
- Escolha o modelo. O seletor fica ao lado do botão de enviar. Dá para trocar depois.
- Diga o que você quer. Escreva como escreveria para um colega. Um bom primeiro pedido é: “Leia esta pasta e me explique o que tem aqui”.
- Revise antes de aceitar. O que acontece agora depende do modo de permissão, que fica no seletor ao lado do botão de enviar.
Os modos de permissão definem quanto o Claude faz sem perguntar:
| Modo | O que acontece | Quando usar |
|---|---|---|
| Manual | O Claude propõe cada mudança e espera sua aprovação. Nada é alterado antes do seu sim. | Nas primeiras semanas |
| Plano (Plan) | Ele só apresenta o plano, sem editar nenhum arquivo. | Antes de uma tarefa grande |
| Aceitar edições (Accept edits) | As edições de arquivo são aceitas automaticamente. | Quando você já confia no fluxo |
| Automático (Auto) | Um classificador revisa as ações em segundo plano e bloqueia as arriscadas, em vez de perguntar. | Em tarefas longas, com pasta de trabalho segura |
No modo Manual, cada mudança aparece numa tela de comparação, com o antes e o depois, e botões de aceitar e recusar. É a melhor escola para entender o que a ferramenta faz.
O que muda no Windows
Pouco. O fluxo do app é o mesmo do Mac. As diferenças são estas:
- Instalador: há um para processadores x64 e outro para ARM64. Na dúvida, o x64 é o mais comum.
- Onde abrir: pelo menu Iniciar, em vez da pasta Aplicativos.
- Opção extra de ambiente: o app oferece rodar a sessão dentro do WSL, o Linux embutido no Windows. Quem não sabe o que é isso não precisa.
- No terminal: os comandos de instalação são outros, e eles mudam conforme você usa o PowerShell ou o Prompt de Comando. Estão na próxima seção.
Caminho 2: instalar pelo terminal (opcional)
Se você quer o comando claude disponível no terminal, a instalação é uma linha. No Mac, abra o app Terminal e cole:
curl -fsSL https://claude.ai/install.sh | bashNo Windows, abra o PowerShell e cole:
irm https://claude.ai/install.ps1 | iexSe você estiver no Prompt de Comando (CMD), o comando é este:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmdComo saber em qual dos dois você está? No PowerShell, a linha começa com PS C:. No Prompt de Comando, começa só com C:. Não é preciso abrir como administrador.
Quando terminar, abra uma nova janela do terminal e confira:
claude --versionO terminal deve responder com um número de versão seguido de “(Claude Code)”. Depois, entre na pasta de trabalho e inicie:
claudeNa primeira vez, ele pede login e abre o navegador. Para um diagnóstico da instalação, existe o comando claude doctor. As instalações feitas por esse caminho se atualizam sozinhas.
Para referência, esta é a saída real da instalação num Mac, em 1º de outubro de 2026:
Setting up Claude Code...
Checking installation status...
Installing Claude Code native build latest...
Setting up launcher and shell integration...
✔ Claude Code successfully installed!
Version: 2.1.286
Location: ~/.local/bin/claude
Next: Run claude --help to get started
✅ Installation complete!E a conferência da versão:
$ claude --version
2.1.286 (Claude Code)Três ajustes para começar bem
1. Trabalhe numa pasta segura
Crie uma pasta só para os testes e copie para lá os arquivos que quer usar. Assim, se algo sair errado, o original está intacto. Evite apontar o Claude Code para a pasta inteira de Documentos ou para a área de trabalho.
2. Comece pedindo aprovação
Use o modo Manual até entender o padrão das mudanças. Antes de qualquer tarefa grande, peça o plano primeiro, no modo Plano. Pular essa etapa é o erro mais comum de quem está começando.
3. Crie o arquivo de instruções do projeto
O Claude Code lê um arquivo chamado CLAUDE.md, que fica na pasta e diz como trabalhar ali: quem é você, o que é o projeto, o que pode e o que não pode. Você não precisa escrever do zero. Peça: “Crie um CLAUDE.md com instruções para esta pasta”. Depois, leia e corrija.
Esse arquivo é o que transforma a ferramenta em alguém do time. Expliquei o porquê em Contexto é o novo prompt. O passo seguinte, quando a rotina estiver rodando, está em Skills e comandos.
Alguns primeiros pedidos que funcionam bem para quem não programa:
- “Leia os arquivos desta pasta e me diga o que cada um contém.”
- “Junte estas planilhas num arquivo só e aponte as linhas duplicadas.”
- “Resuma cada documento desta pasta em cinco linhas e salve num arquivo de resumo.”
- “Renomeie estes arquivos seguindo um padrão de data e assunto. Mostre a lista antes de aplicar.”
Erros comuns e como resolver
| O que aparece | O que significa | O que fazer |
|---|---|---|
| O app pede upgrade ao clicar em Code | A conta está no plano gratuito | Assinar um plano pago |
| O app pede login pela web | A sessão não foi confirmada | Concluir o login e reiniciar o app |
| “claude” não é reconhecido como comando | O terminal ainda não enxerga a instalação | Abrir uma nova janela do terminal e tentar de novo |
| “The token ‘&&’ is not a valid statement separator” | Você colou o comando do CMD no PowerShell | Usar o comando do PowerShell |
| “‘irm’ is not recognized” | Você colou o comando do PowerShell no CMD | Usar o comando do CMD |
Perguntas frequentes
O Claude Code é gratuito?
Não. Ele exige um plano Pro, Max, Team ou Enterprise, ou uma conta de API. O plano gratuito do claude.ai não inclui o Claude Code.
Preciso saber programar para usar o Claude Code?
Não para começar. Pelo app de desktop, você escolhe uma pasta e escreve o que quer em português. Saber ler o que ele propõe, e recusar quando não fizer sentido, importa mais do que saber programar.
Qual a diferença entre o app e o terminal?
É a mesma ferramenta com duas interfaces. O app mostra as mudanças numa tela de comparação e dispensa a linha de comando. O terminal é mais direto para quem já trabalha nele.
O Claude Code funciona no Windows?
Sim, no Windows 10 (versão 1809 em diante) e no Windows 11, tanto pelo app quanto pelo terminal. O fluxo do app é o mesmo do Mac.
É seguro deixar o Claude Code mexer nos meus arquivos?
Ele trabalha a partir da pasta que você escolher, e no modo Manual pede aprovação antes de editar arquivos ou rodar comandos. O cuidado prático é trabalhar numa cópia e manter backup do que importa.
Referências
- Documentação do Claude Code: primeiros passos no app de desktop
- Documentação do Claude Code: quickstart do terminal
- Documentação do Claude Code: requisitos e instalação
Tutorial escrito com base na documentação oficial em 1º de outubro de 2026. O Claude Code muda rápido; confira os nomes de botões e os comandos na documentação antes de seguir.