Claude Code: guía completa en español, con instalación, precio y uso real
Claude Code es una herramienta de Anthropic que trabaja como un agente: lee los archivos de tu proyecto, edita código, ejecuta comandos y se conecta a tus herramientas, desde la terminal, el editor, la aplicación de escritorio o el navegador. Se usa con una suscripción de Claude (Pro, Max, Team o Enterprise), con una cuenta de la Consola de Anthropic o a través de Amazon Bedrock, Google Cloud o Microsoft Foundry. Yo lo uso a diario: 103 sesiones y 18.652 respuestas del modelo entre el 26 de agosto y el 9 de octubre de 2026.
$ claude --version 2.1.293 (Claude Code) $ cd mi-proyecto && claude Claude Code · Opus 5.5 · Claude Pro > ¿qué hace este proyecto? ↳ lee los archivos que necesita ↳ te lo resume en un minuto
¿Qué es Claude Code?
Claude Code es una herramienta de programación con IA de Anthropic que funciona como un agente: entiende tu proyecto, edita archivos distintos a la vez y comprueba que lo que hace funciona. Describes lo que quieres en lenguaje normal y él planifica el trabajo, lo ejecuta y te lo enseña.
Aunque nació para programar, yo lo uso también para tareas que no son código: editar vídeos, auditar SEO, escribir páginas de WordPress o construir servidores MCP. Lo que lo distingue de un chat es que trabaja sobre tus archivos y tu terminal, no sobre texto que tú le pegas.
Yo leo tus archivos. Tú me dices qué quieres.
Lee tu proyecto
Busca y abre los archivos que necesita. No tienes que copiarle el código.
Edita archivos
Cambia archivos distintos a la vez y te enseña cada cambio.
Ejecuta comandos
Lanza tests, scripts y comandos de Git por ti, con tu permiso.
Se conecta a herramientas
Con MCP puede usar tu navegador, Search Console o un generador de vídeo.
Cómo trabaja Claude Code, paso a paso
Tres encargos reales de la documentación oficial. Se reproduce solo al llegar aquí.
| Un chat de IA | Claude Code | |
|---|---|---|
| Dónde trabaja | En la ventana de conversación | En tu proyecto y tu terminal |
| Qué contexto tiene | El que tú le pegas | Lee los archivos que necesita, sin que se los des |
| Qué puede hacer | Responder con texto y código | Editar archivos, ejecutar comandos y crear commits |
| Quién decide | Tú copias y pegas el resultado | Te pide permiso según el modo que elijas |
Dónde se usa: terminal, extensiones de VS Code y JetBrains, aplicación de escritorio y navegador (claude.ai/code). Todas comparten el mismo motor, así que tus archivos CLAUDE.md, tus ajustes y tus servidores MCP funcionan igual en todas.
¿Cómo se instala Claude Code?
Se instala con un comando en la terminal: curl -fsSL https://claude.ai/install.sh | bash en macOS, Linux y WSL, o irm https://claude.ai/install.ps1 | iex en Windows PowerShell. Después compruebas la instalación con claude --version.
curl -fsSL https://claude.ai/install.sh | bash
La instalación nativa se actualiza sola en segundo plano.
irm https://claude.ai/install.ps1 | iex
Se recomienda tener Git para Windows instalado, para que Claude Code pueda usar la herramienta Bash. Sin él, usa PowerShell.
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
brew install --cask claude-code
Hay dos versiones: claude-code (canal estable, que va aproximadamente una semana por detrás) y claude-code@latest. Homebrew no se actualiza solo: brew upgrade claude-code.
winget install Anthropic.ClaudeCode
WinGet tampoco se actualiza solo: winget upgrade Anthropic.ClaudeCode.
1 · Comprueba
Abre una terminal nueva y ejecuta claude --version. Debe salir un número de versión seguido de «(Claude Code)».
2 · Arranca
Entra en la carpeta de tu proyecto y escribe claude.
3 · Inicia sesión
La primera vez te pide entrar con tu cuenta en el navegador. Después no vuelve a pedirlo.
Las cuentas admitidas son Claude Pro, Max, Team o Enterprise, una cuenta de la Consola de Anthropic (API con crédito prepagado) o la nube de Amazon Bedrock, Google Cloud o Microsoft Foundry. Si nunca has usado una terminal, la documentación oficial tiene una guía de terminal. Todo esto es de la documentación oficial (9 de octubre de 2026).
¿Cómo empiezo a usar Claude Code?
Entra en la carpeta de tu proyecto, escribe claude y pídele algo en lenguaje normal; con una pregunta como «¿qué hace este proyecto?» ya ves cómo lee tus archivos.
Pregunta
«¿Qué hace este proyecto?», «¿dónde está el punto de entrada?», «explica la estructura de carpetas».
Pide un cambio pequeño
«Añade una función hola mundo al archivo principal». Te enseña el cambio y te pide permiso.
Usa Git hablando
«¿Qué archivos he cambiado?», «haz un commit con un mensaje descriptivo», «crea una rama».
Arregla algo concreto
«Hay un fallo: los usuarios pueden enviar el formulario vacío, arréglalo». Cuanto más concreto, mejor.
Divide lo grande
Pide los pasos por orden: primero la tabla, luego el endpoint, luego la página.
Déjale explorar antes
Antes de cambiar nada, pídele que analice el código o el esquema.
Los comandos esenciales
| Dónde lo escribes | Comando | Qué hace |
|---|---|---|
| Terminal | claude | Abre una sesión interactiva |
| Terminal | claude "arregla el error de compilación" | Abre una sesión con una primera petición |
| Terminal | claude -p "explica esta función" | Hace una consulta y sale (sirve para scripts) |
| Terminal | claude -c | Continúa la última conversación de esta carpeta |
| Terminal | claude -r | Retoma una conversación anterior |
| Dentro | /help | Muestra los comandos disponibles |
| Dentro | /clear | Borra el historial de la conversación |
| Dentro | /resume | Continúa una conversación anterior |
| Dentro | /init | Genera un CLAUDE.md inicial analizando tu proyecto |
| Dentro | /exit o Ctrl+D dos veces | Sale |
Escribe / para ver los comandos y las skills disponibles, usa Tab para completar y la flecha arriba para el historial. Pulsa Shift+Tab para cambiar el modo de permisos de la sesión.
¿Cuánto cuesta Claude Code?
Claude Code se paga con una suscripción de Claude (Pro, Max, Team o Enterprise), con crédito de API en la Consola de Anthropic o por token a través de una nube; la documentación oficial cifra la media en empresas en unos 13 dólares por desarrollador y día activo.
Yo lo uso con el plan Pro, que me cuesta unos 20 euros al mes. Los precios de los planes cambian: compruébalos en claude.com/pricing.
Mide antes de pagar más.
| Cómo lo pagas | Qué cobran | Para quién |
|---|---|---|
| Suscripción (Pro, Max, Team, Enterprise) | Cuota mensual; el uso consume el cupo de tu plan, con límites de sesión y semanales | Uso personal y equipos pequeños |
| Consola de Anthropic (API) | Pago por token, con crédito prepagado | Quien quiere controlar el gasto al céntimo |
| Nube (Bedrock, Google Cloud, Microsoft Foundry) | Por token, en tu factura de la nube | Empresas que ya trabajan en esa nube |
Mi consumo real, medido
Medí cuánto procesó Claude Code en las transcripciones de este ordenador (del 26 de agosto al 9 de octubre de 2026): 103 sesiones, 18.652 respuestas y 21,2 millones de tokens escritos por Claude. (Son 108 transcripciones, 103 con respuestas.) Pero lo importante es otra cosa: el 97,5 % de lo que procesó fue contexto releído de la memoria caché.
Claude Code envía la conversación entera en cada respuesta. La caché la hace mucho más barata, pero explica por qué una sesión que lleva horas abierta gasta más de lo que parece.
Cómo gastar menos
Limpia entre tareas
/clear al cambiar de tema, con /rename antes para poder volver. El contexto viejo se paga en cada mensaje.
Elige el modelo
Sonnet resuelve la mayoría de tareas y cuesta menos que Opus. Cambia con /model.
Desactiva MCP que no uses
Con /mcp ves los servidores. Las definiciones de herramientas se cargan solo cuando hacen falta.
CLAUDE.md corto
Menos de 200 líneas. Lo específico de un flujo, mejor en una skill, que solo se carga cuando se usa.
Planifica antes
El modo plan (Shift+Tab) explora y propone antes de tocar nada: evita rehacer trabajo.
Mide con /usage
Te enseña el uso de la sesión y, en planes de pago, qué consume tu cupo: skills, subagentes y servidores MCP.
Fuente de las cifras oficiales: documentación de costes, consultada el 9 de octubre de 2026. Los datos de media empresarial no son mi gasto: el mío está arriba.
¿Qué es CLAUDE.md y para qué sirve?
CLAUDE.md es un archivo de texto con las instrucciones permanentes de tu proyecto: Claude Code lo lee al empezar cada sesión, así no tienes que repetirle tus normas. Cada sesión arranca con la memoria en blanco, y este archivo es lo que se la rellena.
| Tipo | Dónde está | Para qué |
|---|---|---|
| Del proyecto | ./CLAUDE.md o ./.claude/CLAUDE.md | Normas del proyecto, compartidas con el equipo por git |
| Tuyo, en todos los proyectos | ~/.claude/CLAUDE.md | Tus preferencias personales |
| Local | ./CLAUDE.local.md | Preferencias de este proyecto que no se suben a git |
| De la organización | /etc/claude-code/CLAUDE.md en Linux y WSL | Normas de una empresa, gestionadas por TI |
Empieza con /init
Analiza tu proyecto y genera un CLAUDE.md con los comandos de construcción y las convenciones que encuentra.
Menos de 200 líneas
Más largo consume más contexto y se cumple peor. Lo que afecta solo a una parte, a una regla por ruta o a una skill.
Importa y reutiliza
Con @ruta/archivo importas otros archivos. Si tu repositorio ya tiene un AGENTS.md, Claude Code puede leerlo.
Además existe la memoria automática: notas que Claude escribe él mismo a partir de tus correcciones. Una advertencia importante de la documentación: CLAUDE.md es contexto, no una regla obligatoria. Para bloquear una acción de verdad hay que usar un hook.
# Mi proyecto - Respuestas siempre en español. - Para probar: npm test - No toques la carpeta /legado sin preguntarme. - Antes de borrar algo, deja una copia.
¿Qué son las skills de Claude Code?
Una skill es un conjunto de instrucciones que amplía lo que Claude Code sabe hacer: la escribes una vez en un archivo SKILL.md y Claude la usa cuando el encargo encaja, o tú la llamas con /nombre.
Escribe el procedimiento una vez.
--- name: api-conventions description: API design patterns for this codebase --- When writing API endpoints: - Use RESTful naming conventions - Return consistent error formats - Include request validation
| Dónde vive | Ruta |
|---|---|
| Proyecto | .claude/skills/<nombre>/SKILL.md |
| Personal | ~/.claude/skills/<nombre>/SKILL.md |
| Plugin | <plugin>/skills/<nombre>/SKILL.md |
El campo description le dice a Claude cuándo usarla. Úsala cuando repites siempre el mismo checklist o procedimiento. A diferencia de CLAUDE.md, el cuerpo de una skill solo se carga cuando se usa.
Las mías: la skill de edición de vídeo, que reparto gratis, una de SEO semántico y una de Search Console. Documentación: skills en Claude Code.
¿Cómo conecto Claude Code con otras herramientas?
Con MCP (Model Context Protocol), el estándar abierto que conecta agentes de IA con herramientas externas: añades un servidor con claude mcp add y Claude Code puede usar tu navegador, Search Console, WordPress o un generador de vídeo. Yo tengo 19 servidores usados y 1.133 llamadas medidas.
claude mcp add --transport http notion https://mcp.notion.com/mcp claude mcp list
La guía completa, con animaciones, mensajes reales y los MCP que uso, está en Qué es un MCP. Un ejemplo de uso real: crear vídeos con Pollo.ai MCP desde Claude Code.
¿Qué he hecho yo con Claude Code?
He usado Claude Code para clonar una web, editar vídeos, investigar con NotebookLM, auditar SEO, generar vídeo con IA y escribir mis propios servidores MCP, y cada caso está medido y publicado.
Editar un vídeo con Claude Code
6:37 de vídeo montado en unos 15 minutos de máquina y la skill gratis.
Leersystemd-oomd cerró mi terminal, con la sesión de Claude Code dentro. Desde entonces lanzo los renders pesados con un límite de memoria. Lo cuento en el artículo de edición de vídeo.¿Se puede usar Claude Code gratis?
Se puede usar sin pagar la API de Anthropic conectándolo a modelos de Ollama con ollama launch claude, pero no es gratis del todo: depende de la cuota de Ollama y la calidad no es la de Opus o Sonnet.
La guía completa, con lo que cambió en los planes de Ollama el 31 de agosto, está en cómo usar Claude Code gratis con Ollama. «Claude Code gratis» se busca unas 590 veces al mes en Google España.
Gratis, con letra pequeña.
¿Es seguro? Modos de permisos
Claude Code te deja elegir cuánto puede hacer sin preguntarte, con seis modos de permisos que cambias en cualquier momento con Shift+Tab; el modo por defecto solo lee sin preguntar.
| Modo | Qué hace sin preguntar | Para qué sirve |
|---|---|---|
default (Manual) | Solo leer | Revisar cada acción tú mismo; trabajo delicado |
acceptEdits | Leer, editar archivos y comandos básicos de archivos (mkdir, mv, cp…) | Iterar sobre código que estás revisando |
plan | Leer; con el modo auto disponible, también comandos que apruebe su clasificador | Explorar el código antes de cambiar nada |
auto | Todo, con comprobaciones de seguridad en segundo plano | Tareas largas, para no tener que aprobar cada paso |
dontAsk | Solo lo que ya autorizaste; lo demás se deniega | Scripts y entornos de integración continua |
bypassPermissions | Todo | Solo en contenedores y máquinas virtuales aisladas |
Empieza en Manual o plan
Hasta que sepas lo que hace, déjale leer y revisa tú cada cambio.
Copias antes de escribir
En mis servidores MCP guardo una copia antes de cualquier escritura. Es un hábito mío, no un modo de Claude Code.
Reglas de denegación
Una regla de denegación bloquea una acción en todos los modos, incluso en bypassPermissions.
Cuidado con el contenido externo
Los servidores que traen contenido de fuera exponen a inyección de instrucciones: verifica que confías en cada servidor.
Fuente: modos de permisos de la documentación oficial (9 de octubre de 2026).
¿Qué errores da Claude Code y cómo se arreglan?
Los fallos más comunes son de instalación (el comando no se encuentra), de cupo agotado y de memoria en tareas pesadas; casi todos se resuelven con una terminal nueva, esperar al reinicio o limitar los recursos.
«claude» no se reconoce o no se encuentra tras instalar
- Qué significa
- La carpeta de instalación no está en el PATH.
- Cómo se arregla
- Abre una terminal nueva y ejecuta
claude --version. Si sigue igual, añade la carpeta al PATH (la documentación tiene una sección «Fix your PATH»). - Dónde lo vi
- Documentación oficial.
«The token ‘&&’ is not a valid statement separator»
- Qué significa
- Estás en PowerShell y has pegado el comando de CMD.
- Cómo se arregla
- Usa el comando de PowerShell (
irm … | iex) o abre CMD. El indicador «PS C:\» es PowerShell. - Dónde lo vi
- Documentación oficial.
Error 403 o «syntax error near unexpected token ‘<‘» al instalar
- Qué significa
- La descarga del instalador falló.
- Cómo se arregla
- Consulta la guía de problemas de instalación de la documentación y prueba otro método (Homebrew o WinGet).
- Dónde lo vi
- Documentación oficial.
«You’ve hit your session limit» o «weekly limit»
- Qué significa
- Has agotado tu cupo de la ventana de cinco horas o de la semana.
- Cómo se arregla
- Espera al reinicio que indica el mensaje, usa créditos de uso si los tienes activados con
/usage-credits, o cambia de familia de modelo con/modelsi el mensaje es de Opus o de Sonnet. - Dónde lo vi
- Documentación oficial.
Gasto que sube en una sesión larga
- Qué significa
- Cada respuesta relee todo el contexto, y tras una pausa la caché caduca.
- Cómo se arregla
- Usa
/clearentre tareas,/compactcon instrucciones y mira/usage. - Dónde lo vi
- Mis datos: 97 % de contexto releído.
La terminal se cierra en mitad de un render o un script pesado
- Qué significa
- Se acabó la memoria y el sistema mató el proceso.
- Cómo se arregla
- Lanza las tareas pesadas con un límite de memoria y reinicios por pieza.
- Dónde lo vi
- Me pasó el 5 de octubre de 2026.
Un servidor MCP no conecta
- Qué significa
- Autorización caducada, ruta que no existe o plan que no incluye el acceso.
- Cómo se arregla
- Empieza con
claude mcp listy/mcp. Hay una tabla de errores completa en la guía de MCP. - Dónde lo vi
- Mis propios servidores.
Si el problema es de un servidor MCP, tienes la tabla completa en la guía de MCP.
Pista: lee el mensaje de error.
Preguntas rápidas sobre Claude Code
¿Necesito saber programar para usar Claude Code?
¿Claude Code funciona en Windows?
¿En qué se diferencia de ChatGPT?
¿Qué modelo usa?
/model: Sonnet para la mayoría de tareas y Opus para razonamiento complejo. El que más usé en mis sesiones medidas fue Opus 5.5, con el 42 % de las respuestas.¿Claude Code frente a Codex o Cursor?
¿Es gratis?
¿Puedo usarlo en VS Code?
¿Se puede automatizar?
claude -p lo lanzas desde scripts, y hay tareas programadas, hooks y subagentes. Lo cuento en la documentación oficial y en mis servidores MCP.Aprende a dominar Claude Code
Entra en mi comunidad de Skool, que es gratuita: ahí dejo las plantillas, las skills y lo que pruebo antes de publicarlo.
¡Nos vemos en la terminal!
Más sobre Claude Code
Fuentes: documentación oficial de Claude Code (visión general, inicio rápido, costes, memoria, skills, modos de permisos), consultadas el 9 de octubre de 2026. Datos propios: transcripciones de Claude Code de este ordenador, del 26 de agosto al 9 de octubre de 2026.
