# 7 recursos do Claude Code que mudam seu fluxo

> Published 2026-10-12T22:58:46.299Z on https://www.crazystack.com.br/pt/p/7-recursos-do-claude-code-que-mudam-seu-fluxo/
> Source video: https://www.youtube.com/watch?v=4CRayNnFKqo

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](https://www.anthropic.com/) 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](https://docs.claude.com/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](https://docs.claude.com/en/docs/claude-code/settings) 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](https://docs.claude.com/en/docs/claude-code/settings) 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](https://bun.sh/), 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](https://docs.claude.com/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](https://playwright.dev/) 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](https://crazystack.com.br) 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](https://crazystack.com.br) | 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](https://skalablog.com)

[Source video](https://www.youtube.com/watch?v=4CRayNnFKqo)