7 recursos do Claude Code que mudam seu fluxo

Claude Code é a CLI agêntica da Anthropic você configura quase tudo por arquivos dentro de .Claude. Este guia cobre comandos, ferramentas, MCPs, skills, memória, contexto, subagentes e hooks, mostrando o que é global, o que é por projeto e o que consome contexto sem necessidade.

O que é Claude Code e como ele se organiza

Claude Code é a ferramenta de codificação agêntica da Anthropic que roda no terminal como interface de linha de comando. Ela pode ser usada no modo interativo, com um prompt inicial, ou em execução única com a flag -p, que devolve a resposta sem abrir a sessão interativa.

A configuração vive em duas camadas. A pasta .Claude dentro do projeto guarda regras e extensões daquele repositório. A pasta .Claude na home do usuário guarda o que vale para todos os projetos, incluindo skills, subagentes e memória automática.

Na sessão interativa, o comando /help lista os comandos disponíveis, incluindo /btw para fazer uma pergunta paralela sem interromper a tarefa em andamento. A escolha de modelo e de esforço aparece no rodapé e altera diretamente custo, velocidade e qualidade.

A documentação oficial mantém a referência completa de comandos, ferramentas e configuração em docs.Claude Code/en/docs/Claude Code.

Comandos da CLI: interativo, -p, -c e /help

Os comandos da CLI do Claude Code cobrem três modos de uso: sessão interativa, consulta única com -p e retomada da última conversa com -c. Cada modo tem um custo e um caso de uso diferente no dia a dia.

O modo interativo é o mais completo. Você digita claude no terminal e a sessão abre com todas as capacidades, como skills, subagentes e hooks. Para começar já com um prompt, basta passar o texto na mesma linha de comando.

Se você não precisa da interface interativa, use claude -p "explique este repositório". O Claude Code processa a consulta e devolve a resposta direto no terminal, sem abrir a sessão. Para continuar a conversa mais recente, o claude -c recupera o histórico anterior.

• /help mostra os comandos disponíveis na sessão.
• //btw faz uma pergunta paralela sem interromper o fluxo principal.
• claude -p "consulta" executa sem entrar na interface interativa.
• claude -c retoma a conversa mais recente.

Ferramentas, MCPs e skills: quem faz o quê

Ferramentas, MCPs e skills são camadas diferentes do mesmo fluxo. As ferramentas internas são as ações que o Claude Code já sabe executar, como Bash e leitura de arquivos. Os MCPs conectam servidores externos. As skills são instruções em Markdown que dizem quando usar cada coisa.

A referência de ferramentas lista as capacidades internas e é útil porque os mesmos nomes aparecem quando você cria um subagente e precisa restringir o que ele pode usar. Vale conferir essa lista antes de montar o primeiro subagente, porque um nome errado ali quebra a restrição sem aviso.

Para conectar um servidor externo, o comando é claude mcp add com o transporte, como HTTP, e o endereço do servidor. O claude mcp list mostra os servidores registrados. Alguns exigem autenticação e o próprio Claude Code avisa quantos precisam de login.

Dentro da sessão, o /mcp permite autenticar um servidor. A skill é outra peça: uma pasta com um arquivo skill.md que contém descrição, condição de uso e instruções. O Claude Code pode invocá-la sozinho ou você chama com /nome-da-skill.

O que cada camada faz

Camada	O que é	Como você aciona
Ferramenta interna	Ação que o Claude Code já executa, como Bash	Automático na sessão
MCP	Conexão com um servidor externo	claude mcp add e login via /mcp
Skill	Pasta com skill.md e instruções	Invocação automática ou /nome-da-skill

Ordem prática para montar o fluxo

1. Confira na referência de ferramentas quais capacidades internas existem antes de criar qualquer subagente.
2. Registre o servidor externo com claude mcp add, informe o transporte e o endereço, e rode claude mcp list para confirmar que ele aparece.
3. Autentique o que exigir login com /mcp dentro da sessão.
4. Crie a pasta da skill com o skill.md descrevendo quando ela deve entrar em ação.

O erro comum é tratar as três camadas como a mesma coisa. Uma ferramenta interna não precisa de instalação, um MCP não funciona sem autenticação e uma skill não executa nada sozinha: ela só orienta a decisão.

Memória: o que fica no Claude.md e o que a auto memory grava

A memória do Claude Code vem de duas fontes distintas. O arquivo Claude.md guarda regras que você escreve à mão, como convenções do projeto. A memória automática é criada pelo próprio Claude conforme ele coleta feedback ao longo das sessões.

Um exemplo prático: se o Claude sempre usa npm num projeto que adota Bun, você corrige e pede para ele lembrar. No Claude.md essa regra fica explícita e versionada. Na memória automática, o próprio Claude registra o feedback e o reaproveita depois.

A memória automática é ativada por configuração no settings e fica no diretório global, organizada por projeto. O comando /memory mostra se ela está ligada e permite abrir a pasta com os feedbacks gravados.

A diferença importa quando o time compartilha o repositório. Regra no Claude.md viaja com o código. Preferência capturada pela memória automática fica na sua máquina e não ajuda quem clona o projeto.

Gestão de contexto: /context, /clear e /compact

A gestão de contexto do Claude Code depende de três comandos: /context mostra o consumo, /clear zera a sessão e /compact resume o histórico. Usar os três na ordem certa evita respostas degradadas por janela cheia.

O /context exibe quanto da janela está ocupado e separa o consumo por origem, como mensagens, prompts de sistema, ferramentas, MCPs e skills. Um servidor de MCP carregado sem uso e skills esquecidas aparecem nesse relatório.

O /clear inicia uma sessão nova com contexto vazio, o que reduz o consumo de tokens de imediato. O /compact resume as partes anteriores da conversa em um texto menor, mantendo a linha de raciocínio sem carregar tudo de novo.

O /rewind funciona como voltar a um commit: você retoma a conversa de um ponto anterior e segue dali. A documentação de custos e limites fica em docs.Claude Code/en/docs/Claude Code/costs.

Subagentes: como o Claude Code paraleliza trabalho

Subagentes são instâncias do Claude Code com contexto próprio, criadas para executar uma tarefa em paralelo à sessão principal. Eles aparecem na interface junto do agente principal e permitem dividir trabalho sem misturar históricos.

O Claude Code já traz subagentes integrados, como Explorer, Plan e General Purpose. Você também pode criar os seus, por projeto ou globalmente, dentro da pasta .claude/agents com um arquivo nome.md.

Cada arquivo de subagente declara descrição, ferramentas permitidas, modelo e prompt. Restringir ferramentas é o ponto mais delicado: um agente de revisão de código não precisa de acesso de escrita em todo o repositório.

Uma recomendação prática é pedir ao próprio Claude que gere o subagente e depois revisar modelo, ferramentas e prompt. Escrever o arquivo à mão exige memorizar a lista de ferramentas, o que aumenta o risco de erro.

Hooks, plugins e o que consome contexto

Hooks são comandos automáticos disparados em eventos específicos, como antes de usar uma ferramenta, depois dela ou quando uma permissão é negada. Eles ficam declarados no settings e executam sem intervenção sua.

O caso mais citado é o hook de notificação, que avisa no sistema operacional quando o Claude Code precisa de atenção. O /hooks mostra o que já está configurado e permite inspecionar os eventos disponíveis.

Plugins empacotam skills, subagentes, hooks e MCPs em uma unidade instalável. O comando é /plugin install, e marketplaces oficiais reúnem opções como integração com Playwright para testes no navegador e servidor de linguagem para TypeScript.

O alerta vale para os dois recursos: cada plugin, MCP ou skill carregado entra na janela de contexto. Instale o que você usa, revise o /context com frequência e remova o resto.

Perguntas frequentes sobre Claude Code

• Claude Code é gratuito? O uso consome a API da Anthropic uma assinatura compatível, então há custo por token ou por plano. O custo varia com o modelo escolhido e com o nível de esforço configurado na sessão.

• Qual a diferença entre Claude.md e memória automática? O Claude.md é escrito por você e versionado no repositório. A memória automática é criada pelo Claude partir de feedback e fica no diretório global da sua máquina, fora do controle de versão.

• Preciso de MCP para usar ferramentas externas? Sim, quando a ferramenta é um serviço fora do ambiente local. Ferramentas internas, como Bash e leitura de arquivos, já vêm no Claude Code sem servidor adicional.

• O que acontece se eu encher a janela de contexto? A qualidade das respostas cai e o consumo de tokens sobe. Use /context para diagnosticar, /clear para começar de novo e /compact para resumir o histórico.

• Posso criar subagentes personalizados? Sim, em .claude/agents, com um arquivo Markdown por agente contendo descrição, ferramentas, modelo e prompt. Também é possível pedir ao próprio Claude que gere o arquivo.

• Plugins e skills são a mesma coisa? Não. Uma skill é um arquivo de instruções. Um plugin é um pacote que pode conter skills, subagentes, hooks e MCPs em um único item instalável.

• Os hooks são obrigatórios para usar o Claude Code? Não. Hooks automatizam eventos, como notificação e validação antes de uma ferramenta. Muitos fluxos funcionam bem sem nenhum hook configurado.

• Como acompanhar a documentação atualizada? A referência oficial fica em docs.Claude Code e é atualizada pela Anthropic. Existem plugins comunitários que conectam o Claude Code a fontes de documentação, mas a fonte canônica continua sendo a oficial.

• Onde ficam as configurações globais? Na pasta .Claude dentro da home do usuário, separada da pasta .Claude Code cada projeto. Regras globais valem para todos os repositórios, o que exige cuidado ao definir modelos e ferramentas.

Como estudar isso sem virar refém do hype

Quem ensina tecnologia no YouTube tem o mesmo problema de qualquer pessoa com conhecimento acumulado: o conteúdo some no feed e não deixa rastro pesquisável. Em ferramentas que mudam rápido, como o Claude Code, a diferença entre uma configuração consciente e uma janela de contexto inchada mora nesses detalhes que passam em segundos no vídeo. Desde 2024 o ritmo de lançamentos só aumentou, e em 2025 a documentação oficial do Claude Code ganhou páginas novas quase toda semana.

Gustavo Dev Doido trabalha esse tipo de conteúdo para desenvolvedores e mostra como estruturar um fluxo de estudo que sobrevive ao próximo lançamento. Quem prefere uma trilha guiada pode olhar o Crazystack Typescript e o Bootcamp do Dev Doido, que organizam fundamentos e prática em sequência.

O caminho que este guia sugere tem três passos:

1. Leia a documentação oficial do recurso antes de assistir qualquer vídeo sobre ele.
2. Teste cada comando em um projeto pequeno, de preferência fora do repositório de produção.
3. Registre no Claude.md o que funcionou, o que quebrou e qual versão você usou.

Recurso	Onde a fonte oficial fica	O que registrar no Claude.md
Comandos de barra	Documentação oficial	Nome do comando e efeito esperado
Janela de contexto	Documentação oficial	Tamanho usado e o que foi cortado
Memória do projeto	Documentação oficial	Decisão tomada e data da mudança
Fluxo de estudo	Gustavo Dev Doido	Trilha seguida e próximo passo

Configuração sem registro vira retrabalho na próxima atualização da ferramenta. O Claude.md funciona como diário de bordo: quando a versão muda, você compara o que anotou com o que a documentação diz agora.

Skala Blog

Source video