Skip to main content

Introdução ao Claude Code

O Claude Code é a ferramenta de codificação agêntica oficial da Anthropic. Diferente de um chatbot que responde perguntas e espera, o Claude Code lê o seu codebase, edita arquivos, roda comandos e trabalha de forma autônoma em problemas enquanto você acompanha, redireciona ou simplesmente sai para tomar um café.

Ele roda como uma CLI no terminal, como extensão no VS Code e JetBrains, como app desktop nativo (macOS/Windows), no navegador em claude.ai/code e via SDK para automações. Toda essa superfície compartilha o mesmo motor por baixo, então as configurações, CLAUDE.md e servidores MCP funcionam igual em qualquer lugar.

O que é o Claude Code?​

Tecnicamente, o Claude Code é um agente que opera em loop: o modelo recebe um objetivo, analisa o estado atual, escolhe uma ferramenta (ler arquivo, rodar comando, editar código, buscar no Grep, etc), executa, observa o resultado e decide o próximo passo até completar a tarefa.

Os modelos disponíveis são os da família Claude 4.x (Opus, Sonnet e Haiku). Você pode trocar o modelo no meio da sessão com /model e até definir modelos diferentes por subagente, balanceando custo e capacidade.

A instalação é simples:

# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

# Homebrew
brew install --cask claude-code

# WinGet
winget install Anthropic.ClaudeCode

Depois é só entrar em qualquer projeto e rodar claude.

Por que usar Claude Code?​

Trabalha onde você já trabalha​

Não é uma janela à parte que você precisa visitar. É um processo no seu terminal, com acesso ao seu git, seu shell, seus arquivos, suas variáveis de ambiente, suas CLIs (gh, aws, gcloud, sentry-cli). Tudo que você já tem instalado, ele usa.

Composabilidade Unix​

O Claude Code segue a filosofia Unix. Você pode pipar conteúdo para ele, usar em CI, encadear com outras ferramentas:

# Analisar logs
tail -200 app.log | claude -p "Me avise se houver anomalias"

# Operações em massa
git diff main --name-only | claude -p "revise esses arquivos por questões de segurança"

# Em pipeline de CI
claude -p "traduza as novas strings para francês e abra um PR"

Autonomia real​

Você descreve o que quer em linguagem natural e o Claude planeja a abordagem, escreve o código em múltiplos arquivos, roda os testes e corrige falhas. Não é autocomplete. É um engenheiro júnior incansável que executa o trabalho.

Persistência e contexto​

Sessões são salvas localmente. claude --continue retoma a última conversa, claude --resume mostra um picker. O CLAUDE.md no seu projeto carrega contexto persistente em toda sessão. A auto memory acumula aprendizados entre conversas sem você escrever nada.

Componentes Principais​

O Claude Code é construído em torno de algumas abstrações que vale conhecer desde o começo:

1. Tools (Ferramentas)​

São as primitivas que o agente usa para interagir com o mundo: Read, Write, Edit, Bash, Glob, Grep, WebFetch, Task (subagentes), entre outras. Cada chamada de ferramenta passa pelo sistema de permissões antes de executar.

2. CLAUDE.md​

Arquivo de markdown na raiz do projeto que o Claude lê no começo de toda sessão. É onde você registra padrões de código, comandos de build, decisões de arquitetura e tudo que não é óbvio pelo código. Pode ser versionado no git e compartilhado com o time.

3. Skills e Slash Commands​

Workflows reutilizáveis acionados com /. Vão desde os built-in (/init, /compact, /clear, /cost, /memory) até comandos customizados que você define em .claude/skills/<nome>/SKILL.md ou .claude/commands/<nome>.md.

4. Subagents​

Assistentes especializados rodando em contexto isolado, definidos em .claude/agents/<nome>.md. Úteis para tarefas que leem muitos arquivos (exploração de codebase, revisão de PR) sem poluir a conversa principal.

5. Hooks​

Scripts shell, endpoints HTTP ou prompts LLM que disparam automaticamente em momentos específicos do ciclo de vida (antes/depois de cada tool, ao iniciar sessão, ao receber prompt do usuário). É a forma determinística de garantir que algo aconteça sempre.

6. MCP (Model Context Protocol)​

Padrão aberto para conectar o Claude a ferramentas externas: GitHub, Jira, Slack, banco de dados, design system, ou suas próprias APIs internas. Adicionados com claude mcp add.

7. Permission Modes​

Controlam o nível de aprovação necessário para ações sensíveis: default, acceptEdits, plan, auto, bypassPermissions. Trocados em tempo real com Shift+Tab.

Como Funciona?​

O Claude Code opera em um loop agêntico clássico:

  1. Lê o contexto inicial: system prompt, CLAUDE.md, auto memory, environment info, ferramentas disponíveis.
  2. Recebe a tarefa: seu prompt entra como mensagem do usuário.
  3. Planeja: o modelo decide se precisa explorar mais, planejar antes ou já executar.
  4. Executa ferramentas: chama Read, Bash, Edit, etc., observa resultados.
  5. Itera: repete até completar a tarefa ou pedir input.
  6. Verifica: idealmente, roda testes, lint, ou outra validação.

O que aparece pra você no terminal é a saída textual do agente. Tudo que ele faz com ferramentas (leitura de arquivos, execução de comandos) é mediado pelo sistema de permissões.

Casos de Uso​

Desenvolvimento de Features​

Descreve a feature, ele planeja, escreve, testa e abre PR.

Debugging​

Cola o erro ou descreve o sintoma. Ele rastreia a causa raiz, propõe a correção e valida.

Refatoração​

Migrações entre bibliotecas, conversões de paradigma (classes para hooks, callbacks para async/await), atualização de dependências.

Onboarding em Codebase​

Faz perguntas como pra um engenheiro sênior: "como funciona o logging aqui?", "como adiciono um novo endpoint?", "por que essa função chama X em vez de Y?".

Automação em CI​

Code review automatizado, triagem de issues, geração de release notes, análise de logs em pipelines.

Tarefas em Lote​

Loop com claude -p para migrar centenas de arquivos, atualizar imports em massa, normalizar padrões em todo o repo.

Próximos Passos​

Nesta trilha, você vai aprender:

  1. Como funciona: o loop agêntico, contexto, permission modes e checkpoint
  2. Slash Commands e Skills: built-in e customizados
  3. Subagents: paralelismo e isolamento de contexto
  4. Hooks: automações determinísticas no ciclo de vida
  5. MCP e Integrações: conectar ferramentas externas
  6. CLAUDE.md e Memória: context engineering pra o time
  7. Dicas de Desenvolvimento e Economia de Tokens: como tirar o máximo gastando o mínimo
  8. Segurança: permissões, sandbox e práticas seguras
  9. Recursos: documentação oficial e referências

Conclusão​

O Claude Code não é só mais uma ferramenta de IA pra desenvolvedor. É um agente que vive no seu terminal, conhece seu projeto, executa tarefas reais e se integra ao seu fluxo. Dominar suas abstrações (tools, hooks, subagents, MCP, CLAUDE.md) é o que separa quem usa o Claude pra autocomplete de quem usa pra entregar features inteiras enquanto faz outra coisa.

Nos próximos capítulos vamos abrir cada um desses componentes em detalhes.

Próximo: Como Funciona

Referências: