Claude Code: Guía Completa desde Cero hasta Profesional
Lo que he aprendido usando Claude Code como Software Engineer profesional: con specs, tests y deploys a producción, organizado para ti.
9 artículos · 35 tips rápidos
Qué es Claude Code
La herramienta agéntica de programación de Anthropic. Una CLI que le da a Claude acceso directo a tu terminal, tus ficheros y tu base de código. No es un chatbot ni un plugin de autocompletado — es un agente que lee tu repositorio, escribe código, ejecuta tests e itera desde una conversación en el terminal.
Llevo usándolo en producción casi desde que salió. Lo que más cambia no es la velocidad — es en qué gastas tu atención. Dejas de escribir boilerplate y empiezas a pensar en arquitectura, en nombres, en qué debería existir y qué sobra. Es una herramienta para quien ya tiene criterio técnico — no te lo da, lo amplifica.
Claude Code Desktop: 5 funcionalidades por las que valdría la pena dejar el terminal
Las 5 funcionalidades exclusivas de Claude Code Desktop sobre la CLI: diff visual, sesiones paralelas, preview embebido, monitorización de PRs y conectores integrados.
Programa con la voz: Voice Mode en Claude Code
Activa /voice, mantén Space y habla. Claude Code transcribe en streaming con vocabulario optimizado para desarrollo.
¿Sabías que Claude Code recuerda entre conversaciones?
Claude Code escribe notas sobre tu proyecto mientras trabajas y las lee en cada nueva sesión. Así recuerda comandos de build, patrones de depuración y decisiones de arquitectura.
Claude Code vs Cursor: Compara y Decide
Uso los dos todos los días. No es uno u otro — son herramientas distintas para momentos distintos. Cursor es un fork de VS Code con IA integrada: autocompletado inline, diffs visuales, multi-modelo. Claude Code vive en el terminal como un agente autónomo. Para ediciones rápidas y autocompletado, Cursor no tiene rival. Para tareas complejas que tocan múltiples ficheros — refactorizaciones, implementaciones guiadas por spec, migraciones — Claude Code gestiona el flujo completo sin que tengas que estar en el bucle en cada paso.
¿Cuál elegir? Si puedes, ambos. Si tienes que elegir uno, depende de si tu flujo es terminal-first o IDE-first.
Claude Code vs Cursor: Comparativa Profesional
Más allá de tablas de funciones. Cómo Claude Code y Cursor se diferencian en flujos de trabajo profesionales y uso diario.
Deja de desperdiciar tokens: elige el modelo correcto en Claude Code
Usa opusplan en Claude Code: Opus para planificar, Sonnet para ejecutar, Haiku para explorar. Deja de usar el modelo frontera para todo.
Tutorial de Claude Code: Primeros Pasos
Instala con curl -fsSL https://claude.ai/install.sh | bash, abre un terminal en tu proyecto y ejecuta claude. La primera vez te pedirá que te autentiques — con tu cuenta de Claude o con una API key de Anthropic.
Tu primera sesión es el verdadero tutorial. Pídele que explique un fichero, haz un cambio pequeño, ejecuta tus tests. Trátalo como un compañero senior con quien haces pair programming — da contexto, explica el objetivo y corrígelo cuando se equivoca.
Tu Primera Sesión
La forma más rápida de entender lo que puede hacer es ejecutarlo en un proyecto real desde el primer día. Empieza con algo de bajo riesgo: pídele que explique un fichero que no escribiste tú, luego haz un cambio pequeño y ejecuta tus tests. Esta secuencia — explorar, editar, verificar — es el bucle central que usarás para todo. El objetivo de tu primera sesión no es ser productivo. Es familiarizarte con la interfaz y desarrollar intuición sobre cómo Claude interpreta tu base de código.
Automatizar Frontend con Claude Code: De 1 hora a 3 minutos (Caso Real)
Descubre cómo usar Claude Code CLI para automatizar tareas de desarrollo frontend. Caso práctico: implementación de eventos de tracking AVO en minutos.
Claude Code Rewind: Deshaz Cambios con Checkpoints
Cada prompt crea un checkpoint automático. Si Claude rompe algo, pulsa Esc dos veces y rebobina a cualquier estado anterior en segundos.
Claude Code Fast Mode: Respuestas 2.5x Más Rápidas
Fast mode prioriza la velocidad sobre el coste en Opus 4.6: respuestas hasta 2.5x más rápidas con la misma inteligencia. Aprende a activarlo con /fast.
Ejecuta comandos en el terminal sin salir de Claude Code
Escribe ! seguido de cualquier comando para ejecutarlo directamente en tu shell sin salir de Claude Code. Usa Ctrl+B para procesos en background.
Claude Code Context Window: Uso de Tokens con /context
El comando /context desglosa cuántos tokens consume cada componente de tu sesión, dándote visibilidad total sobre la ventana de contexto antes de que se agote.
Personaliza tu Configuración
La diferencia entre una experiencia genérica y una que parece que Claude conoce tu proyecto está en la personalización. CLAUDE.md, las preferencias de usuario y la configuración del entorno se combinan para darle el contexto que necesita. Lo más importante que puedes personalizar es qué puede y qué no puede hacer Claude de forma autónoma — establecer esos límites pronto evita sorpresas y construye confianza en la herramienta.
Claude Code Effort Level: Ajusta la Profundidad al Vuelo
Usa /model + flechas para ajustar effort sobre la marcha. O configúralo permanentemente con effortLevel en settings o la variable de entorno CLAUDE_CODE_EFFORT_LEVEL.
Ver el pensamiento en Claude Code: Verbose y Extended
Pulsa Ctrl+O para ver a Claude pensar. Detecta problemas pronto. Frena malas decisiones antes de que se conviertan en mal código.
Pregunta mientras Claude Code trabaja con /btw
Usa /btw para hacer preguntas rápidas mientras Claude Code está trabajando. Sin interrumpir, sin contaminar el historial.
Distingue tus sesiones de Claude Code de un vistazo
Usa /rename y /color para dar identidad visual a tus sesiones de Claude Code. Nombre + color = ubicar cualquier sesión al instante.
Status Line en Claude Code: Personaliza tu Barra de Estado
Claude Code te permite personalizar la barra de estado inferior con un script de shell — como el PS1 de tu terminal, pero para tu sesión de IA.
Haz que Claude Code te avise cuando termine (sin molestar)
Un hook Stop + un script que comprueba la app en foco = sonido solo cuando estás en otra app. Cero notificaciones molestas.
Domina Claude Code: Hooks, Skills y Memoria
Las herramientas que marcan más diferencia: hooks (scripts que se ejecutan automáticamente en tu flujo), skills (comandos personalizados que invocas con /comando) y el sistema de memoria que persiste contexto entre sesiones.
Estas son las funcionalidades que separan a los usuarios diarios de los avanzados. Cada tip de esta sección cubre una en profundidad.
Configuración y CLAUDE.md
CLAUDE.md es el fichero con más impacto en cómo se comporta Claude en tu proyecto. Uno bien escrito lo transforma de un generalista capaz en algo que parece que ya hizo el onboarding. Cubre tu stack, tus convenciones, tu enfoque de testing y qué directorios están fuera de límites. Mantenlo honesto y conciso — Claude lo lee al inicio de cada sesión. Trátalo como documentación viva: actualízalo cuando cambien tus convenciones.
Tu CLAUDE.md está lleno de basura, así es como puedes arreglarlo
La mayoría de CLAUDE.md están llenos de información que Claude puede inferir solo. Aprende a documentar lo que realmente importa: decisiones de negocio, convenciones de equipo y el por qué detrás de cada regla.
Permisos en Claude Code: Reglas Deny, Modos y Wildcards
Los deny siempre ganan. Los modos cambian el comportamiento de todo. Y la sintaxis Tool(specifier) acepta wildcards y patrones gitignore.
Cuándo carga Claude Code cada feature (y lo que cuesta)
Aprende cuándo se carga cada feature de Claude Code en el contexto — CLAUDE.md, Skills, MCP, Subagents y Hooks — y cómo ahorrar tokens desde el inicio.
Skills y Extensiones
Los skills son comandos reutilizables que defines una vez e invocas cuando los necesitas. Cada flujo de trabajo que codificas como skill es trabajo que no tienes que repetir. Los mejores skills son los que te encuentras haciendo manualmente tres veces en una semana — después de la tercera, para y escribe el skill. En un mes tendrás una biblioteca de automatización específica de tu proyecto que cualquier compañero nuevo puede usar desde el primer día.
Los 6 mecanismos de extensión de Claude Code que todos confunden
Skills, Hooks, MCP, Sub-agents, Agent Teams y Plugins: un mapa rápido para saber cuándo usar cada uno.
Crea Comandos Reutilizables con Skills en Claude Code
Las skills son archivos markdown que Claude Code ejecuta como slash commands. Creas un SKILL.md, lo invocas con /nombre, y Claude sigue los pasos. Conversacional, predecible, reutilizable.
Quick Tip: Automatiza los permisos de tus skills con allowed-tools
Usa el campo allowed-tools en tus skills de Claude Code para automatizar la aprobación de herramientas y eliminar confirmaciones repetitivas.
Hooks en Claude Code — Automatiza Tu Flujo de Trabajo
Hooks son comandos que se ejecutan automáticamente en puntos concretos del ciclo de vida de Claude Code. A diferencia de las instrucciones en CLAUDE.md, los hooks son deterministas: si se cumple la condición, se ejecutan siempre.
Configura tu primer servidor MCP en Claude Code en 5 minutos
MCP no es un plugin, ni una skill, ni una API. Es un protocolo. claude mcp add + URL o comando local y tienes Claude conectado a cualquier servicio.
Plugins en Claude Code: no es nada nuevo, es empaquetar lo que ya sabes
Un plugin de Claude Code no es nada nuevo. Es empaquetar skills, subagents, hooks y MCP en un formato compartible con un solo comando.
Patrones de Productividad
Las mayores ganancias no vienen de prompts ingeniosos — vienen de cambiar el ritmo de tu jornada. Yo lo uso para adelantar la parte aburrida: boilerplate, stubs de tests, scaffolding de migraciones. Eso libera atención para las decisiones que importan. El patrón que más me ha cambiado el flujo: antes de escribir código nuevo, le pido a Claude que explique el código existente relevante. Detecta cosas que yo habría pasado por alto y establece el contexto para todo lo que sigue.
Claude Code abre Chrome y depura tu frontend por ti
claude --chrome o /chrome conecta Claude Code con tu navegador. Claude abre pestañas, navega, hace click, lee la consola y depura tu frontend — todo sin salir de la terminal.
Tu sesión de Claude Code tiene ramas (y tú no lo sabías)
claude --continue --fork-session crea una rama independiente de tu conversación actual. Mismo contexto, nuevo camino. Como git branch, pero para tus sesiones con Claude.
Pon a trabajar 3 Claudes a la vez (con un solo comando)
Con git worktrees, claude -w feature-auth abre una nueva rama y arranca una instancia de Claude en ella. Hazlo tres veces y tienes tres Claudes trabajando en paralelo, en el mismo repo, sin conflictos.
Claude Code ahora tiene 1M de tokens de contexto — y no deberías llenarlos
Opus 4.6 incluye 1M de tokens de contexto en planes Max, Team y Enterprise. 5x más que antes, sin coste extra. Pero más contexto no significa mejor resultado.
Haz que Claude Code vigile tu código mientras trabajas
Usa /loop para que Claude Code vigile deploys, PRs y logs de forma recurrente mientras trabajas. Con contexto completo, no como un cron ciego.
Cómo controlar Claude Code desde el móvil
Controla tu sesión de Claude Code desde el móvil con Remote Control. Guía paso a paso con claude --rc, modo servidor y QR code.
Flujos de Trabajo Agénticos
El modo agéntico es donde se diferencia genuinamente. Claude ejecuta una tarea en varios pasos — lee ficheros, hace ediciones, ejecuta comandos, evalúa resultados e itera — sin que tú apruebes cada paso. La clave para usarlo bien es la acotación: un objetivo claro, un buen CLAUDE.md y hooks que apliquen tus reglas automáticamente. Con eso, las sesiones agénticas gestionan tareas que le llevarían medio día a un desarrollador junior, en minutos.
4 patrones Agentic AI en Claude Code que ya usas y uno que no conoces
Cada patrón agentico de Anthropic se mapea a una primitiva de Claude Code. Aquí está la referencia completa.
El patrón de Agentic AI que siempre te pone en tu sitio
Construye el patrón Evaluator-Optimizer como inline skill en Claude Code. Un LLM genera, otro evalúa cada claim contra evidencia real.
Claude Code puede trabajar mientras duermes
Con el flag -p, Claude Code se convierte en un agente headless que puedes programar con cron. Combinado con --allowedTools, tienes automatización autónoma con IA.
Crea agentes personalizados en Claude Code con --agent
Crea agentes especializados como archivos Markdown y lanza sesiones con claude --agent. Cada agente tiene su propio system prompt, herramientas y modelo.
Controla Claude Code desde Telegram o Discord con Channels
Controla Claude Code desde Telegram o Discord con Channels. Escríbele desde el móvil, ejecuta en tu terminal, y responde por el mismo canal.
Por qué tus subagentes devuelven resultados incompletos en Claude Code
Los subagentes de Claude Code arrancan con contexto cero y devuelven resúmenes incompletos. Aprende a incluir el objetivo en la delegación, precargar contexto con skills y usar iterative retrieval para obtener resultados completos.
Guías Claude Code en Profundidad
Guías largas escritas desde el uso real, no desde resúmenes de documentación. Para cuando quieres entender no solo qué hacer, sino por qué funciona y cómo adaptarlo a tu proyecto.
Guía Completa de Claude Code (2026): Qué Es, Cómo Instalarlo y Dominarlo
Guía definitiva de Claude Code (2026). Instalación, configuración CLAUDE.md, hooks, skills, subagentes y workflows profesionales para desarrolladores.
Subagentes en Claude Code: Guía Práctica con Configuraciones Reales
Guía práctica de subagentes en Claude Code (2026). Crea agentes especializados, divide tareas complejas y escala tu desarrollo frontend con IA.
Claude Code Hooks: Guía Práctica con Ejemplos Reales
Guía práctica de hooks en Claude Code: los 3 tipos, 5 hooks esenciales, patrones avanzados y errores comunes. Con ejemplos listos para copiar y usar.
Claude Code Skills: Crea Flujos de Trabajo Reutilizables con Comandos Personalizados
Las skills son la forma más rápida de crear flujos de trabajo repetibles en Claude Code. Un archivo markdown, un slash command, y pasos predecibles con intervención humana.
MCP en Claude Code: Guía Práctica de Configuración (2026)
Entiende qué es el Model Context Protocol (MCP) y cómo usarlo en Claude Code para conectar tu LLM con herramientas reales (GitHub, Linear, Bases de Datos).
Code Review Automático con Claude Code, Playwright y Notion (MCP)
Aprende a conectar Claude Code con Playwright y Notion mediante MCP para crear un sistema automatizado de revisión de UI y código.
Evaluator-Optimizer en Claude Code: de patrón a skill
Cómo convertí un patrón de Agentic AI en una skill reutilizable de Claude Code con evaluación basada en evidencia.
Preguntas Frecuentes
La herramienta se instala gratis, pero necesitas una cuenta de pago para usarla. Hay dos caminos: una suscripción a Claude (Pro, Max, Teams o Enterprise) o una cuenta de API en la consola de Anthropic. Con la suscripción pagas un precio fijo mensual con límites de uso incluidos. Con la API pagas por uso según los tokens que consumas. La mayoría de usuarios individuales empiezan con la suscripción Pro — es la forma más sencilla de arrancar. Los equipos suelen usar Teams o Enterprise. El plan gratuito de Claude no incluye acceso a Claude Code.
La instalación lleva menos de cinco minutos. En macOS o Linux, ejecuta curl -fsSL https://claude.ai/install.sh | bash en tu terminal. En macOS también puedes usar brew install --cask claude-code. En Windows, usa PowerShell: irm https://claude.ai/install.ps1 | iex. Una vez instalado, navega al directorio de tu proyecto y ejecuta claude. La primera vez te pedirá que te autentiques con tu cuenta de Claude o tu API key. No necesitas configurar nada más para empezar. También hay extensión para VS Code, plugin para JetBrains y una app de escritorio si prefieres no usar el terminal.
No son competidores — son herramientas complementarias. Cursor es un IDE (fork de VS Code) con IA integrada: autocompletado inline, diffs visuales, multi-modelo. Claude Code es un agente de terminal que lee tu base de código, ejecuta comandos y lleva a cabo tareas complejas de forma autónoma. Cursor es más cómodo para ediciones rápidas y navegación de código. Claude Code es más eficiente para refactorizaciones multi-fichero, implementaciones guiadas por spec y tareas autónomas de larga duración. Uso los dos cada día — uno para lo pesado, otro para lo diario. Mi recomendación para quien empieza: prueba ambos, la inversión combinada es razonable y te da lo mejor de los dos mundos.
Sí. Está diseñado para desarrolladores. Opera en un terminal, lee y escribe ficheros de código, ejecuta comandos de shell y asume que entiendes lo que está haciendo. Revisar su output es la parte más importante de usarlo bien — y para eso necesitas criterio técnico. Si eres un desarrollador junior, puede ser muy educativo: pídele que explique lo que hace según avanza y aprenderás patrones más rápido que con cualquier tutorial. Pero la herramienta no sustituye el conocimiento de programación — lo multiplica. Si buscas automatizar tareas sin tocar código, hay otras opciones más adecuadas.
Sí. Claude es completamente multilingüe y gestiona el español sin problemas. Puedes escribir prompts en español, obtener respuestas en español y Claude entenderá el contexto y la terminología técnica correctamente. Lo uso en inglés y español según el proyecto. Para tareas de código, el inglés produce output ligeramente más natural porque la mayoría de documentación de programación está en inglés — pero para explicaciones, conversaciones y tareas no estrictamente de código, el español funciona igual de bien. Puedes mezclar idiomas dentro de una sesión. Si quieres que responda siempre en español, indícalo en tu CLAUDE.md.
Usa exclusivamente modelos Claude de Anthropic — no puedes conectar GPT, Gemini ni ningún otro proveedor (a diferencia de Cursor, que es multi-modelo). Por defecto trabaja con la última versión de Claude Sonnet, que equilibra velocidad y capacidad para programación. Puedes cambiar a Claude Opus cuando necesites más potencia — decisiones arquitectónicas, depuración compleja, razonamiento profundo — a costa de mayor consumo de tokens. También está Claude Haiku para tareas ligeras y rápidas. El modelo se configura por sesión o en tu entorno. Mi recomendación: Sonnet para el trabajo diario, Opus cuando la tarea lo justifique.
Sí, y gestiona proyectos grandes mejor que la mayoría de alternativas. Lee de forma inteligente solo las partes relevantes de tu base de código para cada tarea — no carga todo en memoria. La clave es un buen CLAUDE.md que le diga qué partes son relevantes para distintos tipos de tareas y qué directorios evitar. Lo uso en proyectos con cientos de ficheros sin problemas. Lo que escala con el tamaño del proyecto no es la dificultad sino el consumo de tokens: más contexto significa más coste por sesión. Usar hooks para imponer sesiones enfocadas mantiene el consumo bajo control.
Depende de cómo lo uses. Con una suscripción a Claude (Pro, Max, Teams) pagas un precio fijo mensual e incluye uso con ciertos límites. Con la API de Anthropic pagas por tokens consumidos — sin precio fijo, escalas con el uso. El coste real varía según la intensidad: la duración de tus sesiones, el tamaño de la base de código y qué modelo uses. La mejor forma de estimar tu coste es hacer unas cuantas sesiones reales en un proyecto y revisar el consumo. Consulta la página de precios de Anthropic para las tarifas actualizadas.
Esto que acabas de leer lo aplico en directo en Twitch. Ven a verlo.
Recibe solo lo esencial
Si no hay nada que decir, no escribo. Si hay algo importante, te aviso. 7.000+ profesionales ya confían en esto.
Cancela la suscripción en cualquier momento.