Qué es Claude Code y cómo usarlo para programar desde la terminal

Seguidores Online » Redes Sociales » Qué es Claude Code y cómo usarlo para programar desde la terminal

Si llevas un tiempo trasteando con inteligencia artificial y desarrollo, seguro que has oído hablar de Claude Code como la herramienta que está revolucionando la forma de programar desde la terminal. No es otro copiloto más pegado al editor, sino un agente con acceso real a tu sistema que puede leer, modificar y probar código directamente en tu entorno.

En las últimas semanas el ruido ha sido enorme: timeline tras timeline lleno de experiencias de devs que han pasado su día a día a Claude Code, algunos encantados, otros algo más escépticos, pero casi todos coincidiendo en que aquí hay algo distinto. Vamos a ver con calma qué es, qué hace de verdad bien, en qué se diferencia de otros asistentes y cómo sacarle partido sin perder el control de tus proyectos.

Qué es exactamente Claude Code

Claude Code, también llamado a veces Claude Código, es una aplicación de línea de comandos creada por Anthropic que vive dentro de tu terminal. No es una web, ni una extensión de VSCode, ni una GUI bonita: es un CLI que se ejecuta en PowerShell, en la terminal de macOS o en cualquier shell de GNU/Linux.

La gracia de este enfoque es que el propio agente de IA se ejecuta donde ya trabajas siempre: en el terminal. Desde ahí puede ver tu sistema de ficheros, ejecutar comandos reales, interactuar con Git, lanzar tests, correr scripts y orquestar flujos de trabajo completos sin que tengas que ir copiando y pegando código entre un navegador y tu editor.

En lugar del ciclo clásico de “le pido algo a la IA en el navegador, copio el código, lo pego, pruebo, vuelvo a la IA con el error”, Claude Code te permite hablar con el modelo mientras este toca tu proyecto real: abre archivos, los analiza, los modifica, ejecuta el código, lee los mensajes de error, vuelve a corregir y repite el proceso hasta llegar a una solución razonable.

Todo esto se apoya en los modelos Claude de Anthropic (Sonnet, Opus, Haiku), que se caracterizan por un razonamiento fuerte y la capacidad de manejar contextos muy largos. Eso permite trabajar con bases de código extensas, PRs grandes o documentación dispersa sin perder el hilo cada dos mensajes.

Cómo funciona a nivel práctico en la terminal

Al instalar Claude Code, lo que obtienes es un comando claude que puedes lanzar desde cualquier directorio de tu proyecto. A partir de ahí se abre una sesión interactiva tipo chat, pero dentro del terminal, con soporte para atajos de teclado, modos de permiso y comandos especiales.

Este agente hereda tu entorno bash o PowerShell: ve tus alias, scripts personalizados, versiones de herramientas y cualquier configuración que ya tengas montada. Puede ejecutar comandos con --help para entender cómo utilizar tus utilidades, pero lo ideal es que le documentes lo importante en un archivo especial llamado CLAUDE.md.

Ese archivo CLAUDE.md actúa como cerebro compartido entre tú y el agente. Ahí puedes definir cómo está organizado el proyecto, qué stack usas, convenciones de código, comandos frecuentes (por ejemplo pnpm dev, npm run test, scripts de despliegue, etc.), patrones aprobados y antipatrones que quieres evitar. Claude lo lee al iniciar la sesión y adapta todo su comportamiento a esas reglas.

Además del archivo raíz, puedes tener varios CLAUDE.md en subdirectorios para dar contexto específico por módulo (por ejemplo, uno para frontend, otro para backend). Incluso puedes crear un ~/CLAUDE.md global para preferencias personales y un CLAUDE.local.md con ajustes que no quieres subir a Git, como rutas locales o tokens.

Qué puede hacer Claude Code con tu código

Lo que hace que esta herramienta sea tan potente no es solo el chat en sí, sino la combinación de razonamiento de IA con acceso directo al sistema de archivos y a la shell. Con los permisos adecuados, puede desempeñar varios roles dentro de tu flujo de trabajo.

Para empezar, es capaz de leer cualquier archivo de tu proyecto y entender el contexto completo: arquitectura, dependencias, convenciones de nombres, módulos clave, etc. Esto le permite responder preguntas de alto nivel como “dónde se gestiona el estado del carrito” o “cómo funciona el flujo de autenticación”.

Por otro lado, puede crear nuevos archivos completos: código, configuración, documentación o tests. Por ejemplo, le puedes pedir que monte la estructura de un nuevo microservicio, que genere un componente Vue con su test y su historia de Storybook, o que prepare una configuración inicial de CI.

No se queda ahí: también es capaz de editar archivos existentes de forma quirúrgica. Puede refactorizar funciones, extraer lógica a composables o servicios, actualizar imports, renombrar entidades o aplicar cambios en cascada a varios ficheros manteniendo coherencia.

Quizá lo más llamativo es que trabaja de manera iterativa leyendo los mensajes de error reales que genera tu proyecto. Si algo falla al compilar o al ejecutar los tests, Claude Code puede inspeccionar el log, localizar la causa raíz, proponer y aplicar una corrección, volver a lanzar las pruebas y seguir afinando hasta que todo pase.

Permisos, seguridad y control de lo que toca

Dar a una IA acceso a tu terminal suena, con razón, un poco inquietante. Por eso Claude Code está diseñado alrededor de un sistema de permisos muy granular que te permite decidir exactamente qué puede y qué no puede hacer.

De entrada, la herramienta suele pedir confirmación para operaciones sensibles como ediciones masivas, comandos bash “peligrosos” o acceso web. Esa verborrea de pop-ups en modo texto puede resultar pesada al principio, pero es la red de seguridad que evita sustos tipo rm -rf en el sitio equivocado.

Para domar este comportamiento, puedes crear archivos de configuración como .claude/settings.json en el proyecto o ~/.claude.json a nivel global, donde defines lista blanca de herramientas, comandos permitidos y operaciones explícitamente prohibidas. Por ejemplo, puedes autorizar todas las operaciones de edición y ciertos comandos de Git, pero bloquear cualquier cosa que incluya sudo o borrados recursivos.

Durante la sesión, además, tienes el comando /permissions para ajustar sobre la marcha lo que el agente puede hacer, y la opción de marcar algunos cambios como “Always allow” cuando ya confías en un tipo de acción concreto (por ejemplo, aplicar fixes de lint en un conjunto de archivos).

Si estás trabajando en un entorno aislado, como un contenedor Docker sin acceso externo, puedes utilizar flags más agresivos como --dangerously-skip-permissions, pero esto solo tiene sentido cuando estás seguro de que el entorno es desechable y no contiene datos sensibles.

Integración con Git y GitHub: PRs, commits y revisiones

Uno de los puntos más potentes de Claude Code es su integración profunda con Git y con GitHub vía CLI. La herramienta actúa casi como una capa semántica sobre Git: tú describes lo que quieres hacer y ella traduce esa intención en comandos y cambios concretos.

En Git local, puede analizar el historial de commits, revisar diffs, encontrar quién tocó qué parte del código y por qué, revertir cambios de forma segura, preparar ramas de hotfix o generar mensajes de commit claros y coherentes con el estilo del equipo.

Si tienes configurado el CLI oficial de GitHub (gh) y ejecutas el flujo de /install-github-app, Claude Code puede revisar PRs, comentar issues y participar directamente en la conversación de tu repositorio. Puedes mencionarlo en una pull request para que haga una revisión técnica, resuma cambios o proponga mejoras.

También puedes configurar workflows de CI/CD donde cada PR pase primero por el filtro de Claude: la herramienta revisa el código, detecta code smells, incoherencias con el estilo del proyecto o posibles regresiones, dejando comentarios útiles antes de que un humano tenga que dedicarle tiempo.

Todo esto convierte a Claude Code en algo muy parecido a un revisor técnico incansable que trabaja codo con codo con tu flujo de Git y GitHub desde la propia terminal. No sustituye la revisión humana, pero sí reduce mucho el volumen de ruido que llega al equipo.

Modos de uso: planificar, ejecutar o solo observar

Para adaptarse a distintos momentos del desarrollo, Claude Code ofrece tres modos principales de interacción que puedes conmutar rápidamente con atajos como Shift + Tab:

En el modo normal, el agente propone ediciones y comandos, pero pide confirmación antes de aplicarlos. Es el modo por defecto y encaja bien cuando estás haciendo cambios de cierta envergadura o tocando partes delicadas del sistema.

En el modo “Accept edits”, Claude puede editar archivos directamente sin pedir permiso para cada cambio de contenido, aunque sigue pidiendo autorización para comandos bash sensibles. Es ideal cuando ya has comprobado que va en la dirección correcta y quieres agilizar tareas repetitivas.

En el modo “Plan only”, la IA no modifica nada: solo lee, analiza y propone un plan. Es perfecto para auditar un codebase desconocido, explorar un módulo crítico o pensar una refactorización grande sin miedo a que se escape una edición inesperada.

Combinando estos modos con el flujo recomendado de “Explorar → Planificar → Ejecutar → Preservar”, puedes conseguir un estilo de trabajo mucho más metódico que el típico “vibe coding” improvisado que a menudo lleva a parches y deuda técnica.

Flujo de trabajo recomendado con Claude Code

Anthropic y muchos usuarios avanzados coinciden en que la mejor forma de usar Claude Code no es pedirle que escriba código sin más, sino integrarlo en un proceso ordenado que reduce errores y retrabajo.

La primera fase es la de exploración: aquí le pides al agente que recorra la base de código, revise archivos clave y actualice tu CLAUDE.md con lo que vaya averiguando. Puedes orientarle a áreas concretas, como autenticación, pagos o módulos legacy poco documentados.

Después llega la parte de planificación, donde quieres que el modelo proponga un plan detallado de cambios. Puedes darle ya una idea previa o dejar que él la sugiera, pero lo importante es fumar el plan en esta fase: pedirle que desafíe tus decisiones, que plantee alternativas y que identifique riesgos.

Solo cuando el plan tiene sentido pasas a la ejecución. Aquí sí le pides que implemente los cambios paso a paso, lance tests tras cada bloque razonable y vaya generando commits atómicos. Tu papel es revisar cada artefacto, validar la dirección y ajustar el rumbo cuando haga falta.

En la fase final, la de preservación, puedes encargarle que resuma los cambios, prepare una pull request bien descrita e incluso genere diagramas (por ejemplo, en Mermaid) que ayuden al resto del equipo a entender el impacto de la modificación.

Gestión de contexto, checkpoints y navegación temporal

Trabajar con conversaciones largas y cambios encadenados plantea otro reto: no perder el control del contexto ni del estado de tu código. Claude Code incluye varias herramientas para ello.

Por un lado, cada sesión está asociada al directorio en el que la iniciaste, de modo que el contexto de proyecto se mantiene aislado por carpeta. Puedes reanudar sesiones antiguas con --resume o el comando /resume, y seguir hablando “como si no te hubieras ido”.

El sistema de checkpointing registra un punto de control antes de cada tanda de ediciones. A través del comando /rewind o con doble ESC puedes volver a un estado anterior del código, de la conversación o de ambos, sin perder todo el avance ni tener que recomponer el proyecto a mano.

Para mantener el contexto limpio, tienes comandos como /clear, que borra por completo el historial de conversación cuando cambias de tarea, y /compact, que condensa automáticamente iteraciones fallidas, logs de prueba y ruido irrelevante, preservando solo las decisiones importantes.

A nivel de navegación rápida, puedes usar ESC simple para interrumpir una operación larga o que se ha desviado, doble ESC para editar el último prompt y reenviarlo, y la flecha arriba para reutilizar mensajes pasados con pequeños ajustes.

Comandos slash, MCP y automatización avanzada

Además del chat estándar, Claude Code soporta comandos “slash” reutilizables que actúan como macros semánticas. Guardando archivos Markdown en .claude/commands/ puedes definir recetas para crear componentes, preparar módulos, lanzar pipelines, etc.

Por ejemplo, puedes definir un comando que, al invocarlo como /project:vue-component UserCard, genere un componente Vue con su test, su historia de Storybook y lo registre en el índice de componentes, siguiendo las pautas definidas en tu CLAUDE.md. El argumento libre $ARGUMENTS te permite reutilizar la misma receta para distintos nombres.

Otro bloque potente es el soporte de MCP (Model Context Protocol), que permite conectar Claude Code con servidores externos especializados: bases de datos, navegadores automatizados tipo Puppeteer o Playwright, servicios internos, etc., definidos en un archivo .mcp.json.

Con esta infraestructura, el agente puede hacer cosas como tomar capturas de tu aplicación, consultar logs remotos, ejecutar queries directas contra una base de datos o interactuar con APIs privadas, combinando varias herramientas para montar flujos complejos (por ejemplo, screenshot → comparar diseño → crear issue).

Todo esto se complementa con el llamado “modo Unix”: gracias al flag -p, puedes usar Claude Code como un filtro más en pipes y scripts, imprimiendo el resultado y saliendo sin abrir chat interactivo. Eso lo hace idóneo para refactors mecánicos, formateos masivos o análisis automáticos dentro de tus propios scripts de shell.

Subagentes, profundización y calidad de las respuestas

Una de las ideas más interesantes del ecosistema Claude es el uso de subagentes: pequeñas instancias independientes que trabajan en paralelo sobre tareas concretas. Cada subagente arranca con contexto limpio, ejecuta su misión (por ejemplo, investigar cómo se gestiona la sesión, revisar la seguridad del módulo de auth, buscar patrones de errores) y devuelve un único mensaje de resultados.

Al pedirle a Claude Code que “use subagents para verificar”, “lance subagentes para investigar alternativas” o “delegue investigación en subagentes”, puedes repartir el trabajo de exploración entre varios hilos de pensamiento en paralelo sin contaminar el contexto principal.

Otra palanca de calidad es el razonamiento profundo. Si le pides explícitamente que piense a fondo, compare vías y muestre todo su proceso lógico, el modelo entra en un modo de pensamiento extendido en el que desgrana de forma más exhaustiva por qué toma cada decisión.

Eso sí, esta profundidad no conviene usarla para tareas triviales o mecánicas, porque consume más tokens y tiempo; tiene más sentido reservarla para problemas complejos de diseño, refactors delicados o análisis de bugs escurridizos que no se resuelven con un par de parches rápidos.

Por encima de todo, la experiencia de uso repetida demuestra algo muy simple: la especificidad del prompt marca la productividad. Instrucciones vagas como “mejora el rendimiento” o “arregla el bug” generan respuestas genéricas; detalles concretos sobre archivo, tecnología, condición de éxito y restricciones dan lugar a soluciones mucho más precisas.

Casos de uso reales: onboarding, refactor, visual y más

En el día a día, donde más brilla Claude Code es en el onboarding rápido a bases de código nuevas o heredadas. En lugar de pasarte horas leyendo archivos al tuntún, puedes preguntarle cosas del estilo “cómo funciona el flujo de checkout”, “dónde se controla el acceso de usuarios anónimos” o “qué diferencias hay entre estos dos servicios”.

En refactors, el agente destaca como asistente para tareas pesadas pero conceptualmente sencillas: aplicar patrones homogéneos, mover lógica repetida a utilidades comunes, añadir tipados donde faltan, rellenar JSDoc o mejorar mensajes de error sin alterar el comportamiento observable.

A nivel visual, aunque la herramienta no tenga GUI propia, puedes arrastrar y soltar capturas de diseños o mockups en la sesión (cuando se usa en contexto gráfico) y pedirle que implemente un layout “pixel perfect” usando tu stack preferido. Funciona especialmente bien si ya has documentado en CLAUDE.md que usas, por ejemplo, Vue + Tailwind + BEM.

También encaja muy bien como capa inteligente sobre análisis de logs, resultados de tests o perfiles de rendimiento, sobre todo si los pasas vía pipe con -p. En lugar de leer tú 5.000 líneas de logs, le pides que identifique errores críticos, patrones de fallo o tests flakies y te resuma lo que importa.

Por último, en automatización pura, puedes crear colas de tareas tipo “añade comentarios JSDoc”, “arregla errores de TypeScript”, “lanza la suite de tests y corrige lo que falle” para que Claude Code las vaya despachando de forma ordenada, parando solo cuando necesita tu decisión.

Dónde están los límites y qué no deberías delegar

Con todo lo anterior es fácil dejarse llevar y pensar que Claude Code puede con todo, pero sus límites son muy reales y conviene tenerlos bien presentes si no quieres inflar tu deuda técnica.

Primero, la IA no tiene contexto de negocio ni memoria histórica real: no sabe por qué se tomaron decisiones pasadas, qué compromisos técnicos aceptasteis o qué restricciones no están documentadas. Puede proponer soluciones “correctas” a nivel técnico que chocan frontalmente con la realidad de tu producto.

Segundo, aunque los modelos como Claude Opus 4.5 hayan dado un salto enorme y sean capaces de sacar adelante el 80-90 % de una funcionalidad, ese último 10 % suele ser donde se esconde la verdadera dificultad: detalles de edge cases, contratos con otros sistemas, políticas de seguridad, rendimiento bajo carga real…

Además, hay problemas que simplemente no conviene externalizar: diseño de arquitectura, decisiones de producto, priorización de qué merece la pena construir y qué no. Ahí la herramienta puede servir como sparring, pero la responsabilidad sigue siendo tuya.

Por último, no hay que olvidar el coste: la versión CLI trabaja contra la API de Anthropic, y pagas por tokens consumidos, fuera de la suscripción plana de Claude Pro. Sesiones largas con modelos pesados y razonamiento profundo pueden salir caras si no eres disciplinado con lo que le pides.

En resumen, el uso sano pasa por asumir que Claude Code no reemplaza a los desarrolladores, sino que amplifica a quienes tienen criterio y saben formular bien los problemas. Quien solo convierte especificaciones cerradas en código línea a línea sí está mucho más expuesto a ser sustituido.

Visto todo lo anterior, Claude Code se consolida como un aliado muy potente para cualquier dev que viva en la terminal y quiera reducir fricción en lectura, refactor, pruebas y colaboración, siempre que se use con cabeza, validando cada paso y reservando el juicio crítico para las decisiones que realmente importan.