Guia Completo do Claude Code 2026
Uma visão geral de todas as funções básicas, agentes padrão, Skills oficiais e Plugins.
Neste artigo, abordarei de forma abrangente todos os recursos do altamente evoluído Claude Code.
Para ser sincero, em 2026, o termo "chat de IA rodando no terminal" já não é suficiente para descrever o Claude Code.
É o quanto suas capacidades se expandiram.
O Claude Code de hoje pode explorar um repositório por conta própria, organizar requisitos, criar planos de implementação, editar arquivos, executar comandos, iniciar aplicações, observar os resultados e voltar para corrigir se algo falhar.
Ele lida com quase tudo isso de forma independente.
E não é só isso.
Ele pode dividir tarefas entre vários agentes, implementá-las em paralelo usando Git Worktrees independentes, executar processos de longa duração em segundo plano, receber eventos de serviços externos e até publicar resultados como páginas web.
Em resumo, o Claude Code é uma "plataforma de execução de agentes" que reúne os seguintes elementos:
- Raciocínio dos modelos Claude
- Ferramentas de execução para lidar com arquivos, Shell, Web, LSP, etc.
- Gerenciamento de contexto via histórico de conversas, regras do projeto e Memória
- Controles de segurança por meio de Permissões, Modo Automático, Sandboxes e Hooks
- Processamento paralelo via Subagentes, Visualizações de Agentes, Equipes de Agentes e Workflows Dinâmicos
- Extensibilidade através de Skills, Plugins e MCP
- Ambientes de execução que abrangem CLI, IDE, Desktop, Web, Mobile, CI e SDK
Espero que este artigo sirva como um mapa para ajudar você a organizar seu entendimento sobre tudo que o sistema Claude Code possui e como usar cada função de forma eficaz.
Capítulo 1: As 9 Camadas do Claude Code
Observação: Resumi as técnicas de configuração e uso avançado em um PDF.
Se você quiser, pode obtê-lo aqui! 👇
https://x.com/MakeAI_CEO/status/2027682940847898770?s=20
Para dominar o Claude Code, a primeira coisa que você precisa entender é a diferença entre "Modelos", "Ferramentas", "Agentes", "Skills" e "Plugins".
Se esses conceitos se misturarem, você terá problemas.
Você pode acabar escrevendo coisas nos Hooks que deveriam estar no CLAUDE.md, ou simplesmente "pedindo" educadamente em uma Skill por uma operação que deveria ser estritamente bloqueada pelas Permissões.
Para evitar esses desalinhamentos, vamos organizar as ideias dividindo o sistema em nove camadas.
- Modelo Claude (O Cérebro)
O modelo Claude é o "cérebro". Ele lê código, entende problemas e pensa sobre o que fazer em seguida. Esta parte de "pensar" é tratada pelo modelo.
Famílias de modelos representativas incluem:
- Sonnet
- Opus
- Haiku
- Fable
No entanto, um equívoco comum é pensar que o próprio modelo modifica arquivos ou executa comandos diretamente. O modelo apenas decide coisas como "quero ler este arquivo", "quero alterar este código" ou "quero executar um teste". A ação real é realizada pelas chamadas de Ferramentas do runtime.
- Runtime do Claude Code (O Comandante)
O runtime do Claude Code é o comandante que faz a mediação entre o modelo e o ambiente de execução. Suas principais funções incluem:
- Salvar o histórico da conversa
- Carregar o CLAUDE.md e as Skills
- Passar as definições das Ferramentas para o modelo
- Executar as chamadas de Ferramentas
- Determinar as Permissões
- Acionar os Hooks
- Aplicar as restrições do Sandbox
- Iniciar Subagentes
- Comprimir o contexto
- Salvar e retomar sessões
Curiosamente, mesmo com exatamente o mesmo modelo, o comportamento pode mudar drasticamente dependendo das configurações do runtime.
- Ferramentas Integradas (As Mãos e os Pés)
As Ferramentas Integradas são os "membros" incorporados ao Claude Code. Através dessas ferramentas, o Claude pode:
- Ler arquivos
- Criar arquivos
- Editar partes de arquivos
- Pesquisar nomes de arquivos
- Pesquisar strings dentro do código
- Executar comandos Shell
- Pesquisar na Web
- Obter informações de tipo de um Language Server
- Iniciar Subagentes
- Publicar resultados
Sem as Ferramentas, o Claude só poderia oferecer sugestões verbais. As Ferramentas transformam o Claude de uma "IA que apenas aconselha" em uma "IA que realmente trabalha".
- Subagentes Integrados (Assistentes Padrão)
Estes são agentes auxiliares incluídos por padrão. Os três tipos principais são:
- Explore
- Plan
- Uso geral
Eles operam em um contexto separado da conversa principal, como assistentes trabalhando em uma sala diferente.
- Subagentes Personalizados (Funções Especializadas)
Os Subagentes Personalizados são agentes especializados definidos por você ou sua equipe. Você pode criar funções como:
- Agente de Revisão de Segurança
- Agente de Design de API
- Agente de Criação de Testes
- Agente de Migração de Banco de Dados
- Agente de Auditoria de Documentação
- Agente de Análise de Desempenho
- Skills (Manuais Reutilizáveis)
Skills são um mecanismo para fornecer ao Claude procedimentos reutilizáveis ou conhecimento especializado. Se você perceber que está digitando instruções longas repetidamente, elas devem ser transformadas em uma Skill.
- Plugins (Caixas de Distribuição)
Plugins são "caixas" usadas para distribuir vários elementos de extensão juntos, incluindo Skills, Subagentes, Hooks, configurações de MCP e muito mais.
- MCP (Padrão Comum para Conexão Externa)
MCP significa "Model Context Protocol", um padrão para conectar o Claude Code a serviços externos, APIs, bancos de dados e sistemas de negócios.
- Superfícies de Execução (Onde Usar)
O Claude Code não é apenas para o terminal. Ele pode ser usado no VS Code, IDEs JetBrains, Claude Desktop, Web, Mobile, Slack e pipelines de CI/CD.
Capítulo 2: A Operação Básica — O Loop do Agente
A operação básica do Claude Code é melhor imaginada como um "loop" rotativo:
Usuário comunica o objetivo -> Reunir informações necessárias -> Pensar na próxima ação -> Selecionar uma Ferramenta -> Passar por Permissões/Hooks/Sandbox -> Editar arquivos ou executar comandos -> Observar resultados -> Verificar no ambiente de teste/real -> Se insuficiente, retornar à investigação/correção -> Terminar quando as condições de conclusão forem atendidas.
Capítulo 3: Modelos, Esforço, Modo Rápido e Advisor
Esta seção aborda como escolher o modelo e a intensidade certos para o trabalho.
- Sonnet: O burro de carga do dia a dia para implementação e correção de bugs.
- Opus: O parceiro para situações difíceis como design de arquitetura e solução de problemas complexos.
- Haiku: Rápido e barato para pesquisas e resumos simples.
- Fable 5: O corredor de longa distância de alto nível para execução autônoma em grandes repositórios (a partir de julho de 2026).
Esforço: Um controle deslizante para determinar quanto raciocínio alocar (Baixo a Máximo).
Ultracode: Uma configuração única que combina raciocínio profundo com orquestração automática de subagentes.
Modo Rápido: Uma configuração de alta velocidade para o Opus, aproximadamente 2,5x mais rápida para tarefas urgentes.
Advisor: Um recurso experimental onde um segundo modelo fornece uma "segunda opinião" sobre decisões críticas.
Capítulo 4: Contexto, CLAUDE.md, Regras e Memória Automática
O gerenciamento de contexto é um fator importante no desempenho do Claude Code.
- CLAUDE.md: Um arquivo markdown para pré-requisitos do projeto (stack tecnológico, regras de codificação, etc.). É um guia, não um mecanismo de imposição rigorosa.
- .claude/rules/: Permite dividir o CLAUDE.md em regras específicas que são carregadas apenas quando arquivos relevantes são editados.
- Memória Automática: Anota automaticamente descobertas como comandos de build específicos ou estilos de implementação preferidos.
- Compactação Automática: Resume conversas longas para permanecer dentro dos limites de contexto.
Capítulo 5: 42 Tipos de Ferramentas Integradas
A partir de julho de 2026, existem 42 ferramentas integradas que abrangem:
- Arquivo/Código: Ler, Escrever, Editar, Glob, Grep, LSP, etc.
- Shell/Processo: Bash, PowerShell, Monitor.
- Planejamento/Worktree: EnterPlanMode, EnterWorktree.
- Agente/Workflow: Agent, Workflow, SendMessage.
- Tarefas: TaskCreate, TaskList.
- Web/MCP: WebSearch, WebFetch, ToolSearch.
- Usuário/Nuvem: AskUserQuestion, PushNotification, Artifact.
Capítulo 6: Sessão, Checkpoint, Branch, Fork e Worktree
O Claude Code salva o trabalho como uma "Sessão", permitindo que você retome o trabalho, crie ramificações na conversa ou volte a checkpoints anteriores. No entanto, os Checkpoints não substituem o Git; eles não podem desfazer efeitos colaterais externos como chamadas de API ou atualizações de banco de dados.
Capítulo 7: Agentes Padrão
- Explore: Um agente somente leitura especializado em explorar a base de código.
- Plan: Um agente somente leitura usado durante o modo Plan para coletar informações antes da implementação.
- Uso geral: Um agente versátil que lida tanto com exploração quanto com execução.
Continuação no guia 👇
