Depurando un BadUSB de Pi Zero 2W con Claude Code: Solucionando un error 'imposible'

Hace unos 10 meses, un desarrollador creó un kit BadUSB para Pi Zero 2W, pero una función — "reinicio completo entre ataques" — nunca funcionó. Marcada como WIP, fue abandonada. Esta semana, reconstruyeron el proyecto de principio a fin con Claude Code como programador en pareja. Resultado: la función "imposible" ahora funciona, y la sesión descubrió varios bugs sutiles.

Lo que hizo Claude Code

• Diagnosticó la causa raíz de una lectura: El listener monitoreaba la existencia de /dev/hidg0 — verdadera desde el arranque — por lo que ejecutaba payloads al encenderse independientemente de la conexión al host. La señal correcta es /sys/class/udc/<udc>/state == "configured".
• Confirmó empíricamente una limitación de hardware: Cuando la primera solución no funcionó del todo, Claude accedió por SSH, pidió al desarrollador conectar/desconectar mientras consultaba sysfs y el registro regdump de dwc2 debugfs. Encontró que el registro GOTGCTL se congela en 0x000d0000 independientemente del estado del cable — el Pi Zero 2W no tiene detección VBUS conectada al bloque OTG del SoC. Cambió a una solución de desvinculación activa con enfriamiento y protección de límite de velocidad.
• Detectó un bug silencioso en Python: open(udc_path, "w").write("") no invoca write(2) con cero bytes — el TextIOWrapper de CPython omite la llamada. La desvinculación fue un no-op durante una hora de pruebas. Se corrigió a os.write(fd, b"\n") para forzar una syscall.
• Corrigió la destrucción prohibida en configfs: rm -rf fallaba porque configfs prohíbe desvincular archivos de atributos gestionados por el kernel. La secuencia correcta es solo rmdir, de hoja a raíz.
• Escribió una suite de pruebas pytest de 34 tests contra un motor HID simulado, permitiendo probar el analizador en cualquier host sin un Pi.
• Actualizó la memoria de IA: El desarrollador usa Postgres como memoria a largo plazo para Claude — esas entradas de bugs ahora se referencian en proyectos similares de configfs/USB-gadget.

Toda la sesión de trabajo tomó unas 4 horas, principalmente esperando la conexión/desconexión física. El PR tuvo seis commits bien delimitados con etiquetas de coautor y un plan de pruebas. El proyecto (Pi-Zero-2W-Bad-USB) tiene licencia MIT, con lenguaje de payload estilo Ducky-Script, variables, IF/WHILE, HOLD/RELEASE, INJECT MOD, RANDOM *, mapas de teclado US/UK, gadget opcional de almacenamiento masivo RO, integración con systemd e instalador idempotente.

Para desarrolladores que trabajan con flujos de hardware en bucle con Claude Code, este es un caso de estudio convincente de depuración asistida por IA a nivel de sysfs y registros.