Claude Code

Hay un momento que muchos desarrolladores conocen bien. Llevas media hora en un chat con una IA, copias fragmentos de código, los pegas en tu editor, te das cuenta de que falta contexto, vuelves al chat, explicas más, recibes otra sugerencia, repites el ciclo. Al final del día has "colaborado" con la IA, sí, pero el trabajo manual de ir y venir ha consumido más energía mental de la que esperabas.

Yo lo viví durante meses. Hasta que probé Claude Code.

La mayoría de las herramientas de IA para programar funcionan como consultores que trabajan a oscuras. Les describes el problema, ellos te dan una respuesta genérica, y tú tienes que encajar esa respuesta en un proyecto que solo tú conoces. Es útil, pero tiene un techo claro.

El salto conceptual de Claude Code es tan simple que resulta casi obvio cuando lo escuchas: ¿y si en lugar de describir el problema, la IA simplemente viera tu código?

Eso es lo que hace Claude Code. No es un chatbot, no es un autocompletado. Es un agente que vive en tu terminal, explora tu base de código, entiende cómo se conectan los módulos, y puede crear o modificar archivos, ejecutar tests y gestionar flujos de git usando lenguaje natural.

Claude Code es una herramienta de línea de comandos desarrollada por Anthropic. Puedes instalarlo y arrancarlo con un simple claude dentro de cualquier carpeta de proyecto. A partir de ahí, describes lo que quieres en lenguaje natural y el agente actúa.

Lo interesante no es solo que "entiende código". Es que opera a nivel de proyecto, no a nivel de función. Puede leer toda la base de código, planear una secuencia de cambios en múltiples archivos, ejecutarlos, correr los tests, analizar los errores y volver a iterar, todo sin que tú tengas que guiar cada paso.

Anthropic lo define así internamente: "do the simple thing first". En lugar de construir una arquitectura compleja alrededor del modelo, crearon la capa más delgada posible para que las capacidades nativas de Claude brillaran por sí solas.

El resultado es una herramienta que se siente sorprendentemente directa. No hay magia falsa. Hay un agente que razona, actúa y te pide confirmación cuando lo necesita.

Cuando arrancas Claude Code en un proyecto, el agente empieza explorando directorios para construir contexto: entiende cómo están organizados los módulos, qué dependencias existen, qué patrones sigue el código. A partir de ahí puedes pedirle cosas como:

Y aquí está la diferencia clave con otros enfoques: Claude Code no te da una respuesta. Actúa. Edita archivos reales, ejecuta comandos, lee los outputs y ajusta su estrategia. Si los tests fallan, lee los errores, arregla el código y vuelve a correr la suite hasta que todo pase.

Por supuesto, el control siempre está en tus manos. Por defecto, Claude Code adopta un modo cauteloso: te pregunta antes de modificar archivos o ejecutar comandos. Puedes ajustar cuánta autonomía le das, desde aprobar cada acción hasta dejarlo operar de forma más independiente en tareas que ya conoces bien.

Una de las cosas que más me sorprendió es la versatilidad de dónde puedes correr Claude Code. Las opciones principales son:

Terminal CLI: La experiencia original y más completa. Navegas a tu proyecto y ejecutas claude. Funciona con todas tus herramientas de línea de comandos y con cualquier editor. Puedes instalarlo fácilmente desde la documentación oficial.

Extensión para VS Code y forks: Hay extensiones nativas para VS Code y Cursor, y también para los IDEs de JetBrains (IntelliJ, PyCharm, WebStorm). Ves los cambios de Claude directamente como diffs visuales dentro de tu editor.

Versión web: Puedes arrancar Claude Code directamente desde claude.ai/code sin necesitar instalación local. Especialmente útil para tareas largas o para trabajar con repositorios que no tienes en local.

App de escritorio: Una app standalone para usar Claude Code fuera del IDE o del terminal.

La flexibilidad es real. Puedes empezar una tarea en el terminal, continuar revisándola desde el móvil y retomar el trabajo en el IDE. Las sesiones no están atadas a una única superficie.

No quiero caer en la trampa del hype. Pero hay algunos números que merecen atención porque vienen de empresas reales que han integrado Claude Code en sus flujos de trabajo.

Stripe desplegó Claude Code entre 1.370 ingenieros de todos los niveles. Un equipo completó una migración de 10.000 líneas de Scala a Java en cuatro días, trabajo que estimaban en diez semanas-ingeniero.

Ramp, la plataforma de gestión de gastos corporativos, integró Claude Code en su workflow de desarrollo y redujo el tiempo de investigación de incidentes en un 80%. No es solo que los ingenieros programen más rápido: equipos de ventas, riesgo y finanzas ahora consultan su data warehouse en lenguaje natural en lugar de escribir SQL.

Wiz, la empresa de seguridad en cloud, necesitaba migrar una librería de Python de 50.000 líneas a Go. Estimaron el proyecto en dos o tres meses de trabajo manual. Con Claude Code lo completaron en aproximadamente 20 horas de desarrollo activo.

Rakuten redujo el tiempo medio de entrega de nuevas funcionalidades de 24 días laborables a 5. Sus ingenieros ahora corren múltiples sesiones de Claude Code en paralelo, delegando tareas simultáneamente en distintas partes de la base de código.

Son casos extremos, sí. Pero la dirección que señalan es clara: el cuello de botella ya no es solo escribir código. Es saber qué construir, cómo estructurarlo y orquestar bien el trabajo.

Una de las cosas que nadie te cuenta cuando empiezas con Claude Code es que no necesitas memorizar nada. Con /help dentro de cualquier sesión tienes todo el listado disponible. Pero sí hay un puñado de comandos que, una vez que los conoces, no puedes vivir sin ellos.

Empezando por los comandos de sesión, los más cotidianos son tres:

/compact es probablemente el más importante. Cuando llevas un rato largo trabajando en la misma sesión, el contexto empieza a llenarse y Claude empieza a perder el hilo de las decisiones anteriores. /compact comprime la conversación en un resumen inteligente, liberando espacio sin perder el contexto de lo que estabas haciendo. La regla práctica: úsalo cuando el indicador de contexto supere el 80%.

/clear hace algo más radical: borra toda la conversación y empieza de cero. No deshace los cambios en archivos, solo reinicia el hilo de la conversación. Útil cuando terminas una tarea y vas a empezar algo completamente diferente.

/undo revierte el último cambio que Claude hizo en un archivo. Solo el último. Para rollbacks más complejos, git sigue siendo tu amigo.

Luego están los comandos que cambian el modo de trabajo. /plan activa el modo de planificación: antes de tocar nada, Claude te presenta un plan detallado de lo que va a hacer y espera tu aprobación. Es el modo que recomiendo siempre cuando trabajas en partes críticas del código o cuando no tienes claro exactamente qué va a modificar. Puedes activarlo también con Shift+Tab sin salir de la sesión.

Para arrancar bien en un proyecto nuevo, /init es el primer comando que deberías ejecutar. Escanea tu proyecto y genera un archivo CLAUDE.md con un resumen de la estructura, las convenciones y el contexto. Este archivo es la "memoria persistente" de Claude Code: se carga automáticamente en cada sesión y le da al agente contexto sobre tu proyecto sin que tengas que explicarlo cada vez.

Y para saber en qué punto estás, /cost te muestra el consumo de tokens y el coste estimado de la sesión actual, y /context te da una visualización de cuánto espacio de contexto llevas consumido. Muy útil para no llevarte sustos si estás usando la API de pago.

Hay también cinco skills bundled que vienen de serie con Claude Code y que funcionan como comandos especiales: /debug para análisis de errores con razonamiento extendido, /simplify para limpiar y simplificar código existente, /looppara repetir una acción en bucle (muy útil en scripts de automatización), /batch para ejecutar tareas en paralelo sobre múltiples archivos, y /claude-api que da acceso a documentación actualizada de la propia API de Anthropic. Una nota sobre /loop: repite un prompt dentro de una sesión CLI para polling rápido (por ejemplo, comprobar el estado de un deploy cada cierto tiempo), no es un sustituto de scripts de automatización completos, para los que Claude Code tiene tareas programadas con /schedule.

Si los comandos son el vocabulario de Claude Code, las skills son la gramática que le permite adaptarse a tu forma de trabajar.

Una skill es básicamente un archivo SKILL.md que contiene instrucciones, contexto y recursos que Claude carga de forma automática cuando detecta que son relevantes, o cuando las invocas explícitamente con /nombre-de-la-skill. La idea es sencilla pero poderosa: en lugar de explicar lo mismo una y otra vez al principio de cada sesión, lo escribes una vez en una skill y Claude lo tiene siempre disponible.

¿Cuándo tiene sentido crear una skill? Cuando te das cuenta de que estás pegando el mismo playbook o checklist en el chat de forma repetida. Si siempre empiezas una revisión de código explicando los mismos criterios, o si cada vez que creas un endpoint FastAPI tienes que recordarle a Claude el patrón de tu proyecto, eso es una skill esperando a ser escrita.

La estructura es minimalista. Creas una carpeta en .claude/skills/ dentro de tu proyecto (para que esté disponible para todo el equipo) o en ~/.claude/skills/ (para uso personal en todos tus proyectos). Dentro, un archivo SKILL.md con un poco de frontmatter YAML y las instrucciones en markdown:

Con eso, cada vez que le pidas a Claude que cree un endpoint, puede invocar la skill automáticamente o puedes llamarla tú con /fastapi-endpoint. Sin repetir el contexto, sin perder las convenciones del proyecto.

Anthropic también ofrece skills oficiales preinstaladas para trabajar con archivos Excel, Word, PowerPoint y PDF, accesibles desde el Marketplace de Claude. Y la comunidad ha construido ya cientos de skills para casos más específicos: auditorías de seguridad, generación de documentación, patrones de arquitectura, flujos de revisión de PRs. El repositorio awesome-claude-code en GitHub es el mejor punto de partida para explorar lo que ya existe antes de escribir las tuyas desde cero.

Lo que más me gusta de las skills es que siguen el Agent Skills Open Standard, lo que significa que son portables: una skill escrita para Claude Code puede funcionar también en otras herramientas del ecosistema que soporten el estándar.

Si te dedicas a construir sistemas de inteligencia artificial, como es mi caso, Claude Code tiene una dimensión adicional interesante.

Por un lado, es una herramienta de productividad inmediata: pipelines de datos, integraciones de API, scripts de preprocesamiento, gestión de endpoints en FastAPI o Django. Todas esas tareas "de fontanería" que rodean el trabajo de ML y que consumen tiempo sin aportar valor al modelo.

Por otro lado, Claude Code en sí mismo es un ejemplo vivo de lo que estamos construyendo: un agente que razona, planea y actúa en bucles. Estudiarlo te da intuiciones sobre diseño de agentes, gestión de contexto y patrones de orquestación que luego puedes aplicar a tus propios proyectos.

Y hay algo más filosófico. Anthropic reconoce abiertamente que la mayoría del código que produce la propia compañía está siendo escrito por Claude Code. No lo dicen como marketing, lo dicen como una observación sobre hacia dónde va la ingeniería: los desarrolladores cada vez más se enfocan en arquitectura, decisiones de producto y orquestación de múltiples agentes en paralelo, en lugar de escribir cada línea manualmente.

No es una amenaza. Es una redefinición del trabajo.

Si quieres probarlo, el camino más directo es este:

La curva de aprendizaje no está en la herramienta, que es sorprendentemente accesible. Está en aprender a delegar bien: ser específico sobre el objetivo, darle el contexto necesario y revisar el resultado con criterio propio.

Si quieres ir más lejos, la cheatsheet de Shipyard es uno de los mejores recursos que he encontrado: comandos CLI, configuración avanzada, subagentes, MCP servers. Todo en un solo lugar.

Y si te interesa la parte técnica de cómo está construido por dentro, este deep dive de John Ding en Medium es una lectura excelente.

¿Es Claude Code el futuro de cómo se programa? No lo sé. Ninguna herramienta es la respuesta definitiva, y el ecosistema está evolucionando a una velocidad que hace que cualquier predicción dure poco.

Lo que sí sé es que, desde que lo incorporé a mi workflow, hay ciertas tareas que ya no hago de la misma manera. No porque haya perdido el control, sino porque he encontrado una forma de focalizarme en las decisiones que realmente requieren mi criterio y delegar la ejecución mecánica a algo que lo hace bien.

Y eso, en el fondo, es lo que siempre hemos buscado con las herramientas: recuperar tiempo y energía mental para pensar en lo que importa.

¿Has probado Claude Code o alguna herramienta similar? Me encantaría leer tu experiencia.

Si este artículo te ha resultado útil, compártelo con alguien que también esté explorando el mundo del desarrollo con IA. Y si todavía no te has suscrito a Cerebro y Código, este es el momento.