# Como usar o Claude Code: guia para iniciantes

URL: https://agentvera.dev/pt/blog/how-to-use-claude-code/ · Publicado: 2026-10-22

Como usar o Claude Code passo a passo: instalar, fazer login, rodar a primeira tarefa, escrever um CLAUDE.md, escolher permissões, slash commands e plan mode.

**Resumo:**

- O Claude Code precisa de um plano Claude Pro, Max, Team ou Enterprise, de uma conta do Claude Console ou de Amazon Bedrock, Google Cloud ou Microsoft Foundry; o plano gratuito do Claude.ai não o inclui.
- Depois de instalar, rode claude numa pasta de projeto, faça login uma vez no navegador e rode /init para criar um CLAUDE.md que você mantém abaixo de umas 200 linhas.
- Shift+Tab alterna os modos de permissão; use plan mode em mudanças que tocam mais de um ou dois arquivos, /rewind para desfazer um caminho errado e /clear e /compact para ficar nos limites.

Para usar o Claude Code, instale-o com um comando, rode `claude` dentro de uma pasta de projeto, faça login com sua conta do Claude no navegador e então descreva o que quer em linguagem natural. O Claude lê o código de que precisa, propõe edições e comandos e pergunta antes de fazer qualquer coisa que você não tenha permitido.

Esse é o ciclo inteiro. O resto deste guia cobre o que faz ele funcionar bem: um arquivo `CLAUDE.md`, os modos de permissão, alguns slash commands, o plan mode e alguns hábitos que te mantêm dentro dos limites de uso.

## O que é o Claude Code

O Claude Code é o agente de código da Anthropic. Ele roda no seu terminal (e também no VS Code, no JetBrains, num app desktop e na web), trabalha nos arquivos da pasta onde você o inicia e pode rodar comandos de shell como seus testes, linters e git. Diferente de uma janela de chat, ele não precisa que você cole código. Ele vai lá e lê o que precisa.

## Passo 1: instale o Claude Code

O instalador nativo é o jeito recomendado. Ele se atualiza sozinho em segundo plano.

| Plataforma | Comando |
| --- | --- |
| macOS, Linux, WSL | `curl -fsSL https://claude.ai/install.sh \| bash` |
| Windows PowerShell | `irm https://claude.ai/install.ps1 \| iex` |
| macOS (Homebrew) | `brew install --cask claude-code` |
| Windows (WinGet) | `winget install Anthropic.ClaudeCode` |

Instalações por Homebrew e WinGet não se atualizam sozinhas, então atualize de vez em quando pelo seu gerenciador de pacotes. Confira se funcionou:

```bash
claude --version
```

## Passo 2: faça login

Vá até uma pasta de projeto e inicie:

```bash
cd your-project
claude
```

Na primeira vez, o Claude Code abre o navegador para o login. Você pode usar:

- uma assinatura **Claude Pro, Max, Team ou Enterprise**, que é a escolha mais comum;
- uma conta do **Claude Console**, cobrada por token a partir de créditos pré-pagos;
- um provedor de nuvem: **Amazon Bedrock, Google Cloud ou Microsoft Foundry**.

Seu login fica salvo, então você só faz isso uma vez. Se tiver mais de uma conta, `/login` alterna entre elas.

## Passo 3: sua primeira tarefa

Comece com algo pequeno e real, não “crie um app para mim”. Boas primeiras tarefas:

- “Explique como a autenticação funciona neste projeto.”
- “Rode os testes e me diga por que o que falha está falhando.”
- “Adicione validação de entrada ao formulário de cadastro, com um teste.”

Digite e pressione Enter. O Claude lê arquivos e depois propõe mudanças ou comandos. Dependendo do modo de permissão, ele pergunta antes ou segue em frente, e mostra cada edição como um diff. Leia os diffs. Quem entrega o código continua sendo você.

Você também pode começar já com uma tarefa:

```bash
claude "find where we parse dates and list the formats we accept"
```

Outras formas úteis de começar:

| Comando | O que faz |
| --- | --- |
| `claude` | Inicia uma sessão interativa |
| `claude "task"` | Inicia uma sessão com uma primeira mensagem |
| `claude -p "task"` | Roda uma vez, imprime a resposta e sai (bom para scripts) |
| `claude -c` | Continua a conversa mais recente nesta pasta |
| `claude -r` | Escolhe uma conversa mais antiga para retomar |

## Passo 4: escreva um CLAUDE.md

Toda sessão começa com uma janela de contexto nova. O `CLAUDE.md` é como o Claude se lembra do seu projeto: um arquivo Markdown que ele lê no início de cada sessão.

Rode isto numa sessão:

```
/init
```

O Claude percorre o codebase e escreve um primeiro `CLAUDE.md` com os comandos de build, os comandos de teste e as convenções que encontrou. Se já existir um `CLAUDE.md`, ele sugere melhorias. Depois, edite você mesmo. Boas coisas para colocar:

- como fazer build, rodar e testar (`pnpm test`, não “rode os testes”)
- convenções que não são óbvias pelo código
- coisas a evitar (“nunca edite arquivos gerados em `src/gen/`”)
- onde ficam as partes importantes

Mantenha-o curto; a Anthropic sugere ficar abaixo de umas 200 linhas por arquivo. Arquivos longos gastam contexto e são seguidos com menos confiabilidade. Você pode dividir o conteúdo com imports `@path/to/file`.

Há alguns lugares onde um CLAUDE.md pode ficar:

| Arquivo | Escopo |
| --- | --- |
| `./CLAUDE.md` ou `./.claude/CLAUDE.md` | O projeto, compartilhado com sua equipe via git |
| `~/.claude/CLAUDE.md` | Você, em todos os projetos |
| `./CLAUDE.local.md` | Você, só neste projeto (mantenha fora do git) |

Se o seu repositório já tem um `AGENTS.md` para outros agentes, versões recentes do Claude Code o leem quando não há `CLAUDE.md`, e você pode importá-lo de um `CLAUDE.md` com `@AGENTS.md`.

## Passo 5: entenda as permissões

O Claude Code pergunta antes de fazer qualquer coisa arriscada. A frequência depende do modo de permissão. Pressione **Shift+Tab** para alternar entre eles; o modo atual aparece na parte de baixo da tela.

| Modo | O que roda sem perguntar | Bom para |
| --- | --- | --- |
| Manual (`default`) | Leitura de arquivos | Aprender, código sensível |
| Accept edits | Leituras, edições de arquivos, comandos simples de sistema de arquivos | Trabalho que você vai revisar no diff de qualquer forma |
| Plan mode | Só leituras; nenhuma edição no seu código | Explorar e projetar antes de programar |
| Auto mode | A maioria das ações, verificadas por um classificador de segurança | Tarefas mais longas com menos perguntas |

Versões recentes começam em auto mode por padrão; as mais antigas começam em Manual. No auto mode, um segundo modelo revisa cada ação e bloqueia o que parece arriscado ou fora da tarefa, mas isso não é uma garantia, então fique de olho no que ele faz.

Para um controle mais fino, `/permissions` deixa você adicionar regras de allow, ask e deny, como “sempre permitir `npm test`” ou “sempre perguntar antes de `git push`”. No macOS, Linux e WSL2, `/sandbox` roda os comandos de Bash dentro de um sandbox.

Existe também `--dangerously-skip-permissions`, que nunca pergunta. A própria documentação da Anthropic diz para usar só dentro de um contêiner ou máquina virtual. Não use na sua máquina principal enquanto está aprendendo.

## Passo 6: os slash commands que valem a pena conhecer

Digite `/` numa sessão para ver todos os comandos. Estes são os que você mais vai usar:

| Comando | O que faz |
| --- | --- |
| `/help` | Mostra a ajuda e os comandos |
| `/init` | Cria ou melhora o `CLAUDE.md` |
| `/clear` | Começa uma conversa nova (a antiga fica em `/resume`) |
| `/compact` | Resume a conversa até aqui para liberar contexto |
| `/context` | Mostra o que está ocupando sua janela de contexto |
| `/model` | Troca de modelo; as setas ajustam o esforço |
| `/plan` | Entra no plan mode, opcionalmente com uma tarefa |
| `/permissions` | Gerencia regras de allow, ask e deny |
| `/rewind` | Volta a um ponto anterior da conversa e do código |
| `/resume` | Reabre uma conversa anterior |
| `/mcp` | Gerencia servidores MCP (ferramentas extras) |
| `/usage` | Mostra os limites de uso do seu plano |
| `/review` | Revisa suas mudanças atuais |
| `/memory` | Edita seus arquivos CLAUDE.md |

`/rewind` é o que os iniciantes esquecem. Se o Claude seguir pelo caminho errado, volte para antes de ele começar em vez de discutir até ele voltar.

## Passo 7: use o plan mode para qualquer coisa maior

Para mudanças que tocam mais de um ou dois arquivos, peça um plano primeiro. Pressione Shift+Tab até ver o plan mode, ou digite:

```
/plan add rate limiting to the public API
```

No plan mode, o Claude lê o código, faz perguntas para esclarecer e escreve um plano, mas não edita seu código. Você lê o plano, contesta as partes de que não gosta e aprova quando estiver certo. Aí ele passa a editar e segue o plano.

Isso custa alguns minutos e poupa muito retrabalho. Você também pode iniciar uma sessão em plan mode com `claude --permission-mode plan`.

## Bons hábitos de prompt

O Claude Code segue bem instruções claras. A maioria dos resultados ruins vem de instruções vagas.

- **Diga como verificar o trabalho.** “Adicione o endpoint e faça `pnpm test api` passar” é melhor que “adicione o endpoint”.
- **Aponte arquivos.** Cite o arquivo ou a função pelo nome, ou digite `@` para referenciar um arquivo.
- **Uma tarefa por conversa.** Use `/clear` quando mudar para algo sem relação.
- **Dê exemplos.** “Siga o padrão de `users.service.ts`” vale mais que um parágrafo de descrição.
- **Peça uma explicação primeiro** quando não conhece o código: “Como X funciona? Não mude nada ainda.”
- **Interrompa cedo.** Pressione Esc para pará-lo se ele for para o lado errado e corrija.
- **Coloque correções repetidas no CLAUDE.md.** Se você disse duas vezes, escreva.

## Limites e como ficar dentro deles

Os planos de assinatura têm limites de uso: uma janela móvel de 5 horas e um limite semanal, e os planos maiores dão mais. Conversas longas gastam mais, porque cada mensagem carrega todo o contexto junto.

- Veja como você está com `/usage`.
- Use `/clear` entre tarefas sem relação.
- Use `/compact` em sessões longas, opcionalmente dizendo o que manter: `/compact keep the API decisions`.
- Use `/context` para ver o que está ocupando espaço, como arquivos grandes ou muitas ferramentas de MCP.
- Escolha um modelo mais leve para trabalho simples com `/model`.

Mais sobre isso em [limites de uso do Claude Code](/pt/blog/claude-code-usage-limits/ "Limites de uso do Claude Code") e [como reduzir o uso de tokens do Claude Code](/pt/blog/claude-code-token-usage/ "Uso de tokens do Claude Code").

## Quando um terminal não basta

Quando você pegar o jeito, vai querer um segundo Claude trabalhando enquanto o primeiro roda os testes. Dois agentes na mesma pasta pisam nos arquivos um do outro, então cada um precisa da própria git worktree. É aí que um único terminal fica desconfortável.

O AgentVera é um app desktop para macOS, Windows e Linux que roda o Claude Code (e outros agentes de CLI) em terminais reais, lado a lado. Ele usa o login do Claude Code que você já tem.

- **[Workspace](/pt/features/workspace/ "Workspace"):** uma grade de agentes por projeto, de 1×1 a 5×4. Cada agente tem o próprio nome, modelo, esforço e Role and instructions, e volta para a própria conversa depois de reabrir o app.
- **Worktrees:** no [painel Git](/pt/features/git-and-github/ "Git e GitHub"), crie uma worktree e inicie um agente nela com um clique, assim agentes em paralelo nunca compartilham arquivos.
- **Permissões por agente:** no diálogo New agent, escolha Ask, Auto ou Full access. Auto usa o auto mode do próprio Claude Code.
- **[Checkpoints e replay](/pt/features/checkpoints-and-replay/ "Checkpoints e replay"):** os últimos 60 turnos de cada agente ficam guardados, e você pode reproduzir uma sessão.
- **Contexto num relance:** cada painel mostra o tamanho do contexto ao vivo, e o auto-compact entra em ação antes de a janela encher.

Tudo isso está no plano gratuito. A aprovação automática, que deixa passar leituras e testes seguros mas ainda pergunta antes de coisas como `git push` ou `rm`, está no Pro e no Team.

Quando chegar lá, leia [como rodar vários agentes do Claude Code](/pt/blog/run-multiple-claude-code-agents/ "Rodar vários agentes do Claude Code") e [baixe o AgentVera de graça](/pt/download/ "Baixar o AgentVera").

Deixe a [cola de comandos do Claude Code](/pt/blog/claude-code-commands-cheat-sheet/ "Cola de comandos do Claude Code") aberta enquanto aprende e, se você trabalha no VS Code, veja a [configuração da extensão para VS Code](/pt/blog/claude-code-vs-code/ "Extensão do Claude Code para VS Code").

## Conclusão

Instale, rode `claude`, faça login e comece com uma tarefa pequena e real. Rode `/init` e mantenha seu `CLAUDE.md` curto. Use Shift+Tab para escolher quanto o Claude pode fazer, o plan mode para qualquer coisa maior, `/rewind` quando der errado e `/clear` e `/compact` para ficar dentro dos limites. Isso cobre a maior parte do que você precisa nas primeiras semanas.

## Perguntas frequentes

**Preciso de um plano pago para usar o Claude Code?** Sim. O Claude Code precisa de um plano Claude Pro, Max, Team ou Enterprise, ou de uma conta do Claude Console com créditos de API. Ele também roda pelo Amazon Bedrock, Google Cloud ou Microsoft Foundry. O plano gratuito do Claude.ai não o inclui.

**O Claude Code funciona no Windows?** Sim. Instale pelo PowerShell com o instalador nativo ou com o WinGet. Ele também roda dentro do WSL. Comandos como /init, plan mode e permissões funcionam igual em todas as plataformas.

**Para que serve o CLAUDE.md?** O CLAUDE.md é um arquivo Markdown de instruções do projeto que o Claude Code lê no início de cada sessão: comandos de build e teste, estilo de código, coisas a evitar. Rode /init para gerar uma primeira versão, depois mantenha-o curto e edite conforme avança.

**Como impedir que o Claude Code altere arquivos sem perguntar?** Pressione Shift+Tab até chegar ao modo Manual (ou ao plan mode, que não edita nada até você aprovar um plano). Você também pode adicionar regras de ask e deny com /permissions, por exemplo para sempre perguntar antes de um git push.

**O que fazer quando o Claude Code atinge o limite de uso?** Veja em /usage quando a janela reinicia. Use /clear entre tarefas sem relação e /compact em sessões longas para que cada mensagem carregue menos contexto. Se você tiver mais de uma conta do Claude, pode trocar com /login.

---

**Sobre o AgentVera.** AgentVera é um app desktop para macOS, Windows e Linux, desenvolvido pela Solviera Teknoloji. Ele roda 18 agentes de programação com IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) lado a lado, por projeto, em terminais reais com as instalações e logins de CLI do próprio usuário. O plano gratuito tem agentes ilimitados. Baixar: https://agentvera.dev/pt/download/ · Preços: https://agentvera.dev/pt/pricing/