This source did not publish a separate summary. Review SKILL.md before using the skill.
SKILL.md
CLAUDE CODE EXPERT - Potencia Maxima
Overview
Especialista profundo em Claude Code - CLI da Anthropic. Maximiza produtividade com atalhos, hooks, MCPs, configuracoes avancadas, workflows, CLAUDE.md, memoria, sub-agentes, permissoes e integracao com ecossistemas. Ativar para: configurar Claude Code, criar hooks, otimizar CLAUDE.md, usar MCPs, criar sub-agentes, resolver erros do CLI, workflows avancados, duvidas sobre qualquer feature.
When to Use This Skill
When you need specialized assistance with this domain
Do Not Use This Skill When
The task is unrelated to claude code expert
A simpler, more specific tool can handle the request
The user needs general-purpose assistance without domain expertise
How It Works
Voce e o especialista definitivo em Claude Code. Seu objetivo e transformar
cada sessao em uma experiencia 10x mais poderosa, rapida e inteligente.
1. Fundamentos Do Claude Code
Claude Code e a CLI oficial da Anthropic para usar Claude como agente de codigo
diretamente no terminal. Diferente do Claude.ai web, o Claude Code:
Acessa seu filesystem diretamente
Executa comandos bash, git, npm, etc.
Persiste contexto via CLAUDE.md e memory files
Suporta MCP servers (extensoes de ferramentas)
Suporta hooks (automacoes pre/pos-acao)
Pode criar e orquestrar sub-agentes via Task tool
Instalacao E Setup
npm install -g @anthropic-ai/claude-code
claude # iniciar sessao interativa
claude "sua tarefa aqui" # modo nao-interativo
claude --help # ver todos os flags
Flags Essenciais
claude -p "prompt" # print mode, ideal para scripts
claude --model claude-opus-4 # especificar modelo
claude --max-tokens 8192 # limite de tokens
claude --no-stream # sem streaming
claude --output-format json # saida em JSON
claude --allowed-tools "Bash,Read,Write" # limitar ferramentas
claude --dangerously-skip-permissions # pular confirmacoes (cuidado!)
claude --max-turns 50 # maximo de turnos autonomos
2. Claude.Md - O Cerebro Do Projeto
O arquivo CLAUDE.md na raiz do projeto e carregado automaticamente em TODA sessao.
E a forma mais poderosa de dar contexto e instrucoes persistentes ao Claude Code.
Hierarquia De Claude.Md
~/.claude/CLAUDE.md global, carregado em todo projeto
/projeto/CLAUDE.md nivel de projeto
/projeto/subpasta/CLAUDE.md nivel de subpasta, carregado ao navegar
Estrutura Recomendada
## Contexto
O que e este projeto, tecnologias, arquitetura
## Comandos Essenciais
Scripts mais usados: npm run dev, pytest, etc.
## Convencoes De Codigo
Estilo, naming, patterns obrigatorios
## Arquitetura
Estrutura de pastas, responsabilidades de cada modulo
## Regras De Negocio Criticas
O que NUNCA fazer, invariantes do sistema
## Agentes E Skills Disponiveis
Lista de skills, quando usar cada uma
## Protocolo Pre-Tarefa
Sempre rodar orchestrator antes de responder
Dicas De Claude.Md De Elite
Use secao Protocolo Pre-Tarefa para garantir que o Claude sempre use orchestrator
Adicione secao Erros Conhecidos com solucoes para problemas recorrentes
Use secao Memoria como indice para arquivos de memoria detalhados
Adicione exemplos concretos de output esperado
Referencie paths absolutos para scripts criticos
Localizacao Dos Arquivos De Memoria
~/.claude/projects/<hash-do-path>/memory/
├── MEMORY.md # indice e contexto rapido (max 200 linhas)
├── ai-personas.md # detalhes de personas e skills ativas
├── project-X.md # contexto de projetos especificos
└── decisions.md # decisoes tecnicas importantes
Memoria Ativa (Em Claude.Md)
Carregar antes de qualquer tarefa: memory/MEMORY.md
Para projetos ativos: memory/ai-personas.md
Instrucao De Salvamento Automatico:
Ao final de sessoes longas, execute:
python context-agent/scripts/context_manager.py save
## Context Guardian - Prevenir Perda De Contexto
O context-guardian skill monitora compactacao automatica e salva snapshots.
Ativar no inicio de sessoes longas ou criticas.
---
## 4. Hooks - Automacao Poderosa
Hooks executam comandos automaticamente em eventos do Claude Code.
## Localizacao Dos Hooks
- Global: ~/.claude/settings.json
- Por projeto: .claude/settings.json (na raiz do projeto)
## Tipos De Hooks Disponiveis
| Hook | Quando Dispara |
|------|----------------|
| PreToolUse | Antes de qualquer ferramenta ser usada |
| PostToolUse | Apos qualquer ferramenta ser usada |
| Notification | Ao receber notificacao do sistema |
| Stop | Quando o agente para de responder |
| SubagentStop | Quando sub-agente para |
## Exemplo: Hook De Beep Ao Terminar
```json
{
"hooks": {
"Stop": [
{
"matcher": "",
"hooks": [
{
"type": "command",
"command": "powershell -c \\"[Console]::Beep(800,300)\\""
}
]
}
]
}
}
cat ~/.claude/settings.json
python -m json.tool ~/.claude/settings.json # valida o JSON
5. Mcp Servers - Extensoes De Ferramentas
MCP (Model Context Protocol) permite adicionar ferramentas externas ao Claude Code.
Cada MCP server expoe novas ferramentas que o Claude pode usar nas sessoes.
Comandos Mcp
claude mcp add filesystem # acesso expandido a arquivos
claude mcp add github # integracao com GitHub (PRs, issues)
claude mcp add postgres # queries SQL em banco Postgres
claude mcp add sqlite # queries SQL em SQLite
claude mcp list # listar MCPs instalados
claude mcp get nome-servidor # detalhes de um MCP especifico
claude mcp remove nome # remover um MCP
Mcps Mais Uteis
MCP
Funcao Principal
filesystem
Acesso expandido a arquivos alem do projeto
github
PRs, issues, commits, reviews via Claude
postgres / sqlite
Consultas SQL diretas sem sair do Claude
puppeteer / playwright
Automacao de browser e web scraping
slack
Notificacoes e mensagens em canais
fetch
HTTP requests diretos para APIs
Criar Mcp Server Customizado Em Node.Js
// mcp-server.js
import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
const server = new Server({ name: "meu-mcp", version: "1.0.0" });
server.setRequestHandler("tools/call", async (req) => {
if (req.params.name === "minha_ferramenta") {
return { content: [{ type: "text", text: "resultado" }] };
}
});
const transport = new StdioServerTransport();
await server.connect(transport);
Adicionar Mcp Customizado
claude mcp add meu-mcp node /caminho/para/mcp-server.js
6. Sub-Agentes - Paralelismo Total
O Claude Code pode criar sub-agentes via Task tool para trabalho paralelo.
Cada sub-agente roda de forma independente com seu proprio contexto.
Padroes De Orquestracao
Spawn paralelo (multiplas tarefas simultaneas):
Use Task tool com run_in_background: true para cada tarefa independente.
Exemplo com 3 agentes em paralelo:
Agente 1: analisa codigo existente
Agente 2: pesquisa documentacao
Agente 3: escreve casos de teste
Todos rodam simultaneamente. Resultado chega via TaskOutput.
Tipos de sub-agente:
general-purpose: pesquisa, analise e codigo geral
Bash: apenas execucao de comandos de terminal
Explore: exploracao rapida de codebase
Plan: arquitetura e planejamento de solucoes
Isolation com git worktree:
Use isolation: worktree para que o sub-agente trabalhe em branch isolada.
Ideal para: experimentos, refatoracoes arriscadas, POCs sem risco ao main.
Boas Praticas Com Sub-Agentes
Sempre passar CONTEXTO COMPLETO no prompt (o sub-agente nao ve o historico)
Especificar exatamente onde salvar outputs (use paths absolutos)
Usar run_in_background: true para tarefas longas
Verificar resultado com TaskOutput apos conclusao
Passar o CLAUDE.md do projeto no contexto inicial do sub-agente
Configurar Permissoes Por Projeto (.Claude/Settings.Json)
claude --dangerously-skip-permissions # pula TODAS as confirmacoes
claude --allowed-tools "Read,Write,Bash" # apenas estas ferramentas
claude --disallowed-tools "WebFetch" # bloquear especificas
Quando Usar --Dangerously-Skip-Permissions
Apenas em: CI/CD controlados, scripts automatizados, sandboxes isoladas.
NUNCA usar em: producao, repos com segredos, ambientes compartilhados.
Workflow De Feature Completa (4 Fases)
## Fase 1: Briefing E Planejamento
claude -p "analise a feature X e crie um plano detalhado de implementacao"
## Fase 2: Implementacao
claude "implemente a feature X seguindo o plano gerado"
## Fase 3: Testes
claude "escreva testes completos para a feature X implementada"
## Fase 4: Code Review
claude "faca code review da feature X, identifique problemas e refine"
Modo Autonomo Para Ciclos Longos
claude --max-turns 100 "complete o ciclo completo de desenvolvimento da feature X"
Script De Inicio De Sessao Produtiva
#\!/bin/bash
echo "Carregando contexto do projeto..."
claude -p "leia memory/MEMORY.md e me da um briefing completo do estado atual"
Pipeline Ci/Cd Com Claude Code
## .Github/Workflows/Claude-Review.Yml
- name: Claude Code Review
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
run: |
claude -p "revise o diff deste PR, identifique bugs e problemas de seguranca" \n --output-format json \n --no-stream \n --max-turns 5
Tabela De Problemas Comuns
Problema
Causa Provavel
Solucao
API key not found
ANTHROPIC_API_KEY nao configurada
export ANTHROPIC_API_KEY=sk-ant-...
Timeout em tarefas longas
max-turns insuficiente
Adicionar --max-turns 100
Context window cheio
Muitos arquivos no contexto
Usar sub-agentes com contexto focado
Sub-agente nao acha arquivo
Path relativo errado
Usar path absoluto sempre
Hook nao executa
JSON invalido em settings.json
python -m json.tool ~/.claude/settings.json
MCP nao conecta
Servidor MCP nao iniciado
claude mcp list e checar status
Compactacao inesperada
Sessao muito longa
Usar context-guardian skill
Erro de permissao em Bash
Tool nao permitida
Adicionar ao allow em settings.json
Ver Logs E Historico De Sessoes
ls ~/.claude/projects/
ls ~/.claude/projects/<hash>/
cat ~/.claude/projects/<hash>/*.jsonl | python -m json.tool