Claude Code Handbook

Corpus consultável sobre o Claude Code, destilado dos cursos oficiais da Anthropic Academy Claude Code 101 e Claude Code in Action. Recorra a ele quando precisar entender um conceito (como o agentic loop ou o context window funcionam), decidir um workflow (explore → plan → code → commit) ou configurar algo concreto (CLAUDE.md, MCP server, hook, custom command, SDK).

Conceitos centrais

• Ferramenta agêntica, não um chat. O Claude Code lê seu code base, edita arquivos, roda comandos e se integra às suas ferramentas; diferente do Claude AI, tem acesso direto aos arquivos e faz o trabalho ele mesmo, em vez de você copiar e colar código.

  Fonte: claude-code-101--documento-de-estudo.md › What is Claude Code?

• O agentic loop. Prompt → reunir context → o modelo devolve texto ou um tool call → agir (editar/rodar) → verificar; se atingiu o objetivo, finaliza; senão, repete. Você pode adicionar context, interromper e steer durante todo o loop.

  Fonte: claude-code-101--documento-de-estudo.md › How Claude Code Works

• Tool use é o núcleo. Um language model puro só recebe e devolve texto; tools dão a ele a capacidade de ler/escrever arquivos e rodar comandos. Os modelos Claude (Opus, Sonnet, Haiku) são especialmente fortes em tool use, e isso torna o Claude Code extensível.

  Fonte: claude-code-in-action--documento-de-estudo.md › What is a Coding Assistant?

• Context window é memória finita. Tudo que o Claude lê/roda/recebe ocupa espaço; perto do limite há compaction automática. Gerencie com /compact (resumir e seguir), /clear (recomeçar) e /context (inspecionar), e seja específico para gastar menos contexto.

  Fonte: claude-code-101--documento-de-estudo.md › Context Management in Claude Code

• Permission modes e plan mode. Por padrão o Claude pede permissão antes de editar ou rodar comandos; alterne com shift + tab entre auto-accept e o plan mode (read-only, pesquisa e propõe um plano antes de escrever código).

  Fonte: claude-code-101--documento-de-estudo.md › How Claude Code Works

• CLAUDE.md é a memória persistente do projeto. Arquivo markdown na raiz, lido a cada sessão e anexado ao seu prompt; gere com slash init e mantenha compacto, com stack, comandos e preferências.

  Fonte: claude-code-101--documento-de-estudo.md › The CLAUDE.md file

Topic Index

Referências (quando ler cada uma)

• references/fundamentos.md — o que é o Claude Code, o agentic loop por dentro, o que é um coding assistant e tool use, instalação em cada plataforma, e o agent loop visto pela Claude API. Leia para entender os fundamentos antes de qualquer configuração.
• references/workflows.md — o ciclo explore → plan → code → commit, como adicionar context (slash init, @, memory mode) e como fazer mudanças com plan mode e extended thinking. Leia ao planejar como conduzir uma tarefa real.
• references/gerenciamento-de-contexto.md — context window, comandos de contexto, controle da conversa, o arquivo CLAUDE.md e os quatro padrões de context para agentes. Leia quando o contexto estourar ou para configurar memória.
• references/ferramentas-e-mcp.md — tools embutidas hospedadas pela Anthropic e tudo de MCP (na plataforma e dentro do Claude Code). Leia ao conectar serviços externos ou escolher entre tools, skills e MCP.
• references/customizacao.md — custom commands, integração com GitHub, hooks (conceito, definição, implementação e exemplos), Claude Code SDK e managed agents. Leia ao automatizar ou estender o Claude Code.

Escopo e limites

• Cobre apenas o que está nos dois cursos transcritos (Claude Code 101 e Claude Code in Action), com nível introdutório a intermediário. Não é referência de API exaustiva nem documentação oficial completa.
• Detalhes de sintaxe exata de flags, schemas de configuração e nomes de tools podem mudar — o próprio curso lembra que o Claude Code está em desenvolvimento ativo; confirme na documentação oficial antes de depender de um detalhe.
• As aulas de texto/leitura da plataforma (Claude Code setup, Project setup, Gotchas around hooks, Another useful hook) não têm transcript nas fontes e, portanto, não estão sintetizadas aqui.
• Não cobre preços, limites de conta nem outras ferramentas da Anthropic além do Claude Code, do Claude Code SDK e dos managed agents mencionados nos cursos.