claude-code-expert

仓库: sickn33/antigravity-awesome-skills
安装量: 35
排名: #19594

安装

npx skills add https://github.com/sickn33/antigravity-awesome-skills --skill claude-code-expert

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

  1. 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//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
}
]
}
]
}
}
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
← 返回排行榜