566 lines
16 KiB
Markdown
566 lines
16 KiB
Markdown
---
|
|
name: claude-code-expert
|
|
description: "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."
|
|
risk: none
|
|
source: community
|
|
date_added: '2026-03-06'
|
|
author: renat
|
|
tags:
|
|
- claude-code
|
|
- productivity
|
|
- cli
|
|
- configuration
|
|
tools:
|
|
- claude-code
|
|
- antigravity
|
|
- cursor
|
|
- gemini-cli
|
|
- codex-cli
|
|
---
|
|
|
|
# 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
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
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
|
|
|
|
1. ~/.claude/CLAUDE.md global, carregado em todo projeto
|
|
2. /projeto/CLAUDE.md nivel de projeto
|
|
3. /projeto/subpasta/CLAUDE.md nivel de subpasta, carregado ao navegar
|
|
|
|
## Estrutura Recomendada
|
|
|
|
```markdown
|
|
|
|
## 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
|
|
|
|
```json
|
|
{
|
|
"hooks": {
|
|
"PostToolUse": [
|
|
{
|
|
"matcher": "Bash",
|
|
"hooks": [
|
|
{
|
|
"type": "command",
|
|
"command": "echo dated-action >> ~/.claude/action_log.txt"
|
|
}
|
|
]
|
|
}
|
|
]
|
|
}
|
|
}
|
|
```
|
|
|
|
## Exemplo: Hook Scanner De Seguranca Pre-Commit
|
|
|
|
```json
|
|
{
|
|
"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
|
|
|
|
```bash
|
|
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
|
|
|
|
```bash
|
|
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
|
|
|
|
```javascript
|
|
// 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
|
|
|
|
```bash
|
|
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
|
|
|
|
1. Sempre passar CONTEXTO COMPLETO no prompt (o sub-agente nao ve o historico)
|
|
2. Especificar exatamente onde salvar outputs (use paths absolutos)
|
|
3. Usar run_in_background: true para tarefas longas
|
|
4. Verificar resultado com TaskOutput apos conclusao
|
|
5. Passar o CLAUDE.md do projeto no contexto inicial do sub-agente
|
|
|
|
---
|
|
|
|
## Configurar Permissoes Por Projeto (.Claude/Settings.Json)
|
|
|
|
```json
|
|
{
|
|
"permissions": {
|
|
"allow": [
|
|
"Bash(git *)",
|
|
"Bash(npm *)",
|
|
"Read(*)",
|
|
"Write(src/**)"
|
|
],
|
|
"deny": [
|
|
"Bash(rm -rf *)",
|
|
"Bash(sudo *)",
|
|
"Bash(curl *remote-installer*)"
|
|
]
|
|
}
|
|
}
|
|
```
|
|
|
|
## Flags De Permissao Em Linha De Comando
|
|
|
|
```bash
|
|
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)
|
|
|
|
```bash
|
|
|
|
## 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
|
|
|
|
```bash
|
|
claude --max-turns 100 "complete o ciclo completo de desenvolvimento da feature X"
|
|
```
|
|
|
|
## Script De Inicio De Sessao Produtiva
|
|
|
|
```bash
|
|
#\!/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
|
|
|
|
```yaml
|
|
|
|
## .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
|
|
|
|
```bash
|
|
ls ~/.claude/projects/
|
|
ls ~/.claude/projects/<hash>/
|
|
cat ~/.claude/projects/<hash>/*.jsonl | python -m json.tool
|
|
```
|
|
|
|
---
|
|
|
|
## ~/.Claude/Settings.Json Completo E Recomendado
|
|
|
|
```json
|
|
{
|
|
"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
|
|
|
|
```bash
|
|
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
|
|
|
|
1. CLAUDE.md global lista todas as skills disponiveis e quando usar cada uma
|
|
2. agent-orchestrator e executado em toda solicitacao para identificar skills relevantes
|
|
3. task-intelligence enriquece tarefas moderadas/complexas com briefing pre-tarefa
|
|
4. context-agent salva e restaura estado entre sessoes
|
|
5. context-guardian previne perda de contexto em sessoes longas
|
|
|
|
## Comandos Rapidos Do Ecossistema
|
|
|
|
```bash
|
|
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
|
|
|
|
## Limitations
|
|
- Use this skill only when the task clearly matches the scope described above.
|
|
- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
|
|
- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.
|