# A maior biblioteca de prompts de sistema: visão geral do repositório e como utilizá-lo > Visão completa do repositório claude-code-system-prompts: análise de mais de 500 instruções de sistema do Claude Code, categorização e personalização via tweakcc. Estudar as instruções internas dos agentes autônomos modernos é uma das formas mais eficazes de compreender como as equipes de engenharia das principais laboratórios de IA projetam sistemas confiáveis. O repositório público [claude-code-system-prompts](https://github.com/piebald-ai/claude-code-system-prompts), da equipe Piebald, é a coleção pública mais completa dos atuais system prompts do Claude Code. Ele documenta centenas de instruções com contagem exata de tokens e um histórico detalhado de mudanças entre releases. --- ## 1. O que é o repositório claude-code-system-prompts O repositório contém um registro abrangente de todas as diretivas internas do agente CLI oficial Claude Code, da Anthropic. ### 1.1. Origem e propósito do repositório da Piebald O projeto foi criado para permitir uma análise transparente da evolução da arquitetura do Claude Code. Na versão Claude Code v2.1.234, a base já conta com mais de 500 prompts distintos. Além do texto original das instruções, o repositório inclui o arquivo `CHANGELOG.md`, onde são registradas minuciosamente as alterações nos prompts ao longo de mais de 250 releases consecutivos, começando pela versão v2.0.14. ### 1.2. Histórico de atualizações e cobertura de versões Os scripts de sincronização são executados automaticamente poucos minutos após cada publicação de um novo pacote npm do Claude Code. Isso garante que os desenvolvedores tenham acesso às instruções atualizadas em tempo real, sem depender de documentação desatualizada ou suposições de terceiros. A última expansão significativa aumentou o catálogo de prompts de 350 para 515 entradas, garantindo 100% de cobertura do codebase do agente. --- ## 2. Por que o Claude Code não usa um único system prompt, mas centenas deles Um erro comum entre iniciantes é imaginar a interação com modelos de linguagem como um único bloco estático de instruções de sistema. ### 2.1. Arquitetura modular em vez de um system prompt monolítico Em um sistema de produção real no nível do Claude Code, o comportamento do agente é composto dinamicamente por vários módulos: - **Blocos condicionais de ambiente:** instruções ativadas apenas quando certas configurações ou sistemas operacionais estão presentes. - **Descrições de ferramentas (Tool Descriptions):** especificações profundas de funções (`Write`, `Bash`, `TodoWrite`), algumas ocupando milhares de tokens. - **Subagentes especializados:** diretivas de sistema autônomas para processos auxiliares, como `Explore` ou `Plan`. ### 2.2. Ativação condicional e interpolação dinâmica O sistema também inclui dezenas de funções de IA utilitárias: mecanismos de compactação de contexto (Context Compaction), geração de arquivos `CLAUDE.md`, formulação de títulos de sessões e controle de limites de segurança. No total, são centenas de linhas de código distribuídas dentro de um bundle otimizado. --- ## 3. Como os prompts são estruturados: categorias e organização Todos os materiais extraídos foram sistematizados em seis áreas principais, conforme sua função operacional. ### 3.1. Distribuição pelas 6 categorias principais Abaixo está a distribuição quantitativa dos prompts por categoria no repositório: ![Distribuição quantitativa das categorias de prompts no repositório — Ilustração 1](/api/guides-media/prompts/system-prompts-library-repo-overview/images/system-prompts-library-repo-overview-extra-01.webp) | Categoria de Instruções | Quantidade de Prompts | Propósito Funcional | | :--- | :--- | :--- | | **Agent Prompts** | 67 | Especificações de subagentes, comandos slash e monitores autônomos de ações | | **Data** | 121 | Documentação de referência, catálogos de modelos Claude e templates de artefatos | | **System Prompt** | 143 | Regras básicas de comportamento, estilo de comunicação e coordenação de sessões | | **System Reminders** | 81 | Lembretes situacionais sobre modos ativos e limites de confiança | | **Builtin Tool Descriptions** | 176 | Instruções técnicas sobre invocação e parâmetros de utilitários embutidos | | **Skills** | 87 | Protocolos complexos multi-etapa para tarefas de engenharia avançadas | --- ## 4. Visão geral das categorias-chave: de agentes a lembretes de sistema Cada categoria desempenha uma tarefa estritamente definida no ecossistema geral do agente. ### 4.1. Agent Prompts — subagentes, comandos slash e monitoramento Esta categoria abrange quatro grupos: subagentes autônomos, assistentes de sistema de arquivos, comandos slash interativos e utilitários de serviço. - **Agent Prompt: Explore (871 tks):** system prompt especializado para navegação e exploração rápida da estrutura de codebases desconhecidas. - **Agent Prompt: /security-review (2 521 tks):** instrução abrangente para auditoria de mudanças de código, com foco em vulnerabilidades exploráveis. - **Agent Prompt: Security monitor (25 798 tks):** o maior prompt da seção, definindo regras de verificação e bloqueio de operações potencialmente perigosas. ### 4.2. Data — documentação de referência, catálogos de modelos e templates Contém informações estáticas embutidas na ferramenta para operação autônoma, sem necessidade de consultas constantes a APIs externas: - **Claude model catalog (4 965 tks):** lista atualizada dos modelos da Anthropic com IDs, limites de contexto e tarifação. - **Managed Agents core concepts (10 959 tks):** guia sobre arquitetura de ambientes agênticos, sessões e containers isolados. - **Workshop artifact HTML template (49 202 tks):** template HTML autônomo completo para renderização de artefatos interativos. ### 4.3. System Prompt — instruções básicas e orquestração de coordenação Fragmentos que compõem o contexto primário de comunicação do modelo: - **Emoji avoidance (31 tks):** instrução concisa que proíbe o uso de emojis sem solicitação direta do usuário. - **Harness instructions (329 tks):** definição da identidade básica do agente, regras de saída no terminal e direitos de acesso. - **Coordinator mode orchestration (5 757 tks):** regras para distribuição de tarefas entre múltiplos worker-agents paralelos. ### 4.4. System Reminders — lembretes contextuais e limites de segurança Inserções dinâmicas adicionadas ao contexto durante a execução de ações específicas: - **Plan mode is active (147 tks):** lembrete sobre a proibição de edição de arquivos enquanto o modo de planejamento está ativo. - **External source trust boundary (108 tks):** aviso de que dados de plugins externos têm nível zero de confiança e exigem sanitização. ### 4.5. Built-in Tool Descriptions — especificações de ferramentas embutidas Descrições de invocação de utilitários que o modelo interpreta como assinaturas padrão de ferramentas: - **Tool Description: TodoWrite (2 037 tks):** instrução para manutenção de listas estruturadas de tarefas. - **Tool Description: Workflow (7 034 tks):** protocolo para cenários de orquestração determinísticos. - **Tool Description: Bash (Git & PR guidelines) (2 450 tks):** padrões para criação de commits atômicos git e descrições de pull requests. --- ## 5. Skills embutidas e workflows especializados As Skills representam cenários especializados completos, otimizados para tarefas específicas de desenvolvimento. ### 5.1. Catálogo de Skills embutidas Entre os exemplos mais interessantes: - **Skill: Design (20 955 tks):** regras para projetar artboards adaptativos do Claude Design com grids de interface editáveis. - **Skill: Verify skill (4 354 tks):** checklist formalizado para testes obrigatórios de código antes de declarar uma tarefa concluída. ### 5.2. Os maiores prompts por volume de tokens O recorde absoluto do repositório é a **Skill: Model migration guide (64 306 tks)**. Este guia passo a passo massivo contém templates completos de refatoração para migrar chamadas de API obsoletas para os novos padrões das famílias Claude 3.5 e Claude 3.7. --- ## 6. Como a precisão é garantida: extração do código-fonte A confiabilidade da base de prompts é assegurada pela automação completa dos processos de análise. ### 6.1. Extração automatizada do pacote npm Todas as instruções são extraídas por um script de decompilação diretamente do distribution npm (`@anthropic-ai/claude-code`). Isso elimina fatores humanos ou interpretações subjetivas — o repositório contém exatamente as linhas de código que o motor executa durante sua sessão. ### 6.2. Erro de tokenização e variáveis dinâmicas Vale notar que alguns prompts contêm variáveis de template interpoladas (nomes de extensões instaladas, variáveis de ambiente, caminhos disponíveis). Por isso, a contagem real de tokens em sua sessão local pode variar em ±20 tokens em relação ao valor nominal. --- ## 7. Customização prática de prompts usando tweakcc Para desenvolvedores que desejam modificar o comportamento padrão do agente, foi criada a utilidade `tweakcc`. ### 7.1. Recursos e princípios de funcionamento do tweakcc A utilidade oferece três vantagens principais: 1. Permite descrever modificações customizadas nos system prompts como arquivos Markdown legíveis. 2. Aplica patches automaticamente nas instalações binárias ou via npm do Claude Code em seu sistema. 3. Inclui ferramentas integradas de resolução de conflitos quando atualizações da Anthropic afetam trechos que você editou. ### 7.2. Gerenciamento seguro de patches e sincronização com releases da Anthropic Como o `tweakcc` utiliza o mesmo mapa de instruções do repositório `claude-code-system-prompts`, o processo de modificação permanece totalmente determinístico e recuperável após cada atualização do CLI. --- ## 8. Perguntas Frequentes (FAQ) ### 8.1. Respostas para dúvidas comuns sobre system prompts > [!NOTE] > **Posso usar os prompts do repositório para meus próprios agentes?** > Sim. A estrutura das instruções para subagentes, regras de segurança e descrições de ferramentas (especialmente para `Bash` e `TodoWrite`) serve como referência ideal para construir seus próprios sistemas agênticos baseados em LLMs. > [!TIP] > **Como encontrar o prompt certo no repositório?** > Use a busca global pelo nome do comando slash, ferramenta de sistema ou consulte a tabela de categorias no arquivo `README.md` do repositório. > [!IMPORTANT] > **Aplicar patches via tweakcc resultará em bloqueio da minha conta?** > Não. A modificação de prompts client-side via `tweakcc` altera apenas o texto enviado nos parâmetros padrão da API request do seu lado, sem violar os protocolos de segurança do servidor. > [!WARNING] > **Por que a contagem de tokens na minha chamada pode diferir da indicada?** > Muitos prompts contêm slots de interpolação dinâmicos (como data atual, versão do SO, lista de utilitários de terminal disponíveis), calculados diretamente no momento da inicialização do agente.