Claude Code em 2026: Configuração, Comandos Slash, MCP e Subagentes

Última atualização: June 28, 2026

Eu usei Claude Code todos os dias úteis no último mês em um monorepo Next.js real. Este post é sobre a configuração, os comandos slash, CLAUDE.md, MCP, subagents, permissões e hooks que eu realmente executo, além de onde ele falha.

Resposta rápida: o que é Claude Code e vale a pena?

Claude Code é o CLI de codificação agentico da Anthropic. Ele lê seu repo, edita arquivos, executa comandos shell e encadeia ferramentas até que uma tarefa seja concluída. Eu o uso para lançar features, corrigir bugs e revisar diffs sem sair do terminal.

A configuração que funciona para mim: instalar o CLI, adicionar um CLAUDE.md, conectar dois ou três servidores MCP e manter as permissões restritas. Essa combinação transforma a ferramenta de um brinquedo de chat em um colega de equipe que conhece sua codebase.

Não é mágica. Em um repo de 200k arquivos ele alucina APIs e quebra testes. O retorno vem quando você delimita tarefas pequenas, revisa cada plano e commita frequentemente. Mais sobre os limites reais no final.

Como configurar o Claude Code?

Instalei o instalador nativo no macOS e Node no Linux. Ambos são caminhos oficiais documentados no repositório em github.com/anthropics/claude-code.

## Instalador nativo para macOS / Linux
curl -fsSL https://claude.ai/install.sh | bash

## ou via npm
npm install -g @anthropic-ai/claude-code

## verificar
claude --version

Em seguida, executei claude dentro do meu repo e fiz login com minha conta Anthropic. No primeiro lançamento ele escaneou a árvore e me pediu para confirmar o acesso ao diretório. Eu disse sim apenas para a raiz do projeto, não para toda a minha pasta home.

Algumas decisões de configuração que tomei no início e pelas quais não me arrependi:

• Fixei a versão em CI para que os colegas de equipe usem a mesma.
• Adicionei .claude/ ao .gitignore, exceto settings.json, que eu commitei.
• Escrevi o CLAUDE.md antes de qualquer prompt real, porque a qualidade do contexto decide a qualidade da saída.
• Mantive ativado o modo padrão "perguntar antes de ação destrutiva" na primeira semana.

A referência oficial para instalação e configuração está em docs.claude.com/en/docs/claude-code, que eu mantenho aberto enquanto configuro.

Quais comandos slash eu uso diariamente?

Os comandos slash são a maneira mais rápida de direcionar uma sessão. Eu aprendi isso executando /help e reduzindo a lista para apenas aqueles que realmente utilizo.

Eu executo /clear mais do que qualquer outro comando. Quando uma sessão fica confusa, uma tela limpa mais um prompt mais restrito resolve 80% dos problemas. /compact é a versão mais suave que uso quando quero manter o ritmo, mas o contexto está ficando pesado.

Como escrever um CLAUDE.md que vale a pena?

CLAUDE.md é um arquivo markdown que o Claude lê no início de cada sessão. Trate-o como documentos de integração para um novo funcionário que é rápido, mas tem zero memória das suas decisões.

Eu executo /init para gerar um primeiro rascunho e, em seguida, eu reescrevo manualmente. A versão gerada é um ponto de partida, não o arquivo final. Meu CLAUDE.md cobre stack, convenções, layout, comandos e os três bugs que nunca quero que sejam reintroduzidos.

## Project

Next.js 14 App Router, TypeScript strict, Prisma + Postgres, pnpm workspaces.

## Layout
- App routes in app/
- Server actions in app/actions
- UI primitives in packages/ui

## Conventions
- Prefer async/await over .then chains
- Never use `any`; type unknown and narrow
- Keep components under 200 lines

## Commands
- Dev: pnpm dev
- Test: pnpm test
- Lint: pnpm lint

## Known traps
- Do not edit prisma/schema.prisma without running migrate
- rate-limit.ts is shared; changes affect all routes

Dois erros de CLAUDE.md que cometi e corrigi. Primeiro, escrevi parágrafos em vez de listas, o que diluiu o sinal. Segundo, coloquei histórico do projeto lá, o que consumiu tokens sem ganho. Mantenha-o curto, imperativo e atual.

Para padrões mais profundos, meu Claude Code skills writeup detalha fragmentos de prompt reutilizáveis que combinam bem com CLAUDE.md.

Como funcionam MCP e subagents na prática?

MCP (Model Context Protocol) é como o Claude Code alcança fora do seu repo: bancos de dados, navegadores, GitHub, Linear. Eu executo três servidores MCP e isso é mais do que suficiente. Mais servidores significam mais tokens e mais prompts de aprovação.

Minha configuração atual de MCP faz trabalho real toda semana:

• O servidor GitHub abre PRs e lê comentários de revisão.
• O servidor Postgres responde "quantas linhas correspondem" sem eu escrever SQL.
• O servidor Playwright verifica mudanças na UI em relação a uma URL de staging.

Eu os configurei em .claude/settings.json e verifiquei cada um com um prompt de linha única antes de confiar nele em uma tarefa real. Configuração e escolhas de servidores são detalhadas no Claude Code MCP integration guide e no guia mais amplo MCP model context primer.

Subagents são o outro multiplicador. Para um feature com partes independentes, peço ao Claude para despachar subagents paralelos, cada um limitado a um arquivo ou módulo, e deixar um agente líder mesclar os resultados. Isso reduz o tempo de relógio em grandes mudanças.

Subagents brilham quando o trabalho é genuinamente paralelo. Eles falham quando as tarefas compartilham estado, porque a etapa de merge fica bagunçada. Para os padrões de paralelização que confio, veja Claude Code subagents and team automation.

Como funcionam permissões e hooks?

Permissões decidem o que o Claude pode fazer sem perguntar. Eu mantenho os defaults conservadores e expando por projeto. O prompt de aprovação aparece antes de qualquer coisa destrutiva, que é a única rede de segurança que eu nunca desativo.

Hooks são scripts definidos pelo usuário que rodam em eventos do Claude: antes de um comando, após uma edição, no início de uma sessão. Eu uso um hook post-edit para rodar o linter e o type-checker automaticamente, para que o Claude receba feedback rápido sem eu precisar executar nada.

Um hook salvou minha semana passada. Meu hook pre-command bloqueou um rm -rf contra um caminho fora do projeto, e o Claude se ajustou a um delete limitado. Esse é exatamente o tipo de proteção que vale os dez minutos para configurar.

O Claude Code vale a pena em 2026?

Sim, para desenvolvedores que já vivem no terminal. O custo é real, medido em tokens, e compensa quando suas tarefas são delimitadas e seu repo é bem descrito por CLAUDE.md.

Ele substituiu três ferramentas para mim: um chat AI separado, um assistente de busca CLI e a maior parte da minha exploração manual de grep-and-read. O loop nativo do terminal é mais rápido do que alternar abas para um navegador.

Onde ele ainda perde: refatorações grandes e ambíguas, frameworks novíssimos com documentação escassa e qualquer coisa que exija bom senso em uma codebase inteira. Para essas, eu planejo primeiro em texto simples, depois dou ao Claude uma especificação precisa.

Você deveria confiar nele com código de produção?

Não sem supervisão. Eu trato a saída do Claude Code como trato um PR de júnior forte: reviso cada diff, rodo os testes e nunca mergeio por fé. Autonomia é um dial, não um interruptor.

O aviso honesto: o Claude Code produzirá com confiança código que parece correto e está sutilmente errado, especialmente em torno de tratamento de erros e limpeza async. Revise os caminhos de falha você mesmo, mantenha um rollback rápido e você ganha um aumento sério de produtividade sem desastres. Os Anthropic docs cobrem as configurações que não repeti aqui.

Principais conclusões

• Instale o CLI e depois invista em CLAUDE.md antes do primeiro prompt real.
• Domine /clear, /compact e /permissions; o resto é opcional.
• Comece com dois ou três servidores MCP e adicione apenas quando um fluxo de trabalho exigir.
• Use subagents para trabalho paralelo e independente; mantenha tarefas de estado compartilhado em série.
• Mantenha as permissões restritas e adicione hooks para lint, type-check e guardas de comandos destrutivos.
• Revise cada diff como um PR. Autonomia sem revisão é onde os projetos sofrem.

Créditos das imagens

• Código fonte colorido brilhando em um monitor de desenvolvedor — foto por Mikhail Nilov em Pexels
• Close-up de código de programação colorido exibido em uma tela — foto por Pixabay em Pexels
• Um programador usando fones de ouvido codificando em uma mesa com monitores duplos — foto por Christina Morillo em Pexels
• Um engenheiro de software escrevendo e revisando código em um escritório moderno — foto por ThisIsEngineering em Pexels