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)\\""
          }
        ]
      }
    ]
  }
}

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

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)

{
  "permissions": {
    "allow": [
      "Bash(git *)",
      "Bash(npm *)",
      "Read(*)",
      "Write(src/**)"
    ],
    "deny": [
      "Bash(rm -rf *)",
      "Bash(sudo *)",
      "Bash(curl * | bash)"
    ]
  }
}

Flags De Permissao Em Linha De Comando

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

~/.Claude/Settings.Json Completo E Recomendado

{
  "theme": "dark",
  "verbose": false,
  "cleanupPeriodDays": 30,
  "hooks": {
    "Stop": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "powershell -c \\"[Console]::Beep(800,200); Start-Sleep -Milliseconds 100; [Console]::Beep(1000,200)\\""
          }
        ]
      }
    ]
  },
  "permissions": {
    "allow": [
      "Bash(git *)",
      "Bash(npm *)",
      "Bash(python *)",
      "Bash(powershell *)",
      "Read(*)",
      "Write(*)"
    ]
  }
}

Variaveis De Ambiente Essenciais

export ANTHROPIC_API_KEY=sk-ant-SUA_CHAVE_AQUI
export CLAUDE_CODE_MAX_OUTPUT_TOKENS=8192
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1   # modo privado

Como Claude Code Se Integra Com As Skills Auri

CLAUDE.md global lista todas as skills disponiveis e quando usar cada uma
agent-orchestrator e executado em toda solicitacao para identificar skills relevantes
task-intelligence enriquece tarefas moderadas/complexas com briefing pre-tarefa
context-agent salva e restaura estado entre sessoes
context-guardian previne perda de contexto em sessoes longas

Comandos Rapidos Do Ecossistema

python agent-orchestrator/scripts/scan_registry.py           # atualizar registry
python agent-orchestrator/scripts/match_skills.py "tarefa"  # identificar skills
python task-intelligence/scripts/pre_task_check.py "tarefa" # briefing
python context-agent/scripts/context_manager.py save        # salvar contexto
python context-agent/scripts/context_manager.py load        # carregar contexto

Quando Esta Skill E Ativada

Esta skill e ativada automaticamente quando o usuario quer:

Configurar ou otimizar o Claude Code CLI
Criar, debugar ou otimizar hooks
Adicionar ou configurar MCP servers
Criar sub-agentes e orquestracao paralela
Entender qualquer feature do Claude Code
Resolver erros ou comportamentos inesperados do CLI
Otimizar CLAUDE.md e arquivos de memoria
Configurar permissoes e seguranca

12. Slash Commands No Claude Code

Comando	Acao
/status	Ver estado atual da sessao e contexto
/clear	Limpar historico da conversa atual
/compact	Compactar contexto (Claude resume o historico)
/memory	Ver e editar arquivos de memoria
/hooks	Ver hooks configurados e ativos
/mcp	Ver MCPs conectados e seus status
/cost	Ver custo em tokens e USD da sessao
/model	Trocar modelo em uso (opus, sonnet, haiku)
/help	Ver todos os comandos e atalhos disponiveis

13. Referencias Oficiais

Documentacao principal: https://docs.anthropic.com/claude-code
Referencia de hooks: https://docs.anthropic.com/claude-code/hooks
Referencia de settings: https://docs.anthropic.com/claude-code/settings
MCP SDK e exemplos: https://github.com/modelcontextprotocol/sdk
Repositorio oficial: https://github.com/anthropics/claude-code
Release notes: https://docs.anthropic.com/claude-code/changelog

Best Practices

Provide clear, specific context about your project and requirements
Review all suggestions before applying them to production code
Combine with other complementary skills for comprehensive analysis

Common Pitfalls

Using this skill for tasks outside its domain expertise
Applying recommendations without understanding your specific context
Not providing enough project context for accurate analysis

Related Skills

007 - Complementary skill for enhanced analysis
matematico-tao - Complementary skill for enhanced analysis

claude-code-expert