Arnés de Referencia para Defensa de Código

Una implementación de referencia para el descubrimiento y remediación autónomos de vulnerabilidades con Claude, basada en nuestros aprendizajes de asociarnos con equipos de seguridad en varias organizaciones desde el lanzamiento de Claude Mythos Preview. Para un informe de estos aprendizajes junto con mejores prácticas, consulte la publicación de blog adjunta (también disponible en blog-post.md). Para un tutorial ligero solo con SDK del mismo ciclo de reconocimiento → búsqueda → triaje → informe → parche, consulte el libro de cocina complementario.

Este repositorio no se mantiene y no acepta contribuciones.

🔒 ¿Quiere una opción gestionada? Anthropic ofrece Claude Security, un producto alojado que encuentra y corrige vulnerabilidades en su código fuente en múltiples proyectos. Claude Security escanea su repositorio en busca de vulnerabilidades, aplica un pipeline de verificación de varias etapas para reducir falsos positivos, y le permite gestionar los hallazgos a lo largo de su ciclo de vida: triaje, validación de correcciones y generación rápida de parches.

Este repositorio es una implementación de referencia de código abierto basada en mejores prácticas generales para encontrar vulnerabilidades usando Claude. Puede usarlo para construir su propio pipeline de búsqueda de vulnerabilidades, personalizar la lógica, y se puede usar con cualquier acceso que tenga a las APIs de Claude (incluyendo Bedrock, Vertex o Azure).

Contenido

• Habilidades de Claude Code: /quickstart, /threat-model, /vuln-scan, /triage, /patch, /customize: alcance interactivo, escaneo, triaje y parches. Abra este repositorio en Claude Code y ejecute /quickstart para orientarse.
• harness/: el pipeline de referencia autónomo (reconocimiento → búsqueda → verificación → informe → parche), configurado para encontrar vulnerabilidades de memoria en C/C++ usando Docker y ASAN. Este harness es una referencia, no un producto. La forma general, los prompts y el sandboxing son reutilizables, pero el harness no funcionará con todas las bases de código listas para usar. Ejecute /customize para adaptarlo a su lenguaje, detector o clase de vulnerabilidad.

⚠️ Seguridad: /quickstart, /threat-model, /vuln-scan y /triage solo leen y escriben archivos. Ejecutar /patch sobre hallazgos estáticos (TRIAGE.json o VULN-FINDINGS.json) también es de solo lectura y escritura. /customize edita el código del harness y ejecuta comandos de validación. Cualquiera de estas habilidades es segura de ejecutar sin sandbox, siempre que revise y apruebe cada uso de herramienta en Claude Code. El pipeline de referencia autónomo (incluyendo /patch sobre resultados del pipeline) ejecuta código objetivo, por lo que se niega a ejecutarse fuera de un sandbox de gVisor a menos que se anule explícitamente. Para configurarlo, ejecute scripts/setup_sandbox.sh una vez, luego invoque el pipeline mediante bin/vp-sandboxed. Consulte docs/security.md y docs/agent-sandbox.md para más detalles.

Primeros Pasos

git clone https://github.com/anthropics/defending-code-reference-harness
cd defending-code-reference-harness
claude

# Introducción de 30 segundos + primera ejecución guiada en el objetivo canary
> /quickstart

> /quickstart how do I port the pipeline to Java?
> /quickstart how do I triage all these bugs?

Lecturas Adicionales

• Publicación de Blog · La publicación de blog adjunta con aprendizajes + mejores prácticas
• Pipeline · Cómo funciona: diagrama, etapas, flags de CLI
• Seguridad · Sandboxing, qué no montar
• Sandbox del agente · Aislamiento gVisor + lista de permisos de salida para cada agente
• Personalización · Adaptar a mi stack; qué archivos cambian y por qué
• Parcheo · Generar y verificar correcciones para cierres confirmados
• Solución de Problemas · Duplicados, límites de tasa, fijación de modelo de subagente
• Salvaguardias · Bloqueo para trabajo cibernético peligroso

---

Aceleración

Los equipos de seguridad con los que nos hemos asociado con más éxito son aquellos que se han puesto manos a la obra más rápido. Aunque es tentador pasar meses diseñando el pipeline perfecto, recomendamos empezar con algo pequeño el Día 1 y construir desde ahí a medida que surgen aprendizajes. Los siguientes pasos siguen ese patrón y marcan un ritmo ambicioso (pero razonable) basado en lo que hemos visto.

Paso 1	Día 1	Construir un modelo de amenaza y ejecutar su primer escaneo estático + triaje
Paso 2	Día 2	Ejecutar el pipeline de referencia en una biblioteca C/C++
Paso 3	Días 3-5	Personalizar el pipeline para su objetivo
Paso 4	Semana 2	Iniciar escaneo autónomo, triaje y parcheo

Paso 1 (Día 1): Construir un modelo de amenaza y ejecutar su primer escaneo estático + triaje

El Día 1 se centra en ver todo el ciclo de principio a fin. Usando solo las habilidades interactivas, construirá un modelo de amenaza, ejecutará un escaneo estático delimitado por él, triará lo que regrese y redactará correcciones candidatas. Terminará el día con un modelo de amenaza, una lista clasificada de hallazgos estáticos y parches candidatos.

Las habilidades relevantes solo leen y escriben archivos en su repositorio. Mientras ejecute Claude Code de forma interactiva y apruebe cada uso de herramienta, no se necesita ningún sandbox.

# Fijar cada subagente al modelo deseado
export CLAUDE_CODE_SUBAGENT_MODEL=<model-id>
claude

# 0. Introducción + primera ejecución guiada
> /quickstart

# 1. Construir un modelo de amenaza (apuntar antes de disparar)
> /threat-model bootstrap targets/canary

# 2. Ejecutar un escaneo estático, delimitado por ese modelo de amenaza
> /vuln-scan targets/canary

# 3. Verificar, deduplicar y clasificar lo que regresó
> /triage targets/canary/VULN-FINDINGS.json