Claude Code es un agente de IA específicamente pensado para el desarrollo de código.
Vive en tu terminal, puedes acceder a él a través de tu editor de código de confianza y puede leer, editar, crear y ejecutar código por ti.
No es un autocompletado ni un chatbot que te da fragmentos para copiar y pegar.
Es un modelo de lenguaje con herramientas: le describes lo que quieres y él se encarga de construirlo, probarlo y corregirlo.
En este artículo te explico cómo funciona, cómo instalarlo, y cómo usarlo para convertir un script suelto en una aplicación web funcional.
Si prefieres verlo en acción, tienes el vídeo completo aquí:
Pero si lo que quieres es entenderlo a fondo, con las cosas que en el vídeo no dio tiempo a desarrollar, sigue leyendo.
En la Comunidad Ninja hemos tenido una sesión en directo donde llevamos Claude Code bastante más lejos de lo que cubre este artículo: tres casos de uso explicados en directo en una sesión de una hora.
Si quieres ver cómo se trabaja con Claude Code en proyectos reales de Machine Learning e Ingeniería de datos, con los tropiezos incluidos, tienes la grabación completa aquí.
Un chatbot genera texto.
Claude Code genera texto y hace cosas. La diferencia es importante.
Cuando le das una tarea, Claude entra en un bucle de tres fases:
Todo esto sin que le tengas que ir diciendo paso a paso lo que tiene que hacer.
En concreto, Claude Code tiene acceso a:
La clave es que no tienes que saber programar para usarlo.
Tienes que saber describir lo que quieres, que es algo muy distinto. Y saber guiarlo cuando se desvía, que también ocurre.
La instalación lleva menos de cinco minutos. Puedes acceder a la guía oficial de Anthropic aquí.
En Mac o Linux, abre la terminal y ejecuta:
curl -fsSL https://claude.ai/install.sh | bash
En Windows, necesitas Git for Windows instalado. Luego puedes ejecutar el instalador desde PowerShell o CMD. También funciona con WSL si ya lo tienes configurado.
Una vez instalado, verifica que funciona:
claude --version
Y para un diagnóstico más completo:
claude doctor
Necesitas una suscripción a Claude Pro, Max, Teams o Enterprise, o una cuenta con créditos en la API de Anthropic.
El plan gratuito de Claude no incluye acceso a Claude Code.
La primera vez que ejecutes claude se abrirá el navegador para autenticarte.
Con eso, ya estás. Navegas a la carpeta de tu proyecto, escribes claude y a trabajar.
CLAUDE.md es un archivo que vive en la raíz de tu proyecto y que Claude lee al inicio de cada sesión. Piensa en él como un briefing: le pone en situación antes de empezar a trabajar.
Sin este archivo, Claude tiene que descifrar tu proyecto desde cero cada vez que abres una sesión. Con él, ya sabe dónde está, qué herramientas usas y cómo te gusta trabajar.
Lo justo y necesario. Específicamente:
npm run build, docker compose up, etc.).La regla es sencilla: por cada línea, pregúntate "si quito esto, ¿Claude la liará?". Si la respuesta es no, bórrala.
El creador de Claude Code, Boris Cherny, tiene un CLAUDE.md de aproximadamente 2.500 tokens, que es más o menos una página de texto.
Si el tuyo es significativamente más largo, probablemente estés desperdiciando contexto.
Y el contexto, como verás ahora, es el recurso más valioso que tienes.
Claude Code funciona con una ventana de contexto de 200.000 tokens.
Puedes pensar en ella como su memoria de trabajo: todo lo que puede "recordar" durante una conversación.
Cada mensaje que le envías, cada archivo que lee, cada respuesta que genera, cada comando que ejecuta… todo va llenando esa ventana.
Y aquí está el problema: el rendimiento de un modelo de lenguaje se degrada a medida que su ventana de contexto se llena.
Cuanta más información irrelevante acumula, peor razona.
Empieza a olvidar instrucciones, a cometer errores, a perder el hilo.
La información que queda enterrada en medio de una conversación larga pierde peso para el modelo.
Esto significa que una sesión de Claude Code al 90% de capacidad no es solo más lenta: es peor.
Las instrucciones importantes se pierden entre el ruido.
| Comando | Qué hace | Cuándo usarlo |
|---|---|---|
/context | Muestra cuánto se ha llenado la ventana | Antes de prompts importantes. Actúa cuando pase del 60-70% |
/clear | Borra toda la conversación | Cuando cambias de tarea completamente |
/compact | Resume la conversación, conservando lo importante | Cuando quieres seguir con la misma tarea pero liberando espacio |
/compact [instrucciones] | Resume con foco específico | Ejemplo: /compact Céntrate en los cambios de la API |
/rewind (o ESC ESC) | Rebobina la conversación hasta un punto anterior | Cuando Claude entra en bucle o empieza a desvariar |
/model | Cambia el modelo durante la sesión | Para usar Sonnet en exploración y Opus en planificación |
/memory | Abre CLAUDE.md para editarlo | Después de terminar una tarea, para actualizar el briefing |
Sesión nueva para tarea nueva.
No arrastres una conversación de dos horas sobre autenticación cuando lo que quieres ahora es refactorizar el frontend. Cada sesión debería tener un propósito claro, y cuando ese propósito cambia, /clear y a empezar de cero.
Un buen hábito es hacer /clear después de cada commit. El commit marca un punto de control natural: el trabajo está hecho, probado y guardado. No hay razón para arrastrar ese contexto a la siguiente tarea.
Explorar → Planificar → Ejecutar.
Siempre en ese orden, especialmente cuando el cambio es complejo.
Cuando te enfrentas a un proyecto por primera vez (o a un código que no has escrito tú) lo primero es que Claude (y tú) entendáis qué hay ahí.
Pídele que analice la estructura, que te explique qué hace cada parte, que identifique dependencias.
Para esta fase, Sonnet es más que suficiente. Es rápido, barato y entiende código perfectamente.
Puedes seleccionarlo con /model sonnet.
Con el contexto claro, pídele un plan.
Aquí es donde merece la pena cambiar a un modelo más potente con /model opus, porque la planificación requiere un razonamiento más profundo.
El plan debería incluir qué archivos se van a crear o modificar, qué tecnologías se van a usar, qué orden van a seguir los pasos y qué podría salir mal.
La planificación es especialmente útil en tres situaciones:
Si puedes describir el cambio en una sola frase probablemente no necesitas planificar.
Revisas el plan, ajustas lo que consideres, le das el visto bueno y que empiece el espectáculo. Claude va creando archivos, escribiendo código, configurando dependencias y verificando que todo encaja.
Mientras trabaja, puedes ir viéndolo en tiempo real.
Y si en algún momento va por mal camino, le paras con Escape y le rediriges.
No dejes que acumule errores en la ventana de contexto, porque cada intento fallido es ruido que empeora los siguientes.
Después de trabajar con la herramienta y de ver cómo la usa mucha gente, hay un patrón claro. Los errores más frecuentes tienen la misma raíz: tratar la ventana de contexto como si fuera infinita.
Empiezas arreglando un bug, luego le preguntas por otra cosa completamente distinta, luego vuelves al bug.
La ventana se llena de ruido y Claude pierde el hilo.
Solución:
/clearentre tareas que no tengan relación.
Claude la lía, le corriges, la vuelve a liar, le corriges otra vez… y ahora el contexto está lleno de intentos fallidos que confunden aún más al modelo.
Solución:
/rewindpara volver al punto anterior al error, reescribes el prompt con lo que has aprendido y arrancas en limpio.
Un buen prompt desde cero siempre gana a una conversación larga llena de correcciones.
Has metido tantas instrucciones que Claude ignora la mitad. Más instrucciones no significa mejor comportamiento; significa más ruido desde el minuto uno de cada sesión.
Le dices que "investigue el código" sin especificar qué parte o para qué. Claude se pone a leer todos los archivos y para cuando quieres que haga algo útil, la ventana está llena.
Solución: acota siempre la exploración a lo que necesitas resolver en esta sesión.
Cinco prácticas que marcan la diferencia entre usar Claude Code bien y frustrarse con él:
Dale cómo verificar su propio trabajo. No le digas solo "haz que funcione". Dile que escriba tests, que compare el resultado con lo esperado, que ejecute el build y compruebe que no hay errores. Que Claude se corrija solo es lo que más rendimiento te da. Si tú eres el único que valida, cada error te cuesta tu tiempo.
Sé específico. Claude no lee mentes. En lugar de "arregla el bug de login", prueba con: "el login falla después de que expire la sesión, mira el flujo de auth en src/auth, escribe un test que lo reproduzca y arréglalo". Cuanto más contexto le des, menos correcciones necesitas después.
Deja que te entreviste. Cuando vayas a implementar algo grande, dile que te haga preguntas antes de empezar. Sobre implementación, casos raros, decisiones de diseño… Claude va a pensar en cosas que a ti no se te habían ocurrido. Con esas cosas, que escriba la especificación en un archivo y luego arranca una sesión limpia con esa especificación como base.
Usa subagentes para investigar. Si necesitas que Claude explore una parte del código, puedes pedirle que lance un subagente. Los subagentes trabajan en una ventana de contexto separada y devuelven un resumen, sin ensuciar tu conversación principal. Esto es especialmente útil en proyectos grandes.
Corrige rápido. En cuanto veas que va por mal camino, Escape. No le dejes seguir generando basura. Y si le has corregido dos veces lo mismo y no lo pilla, no insistas: /rewind, reescribe el prompt y arranca de nuevo.
En el vídeo que acompaña a este artículo, cogemos un Jupyter notebook con un script de transcripción de audio usando Whisper y lo convertimos en una aplicación web completa con Docker y Streamlit.
El proceso sigue exactamente el flujo que hemos descrito:
El resultado: una app funcional en menos de 20 minutos, sin escribir una sola línea de código manualmente.
Después de verificar que funciona, actualizamos el CLAUDE.md con /memory para que la próxima sesión ya sepa que este proyecto tiene Docker, Streamlit y Whisper configurados.
No, pero necesitas saber describir lo que quieres con claridad y tener una idea general de lo que es técnicamente posible. No necesitas escribir código, pero sí entender a grandes rasgos lo que Claude está haciendo para poder guiarlo cuando se desvíe.
Necesitas como mínimo una suscripción a Claude Pro. Si vas a usarlo de forma intensiva, Claude Max es probablemente la opción más económica a largo plazo porque ofrece un coste fijo mensual en lugar de pago por uso. También puedes usar la API con créditos, pero el consumo puede subir rápido en sesiones largas.
Sonnet para tareas rápidas, exploración y cambios sencillos. Opus para planificación, razonamiento complejo y cambios que afecten a múltiples archivos. Puedes cambiar entre ellos durante la misma sesión con /model.
Puede hacer cambios que rompan cosas, sí. Por eso es fundamental trabajar con control de versiones (git). Haz commits frecuentes y antes de cualquier cambio grande, asegúrate de tener tu código en un estado limpio. Si algo sale mal, puedes volver atrás.
Claude Code accede a los archivos de la carpeta desde la que lo invocas. Si necesita acceder a otros archivos o ejecutar comandos que puedan tener consecuencias (como instalar paquetes o modificar configuraciones del sistema), te pedirá permiso. Puedes configurar el nivel de permisos según tu nivel de confianza.
La diferencia principal es que Claude Code opera en tu terminal, no dentro de un IDE. No es un autocompletado ni un panel lateral. Es un agente autónomo que puede ejecutar comandos, crear archivos, correr tests y hacer cambios coordinados en múltiples archivos. Trabaja a nivel de proyecto, no a nivel de línea de código.
MCP (Model Context Protocol) es un estándar abierto que permite conectar Claude Code con servicios externos: GitHub, Slack, bases de datos, Jira, y más de 300 integraciones disponibles. Básicamente, amplía lo que Claude puede hacer más allá de tu código local. Pero eso da para otro artículo (y otro vídeo).