--- name: claude-code-expert-6bc649062203 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//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 * | bash)" ] } } ``` ## 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// cat ~/.claude/projects//*.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 --- Source attribution: pinkpixel-dev Original project: https://github.com/pinkpixel-dev/skills-collection-1/blob/dc709653773653302e333a45d3b6f3b70fdff8f8/SKILLS/claude-code-expert/SKILL.md License: Apache-2.0 License information: https://www.apache.org/licenses/LICENSE-2.0 Original upstream instructions; downloaded from Mega AI Hub. ## Upstream license notice Apache License Version 2.0, January 2004 http://www.apache.org/licenses/ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 1. Definitions. "License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document. "Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License. "Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity. "You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License. "Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files. "Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types. "Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below). "Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof. "Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution." "Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work. 2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form. 3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed. 4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions: (a) You must give any other recipients of the Work or Derivative Works a copy of this License; and (b) You must cause any modified files to carry prominent notices stating that You changed the files; and (c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and (d) If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License. You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License. 5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions. 6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file. 7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License. 8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages. 9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability. END OF TERMS AND CONDITIONS APPENDIX: How to apply the Apache License to your work. To apply the Apache License to your work, attach the following boilerplate notice, with the fields enclosed by brackets "[]" replaced with your own identifying information. (Don't include the brackets!) The text should be enclosed in the appropriate comment syntax for the file format. We also recommend that a file or class name and description of purpose be included on the same "printed page" as the copyright notice for easier identification within third-party archives. Copyright 2026 Pink Pixel Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. # Mega AI Hub resource metadata Creator / publisher: pinkpixel-dev Original project: https://github.com/pinkpixel-dev/skills-collection-1/blob/dc709653773653302e333a45d3b6f3b70fdff8f8/SKILLS/claude-code-expert/SKILL.md Attribution basis: Source repository record Fields of work: Development & Engineering, Product Management Roles: Backend Developer, DevOps / SRE, ML / AI Engineer, Product Manager, Technical Product Manager Specialties: API, Backend, DevOps Tools: Anthropic, Cli Country applicability: Country not specified Classification basis: Source catalog labels Instruction SHA-256: 994330f0322c175e200484d70005c546d22c3d1224b60ea38fa1e531febdb2e7