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

{ "hooks": { "Stop": [ { "matcher": "", "hooks": [ { "type": "command", "command": "powershell -c \\"[Console]::Beep(800,300)\\"" } ] } ] } }


## Exemplo: Hook De Log De Acoes Bash

{ "hooks": { "PostToolUse": [ { "matcher": "Bash", "hooks": [ { "type": "command", "command": "echo dated-action >> ~/.claude/action_log.txt" } ] } ] } }


## Exemplo: Hook Scanner De Seguranca Pre-Commit

{ "hooks": { "PreToolUse": [ { "matcher": "Bash", "hooks": [ { "type": "command", "command": "python C:/Users/renat/skills/cred-omega/scripts/secret_scanner.py --staged 2>/dev/null || true" } ] } ] } }


## Ver E Validar Hooks Ativos

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";


## 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
-

claude-code-expert

Como adicionar

Cole no README do seu repo

Skills relacionadas

frontend-design

mcp-builder

webapp-testing

web-artifacts-builder

Receba novas skills de Design e Frontend toda segunda