El estudio de las directivas operativas internas de los agentes de programación autónomos actuales proporciona una perspectiva inestimable sobre cómo los principales laboratorios de IA diseñan arquitecturas robustas y predecibles.
El repositorio de código abierto claude-code-system-prompts del equipo de Piebald constituye la colección pública más completa de prompts del sistema de Claude Code. En él se catalogan cientos de instrucciones con recuentos exactos de tokens y el historial de cambios entre versiones.
1. Qué es el repositorio claude-code-system-prompts
El repositorio actúa como un registro vivo y riguroso de todas las directivas internas que gobiernan el agente de terminal oficial de Anthropic, Claude Code.
1.1. Origen y propósito del repositorio de Piebald
Creado para ofrecer transparencia sobre la evolución técnica de Claude Code, el proyecto indexa más de 500 prompts específicos a partir de la versión v2.1.234.
Además del texto de las directivas, incluye un archivo CHANGELOG.md detallado que registra los cambios en los prompts a lo largo de más de 250 actualizaciones consecutivas desde la versión v2.0.14.
1.2. Frecuencia de actualización y cobertura de versiones
Los procesos de extracción automatizada se ejecutan a los pocos minutos de publicarse cada nueva versión en el registro de npm de @anthropic-ai/claude-code. Gracias a ello, los ingenieros acceden a instrucciones actualizadas en tiempo real sin depender de conjeturas ni documentación desfasada.
Una reciente ampliación elevó el catálogo de 350 a 515 registros, alcanzando una cobertura exhaustiva del código fuente del agente.
2. Por qué Claude Code utiliza cientos de prompts del sistema
Un error común entre principiantes es concebir la interacción con un modelo de lenguaje como un único bloque monolítico de instrucciones del sistema.
2.1. Arquitectura modular frente a un prompt monolítico
En una herramienta de grado industrial como Claude Code, el comportamiento del agente surge de la composición dinámica de múltiples módulos:
- Bloques condicionales de entorno: directivas que se activan según la configuración del usuario, el sistema operativo o los permisos de terminal.
- Descripciones de herramientas (Tool Descriptions): especificaciones formales de funciones integradas (
Write,Bash,TodoWrite), algunas de las cuales superan miles de tokens. - Subagentes especializados: directivas autónomas para procesos auxiliares como
ExploreoPlan.
2.2. Inyección condicional e interpolación dinámica
La arquitectura integra además decenas de micro-prompts de soporte: rutinas de compactación de contexto, generación de archivos CLAUDE.md, asignación de títulos de sesión y filtros de seguridad. En conjunto, conforman cientos de instrucciones orquestadas dinámicamente en tiempo de ejecución.
3. Arquitectura de prompts: estructura y categorías
Todos los elementos extraídos se clasifican en seis categorías funcionales principales según su cometido operativo.
3.1. Distribución en las 6 categorías principales
A continuación se detalla la distribución cuantitativa de los prompts catalogados:
Distribución cuantitativa de categorías de prompts en el repositorio — ilustración 1| Categoría | Número de prompts | Cometido funcional principal |
|---|---|---|
| Agent Prompts | 67 | Directivas para subagentes, comandos de barra y monitores de seguridad |
| Data | 121 | Documentación de referencia, catálogos de modelos y plantillas HTML |
| System Prompt | 143 | Reglas de identidad base, formato de salida y orquestación de sesiones |
| System Reminders | 81 | Recordatorios contextuales sobre modos activos y límites de confianza |
| Built-in Tool Descriptions | 176 | Especificaciones técnicas y parámetros de utilidades internas |
| Skills | 87 | Protocolos detallados de varios pasos para tareas de ingeniería complejas |
4. Resumen de categorías clave: de agentes a recordatorios del sistema
Cada categoría atiende a un área concreta dentro del ecosistema de ejecución del agente.
4.1. Agent Prompts: subagentes, comandos de barra y monitores de acción
Abarca cuatro divisiones: subagentes autónomos, asistentes de archivos, comandos interactivos y monitores de utilidades:
- Agent Prompt: Explore (871 tks): directiva especializada para examinar y mapear rápidamente la estructura de repositorios desconocidos.
- Agent Prompt: /security-review (2.521 tks): instrucción de auditoría orientada a identificar vulnerabilidades críticas explotables.
- Agent Prompt: Security monitor (25.798 tks): el prompt más voluminoso de esta sección, que fija las políticas de validación y bloqueo de operaciones de riesgo.
4.2. Data: documentación técnica, catálogo de modelos y plantillas
Colecciones de datos estáticos integradas en el binario para evitar consultas remotas recurrentes:
- Claude model catalog (4.965 tks): listado exhaustivo de modelos de Anthropic con identificadores, límites de contexto y precios por token.
- Managed Agents core concepts (10.959 tks): guía sobre arquitectura de sesiones, entornos y contenedores aislados de agentes.
- Workshop artifact HTML template (49.202 tks): plantilla autónoma para renderizar artefactos interactivos de proyectos.
4.3. System Prompt: identidad base, estilo y orquestación de sesiones
Módulos esenciales ensamblados en el contexto conversacional principal:
- Emoji avoidance (31 tks): breve indicación que restringe el empleo de emoticonos salvo petición explícita.
- Harness instructions (329 tks): define la identidad del agente, los formatos de terminal y los niveles de autorización.
- Coordinator mode orchestration (5.757 tks): reglas para delegar subtareas entre múltiples agentes paralelos y verificar entregables.
4.4. System Reminders: avisos contextuales y perímetros de seguridad
Fragmentos dinámicos inyectados durante la sesión ante eventos específicos:
- Plan mode is active (147 tks): recuerda la restricción de editar archivos mientras permanezca activo el modo de planificación.
- External source trust boundary (108 tks): advierte de que la información procedente de complementos externos no es de confianza y debe sanearse.
4.5. Built-in Tool Descriptions: especificaciones de herramientas integradas
Guías operativas asociadas a los esquemas de llamada de herramientas:
- Tool Description: TodoWrite (2.037 tks): protocolo para la gestión y seguimiento jerárquico de listas de tareas.
- Tool Description: Workflow (7.034 tks): especificación de flujos de trabajo orquestados entre múltiples subagentes.
- Tool Description: Bash (Git & PR guidelines) (2.450 tks): directrices para generar confirmaciones git atómicas y solicitudes de extracción bien descritas.
5. Habilidades integradas y flujos de trabajo especializados
Las habilidades (Skills) constituyen guías de ejecución completas diseñadas para resolver flujos de trabajo avanzados.
5.1. Catálogo de habilidades integradas (Skills)
Entre los ejemplos más destacados figuran:
- Skill: Design (20.955 tks): pautas para estructurar y publicar lienzos adaptativos de Claude Design con maquetas editables.
- Skill: Verify skill (4.354 tks): lista de verificación obligatoria para validar cambios de código antes de dar por terminada una tarea.
5.2. Los prompts más extensos por volumen de tokens
El prompt más extenso del repositorio es Skill: Model migration guide (64.306 tks), un manual minucioso para refactorizar integraciones hacia los nuevos estándares de Claude 3.5 y 3.7.
6. Cómo se garantiza la precisión: extracción del código fuente
La exactitud de la biblioteca se sustenta en la extracción programática automatizada.
6.1. Decompilación automatizada del paquete npm
Todas las instrucciones se extraen directamente del paquete oficial @anthropic-ai/claude-code. Esto excluye errores de transcripción: el repositorio refleja con absoluta fidelidad las cadenas ejecutadas en cada sesión de usuario.
6.2. Variación en el conteo de tokens y variables dinámicas
Determinadas directivas incorporan variables de sustitución en tiempo de ejecución (rutas de trabajo, variables de entorno, herramientas activas). Por este motivo, el recuento real en una sesión local puede diferir en ±20 tokens respecto al valor de referencia.
7. Personalización práctica de prompts del sistema con tweakcc
Para los profesionales interesados en adaptar o modificar estas directivas en sus entornos locales, la comunidad ha creado tweakcc.
7.1. Capacidades principales y modelo de funcionamiento de tweakcc
Esta herramienta ofrece tres ventajas fundamentales:
- Permite redactar modificaciones de prompts del sistema en formato Markdown convencional.
- Aplica automáticamente los cambios sobre la instalación binaria o de npm de Claude Code en su equipo.
- Incorpora herramientas de resolución de conflictos cuando las actualizaciones oficiales sobrescriben personalizaciones previas.
7.2. Flujo seguro de parches y sincronización con lanzamientos de Anthropic
Dado que tweakcc se apoya en el mismo mapa de directivas indexado en claude-code-system-prompts, el proceso de modificación es reproducible y fácil de restituir tras cada actualización del CLI.
8. Preguntas frecuentes (FAQ)
8.1. Respuestas prácticas a dudas esenciales sobre los prompts
¿Es viable utilizar estos prompts del sistema en agentes de IA propios?
Sí. La arquitectura de delegación de subagentes, las directrices de seguridad y las descripciones de herramientas (Bash, TodoWrite) representan estándares de referencia de la industria.
¿Cómo localizar con rapidez un prompt concreto en el repositorio?
Emplee el buscador de GitHub indicando el nombre exacto de la herramienta o comando de barra, o consulte la tabla de índices en el archivo README.md.
¿Modificar prompts con tweakcc puede conllevar la suspensión de la cuenta?
No. La aplicación de parches locales con tweakcc altera únicamente el contenido de la petición enviada a la API desde su cliente, dentro de las autorizaciones estándar.
¿Por qué el conteo de tokens en mi sesión difiere levemente del catálogo?
Las variables de entorno dinámicas (rutas del sistema de archivos, permisos de usuario y utilidades detectadas) se resuelven al iniciar la sesión, generando pequeñas variaciones de ±20 tokens.