Claude Code

irm https://claude.ai/install.ps1 | iex

curl -fsSL https://claude.ai/install.sh | bash

winget install Anthropic.ClaudeCode

brew install --cask claude-code

npm install -g @anthropic-ai/claude-code

claude --version
claude doctor
claude

Claude Code convierte tareas de programación en una conversación dentro de tu terminal. En una frase: le explicas qué quieres lograr y el agente lee tu proyecto entero, propone cambios, edita archivos y corre comandos como un compañero de equipo con acceso al teclado, siempre pidiéndote permiso para lo sensible.

El problema que resuelve es la distancia entre “tengo una idea de cambio” y “está implementado y funcionando”. Hasta ahora, editores con autocompletado te ayudaban línea a línea o dentro del archivo abierto, pero faltaba un agente que tuviera contexto del repositorio completo: que supiera dónde está la configuración, qué patrón sigue el resto del código y qué tests hay que pasar. Claude Code cubre justo ese hueco trabajando con la carpeta entera, no con un archivo.

Le rinde a quien programa todos los días y quiere acelerar tareas que cruzan varios archivos (refactor, migraciones, nuevas funcionalidades). También a personas con menos experiencia que necesitan una mano que entienda el contexto y les explique lo que hace. Es además la base sobre la que corren skills y MCPs, así que si quieres explotar esos ecosistemas, tienes que pasar por aquí. Le sobra a quien solo quiere autocompletado puntual en su editor: para eso, Copilot dentro del editor es más ligero.

Por qué importa

Antes de los agentes de programación, el ciclo típico era leer documentación, copiar fragmentos de Stack Overflow, adaptarlos a tu base de código y rezar para que no rompieran nada. Cada cambio cruzado entre varios archivos (renombrar una función usada en veinte sitios, añadir un campo a un modelo y propagarlo a la vista y a los tests) era una tarea manual con cien decisiones pequeñas.

Con un agente que tiene contexto del proyecto, el “después” es que pides el cambio una sola vez y Claude se encarga de localizar todos los puntos afectados, proponer las ediciones, ejecutarlas y, si quieres, correr los tests para validar. Tú revisas el diff, no tecleas cada línea. Eso libera tiempo cognitivo para pensar en el diseño en lugar de en la mecánica.

Lo que cambia en el día a día es que tu unidad de trabajo deja de ser “una línea o una función” y pasa a ser “una intención” (“añade una página de contacto”, “migra estos componentes a la nueva API”). El equipo entrega más rápido sin sacrificar control, porque los cambios pasan por tu revisión antes de ir a producción.

Cómo se usa en la práctica

El flujo del frontmatter (instalar, abrir terminal, ejecutar claude, hablar en lenguaje natural) describe la mecánica. Lo importante son las decisiones que tomas alrededor para que el agente trabaje a tu favor y no contra ti.

Lo primero es elegir el método de instalación. El instalador nativo se actualiza solo y es el camino recomendado en la mayoría de los casos. Si trabajas en un entorno corporativo con políticas estrictas, el gestor de paquetes (brew o winget) te da una pista de auditoría más limpia, a cambio de tener que actualizarlo tú periódicamente. En Windows, además del propio Claude Code conviene tener Git for Windows para que Claude pueda usar Bash en sus comandos.

Después, trabaja siempre dentro de un repositorio con control de versiones. Esto no es opcional: lo que hace que sea seguro dejar a un agente editar tus archivos es poder revertir con git checkout cualquier desastre. Si te plantas en una carpeta sin git, una mala iteración puede dejarte llorando.

A la hora de pedir cambios, troce las tareas. Un prompt como “refactoriza toda la app a TypeScript estricto” produce muchísimo cambio en un solo turno y revisarlo es agotador. Mejor “convierte este módulo a TypeScript estricto y arregla los errores que aparezcan”, confirmas, y pasas al siguiente. La revisión humana es el cuello de botella; respétalo dejándole bocados manejables.

Aprovecha los permisos. Por defecto Claude te pide confirmación antes de ejecutar comandos o tocar archivos potencialmente destructivos. No automatices esa autorización hasta que confíes en cómo trabaja en tu repositorio. Para entornos críticos, configura permisos restrictivos en settings.json del proyecto para que ciertos comandos (publicar paquetes, borrar carpetas, hacer push a main) requieran intervención humana sí o sí.

Cuando algo no funcione al instalar o al ejecutar, claude doctor es tu primera parada. Diagnostica problemas comunes (versiones, permisos, conflictos) y te dice qué hace falta arreglar. Antes de buscar en foros, ejecuta el diagnóstico.

Para sacarle el jugo a las skills, instálalas como te indica la documentación de cada una y deja que Claude las invoque cuando detecte que vienen al caso. No fuerces. Si tienes muchas skills instaladas pero ninguna se usa, suele ser porque sus descripciones no son claras: revisa que el frontmatter de cada skill explique bien cuándo aplicar.

Los MCPs son el otro pilar. Conectan a Claude con servicios externos (bases de datos, navegadores, APIs). Configúralos en mcp.json del proyecto o globalmente, según necesites compartirlos entre proyectos.

Casos de uso reales

Refactor de un proyecto mediano. Un equipo tiene una aplicación de Next.js que arrastra deuda técnica: imports inconsistentes, componentes duplicados, tests rotos. Abren Claude Code, le explican el patrón objetivo y van pidiendo refactores por módulos. En lugar de tres semanas de trabajo manual, lo resuelven en cinco días con revisión humana de cada PR.

Persona con poco código resolviendo un bug. Una desarrolladora junior recibe un bug crítico en un módulo que no conoce. Abre Claude Code en el repositorio, le pega el mensaje de error y le pide que explique qué está pasando antes de tocar nada. Claude le señala el archivo, ella entiende el problema, le pide la corrección y la valida con los tests. En dos horas resuelve algo que sin ayuda le habría llevado un día entero.

Migración entre librerías. Un proyecto tiene que pasar de una librería de gráficos a otra. Las dos tienen API parecida pero distinta. Claude Code recorre todos los archivos donde se usa, propone el cambio mecánico, ejecuta los tests y deja un par de casos raros marcados para revisión humana. Lo que sería un trabajo aburrido y propenso a despistes se convierte en supervisión de cambios automáticos.

Documentación generada desde el código. Un equipo necesita escribir documentación interna sobre módulos antiguos. Le piden a Claude Code que recorra cada módulo y produzca un README explicando qué hace, qué dependencias tiene y cómo se usa. Después el equipo revisa y matiza, en vez de partir del folio en blanco.

Errores comunes y cómo evitarlos

• Instalar con sudo npm install -g y romper permisos del sistema. Usa el instalador nativo o el gestor de paquetes; si vas con npm, sin sudo.
• Trabajar fuera de un repositorio con control de versiones, perdiendo la capacidad de revertir. Inicializa git antes de empezar a pedir cambios.
• Pedir cambios enormes en un solo turno y luego no poder revisar el diff con cabeza. Trocea por módulos o funcionalidades.
• Aceptar a ciegas todas las propuestas sin leer el diff. Mira git diff o el resumen que muestra Claude antes de confirmar.
• No usar claude doctor cuando algo falla y meterse en foros antes de tiempo. El diagnóstico interno resuelve la mayoría de problemas.
• Olvidar que los comandos peligrosos (borrados, despliegues, git push --force) deberían pedir confirmación. Revisa permisos antes de dar manga ancha.

Cuándo NO usarla

Si tu única necesidad es autocompletado dentro del editor mientras escribes, Claude Code es más herramienta de la que necesitas: Copilot u otra solución embebida basta. Si trabajas con código altamente regulado donde toda edición debe pasar por revisión humana paso a paso y registro pormenorizado, un agente que toca archivos por su cuenta complica el flujo en lugar de simplificarlo. Y si no estás dispuesto a contratar un plan de pago de Anthropic, este no es tu camino: el plan gratuito de Claude no lo incluye.

Combinarla con otras herramientas

Claude Code + un MCP de filesystem o de navegador + skills específicas del dominio que toques (Python, Astro, lo que sea) es el combo natural. Si trabajas en equipo, súmale GitHub Actions para que tras los cambios locales se disparen tests y despliegues. La combinación con Cursor o VS Code es complementaria: usa el editor para mirar el código mientras Claude trabaja en paralelo en otra ventana.

Mini-ejercicio

En un proyecto pequeño con git inicializado, abre Claude Code y pídele que añada una función trivial (por ejemplo, un endpoint que devuelva la fecha actual) con su test correspondiente. Revisa el diff antes de aceptar. Pídele luego que ejecute los tests y reporte el resultado. Sabrás que está bien si el código aparece en tu árbol con el patrón que ya usabas y el test pasa al ejecutarlo localmente.