Claude How To: la guía visual y práctica para dominar Claude Code
luongnv89/claude-howto · 41.663★ · 5.110 forks
Todo lo que hay que saber sobre luongnv89/claude-howto: una guía estructurada y visual, de diez módulos y con plantillas listas para copiar, que enseña a combinar todos los mecanismos de Claude Code —comandos slash, memoria, skills, subagentes, MCP, hooks, plugins y checkpoints— en flujos de trabajo reales.
Desambiguación: este informe documenta el repositorio
luongnv89/claude-howtode Luong NGUYEN. No debe confundirse con la expresión genérica «claude how to», con los hilos de Reddit sobre «cómo conectar Claude Desktop con servidores MCP», ni con las decenas de tutoriales y listados que comparten las mismas palabras clave. Aquí se analiza únicamente el repositorio de primera parte del autor.
Qué es Claude How To
Claude How To es una guía didáctica de código abierto, no una herramienta, un framework ni un servicio. El producto es un repositorio de Markdown organizado en diez módulos de tutorial —comandos slash, memoria, checkpoints, CLI, skills, hooks, MCP, subagentes, funciones avanzadas y plugins—, cada uno con explicaciones, diagramas Mermaid y plantillas de configuración listas para copiar en el propio proyecto. Su eslogan, tomado del README, es «Master Claude Code in a Weekend» (Dominar Claude Code en un fin de semana).
Su objetivo declarado es cerrar la brecha entre saber que una función existe y saber cómo combinarla. El README la formula con precisión: la documentación oficial de Anthropic describe las características, pero no muestra cómo encadenarlas en un flujo; no hay una ruta de aprendizaje clara (¿MCP antes que hooks? ¿skills antes que subagentes?); y los ejemplos oficiales son demasiado básicos para construir, por ejemplo, un pipeline de revisión de código de producción. La guía se presenta como el complemento práctico de la documentación oficial: «empieza aquí para aprender, consulta los docs cuando necesites detalles».
A diferencia de un simple listado de recursos, el repositorio propone una ruta progresiva con estimaciones de tiempo (el recorrido completo suma 11-13 horas) y una autoevaluación integrada: el propio repositorio incluye dos skills (lesson-quiz y self-assessment) que se ejecutan dentro de Claude Code con /self-assessment o /lesson-quiz <tema> para detectar lagunas de conocimiento.
El origen
El repositorio fue creado el 7 de noviembre de 2025 por Luong NGUYEN (luongnv89), ingeniero de software de París (Francia) cuyo perfil de GitHub lo describe como «Software Engineer / AI, Cybersecurity / Learn, Build, Share and Connect», vinculado a Montimage (montimage.com), con blog en luongnv.com y 141 repositorios públicos. La cuenta de GitHub existe desde 2013.
El contexto del lanzamiento es relevante: Claude Code (la herramienta de línea de comandos de Anthropic) se había popularizado, pero su superficie funcional —comandos slash, memoria, hooks, subagentes, MCP, plugins— crecía más rápido que las guías de uso. Claude How To nació como respuesta a ese vacío: un único lugar donde ver, con diagramas y ejemplos de producción, cómo encajan todas las piezas. Su primera aparición verificable en la conversación pública es el envío de Hacker News de 25 de diciembre de 2025.
El mantenimiento es un rasgo definitorio del proyecto: el README declara que la guía está sincronizada con cada lanzamiento de Claude Code (el sitio oficial del proyecto cita «latest: v2.1.235, August 2026»), y el historial de issues lo confirma: hay una serie de PR de mantenimiento tituladas «[DOCS] Sync tutorial to Claude Code v2.1.1xx» abiertas por el propio luongnv89 en agosto de 2026.
Filosofía y principios
El README expone una filosofía didáctica explícita, resumida en la tabla comparativa «Official Docs vs This Guide»:
- Visual y guiado por ejemplos: diagramas Mermaid que muestran cómo funciona cada función «por dentro», de modo que se entienda el porqué y no solo el cómo.
- Plantillas de producción, no hello world: todo ejemplo debe ser «copy-paste ready» y útil de inmediato (comandos slash, plantillas de
CLAUDE.md, scripts de hooks, configuraciones MCP, definiciones de subagentes, bundles de plugins). - Ruta progresiva con evaluación: diez módulos que se construyen uno sobre otro, con autoevaluación para personalizar el recorrido y comprobar la comprensión tras cada módulo.
- Combinación de funciones como unidad de valor: el README insiste en que «el verdadero poder está en combinar funciones»: encadenar comandos slash + memoria + subagentes + hooks en pipelines automatizados de revisión de código, despliegue y generación de documentación.
- Libre y permanente: licencia MIT, «gratuito para siempre».

Cómo funciona
La estructura del repositorio tiene diez carpetas numeradas, una por módulo, más archivos de soporte (CATALOG.md como catálogo de referencia, LEARNING-ROADMAP.md como mapa de ruta, resources.md, QUICK_REFERENCE.md y claude_concepts_guide.md).
| Orden | Módulo | Nivel | Tiempo |
|---|---|---|---|
| 1 | 01-slash-commands | Principiante | 30 min |
| 2 | 02-memory | Principiante+ | 45 min |
| 3 | 08-checkpoints | Intermedio | 45 min |
| 4 | 10-cli | Principiante+ | 30 min |
| 5 | 03-skills | Intermedio | 1 h |
| 6 | 06-hooks | Intermedio | 1 h |
| 7 | 05-mcp | Intermedio+ | 1 h |
| 8 | 04-subagents | Intermedio+ | 1,5 h |
| 9 | 09-advanced-features | Avanzado | 2-3 h |
| 10 | 07-plugins | Avanzado | 2 h |

Memoria, checkpoints y CLI forman el trío de fundamentos: la memoria persiste contexto de proyecto entre sesiones, los checkpoints marcan puntos de retorno seguros y la CLI permite operar Claude Code en modo headless para automatización.

Las skills y los hooks son el par que convierte funciones reutilizables en automatización disparada por eventos: una skill encapsula una capacidad (revisión de código, generación de documentación) y un hook la activa en un punto del ciclo de vida (pre-commit, post-despliegue).

El flujo de uso previsto en cuatro pasos: (1) hacer la autoevaluación (/self-assessment) o elegir nivel (principiante/intermedio/avanzado con punto de partida sugerido); (2) seguir la ruta guiada copiando plantillas al proyecto; (3) combinar funciones en flujos de trabajo; (4) ejecutar /lesson-quiz <tema> al terminar cada módulo.
Ejemplos de flujo que documenta el README:
- Revisión de código automatizada (slash commands + subagents + memory + MCP): el usuario escribe
/review-pr; Claude carga la memoria del proyecto, obtiene el PR vía GitHub MCP, delega en un subagentecode-reviewery en otrotest-engineer, y sintetiza los hallazgos.

- Despliegue DevOps (plugins + MCP + hooks):
/deploy productionejecuta un hook pre-despliegue, delega en un subagente de despliegue, opera Kubernetes vía MCP y cierra con un hook post-despliegue.

Dos skills viven dentro del propio repositorio, en .claude/skills/: lesson-quiz (v1.1.0, autor Luong NGUYEN): cuestionario interactivo de 8-10 preguntas por lección (01-10), con banco de preguntas en references/question-bank.md. Sus guardarraíles declarados: «nunca inventar preguntas ni respuestas»; si falta el README de la lección o el banco, avisa en lugar de fabricar contenido. self-assessment: evaluación inicial para personalizar la ruta de aprendizaje.

Estado oficial y semioficial
Claude How To es un proyecto comunitario independiente, sin relación formal con Anthropic. No hay ninguna de las señales de aceptación oficial que sí tienen otros proyectos:
- No está en el marketplace oficial de plugins de Claude Code (no se instala con
/plugin), y ninguna fuente consultada en esta ejecución muestra un respaldo de Anthropic. - Sí tiene presencia en listados curados de referencia: el listado
hesreallyhim/awesome-claude-code(52.819 estrellas) lo incluye explícitamente como «una guía estructurada por capítulos para empezar con Claude Code, con autoevaluación y una ruta de aprendizaje progresiva de diez módulos». Esa inclusión en uno de los listados más citados del ecosistema de Claude Code le da un estatus de facto como punto de partida para muchos nuevos usuarios, sin que exista ninguna designación formal de estándar. - Su sitio oficial (
luongnv.com/claude-howto/) es un espejo web del repositorio titulado «Master Claude Code in a Weekend», mantenido por el propio autor.
En la práctica: funciona como referencia comunitaria de facto para el onboarding en Claude Code, pero el lector debe tratarlo como material de un tercero que se sincroniza con las versiones de la herramienta oficial.
El ecosistema
Repositorios hermanos del mismo autor: luongnv89/skills — «Potencia tus agentes/bots con skills reutilizables»; instalación con un comando y compatible con Claude Code, Cursor, Windsurf, GitHub Copilot, OpenAI Codex, OpenCode y Google Antigravity; 117 estrellas. luongnv89/asm — «el gestor de skills universal para agentes de código de IA» (TUI/CLI agent-skill-manager); 891 estrellas. luongnv89/context-stats — «entiende cómo usas Claude Code y gasta menos haciéndolo»; 115 estrellas. luongnv89/music-cli — reproductor de música en línea de comandos para programadores; 81 estrellas. luongnv89/ccl — cambio de modelo manteniendo la configuración; 38 estrellas.

Skills embebidas en el repositorio: el propio claude-howto contiene en .claude/skills/ las skills lesson-quiz y self-assessment, que convierten al repositorio en un curso autoevaluado: no solo se lee, se pone a prueba dentro de Claude Code.
Bifurcaciones, traducciones y derivados: las bifurcaciones de mayor star-count devueltas por la API son, en la práctica, réplicas personales de aprendizaje: Shubhamsaboo/claude-howto (19 estrellas), akolaarthurali/claude-howto-Master-Claude-Code-in-a-Weekend (11 estrellas), Pgooone/claude-howto (7 estrellas). No se encontró un fork de gran escala ni una comunidad de traducción paralela comparables a los de otros repos. Las traducciones oficiales viven dentro del mismo repositorio (translations/), no como repos separados. El README lista módulos traducidos a chino, español, francés, alemán, ucraniano, ruso, japonés, coreano, portugués, vietnamita, hindi, árabe y tamil.
Listados curados y guías competidoras del mismo nicho: hesreallyhim/awesome-claude-code (52.819 estrellas, listado a mano de recursos), ComposioHQ/awesome-claude-skills (73.024 estrellas) y VoltAgent/awesome-agent-skills (30.918 estrellas) — listados de skills, el ecosistema que los módulos 03/07 de la guía enseñan a usar. wesammustafa/Claude-Code-Everything-You-Need-to-Know (2.679 estrellas, competidor directo en formato). peterkrueck/Claude-Code-Development-Kit (1.380 estrellas). xianyu110/awesome-claudcode-tutorial (594 estrellas, «el tutorial más completo de Claude Code en chino»).
Números del repo
Medición: 22 de agosto de 2026, API de GitHub.
| Métrica | Valor |
|---|---|
| Estrellas | 41.155 |
| Bifurcaciones | 5.029 |
| Suscriptores reales | 185 |
| Commits | 244 |
| Incidencias + PR abiertos | 29 |
| Lenguaje principal | Python (guiones de soporte) |
| Licencia | MIT |
| Creación | 7 de noviembre de 2025 |
| Último push | 19 de agosto de 2026 |
| Último release formal | v2.1.160, 2 de junio de 2026 |
watchers_count replica las estrellas, por lo que se informa subscribers_count como suscriptores reales. El esquema de tags es inusual: los releases se nombran por versión de Claude Code a la que se sincroniza la guía, mezclados con tags propios. El README y el sitio citan versiones distintas entre sí (README: «v2.1.220, July 2026»; sitio: «v2.1.235, August 2026»), lo que refleja el mantenimiento continuo del texto.
Principales contribuidores por contribuciones: luongnv89 (189), edocltd (20), toanalien (4), lzw-git-all (4), wjhrdy (3), xiaolai (3). El autor concentra alrededor del 75 % de las contribuciones; los colaboradores recurrentes trabajan sobre todo en traducciones y en el banco de preguntas de las quizzes.
Guía rápida de uso
Instalación y primer arranque
Prerrequisito: tener Claude Code instalado. Nota del README: desde v2.1.113 Claude Code se distribuye como binario nativo por plataforma; npm install -g @anthropic-ai/claude-code sigue funcionando. Desde v2.1.116 las descargas vienen de https://downloads.claude.ai/claude-code-releases, así que los proxies corporativos deben permitir ese dominio.
El «arranque» de la guía es copiar plantillas al propio proyecto (15 minutos, según el README):
# 1. Clonar la guía
git clone https://github.com/luongnv89/claude-howto.git
cd claude-howto
# 2. Copiar el primer comando slash a tu proyecto
mkdir -p /path/to/your-project/.claude/commands
cp 01-slash-commands/optimize.md /path/to/your-project/.claude/commands/
# 3. Probarlo: en Claude Code escribir
# /optimize
# 4. Establecer memoria del proyecto
cp 02-memory/project-CLAUDE.md /path/to/your-project/CLAUDE.md
# 5. Instalar un skill
cp -r 03-skills/code-review-specialist ~/.claude/skills/
El README ofrece además un setup esencial de 1 hora y deja el resto (hooks, subagentes, MCP, plugins) como objetivo del «fin de semana», siguiendo LEARNING-ROADMAP.md. Para lectura offline, el README documenta uv run scripts/build_epub.py para generar un EPUB con todo el contenido.
Flujos de trabajo habituales
- Autoevaluación y ruta personalizada. Escribir
/self-assessmentdentro de Claude Code; el resultado es un mapa personalizado según lo que ya sabes. - Primer comando slash. Copiar
01-slash-commands/optimize.mda.claude/commands/y escribir/optimize. - Memoria de equipo. Copiar
02-memory/project-CLAUDE.mdcomoCLAUDE.mden la raíz del proyecto; se carga automáticamente en cada sesión. - Cuestionario de lección. Escribir
/lesson-quiz hooks(u otra lección); el skill usa solo el bancoreferences/question-bank.md, corrige pregunta a pregunta y señala los puntos débiles. - Módulo CLI sin instalación. La lección
10-cli/documenta el modo headlessclaude -p "review this code", salida JSON y el reanudado de sesiones.
Configuración esencial
Los archivos y ajustes que un usuario nuevo tocará primero: CLAUDE.md (raíz del proyecto, memoria persistente), .claude/commands/ (comandos slash del proyecto), ~/.claude/skills/ (skills personales), .mcp.json (configuración de servidores MCP) y ~/.claude/settings.json (configuración avanzada, modos de permiso).
Trampas frecuentes y soluciones
- Proxy corporativo bloqueando Claude Code. Desde v2.1.116 las descargas del binario nativo vienen de
downloads.claude.ai/claude-code-releases; si el primer uso falla en una red corporativa, permitir ese dominio en el proxy. - Build del EPUB falla sin Mermaid CLI. El build del EPUB exige
mmdc; solución: instalarnpm install -g @mermaid-js/mermaid-cliantes deuv run scripts/build_epub.py. - Desincronización entre lecciones, quizzes y traducciones. Dado que la guía se sincroniza con cada release de Claude Code, hay una cola constante de PRs de coherencia. Si se detecta una contradicción, la solución habitual del proyecto es abrir una PR de sincronización.
- Traducción china menos detallada que el inglés. Se trata cada traducción como contenido a sincronizar continuamente.
- No usar la guía como referencia de versiones. Para la versión exacta soportada, fijarse en los PRs de sincronización recientes, no en el texto estático.
Integraciones y migración
- Con Claude Code (núcleo): toda la guía es configuración de Claude Code; los módulos producen artefactos que Claude Code consume nativamente.
- Con CI/CD: la lección 10 documenta el modo headless (
claude -p) y el modo JSON para embeber Claude Code en pipelines. - Con el ecosistema de skills del autor: los skills que la lección 03 enseña a crear pueden gestionarse con
luongnv89/skillsoluongnv89/asm. - Con Claude Code en otros idiomas: las traducciones internas permiten seguir la ruta en trece idiomas sin salir del repositorio.
- Migración de la documentación oficial a esta guía: la documentación oficial de Anthropic es una referencia de funciones; esta guía es el tutorial con plantillas. No existe un mecanismo de migración formal porque ambos son material de lectura, no software.
Cómo contribuir
CONTRIBUTING.md documenta un proceso completo: tipos de contribución aceptados (nuevos ejemplos, mejoras de documentación, guías de nuevas funciones, informes de incidencias, sugerencias); fork y rama descriptiva; entorno de desarrollo (pip install uv, uv venv, npm install -g markdownlint-cli y @mermaid-js/mermaid-cli, pre-commit install); pruebas (unitarias con pytest, cobertura, seguridad con bandit, verificación del build de EPUB); pull request con descripción clara.
Cómo lo recibió la comunidad
La evidencia recuperada muestra un proyecto de muy alta adopción relativa a su edad (41.155 estrellas ~9 meses después de su creación) pero de baja visibilidad en foros de discusión, con una crítica comunitaria concreta y verificable.
En Hacker News, el envío «Claude-How To» de handfuloflight (25 de diciembre de 2025) reunió 3 puntos y 0 comentarios; «Complete Guide to Claude Concepts» de rob (3 de febrero de 2026) reunió 1 punto y 0 comentarios. No se encontró ningún hilo de Hacker News con discusión amplia verificable.
La conversación técnica real vive en GitHub. La incidencia #103, abierta por xiaoweizano el 28 de abril de 2026 (4 comentarios), pregunta en chino por qué la documentación en inglés es más detallada que la china; es la objeción comunitaria más concreta verificada en esta ejecución. jeffreyyjp (PR #106) detectó que la respuesta de la pregunta Q2 de memoria contradecía el README porque el prefijo # fue discontinuado; HuberttFox ha abierto varias PRs de coherencia entre quizzes, README y traducción al chino, un patrón de revisión por pares comunitaria activo en julio-agosto de 2026. Además, hesreallyhim/awesome-claude-code lo lista con una descripción positiva, lo que funciona como señal de recomendación entre usuarios del ecosistema.
En conjunto: la comunidad consume la guía (estrellas, forks, PRs de sincronización y correcciones) más de lo que la debate; la crítica verificable y reiterada gira en torno a la coherencia entre versiones de Claude Code, lecciones, quizzes y traducciones, un riesgo inherente a un manual que persigue un objetivo móvil.
Claude How To frente a otras propuestas
| Propuesta | Coincidencia verificable | Diferencia verificable |
|---|---|---|
| Documentación oficial de Anthropic (Claude Code) | Cubre las mismas funciones (slash commands, memoria, hooks, MCP, subagentes, plugins). | Es referencia de funciones; el README de claude-howto la describe explícitamente como complementaria, no sustitutiva: sin rutas de aprendizaje, sin plantillas de producción ni autoevaluación. |
wesammustafa/Claude-Code-Everything-You-Need-to-Know (2.679 ⭐) | Guía práctica de Claude Code con «modelos mentales claros y ejemplos copiables». | Proyecto independiente del autor; claude-howto aporta además diagramas Mermaid, autoevaluación ejecutable dentro de Claude Code y sincronización declarada con cada release. |
peterkrueck/Claude-Code-Development-Kit (1.380 ⭐) | Flujo de trabajo de Claude Code para principiantes e intermedios, con tutorial e instalador. | Orientado a un flujo de desarrollo concreto (con instalador), no a un recorrido de diez módulos con quiz por lección. |
hesreallyhim/awesome-claude-code (52.819 ⭐) | Recurso sobre Claude Code muy popular. | Es un listado curado de recursos (que incluye a claude-howto), no una guía con plantillas ni ruta de aprendizaje. |
La comparación más útil no es por estrellas: claude-howto destaca cuando se quiere una única guía con plantillas copiables, diagramas y autoevaluación que cubra todas las funciones de Claude Code en un solo repositorio.
Casos de uso y a quién puede ayudar este repositorio
- Desarrolladores que acaban de instalar Claude Code pueden seguir la ruta de 15 minutos para obtener valor inmediato y luego la ruta completa de 11-13 horas para cubrir comandos slash, memoria, skills, hooks, MCP, subagentes y plugins sin perderse entre funciones.
- Equipos que estandarizan su uso de Claude Code pueden partir de las plantillas de
CLAUDE.md, de las configuraciones de.mcp.jsonde la lección 05 y de los hooks de la lección 06 para fijar estándares de equipo y automatizaciones repetibles. - Ingenieros de CI/CD pueden usar la referencia de la lección 10 (modo headless, salida JSON, reanudado de sesiones) para integrar Claude Code en pipelines.
- Formadores y creadores de contenido técnico encuentran en el formato una estructura replicable para sus propios cursos; la licencia MIT lo permite explícitamente.
- Usuarios de Claude Code en otros idiomas pueden seguir la guía traducida internamente sin depender de terceros.
Recursos
- Repositorio: https://github.com/luongnv89/claude-howto
- Sitio oficial: https://luongnv.com/claude-howto/
- Ruta de aprendizaje: https://github.com/luongnv89/claude-howto/blob/main/LEARNING-ROADMAP.md
- Catálogo de funciones: https://github.com/luongnv89/claude-howto/blob/main/CATALOG.md
- Skills del autor: https://github.com/luongnv89/skills · https://github.com/luongnv89/asm
- Listado que lo incluye: https://github.com/hesreallyhim/awesome-claude-code
Nota: este artículo combina el README, CONTRIBUTING.md, los releases y la API de GitHub de luongnv89/claude-howto, el perfil de GitHub y los repositorios del autor Luong NGUYEN, la búsqueda de Hacker News y la API de búsqueda de repositorios de GitHub, consultadas el 22 de agosto de 2026. Las cifras de estrellas, bifurcaciones, contribuciones y commits cambian con el tiempo.
Comentarios