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

Claude Code es el asistente de programación con IA de Anthropic que trabaja dentro de tu proyecto: lee tu código, edita archivos, corre comandos en la terminal y hace commits con git, siempre pidiéndote permiso según el modo que elijas. No es un autocompletado: le describes una tarea en lenguaje natural («arregla este error», «escribe las pruebas de este módulo») y él planea, cambia los archivos necesarios y verifica el resultado. Funciona en la terminal, en VS Code y JetBrains, en una app de escritorio y en el navegador.

En esta guía te explico qué puede hacer y qué no, cómo instalarlo en macOS, Linux o Windows, cómo configurarlo el primer día y en qué se diferencia de Cursor. Los comandos los verifiqué en la documentación oficial el 09/10/2026.

Qué es Claude Code

La documentación lo define como una herramienta de programación «agéntica»: entiende el repositorio completo y puede trabajar en varios archivos y herramientas a la vez para terminar una tarea. La diferencia práctica con un chat es que no copias y pegas código: Claude Code abre los archivos, propone el cambio, lo aplica y corre tus pruebas o tu linter para comprobarlo.

Todas sus versiones (terminal, editor, escritorio y web) usan el mismo motor, así que tu archivo CLAUDE.md, tu configuración y tus servidores MCP sirven igual en cualquiera de ellas.

Qué puede hacer y qué no

Lo que sí hace bien

• Entender un repositorio que no conoces: le preguntas «¿dónde se valida el login?» y busca, lee y te responde con rutas y líneas.
• Cambios en varios archivos: una función nueva, un error que atraviesa tres capas, renombrar algo en todo el proyecto.
• Correr comandos: instala dependencias, ejecuta pruebas, lee el error y vuelve a intentar.
• Git: prepara cambios, escribe el mensaje del commit, crea ramas y abre pull requests.
• Tareas pesadas y aburridas: pruebas para código que no las tiene, errores de lint en todo el proyecto, conflictos de merge, notas de versión.
• Automatizar desde la línea de comandos: con claude -p le pasas una instrucción sin abrir una sesión, útil en scripts o en CI.

Lo que no debes esperar

• Que adivine lo que no está en el código. Si una regla de negocio solo existe en tu cabeza, escríbela en CLAUDE.md o en el prompt.
• Que reemplace tu revisión. Revisa cada diff como revisarías el de un compañero. Tú respondes por lo que se sube a producción.
• Que funcione gratis. El plan gratuito de claude.ai no incluye Claude Code (lo vemos abajo).
• Que trabaje sin internet. Necesita conexión: el modelo corre en los servidores de Anthropic o de un proveedor compatible.

Cómo instalar Claude Code

Requisitos según la documentación: macOS 13 o superior, Windows 10 (1809) o superior, Ubuntu 20.04+, Debian 10+ o Alpine 3.19+, 4 GB de RAM o más y conexión a internet. Abre una terminal y corre el comando de tu sistema.

macOS, Linux y WSL

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

Si usas Homebrew también puedes instalarlo con brew install --cask claude-code. Esa versión no se actualiza sola: tendrás que correr brew upgrade claude-code de vez en cuando.

Windows

En PowerShell (tu terminal muestra PS C:\):

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

En CMD (sin el PS):

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

En Windows conviene instalar Git for Windows: con él Claude Code usa Git Bash para correr comandos; sin él, usa PowerShell. Si tus proyectos usan herramientas de Linux, instálalo dentro de WSL con el comando de Linux. También existe winget install Anthropic.ClaudeCode.

Comprobar la instalación

claude --version   # imprime el número de versión
claude doctor      # diagnóstico de la instalación y la configuración

Si la terminal responde command not found: claude (en Windows, que claude «no se reconoce»), abre primero una ventana nueva: la sesión desde la que instalaste conserva su PATH anterior. Si sigue igual, la carpeta donde quedó el programa (~/.local/bin) no está en tu PATH. En Mac, con zsh, la guía oficial de problemas de instalación lo resuelve con dos líneas:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

En Linux con Bash es lo mismo con ~/.bashrc. En Windows la carpeta es %USERPROFILE%\.local\bin y la misma guía trae los comandos de PowerShell para agregarla.

Qué plan necesitas

Según la documentación oficial, Claude Code requiere una cuenta Pro, Max, Team, Enterprise o de la Console (pago por uso de la API). El plan gratuito de claude.ai no lo incluye. También puedes usarlo con Amazon Bedrock, Google Cloud o Microsoft Foundry si tu empresa ya paga alguno de esos proveedores.

Los precios cambian seguido y dependen del país y la moneda, así que no los copio aquí: revísalos en la página oficial de precios. Mi recomendación para empezar: el plan Pro, y subir solo si en el día a día te topas con los límites de uso.

Tu primer uso, paso a paso

1. Abre tu proyecto y arranca: cd mi-proyecto y luego claude. La primera vez te pide iniciar sesión en el navegador.
2. Crea tu CLAUDE.md: escribe /init y Claude Code analiza el repo y genera un CLAUDE.md en la raíz. Ese archivo lo lee al inicio de cada sesión: ahí van los comandos del proyecto (cómo correr pruebas, lint, build), las convenciones y lo que nunca debe tocar. Edítalo a mano; cuanto más concreto, mejor.
3. Elige cuánto te pregunta: desde la versión 2.1.283, las sesiones de la terminal y de VS Code arrancan en modo auto, en el que un segundo modelo revisa cada acción en tu lugar. La documentación de los modos de permisos (consultada el 10/10/2026) advierte que eso reduce las preguntas, pero no garantiza seguridad. Con Shift+Tab cambias de modo: desde auto, la primera pulsación te pasa al modo manual, que te pide permiso para casi todo; la siguiente, a accept edits, que edita archivos sin preguntar. Mi recomendación: pásate a manual hasta que confíes en cómo trabaja.
4. Usa el modo plan antes de cambios grandes: en plan mode Claude investiga y te propone un plan sin editar tu código. Lo apruebas, lo corriges o lo descartas. También puedes empezar un mensaje con /plan.
5. Pide algo pequeño y verificable: «corre las pruebas y explícame por qué falla la de login» es mejor primera tarea que «refactoriza todo».
6. Revisa el diff y haz commit: «haz commit de estos cambios con un mensaje descriptivo». Lee el mensaje antes de subirlo.

El resultado depende mucho de cómo pides las cosas. Si quieres mejorar ahí, te sirve mi guía sobre qué es un prompt y cómo escribir uno bueno.

MCP: conectar Claude Code con tus herramientas

MCP (Model Context Protocol) es un estándar abierto para conectar herramientas de IA con fuentes de datos externas. Con un servidor MCP, Claude Code puede leer tus documentos de diseño, actualizar tickets en Jira, consultar Slack o usar una herramienta interna de tu equipo, sin que copies nada a mano. Cómo funciona por dentro, los ámbitos y la seguridad están en qué es MCP y cómo conectar Claude a tus herramientas.

Se agrega con un comando. Un servidor remoto por HTTP y uno local se ven así:

# Servidor remoto (HTTP)
claude mcp add --transport http notion https://mcp.notion.com/mcp

# Servidor local (stdio): lo que va después de -- es el comando que lo levanta
claude mcp add --env AIRTABLE_API_KEY=TU_CLAVE --transport stdio airtable -- npx -y airtable-mcp-server

Con --scope project el servidor queda en un .mcp.json en la raíz del repo y lo comparte todo tu equipo; sin esa opción, solo lo ves tú en ese proyecto. Conecta únicamente servidores en los que confíes: tienen acceso a lo que les des.

Claude Code vs Cursor

No son excluyentes: Claude Code tiene extensión para VS Code y también se instala dentro de Cursor. La diferencia está en el punto de partida.

• Dónde vive: Claude Code nace en la terminal (y se lleva al editor, escritorio y web); Cursor es un editor completo, derivado de VS Code.
• Forma de trabajar: Claude Code está pensado para delegar tareas completas (planear, editar, correr, verificar, hacer commit); Cursor brilla en el autocompletado y la edición mientras tú escribes.
• Automatización: Claude Code se puede usar en scripts y en CI con claude -p, GitHub Actions o GitLab CI/CD; en Cursor el flujo gira alrededor del editor.
• Modelos: Claude Code usa los modelos de Anthropic; Cursor permite elegir entre varios proveedores.

Si ya estás cómodo en tu editor y quieres sugerencias mientras escribes, Cursor. Si quieres pasarle una tarea entera y revisar el resultado, Claude Code. Muchos usamos los dos.

Errores comunes al empezar

• No escribir el CLAUDE.md. Sin él, cada sesión empieza de cero y tienes que repetir cómo se corren tus pruebas.
• Pedir tareas enormes y vagas. Divide: primero el plan, luego un paso a la vez, verificando cada uno.
• Aprobar todo sin leer. Los permisos existen por algo. Revisa los comandos que van a correr, sobre todo los que borran o despliegan.
• No darle una forma de comprobar su trabajo. Si el proyecto tiene pruebas, typecheck o lint, díselo: así puede verificar antes de darte el resultado.
• Instalar con sudo npm install -g. La documentación lo desaconseja; usa el instalador nativo.

Preguntas frecuentes

¿Claude Code es gratis?

No. Necesitas un plan de pago de Claude (Pro, Max, Team o Enterprise) o una cuenta de la Console con pago por uso. Consulta los precios vigentes en claude.com/pricing.

¿Funciona en Windows?

Sí, de forma nativa desde PowerShell o CMD, o dentro de WSL. Con Git for Windows instalado puede usar Git Bash para correr comandos.

¿Puedo usarlo con modelos locales como Ollama?

La documentación oficial cubre la API de Anthropic y proveedores como Amazon Bedrock, Google Cloud y Microsoft Foundry. Conectarlo a modelos locales depende de herramientas de terceros que no forman parte del producto; si lo pruebas, hazlo en un proyecto sin datos sensibles.

¿Sustituye a un programador?

No. Acelera mucho el trabajo de alguien que sabe qué pedir y cómo revisar el resultado. Sin ese criterio, también acelera los errores.

Cada mes comparto en la newsletter lo que voy probando con IA para programar; suscríbete si quieres recibirlo.