Claude Code: qué es, cómo instalarlo y cuánto cuesta

Claude Code es el agente de programación de Anthropic: lee tu proyecto, edita archivos, ejecuta comandos y propone cambios. Funciona en la terminal, en VS Code y JetBrains, en la app de escritorio y en el navegador. Necesita un plan de pago de Claude (desde 18 € al mes) o una cuenta de API.

En esta guía te explico cómo instalar Claude Code en Windows, Mac y Linux con los comandos oficiales, cuánto cuesta cada plan en España, si hay alguna forma de usarlo gratis y cómo dar los primeros pasos sin romper nada. Al final lo comparo con Codex, la alternativa de OpenAI, y respondo a las dudas más buscadas.

Qué es Claude Code y para qué sirve

Claude Code es un asistente que trabaja dentro de tu código. A diferencia del chat de Claude, donde pegas un fragmento y copias la respuesta, aquí el agente ve el repositorio entero, abre los archivos que necesita, lanza los tests y te enseña los cambios antes de aplicarlos. Según la documentación oficial, sirve para escribir funciones nuevas, corregir errores, refactorizar, explicar código heredado, preparar commits y pull requests o automatizar tareas repetitivas.

Anthropic lo presentó en febrero de 2025 como versión preliminar junto a Claude 3.7 Sonnet y lo abrió a todo el mundo el 22 de mayo de 2025, con Claude 4. Desde entonces ha pasado de ser una herramienta de terminal a tener extensión para editores, versión web, app de escritorio y apps móviles.

Por dentro usa los modelos de Claude. En la API de Anthropic, los alias opus, sonnet y haiku apuntan hoy a Opus 5.5, Sonnet 5.5 y Haiku 5.5, y existe un modelo superior, Fable 5.1, que hay que elegir a mano con /model fable y que en algunos planes se cobra aparte con créditos de uso. Si quieres ver cómo quedan estos modelos frente a GPT o Gemini, lo tienes en nuestra guía de la mejor IA.

Lo que más me gusta es que no tienes que cambiar de editor ni de forma de trabajar: le das una tarea concreta, revisas lo que propone y decides. Si lo que buscas es una herramienta para montar una app sin tocar código, Cursor o los constructores visuales del directorio de asistentes de código con IA te pueden encajar mejor.

Claude Code precio: cuánto cuesta en España

No hay una suscripción solo de Claude Code. Va incluido en los planes de pago de Claude y comparte los límites con el chat: lo que gastes programando se descuenta del mismo saldo que tus conversaciones en claude.ai. Estos son los precios que muestra la web oficial con ubicación en España:

Antes de pagar, ten claros dos detalles. Los límites se reinician en ventanas de cinco horas y los planes de pago tienen además un tope semanal, así que una tarde larga de refactorización puede dejarte sin saldo hasta la siguiente ventana. Y los créditos de API que regala el plan Max no se pueden gastar en Claude Code, según el artículo de soporte sobre Pro y Max.

Si usas Claude Code con una clave de API en vez de con suscripción, pagas por tokens. La página de costes de la documentación da una referencia útil para empresas: unos 13 $ por desarrollador y día activo, entre 150 y 250 $ al mes, y el 90 % de los usuarios se queda por debajo de 30 $ al día. Con /usage ves lo que llevas consumido en la sesión.

Yo empezaría por Pro mensual. Si a la semana te topas con el límite cada día, sube a Max 5x; si no, ya tienes la respuesta y te ahorras más de 70 € al mes. Para estirar el saldo te sirven los trucos de cómo reducir el consumo de tokens en Claude Code y cómo evitar que se agoten los límites con rutinas.

Cómo instalar Claude Code paso a paso

Antes de nada, revisa los requisitos de la página de instalación oficial: macOS 13 o superior, Windows 10 (versión 1809) o superior, Ubuntu 20.04+, Debian 10+ o Alpine 3.19+, al menos 4 GB de RAM y un procesador x64 o ARM64. También necesitas conexión a internet y una cuenta Pro, Max, Team, Enterprise o de Console. No hacen falta permisos de administrador.

Instalar Claude Code en Windows

Abre PowerShell (no hace falta ejecutarlo como administrador) y pega este comando:

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

Si prefieres la consola clásica CMD, el comando oficial es este otro:

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

Anthropic recomienda instalar también Git para Windows, aunque ya no es obligatorio: sin él, Claude Code usa PowerShell para ejecutar los comandos. Otra opción es WinGet, con winget install Anthropic.ClaudeCode, pero esa versión no se actualiza sola. Si trabajas en WSL 2, instálalo dentro de Linux con el comando de la siguiente sección; además tendrás el modo sandbox, que en Windows nativo no está disponible.

Instalar Claude Code en Mac y Linux

En macOS, Linux o WSL abre la terminal y ejecuta:

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

En Mac también puedes usar Homebrew con brew install --cask claude-code. Igual que con WinGet, las instalaciones de Homebrew no se actualizan solas y tendrás que lanzar brew upgrade de vez en cuando. La instalación nativa con el script, en cambio, se actualiza en segundo plano.

Instalar con npm (y el error más común)

La vía de npm sigue existiendo, con npm install -g @anthropic-ai/claude-code, pero pide Node.js 22 o superior. Los dos fallos que más se repiten en los foros son tener una versión vieja de Node y usar sudo para saltarse un error de permisos. La documentación dice expresamente que no uses sudo npm install -g, porque crea problemas de permisos y de seguridad. Si te pasa, usa el instalador nativo y olvídate de npm.

Comprobar la instalación e iniciar sesión

Cuando termine, cierra y vuelve a abrir la terminal y comprueba que todo está bien:

claude --version
claude doctor

El primero te devuelve el número de versión y el segundo revisa la instalación y la configuración. Después entra en la carpeta de tu proyecto y arranca:

cd mi-proyecto
claude

La primera vez se abre el navegador para que inicies sesión con tu cuenta de Claude. Si tienes definida la variable ANTHROPIC_API_KEY en tu sistema, ojo, porque Claude Code la usará y te cobrará por la API en lugar de tirar de tu suscripción. Para cambiar de cuenta, escribe /login dentro de la sesión.

Terminal, escritorio, web o editor: dónde usarlo

La terminal es el sitio original, pero no el único. Todas las versiones comparten la misma cuenta y los mismos límites, y puedes pasar una sesión de una a otra: claude --teleport trae a tu terminal una tarea empezada en la web, y la app de escritorio puede mandar a la nube una sesión local.

La versión web trabaja sobre tus repositorios de GitHub en máquinas de Anthropic, así que puedes dejar una tarea corriendo y cerrar el portátil. En septiembre Anthropic fue más allá con los proyectos, que reparten el trabajo en varios hilos en paralelo desde una sola conversación:

Projects now run from one conversation, starting in Claude Code. You describe what needs doing, and Claude directs parallel threads that keep working after you close your laptop.

In beta today for select Pro and Max users in cloud sessions; coming to all Claude users soon.

— Claude (@claudeai) 17 de septiembre de 2026

Si empiezas desde cero y la terminal te impone, yo arrancaría por la extensión de VS Code. Ves cada cambio marcado en verde y rojo antes de aceptarlo, y eso ayuda mucho a entender qué está haciendo el agente.

Cómo usar Claude Code: primeros pasos

La forma de trabajar es siempre la misma: describes la tarea, Claude Code explora el proyecto, te propone un plan o unos cambios y tú los aceptas o los corriges. Por defecto pide permiso antes de editar archivos o ejecutar comandos, y yo lo dejaría así mientras le coges el tranquillo.

1. Pídele que te explique el proyecto. Es la mejor primera tarea porque no toca nada.
2. Crea el archivo CLAUDE.md con /init. Claude Code analiza el repositorio y escribe un resumen con los comandos de build, test y las convenciones, que leerá al empezar cada sesión.
3. Activa el modo plan para tareas grandes. Pulsa Shift+Tab hasta ver «plan mode on»: el agente investiga y te presenta un plan sin modificar archivos.
4. Pide un cambio pequeño y revisa el diff. Acepta o rechaza cada edición.
5. Deja que haga el commit. Puede escribir el mensaje y, si tienes GitHub conectado, preparar la pull request.

Estos prompts funcionan bien para arrancar. Fíjate en que todos dicen qué quieres, dónde y cómo comprobarlo:

Explícame la estructura de este proyecto: qué hace cada carpeta y cómo se arranca en local.

El formulario de /contacto envía el email dos veces si el usuario hace doble clic. Busca la causa, propón un arreglo y añade un test que lo cubra.

Antes de tocar nada, haz un plan para migrar las fechas de moment.js a date-fns. Dime qué archivos cambiarías y qué riesgos ves.

La diferencia con un prompt vago es enorme. «Arregla el formulario» obliga al agente a adivinar; «el formulario envía el email dos veces con doble clic» le da el síntoma, y «añade un test» le da una forma de comprobar que lo ha resuelto. Cuanto más concreta es la tarea, menos tokens gasta buscando.

Comandos que vas a usar a diario

Un error típico de principiante es pedirle diez cosas en el mismo mensaje. El agente las mezcla, el contexto se llena y acabas con cambios a medias. Mejor una tarea por petición y, cuando termines un bloque de trabajo, empieza una conversación nueva.

CLAUDE.md, skills, subagentes y MCP

Cuando ya lo uses a diario, estas cuatro piezas son las que marcan la diferencia. Todas se guardan como archivos en tu proyecto (en la carpeta .claude/) o en tu carpeta de usuario, así que puedes compartirlas con tu equipo por Git.

• CLAUDE.md: instrucciones permanentes del proyecto, como «usa pnpm, no npm» o «los tests se lanzan con make test». Claude Code también lee AGENTS.md si ya lo tienes para otras herramientas.
• Skills: recetas reutilizables en .claude/skills/nombre/SKILL.md. Se lanzan con /nombre o el agente las usa solo cuando encajan con la tarea. Los antiguos comandos personalizados se han integrado aquí.
• Subagentes: asistentes especializados (revisor de código, experto en tests) definidos en .claude/agents/, con su propio contexto para no llenar el de la conversación principal.
• MCP: conectores con servicios externos como GitHub, Sentry o tu base de datos. Se añaden con claude mcp add --transport http nombre url.

Las skills nacieron en Claude Code y han acabado siendo un estándar que usan otras herramientas. El 22 de octubre Boris Cherny, creador de Claude Code, anunció que Anthropic las cede a una fundación, como ya hizo con MCP:

Agent Skills started as an experiment in Claude Code. Many across the industry have come to adopt it, so we at Anthropic found it more fitting to donate it to the @AgenticAIFdn, next to MCP.

— Boris Cherny (@bcherny) 22 de octubre de 2026

Mi consejo es no instalar diez skills y cinco servidores MCP el primer día. Empieza con un buen CLAUDE.md, y cuando te veas repitiendo la misma instrucción tres veces, conviértela en una skill. Si quieres una base más ordenada, Anthropic tiene un curso gratis de Claude Code en español que explica estas piezas con ejemplos.

Otra función que el equipo de Anthropic usa mucho es la revisión automática de pull requests. Se conecta a GitHub y revisa cada PR antes de que la fusiones:

I could not imagine being productive without Claude Code Review. It runs on all of my PRs, and catches almost every bug before it goes it. This is a piece of the secret sauce that lets the team and I move so quickly while raising the quality bar

— Boris Cherny (@bcherny) 16 de octubre de 2026

¿Se puede usar Claude Code gratis?

Con el plan gratuito de Claude, no. La tabla de planes de claude.com/es/pricing marca Claude Code como «No» en Free, y la documentación pide una cuenta Pro, Max, Team, Enterprise o de Console. Lo que sí existen son tres caminos para pagar poco o nada, cada uno con su pega.

Con la API y pago por uso

Si creas una cuenta en la consola de Claude y añades saldo, Claude Code cobra solo lo que consumes. Para un uso esporádico puede salir más barato que Pro, pero no hay tope mensual automático: una sesión larga con Opus puede costar más que la suscripción de todo el mes. Fija un límite de gasto en la consola antes de empezar.

Claude Code gratis con Ollama

Ollama permite conectar Claude Code a modelos que se ejecutan en tu ordenador. La guía oficial de Ollama lo resume en un comando:

ollama launch claude

También puedes configurarlo a mano apuntando Claude Code al servidor local de Ollama:

export ANTHROPIC_AUTH_TOKEN=ollama
export ANTHROPIC_API_KEY=""
export ANTHROPIC_BASE_URL=http://localhost:11434
claude --model qwen3.5

Ten en cuenta lo que estás haciendo: usas la herramienta de Claude Code, pero con otro modelo, no con Claude. Ollama recomienda modelos con al menos 64.000 tokens de contexto, lo que exige un ordenador con bastante memoria, y el resultado en tareas complejas queda lejos de Opus o Sonnet. Para aprender cómo funciona el agente o para tareas sencillas sin conexión, me parece una opción muy razonable.

Proxys de terceros

En X circulan proyectos como free-claude-code, un repositorio de GitHub con más de 60.000 estrellas que redirige las peticiones de Claude Code a proveedores gratuitos o locales. No es de Anthropic. Antes de instalar algo así, revisa el código y no le pases claves ni repositorios con datos sensibles, porque todo lo que escribes pasa por ese intermediario.

Claude Code vs Codex

Codex es la respuesta de OpenAI y se busca casi tanto como Claude Code en España. Hacen lo mismo en lo esencial (agente en terminal, editor, web y escritorio), así que la elección depende sobre todo del modelo que prefieras y de qué suscripción tengas ya.

Si ya pagas ChatGPT Plus, prueba Codex primero, porque lo tienes incluido. Si pagas Claude Pro, lo mismo con Claude Code. Para alguien que empieza sin ninguna de las dos, la ventaja de Codex es que se puede probar gratis, aunque con límites y con el modelo pequeño. Yo no elegiría por la herramienta, sino por el modelo con el que mejor te entiendas en tu tipo de proyecto, y eso solo se sabe probando la misma tarea en los dos.

Errores típicos y cómo resolverlos

Y un consejo que te ahorrará disgustos: trabaja siempre con Git. Si Claude Code hace un cambio que no te gusta, lo deshaces en un segundo. Sin control de versiones, revertir veinte archivos editados es un dolor de cabeza.

Preguntas frecuentes sobre Claude Code

¿Cómo funciona Claude Code?

Le escribes una tarea en lenguaje natural y el agente lee los archivos de tu proyecto, decide qué cambiar, ejecuta comandos (tests, build, git) y te muestra los cambios para que los apruebes. Repite ese ciclo hasta terminar la tarea. Todo lo hace con los modelos de Claude a través de tu cuenta.

¿Qué tan bueno es Claude para programar?

Es uno de los modelos más usados para programar y Anthropic lo orienta claramente a ese uso. En los rankings públicos los modelos de Claude suelen estar en la parte alta de las tablas de código, aunque las posiciones cambian cada pocas semanas. Lo tienes actualizado en nuestra guía de la mejor IA.

¿Cuándo salió Claude Code?

Anthropic lo presentó como versión preliminar el 24 de febrero de 2025, junto con Claude 3.7 Sonnet, según su anuncio oficial. La versión estable llegó el 22 de mayo de 2025 con el lanzamiento de Claude 4.

¿Claude Code está en español?

Sí. Le puedes hablar en español y responde en español, y la documentación oficial tiene versión en castellano. Los comandos y los nombres de los archivos, eso sí, siguen en inglés.

Por dónde empezar

Si nunca has usado un agente de programación, instala Claude Code con el comando oficial de tu sistema, entra con una cuenta Pro y pídele que te explique un proyecto tuyo antes de dejarle cambiar nada. Con eso verás en diez minutos si te encaja. Y si prefieres comparar antes con otras herramientas, tienes la ficha de Claude Code y el resto de asistentes de código con IA en nuestro directorio.

Aitor Wilzig

Me dedico al SEO y la monetización con proyectos propios desde 2019. Un friki de las nuevas tecnologías desde que tengo uso de razón.
Estoy loco por la Inteligencia Artificial y la automatización.

gptzone.net