- Prefacio
-
Introducción
- Por qué esta guía
- A quién va dirigida
- Qué encontrarás
- Qué no encontrarás
- Cómo leerla
- Cómo se ha escrito esta guía
- Comentarios y fe de erratas
-
1. Qué es Claude Code
- 1.1 Una breve historia
- 1.2 Claude Code frente a Lovable, Replit y otros entornos de IA
- 1.3 Cuándo conviene usarlo
- 1.4 La curva de aprendizaje
- 1.5 La línea temporal de los modelos Claude
- 1.6 Modelo y harness: qué convierte un modelo en un agente
- 1.7 Del prompt engineering al graph engineering
-
2. Instalación y configuración
- 2.1 Planes compatibles
- 2.2 Requisitos del sistema
- 2.3 Instalación en macOS y Linux
- 2.4 Instalación en Windows
- 2.5 Instalación mediante WSL2 (recomendada en Windows)
- 2.6 Instalación alternativa mediante npm
- 2.7 Comprobar la instalación
- 2.8 Autenticación
-
3. El primer proyecto de principio a fin
- 3.1 Paso 1: sitúate en el directorio del proyecto
- 3.2 Paso 2: inicializa el proyecto
- 3.3 Paso 3: revisa y personaliza CLAUDE.md
- 3.4 Paso 4: primera petición
- 3.5 Paso 5: sal de la sesión
- 3.6 Paso 6: retoma donde lo dejaste
-
4. Comandos y atajos esenciales
- 4.1 La sintaxis de comandos: por qué funciona así
- 4.2 Flags de CLI esenciales
- 4.3 Flags de CLI avanzados
- 4.4 Slash commands: el corazón de la sesión interactiva
- 4.5 Slash commands esenciales
- 4.6 Slash commands para workflows concretos
- 4.7 Atajos de teclado
- 4.8 La sintaxis @, !, / — los tres prefijos que lo cambian todo
-
5. Plan Mode: pensar antes de escribir
- 5.1 Por qué es importante
- 5.2 Cómo activarlo
- 5.3 Herramientas disponibles en Plan Mode
- 5.4 Ejemplo de workflow con Plan Mode
- 5.5 opusplan: el modelo adecuado para cada cosa
-
6. Prompt engineering: escribir prompts eficaces
- 6.1 Qué es el prompt engineering y por qué importa en la CLI
- 6.2 Anatomía de un prompt bien hecho
- 6.3 De los roles a las restricciones estructurales (la revolución de 2026)
- 6.4 Las técnicas fundamentales
- 6.5 Particularidades de Claude Code frente al chat
- 6.6 Los modelos de la generación 5: qué quitar de los prompts y qué añadir
- 6.7 Ejemplos de antes y después
- 6.8 Antipatrones comunes
- 6.9 Promover un prompt: cuándo pasa a CLAUDE.md o a un custom command
- 6.10 Prompt library: archivar y versionar
-
7. Memoria persistente: CLAUDE.md y Auto Memory
- 7.1 Generar CLAUDE.md con /init
- 7.2 Qué poner en CLAUDE.md
- 7.3 Ejemplo 1: plugin de WordPress
- 7.4 Ejemplo 2: proyecto Node/TypeScript genérico
- 7.5 CLAUDE.md jerárquicos
- 7.6 La lección de Karpathy y las cuatro reglas de Forrest Chang
- 7.7 Auto Memory: qué es y qué cambia
- 7.8 Requisitos y activación
- 7.9 Dónde viven las memorias
- 7.10 Anatomía de la carpeta memory
- 7.11 Auto Memory y subagents
- 7.12 Cuándo desactivarla
- 7.13 CLAUDE.md frente a Auto Memory: cuándo usar cada uno
-
8. Gestión del contexto
- 8.1 Qué es el contexto y por qué importa
- 8.2 Qué pesa en el contexto
- 8.3 Señales de contexto saturado
- 8.4 El comando /context: leer y actuar
- 8.5 Compresión: /compact y /clear
- 8.6 Subagents: la estrategia estructural
- 8.7 Modelos con ventana de 1M tokens: cuándo pasarse
- 8.8 Regla práctica y mentalidad
- 8.9 Elegir la arquitectura adecuada: tabla de decisión
- 8.10 Prompt cache y observabilidad del consumo
-
9. Seguridad, permisos y guardarraíles
- 9.1 Los guardarraíles de Claude Code: defensa en profundidad
- 9.2 El sistema de permisos
- 9.3 Configurar los permisos en settings.json
- 9.4 Proteger los secretos
- 9.5 Modos peligrosos
- 9.6 Prompt injection
- 9.7 Los tests como guardarraíl de corrección
- 9.8 Sandbox y managed settings
-
10. Skills: el mecanismo de extensión
- 10.1 Cómo funciona una Skill
- 10.2 Skills incluidas y el repositorio anthropics/skills
- 10.3 Skills de la comunidad: una selección comentada
- 10.4 Instalar y gestionar las skills
- 10.5 Crear una Skill personalizada
- 10.6 Seguridad de las skills de terceros
-
11. MCP: integrar servicios externos
- 11.1 Qué es MCP y por qué existe
- 11.2 Arquitectura del protocolo
- 11.3 Configurar un servidor MCP existente
- 11.4 Servidores MCP útiles: una selección comentada
- 11.5 Crear un servidor MCP desde cero: publicar en WordPress
- 11.6 Seguridad y consideraciones operativas
- 11.7 Gestionar el coste de los servidores MCP en el contexto
-
12. Subagents: orquestar trabajo especializado
- 12.1 Qué son y por qué te hacen falta
- 12.2 Subagent frente a agente principal: la diferencia concreta
- 12.3 Los subagents integrados
- 12.4 Crear un subagent personalizado
- 12.5 Jerarquía de precedencia
- 12.6 Invocación automática frente a explícita
- 12.7 Paralelismo: patrones de delegación múltiple
- 12.8 Optimización de costes mediante model routing
- 12.9 Cuándo NO usarlos
- 12.10 Subagents, Skills y Hooks en comparación
-
13. Hooks: automatizar el ciclo de vida de Claude Code
- 13.1 Qué son y para qué sirven
- 13.2 Anatomía de un hook
- 13.3 Eventos del ciclo de vida
- 13.4 Matchers e inspección (/hooks)
- 13.5 Entrada y salida
- 13.6 Ejemplos prácticos
- 13.7 Seguridad
- 13.8 Trampas y cuándo NO usarlos
-
14. Plugins: paquetes distribuibles
- 14.1 Mecanismos de extensión de Claude Code: un mapa
- 14.2 Qué es un plugin y por qué existe
- 14.3 Anatomía de un plugin
- 14.4 Plugin marketplace
- 14.5 Crear un plugin personalizado
- 14.6 Distribuir un plugin
- 14.7 Seguridad de los plugins de terceros
- 14.8 Mods: plugins que cambian Claude Code desde dentro
-
15. Workflows avanzados y consejos
- 15.1 Onboarding en un repositorio existente
- 15.2 Caza de bugs con TDD
- 15.3 Refactorización segura
- 15.4 Auditoría de rendimiento
- 15.5 Vim mode
- 15.6 Custom slash commands
- 15.7 Modo headless para CI/CD
- 15.8 Resumen de las sesiones
- 15.9 Checkpoints de Git estratégicos
- 15.10 Fork de la conversación
- 15.11 Orquestación a gran escala: los workflows dinámicos
- 15.12 Dar un objetivo verificable: /goal
- 15.13 Más allá del terminal: sesiones paralelas, programadas y remotas
-
16. Los harness: Claude Code y los otros agentes de programación
- 16.1 Criterios de comparación: el esquema común
- 16.2 Claude Code (Anthropic)
- 16.3 OpenAI Codex
- 16.4 OpenCode
- 16.5 Tabla comparativa
- 16.6 El resto del panorama
- 16.7 Cómo elegir
-
17. Conclusiones: por qué la CLI y no solo el chat
- 17.1 Contexto persistente: dejar de presentarse cada vez
- 17.2 Autonomía agéntica: ejecuta, no solo sugiere
- 17.3 Integración en el workflow real
- 17.4 Cuándo el chat sigue siendo la opción correcta
- 17.5 En resumen
- Epílogo
- Anexo A — Glosario
- Anexo B — Fuentes
- Anexo C — Notas de la versión
- Anexo D — Cronología de los modelos
- Sobre el autor
Claude Code
Una guía práctica para empezar a usar Claude Code de forma profesional
Una guía práctica de Claude Code, escrita con Claude Code.
Más de 300 páginas basadas en la documentación oficial de Anthropic y verificadas con Claude Code v2.1.311: de la instalación al Plan Mode, CLAUDE.md, la gestión del contexto, los permisos, las Skills, los subagents, los hooks, MCP y los plugins, con ejemplos reales en WordPress y Node.js en lugar de demos de presentación. Se abre con un prefacio escrito por Claude Opus, que leyó el manuscrito y lo comentó sin complacencia.
El libro es gratuito: precio libre con un mínimo de 0 $, tú decides si contribuyes y cuánto. La licencia Creative Commons BY-SA 4.0 te permite redistribuirlo y modificarlo, siempre que cites la fuente y conserves la misma licencia.
This book is a translation into Spanish of Claude Code which was originally written in Italian
Minimum price
Free!
$7.00
You pay
Author earns
PDF
About
About the Book
Versión 6.2 (octubre de 2026). Esta edición en español es la traducción de la edición italiana original, revisada capítulo a capítulo y actualizada en octubre de 2026 sobre la documentación oficial de Anthropic y sobre Claude Code v2.1.311: un capítulo nuevo sobre los harness (Claude Code y los otros agentes de programación), secciones nuevas sobre la sandbox y los managed settings, los mods, las sesiones paralelas, programadas y remotas, y el paso del prompt engineering al graph engineering.
Claude Code es la CLI agéntica de Anthropic que vive en el terminal del desarrollador: lee el código, ejecuta comandos y respeta las convenciones del proyecto.
Esta guía práctica, pensada para quien quiere empezar a usarlo de forma profesional, cubre la instalación y la configuración, los comandos del día a día, el Plan Mode, el prompt engineering, la gestión del contexto y de los permisos, los hooks, los servidores MCP, los subagents y las Skills personalizadas.
Todos los contenidos están comprobados en la documentación oficial de Anthropic. Ejemplos concretos en PHP, JavaScript y WordPress. Sin hype: cada capítulo dice dónde la herramienta merece de verdad la pena y dónde no.
Para desarrolladores web que se manejan con el terminal y Git, profesionales que quieren integrar la IA en su trabajo con conocimiento de causa y equipos técnicos que evalúan la adopción de herramientas de IA agéntica en sus procesos de desarrollo.
Feedback
This book is a translation into Spanish of Claude Code which was originally written in Italian
Author
About the Author
Maurizio Pelizzone
Mi chiamo **Maurizio Pelizzone**, sono Senior Software Architect, Co-titolare di **Mavida snc** (Torino) dal 2001 e formatore tecnico specializzato nell'ecosistema WordPress. In oltre vent'anni ho progettato e portato in produzione più di 200 progetti web per clienti nazionali, specializzandomi in architetture WordPress enterprise, sviluppo plugin e temi custom, migrazioni di piattaforme legacy e ottimizzazione performance/security. Dal 2010 sono **Speaker ricorrente ai WordCamp italiani** (Milano, Bologna, Torino, WordCamp Italia), con talk su Custom Post Types, Hardening & Security, Solutions Architecture e Full Site Editing. **Dal 2023 ho aggiunto un "superpotere" al mio workflow: l'Intelligenza Artificiale**, usandola come leva strategica per scrivere codice più pulito, scalabile e intelligente. Non come sostituto del mestiere, ma come amplificatore: vent'anni di PHP, WordPress e architetture software mi permettono di distinguere un suggerimento brillante da una scorciatoia rischiosa, e di dirigere l'AI verso soluzioni che reggono il peso della produzione. Oggi affianco alla consulenza tecnica per PMI e aziende nazionali un'attività di **formazione su AI tools, prompt engineering, vibe coding e automazione con N8N**, convinto che la combinazione tra esperienza artigianale del codice e utilizzo consapevole dell'AI sia la direzione in cui il nostro mestiere sta evolvendo. Questa guida nasce da quella convinzione: uno strumento come Claude Code non sostituisce lo sviluppatore, ma cambia il modo in cui lavora. Per usarlo bene servono le stesse virtù di sempre — rigore, curiosità, capacità di verificare — più un po' di disciplina nuova.
Translations
Translations
Contents
Table of Contents
The Leanpub 60 Day 100% Happiness Guarantee
Within 60 days of purchase you can get a 100% refund on any Leanpub purchase, in two clicks.
See full terms...
Earn $8 on a $10 Purchase, and $16 on a $20 Purchase
We pay 80% royalties on purchases of $7.99 or more, and 80% royalties minus a 50 cent flat fee on purchases between $0.99 and $7.98. You earn $8 on a $10 sale, and $16 on a $20 sale. So, if we sell 5000 non-refunded copies of your book for $20, you'll earn $80,000.
(Yes, some authors have already earned much more than that on Leanpub.)
Learn more about writing on Leanpub
Free Updates. DRM Free.
If you buy a Leanpub book, you get free updates for as long as the author updates the book! Many authors use Leanpub to publish their books in-progress, while they are writing them. All readers get free updates, regardless of when they bought the book or how much they paid (including free).
Most Leanpub books are available in PDF (for computers) and EPUB (for phones, tablets and Kindle). The formats that a book includes are shown at the top right corner of this page.
Finally, Leanpub books don't have any DRM copy-protection nonsense, so you can easily read them on any supported device.
Learn more about Leanpub's ebook formats and where to read them
Write and Publish on Leanpub
You can use Leanpub to easily write, publish and sell in-progress and completed ebooks and online courses!
Leanpub is a powerful platform for serious authors, combining a simple, elegant writing and publishing workflow with a store focused on selling in-progress ebooks.
Leanpub is a magical typewriter for authors: just write in plain text, and to publish your ebook, just click a button. (Or, if you are producing your ebook your own way, you can even upload your own PDF and/or EPUB files and then publish with one click!) It really is that easy.