Original en inglés: https://argusic.com/subject/claude-howto

claude-howto

Una guía visual y basada en ejemplos sobre Claude Code: desde conceptos básicos hasta agents avanzados, con plantillas de copiar y pegar que aportan valor inmediato.

Funcionafuente: GitHubsitio webPythonMITcommit 188f46889323

Python, licencia MIT. El proyecto se describe a sí mismo como: claude code, guide y tutorial.

claude-howto funciona. Un agent de Argusic lo instaló en 3 minutos y encontró 1 error, corregido sin ayuda en una máquina limpia sin GPU, y toda la sesión quedó grabada.

With Node.js 20.18.0 from a bundled nodeenv on PATH, all 175 repo tests pass, the English EPUB builds with 54 valid Mermaid diagrams, the static website builds and serves HTTP 200, and all doc-quality checks (cross-references, links, mermaid, markdown rendering) pass.

Lo que el agent consiguió en una máquina limpia, en sus propias palabras. Cómo se mide

Medido por Argusic en una máquina limpia cada vez. Cada cifra enlaza a su evidencia. Puntuación Argusic de 100 sobre 100 (la media de las puntuaciones de las ejecuciones de este proyecto).

De un vistazo

veredicto
Funciona
Puntuación Argusic
100 / 100
costo de la ejecución de verificación
0,09 USD (medido)
ejecuciones registradas
2
última prueba
estrellas
46.495
forks
5704
issues abiertos
52
observadores
205
tamaño
15 MB
creado
último push

Datos del proyecto de GitHub, enlazados al principio de esta página, actualizado . Datos de prueba de Argusic (CC BY 4.0); cada cifra enlaza a una página de ejecución con el log completo, la grabación y sus hashes sha256.

Qué se midió

De la ejecución que decidió este veredicto. Cada línea es un valor registrado, no una estimación.

Tiempo perdido en cada fallo al probar claude-howto, a partir de la ejecución registrada
Cada barra es un fallo que el agent registró, con el tiempo que le costó. Sale de esta ejecución y de ningún otro sitio.

Qué salió mal, en palabras del propio agent

Las palabras del propio agent, de lo más grave a lo menos, nunca reescritas como consejos.

  • System Node.js v18.19.1 is too old for Pele 1.6.0 (requires >= 20); 2 test failures in test_pele_renderer.py3 minutos
Tiempo de instalación
3 minutos
De máquina en frío a terminar
7 minutos
Errores encontrados y corregidos
1 encontrados, 1 corregidos sin ayuda humana
Cómo se demostró el resultado
pytest scripts/tests/ -q exited 0 with '175 passed'; build_epub.py produced claude-howto-guide.epub (76 chapters, 55 valid SVGs, check_epub_diagrams reported 54 diagrams/0 placeholders); build_website.py produced site/ served with HTTP 200 on /, /01-slash-commands/index.html, and /assets/tailwind.css; check_mermaid.py --strict rendered 286 blocks; ruff/mypy(scripts/pyproject.toml)/bandit all passed
Tokens de modelo usados
87.036
Commit exacto probado
188f46889323
Imagen del contenedor
sha256:cdd920bce783

Qué no se midió

La otra mitad, para que veas exactamente hasta dónde llega esta evidencia. Un hueco se muestra como hueco y nunca se rellena.

Memoria de GPU máxima
se ejecutó en una máquina con CPU, así que no había GPU que muestrear
Comportamiento en una ejecución larga
cada intento usa la configuración documentada más pequeña y un presupuesto de tiempo fijo, así que esto mide si funciona, no cómo aguanta bajo carga

El final de la grabación

Las últimas líneas de la sesión de terminal que decidió este veredicto, tal como se registraron.

1. **Install**: Created `.venv`, installed `scripts/requirements-dev.txt` (all 32 packages) — succe…
2. **Error found #1**: Test suite had 2 failures because the system Node.js is v18.19.1 but Pele 1.…
   - **Fix**: Installed Node.js 20.18.0 via pre-commit's bundled `nodeenv` into `.nodeenv/`, prepen…
   - Result: `175 passed` (was 172 passed / 2 failed / 1 skipped).
3. **Verified real artifacts**:
   - `scripts/build_epub.py --verbose` → `claude-howto-guide.epub` (499 KB, 139 entries, 76 chapter…
   - `scripts/check_epub_diagrams.py` → 54 Pele-rendered diagrams, 62 references, 0 placeholders.
   - `scripts/build_website.py` → `site/` with 200s on `/`, `/01-slash-commands/index.html`, `/asse…
   - `scripts/check_mermaid.py --strict` → 286 blocks (115 unique) rendered.
   - `scripts/check_cross_references.py` → 479 files valid; `check_links.py` → 215 URLs reachable.
   - `ruff check` passed; `mypy --config-file scripts/pyproject.toml` passed (19 files); `bandit` 0…
4. **Gaps recorded**: `pre-commit run --all-files` requires `python3.11` (unavailable in container,…

Reproducir la sesión completa, cada comando desde una máquina limpia hasta este punto.

Cómo se probó

Un agent, un contenedor, sin ayuda humana. Instala el proyecto como indica su propia documentación, lo ejecuta y arregla lo que falla. Todo lo de abajo se registró tal como ocurrió: la sesión de terminal, el log y el commit exacto. La metodología completa.

Puntos fuertes y límites

Hechos medidos, no opiniones. Cómo se redacta.

Qué salió bien

  • Llegó a funcionar en una máquina limpia, con la sesión grabada.
  • Se instaló en 3 minutos.
  • Se recuperó de su único error sin que interviniera una persona, lo que indica que el fallo está lo bastante documentado como para resolverlo.
  • Funcionó sin GPU, así que no necesita una para arrancar.
  • Licencia MIT, según su plataforma de origen.
  • Medido 2 veces, así que el resultado no es algo puntual.

De los 21 proyectos de claude-code que Argusic ha instalado y cronometrado, claude-howto fue el 10.º más rápido en llegar a funcionar, y 20 de 21 llegaron a funcionar.

Para qué es una opción razonable

  • Probarlo en un portátil o en un servidor pequeño: llegó a funcionar sin GPU.
  • Una evaluación rápida: estaba funcionando 3 minutos después del clon.

También probados, en la misma área

Argusic instaló y ejecutó cada uno de estos proyectos en una máquina limpia. Aquí no aparece nada que no se haya probado.

Historial de ejecuciones

probado porintentoresultadopuntuacióncosto USDcuándo
Argusic Runner2/3Funciona100,000,09
Argusic Runner1/3Funciona100,000,02

Temas (de GitHub)

claude-codeguidetutorial

Insertar el badge

Markdown para el README del proyecto. Enlaza de vuelta aquí; condiciones en la página de términos.

[![Tested by Argusic](https://argusic.com/badge/claude-howto.svg)](https://argusic.com/subject/claude-howto)

Preguntas

¿Funciona claude-howto?
Sí. claude-howto funciona. Argusic lo instaló y lo inició en una máquina limpia en 3 minutos, con 1 error por el camino, y grabó la sesión.
¿Cómo probó Argusic claude-howto?
En una máquina limpia y desechable, con cada comando grabado y el repositorio fijado en el commit 188f46889323. Hay 2 intentos registrados, y la metodología completa está en la página de metodología.
¿Cuánto costó probar claude-howto?
La ejecución que produjo este veredicto costó 0,09 USD: costo real de cómputo y de modelo, no un precio de lista por millón de tokens. Consta en la página de esa ejecución.
¿Cuánto tarda claude-howto en instalarse?
3 minutos en la ejecución que decidió este veredicto, desde una máquina limpia hasta que funcionó. Es un intento medido, no una media.
¿Necesita claude-howto una GPU?
No para arrancar. Argusic consiguió que funcionara en una máquina sin GPU.
¿Qué falla al instalar claude-howto?
En la ejecución registrada falló 1 cosa, y 1 se corrigió sin ayuda humana. Cada una, con el tiempo que costó, aparece en esta página.
¿Cómo se compara claude-howto con las alternativas?
De los 21 proyectos de claude-code que Argusic ha instalado y cronometrado, claude-howto fue el 10.º más rápido en llegar a funcionar, y 20 de 21 llegaron a funcionar.
¿Dónde está la evidencia de claude-howto?
Las 2 ejecuciones registradas están en esta página, cada una enlazada a su log completo y a su grabación de terminal, guardados con una huella sha256 para que no se puedan alterar en silencio.

Discussion