Claude Code en español: qué es, cuánto cuesta y cómo instalarlo sin ser programador

Para armar este sitio bajé 18 archivos de Google Keyword Planner. Juntos sumaban 48.515 filas, llenas de keywords repetidas. No los abrí uno por uno: se los pasé a Claude Code, le expliqué en español qué necesitaba y me devolvió un Excel con 45.806 keywords únicas, una hoja por tema.

Claude Code es la versión de Claude que trabaja dentro de tu computadora. Lee los archivos de una carpeta, los edita y ejecuta comandos en la terminal mientras tú le explicas qué quieres. En esta guía lo instalas en Windows, Mac o Linux en unos 5 minutos, haces tu primera sesión y ves tres proyectos que puedes hacer con él.

Te digo lo malo antes de empezar: Claude Code no viene en el plan gratis de Claude. Necesitas Pro, Max o una cuenta de API.

Resumen rápido

• Qué necesitas: Windows 10 (versión 1809 o más nueva), macOS 13 o Linux; 4 GB de RAM; internet; una cuenta de Claude Pro, Max, Team, Enterprise o Console.
• Comando para instalar en Windows (PowerShell): irm https://claude.ai/install.ps1 | iex
• Precio (octubre de 2026): desde USD 20 por mes con Claude Pro, o USD 17 por mes si pagas el año.
• Tiempo: 5 minutos para instalarlo y 10 más para la primera tarea.

Qué es Claude Code (y en qué se diferencia de Claude en el navegador)

En claude.ai copias y pegas: le pasas un texto, te devuelve otro y tú lo llevas a donde haga falta. Claude Code hace ese trabajo de punta a punta. Lo abres en una carpeta de tu computadora y puede ver todo lo que hay adentro, crear archivos nuevos, cambiar los que existen y ejecutar programas para comprobar que lo que hizo funciona.

Con las keywords del principio, unió los 18 archivos en una sola tabla, sacó los duplicados y clasificó cada keyword por tema con un script de Python que escribió él mismo. No salió perfecto a la primera: al revisar el Excel encontré keywords en el tema equivocado. Le marqué esos casos y ajustó las reglas. Con Claude en el navegador habría tenido que copiar y pegar cada archivo a mano.

Qué puede hacer

• Leer tu proyecto: le preguntas “¿qué hace esta carpeta?” y la recorre solo. No hace falta pegarle el contenido.
• Escribir y editar archivos: código, textos, hojas de cálculo en CSV, páginas web.
• Ejecutar comandos: instalar dependencias, correr un script, abrir un servidor de prueba, usar Git.
• Pedir permiso: antes de cambiar archivos o ejecutar algo, te muestra qué va a hacer y tú lo apruebas. Con Shift+Tab cambias cuánto puede hacer sin preguntarte.

Claude Code vs. Claude.ai vs. Cursor

Cuánto cuesta Claude Code

¿Hay Claude Code gratis?

No. Según la documentación oficial, Claude Code necesita una cuenta Pro, Max, Team, Enterprise o de Console (la de API). El plan gratis de claude.ai no lo incluye. Si viste una guía que dice que se usa gratis, o es vieja o habla de otra cosa.

Pro, Max o API: cuál te conviene

Precios tomados de claude.com/pricing el 15 de octubre de 2026, en dólares:

Para qué uso alcanza cada uno:

• Pro: para empezar, aprender y proyectos chicos. Es el que conviene probar primero. Si pagas el año, son USD 200 por adelantado.
• Max (5x y 20x): si lo usas varias horas por día y Pro se te queda corto.
• Team: para equipos de 2 a 150 personas. USD 25 por usuario al mes (USD 20 si pagas el año); el asiento premium cuesta USD 125 (100 anual).
• Console (API): pagas por uso, con crédito precargado. Sirve si ya usas la API o quieres controlar el gasto por proyecto.

Te recomiendo empezar con Pro. Si en el primer mes llegas seguido al límite de uso, ahí sí piensa en Max. Con /usage, dentro de Claude Code, ves cuánto llevas gastado del plan.

Los precios cambian. Antes de pagar, confírmalos en claude.com/pricing.

Requisitos antes de instalar

• Sistema operativo: Windows 10 versión 1809 o posterior (o Windows Server 2019+), macOS 13.0 o posterior, Ubuntu 20.04+, Debian 10+ o Alpine 3.19+.
• Computadora: 4 GB de RAM o más, procesador x64 o ARM64.
• Internet: sí o sí, porque el modelo corre en los servidores de Anthropic.
• País: tiene que estar en la lista de países soportados por Anthropic.
• Cuenta: Pro, Max, Team, Enterprise o Console. Créala antes de instalar, así el inicio de sesión sale a la primera.

Cómo instalar Claude Code en Windows

En Windows hay tres caminos. Los tres dejan Claude Code funcionando. El primero es el que recomienda Anthropic, porque se actualiza solo.

Primero, revisa en qué terminal estás. Si la línea empieza con PS C:\, estás en PowerShell. Si dice C:\ sin el PS, estás en CMD (Símbolo del sistema). Para abrir PowerShell, presiona la tecla Windows, escribe “PowerShell” y presiona Enter. No hace falta abrirlo como administrador.

Con PowerShell (recomendado)

Pega esto y presiona Enter:

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

El instalador no muestra una barra de progreso mientras descarga, así que puede parecer que no pasa nada. Espera a que vuelva a aparecer la línea de comandos.

Cuando termine, cierra esa ventana y abre una nueva (si no, Windows no se entera de que el programa existe). Después comprueba que quedó instalado:

claude --version

Tiene que aparecer un número de versión seguido de (Claude Code).

Con CMD

Si estás en el Símbolo del sistema, el comando es otro:

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

Dos errores típicos te avisan que estás en la terminal equivocada. Si te sale The token '&&' is not a valid statement separator, estás en PowerShell: usa el comando de la sección anterior. Si te sale 'irm' is not recognized, estás en CMD: usa este.

Con WinGet

Si usas el gestor de paquetes de Windows:

winget install Anthropic.ClaudeCode

Esta versión no se actualiza sola. De vez en cuando vas a tener que ejecutar winget upgrade Anthropic.ClaudeCode. Por eso prefiero el instalador de PowerShell.

¿Necesito Git para Windows o WSL?

No para empezar. Claude Code funciona en Windows sin nada más. Igual hay dos cosas que conviene saber:

• Git para Windows (git-scm.com) es opcional, pero ayuda: le da a Claude Code una terminal tipo Linux (Git Bash) para ejecutar comandos. Sin Git, usa PowerShell y funciona igual para la mayoría de las tareas.
• WSL 2 (Linux dentro de Windows) solo vale la pena si trabajas con herramientas de Linux o quieres el modo sandbox, que ejecuta los comandos en un entorno aislado. En Windows nativo ese modo no está disponible.

Error “claude no se reconoce”: cómo arreglarlo

Si te aparece este error después de instalar, casi siempre significa que Windows no sabe en qué carpeta quedó el programa. Claude Code se instala en %USERPROFILE%\.local\bin\claude.exe (o sea, C:\Users\TuUsuario\.local\bin).

1. Abre una ventana nueva de PowerShell y prueba otra vez claude --version. Una terminal que ya estaba abierta antes de instalar no ve el programa nuevo.

2. Si sigue sin funcionar, revisa si el archivo existe:

   Test-Path "$env:USERPROFILE\.local\bin\claude.exe"
   

   Si dice False, la instalación no terminó: vuelve a ejecutar el instalador. Si dice True, sigue con el paso 3.

3. Agrega esa carpeta al PATH de tu usuario (se hace una sola vez):

   $currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
   [Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
   

4. Cierra todas las terminales y abre una nueva. Si usas la terminal de VS Code, cierra VS Code entero y vuelve a abrirlo, porque toma el PATH del momento en que arrancó.

Para un chequeo completo de la instalación existe claude doctor: no cambia nada, solo te muestra qué está bien y qué no.

Cómo instalar Claude Code en Mac y Linux

En macOS, Linux y WSL es un solo comando:

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

En Mac también puedes usar Homebrew:

brew install --cask claude-code

Igual que con WinGet, Homebrew no actualiza solo: de vez en cuando ejecuta brew upgrade claude-code. Después de instalar, abre una terminal nueva y comprueba con claude --version.

Si prefieres npm (hace falta Node.js 22 o más nuevo), el comando es npm install -g @anthropic-ai/claude-code. No le pongas sudo adelante: la documentación oficial lo desaconseja porque trae problemas de permisos.

Tu primera sesión: inicio de sesión y primeros comandos

Iniciar sesión con tu cuenta

Claude Code trabaja sobre la carpeta en la que lo abres. Antes de empezar, crea una carpeta para practicar, por ejemplo C:\proyectos\prueba, y entra en ella desde la terminal:

cd C:\proyectos\prueba
claude

La primera vez te pide que inicies sesión. Se abre el navegador, entras con tu cuenta de Claude y listo: las credenciales quedan guardadas y no te las vuelve a pedir. Si alguna vez quieres cambiar de cuenta, escribe /login dentro de Claude Code.

Después te pregunta si confías en los archivos de esa carpeta. Si la carpeta es tuya, acepta.

Ahora prueba con algo simple, en español:

crea un archivo llamado gastos.csv con 10 gastos de ejemplo de un mes y después dime cuál fue la categoría más cara

Te va a mostrar el archivo que piensa crear y te va a pedir permiso. Apruébalo y mira cómo lo hace.

Claude te contesta en el idioma en que le escribes. Los menús y los comandos están en inglés, pero son pocos y se aprenden rápido.

Los comandos que vas a usar siempre

Dentro de Claude Code, todo lo que empieza con / es un comando. Escribe / solo y te muestra la lista. Estos son los que más uso:

Y desde la terminal, antes de entrar:

Un atajo que te ahorra tiempo: Shift+Tab cambia el modo de permisos (cuánto puede hacer Claude sin preguntarte).

El archivo CLAUDE.md: qué es y una plantilla para copiar

Cada vez que abres Claude Code, empieza sin memoria de la vez anterior. El archivo CLAUDE.md le da la memoria que necesita: es un texto que Claude lee al empezar cada sesión, con las reglas de tu proyecto. Puede ir en la carpeta del proyecto (./CLAUDE.md) o en tu usuario (~/.claude/CLAUDE.md, para reglas que valen en todos tus proyectos).

La forma más fácil de empezar es escribir /init: Claude revisa la carpeta y te arma uno. Después lo vas corrigiendo. La documentación recomienda que no pase de 200 líneas, porque cuanto más largo, peor lo sigue.

Esta es una plantilla simple para un proyecto que no es de programación:

# Proyecto: [nombre]

## Qué es
[Una o dos líneas: para quién es y qué tiene que lograr.]

## Reglas
- Escribe siempre en español neutro y trátame de tú.
- Antes de borrar o reemplazar un archivo, pregúntame.
- Los números van con el formato de mi país (por ejemplo, 1.234,56).
- Si no sabes un dato, dilo. No inventes.

## Carpetas
- `datos/`: archivos originales, no se editan.
- `salida/`: lo que generas tú.

## Cómo sé que terminaste
- [Ej.: el Excel abre sin errores y tiene una hoja por mes.]

Deja la regla de “no inventes” aunque parezca obvia. Con ella en el CLAUDE.md vas a ver muchas más respuestas del estilo “ese dato no lo tengo, ¿me lo pasas?”.

Cómo pedirle las cosas para que salgan bien

La diferencia entre una sesión que te ahorra la tarde y una que te la hace perder está casi siempre en cómo pides. Cuatro costumbres que me funcionan:

1. Sé específico. En lugar de “arregla el error”, escribe “cuando cargo un gasto sin fecha, el total da cero; arréglalo”. Cuanto más se parezca tu pedido a cómo se lo explicarías a una persona, mejor.
2. Déjalo mirar antes de tocar. Empieza con “lee la carpeta y explícame qué hay” o usa /plan. Así arma un plan, tú lo revisas y solo después cambia archivos.
3. Divide lo grande en pasos. “1) junta los archivos, 2) saca los duplicados, 3) arma el resumen” sale mejor que un pedido gigante de una sola vez.
4. Dile cómo vas a comprobar que está bien. “El total de marzo tiene que dar 152.300” le da una forma de verificar su propio trabajo. Si no coincide, lo revisa antes de decirte que terminó.

Y si la conversación ya se hizo muy larga y empieza a confundirse, escribe /clear y empieza de nuevo con un pedido claro. Lo importante queda en el CLAUDE.md, así que no pierdes nada.

3 proyectos reales para hacer con Claude Code

Son trabajos que los negocios chicos necesitan y que Claude Code ya resuelve con pedidos como los de abajo. Si los ofreces a un cliente, lo que te paga es la página funcionando o el Excel que ya no tiene que llenar a mano; que lo hayas hecho con IA le da igual. No te prometo que alguien te los compre ni cuánto vas a cobrar: eso depende de tu zona, de tus clientes y de cómo lo vendas.

Una landing para un cliente en una tarde

Un negocio que hoy solo tiene Instagram necesita una página con lo que vende, los precios y un botón de WhatsApp. Le pides a Claude Code:

arma una landing de una sola página para una pastelería de barrio: portada, 6 productos con precio, horarios, mapa y un botón de WhatsApp. HTML y CSS en un solo archivo, que se vea bien en el celular.

Después ajustas colores, fotos y textos con el cliente al lado. Claude Code también te ayuda a publicarla gratis (por ejemplo, en Cloudflare Pages o Vercel). Lo que entregas es la página funcionando y publicada.

Automatizar un Excel que alguien hace a mano

En casi todas las pymes hay alguien que cada semana copia datos de un lado a otro: las ventas del sistema a una hoja de cálculo, la hoja a un informe. Le pasas a Claude Code un ejemplo del archivo de entrada y uno del resultado esperado:

en la carpeta datos/ hay 4 exportaciones semanales de ventas. Escribe un script en Python que las junte, sume las ventas por vendedor y por producto, y genere un Excel con una hoja por semana y una de resumen. Pruébalo con estos archivos.

El script queda guardado, así que la próxima semana se ejecuta con doble clic. Es el mismo tipo de trabajo que te conté al principio con las keywords de este sitio.

Un script que junta datos y te los manda por correo

Precios de la competencia, cotización del dólar, publicaciones nuevas en un portal: mucha gente revisa lo mismo todos los días a mano. Claude Code puede escribirte un script que busque esos datos, los guarde en una hoja de cálculo y te mande un resumen por correo.

escribe un script que cada mañana lea el precio de estos 5 productos en estas páginas [links], lo guarde en precios.csv con la fecha y me avise si alguno bajó más de 10%.

Antes de ofrecerlo, revisa que las páginas permitan leer esos datos (sus términos de uso). Y ten en cuenta que, si una página cambia su diseño, hay que volver a tocar el script. Ese mantenimiento también es trabajo, y se cobra aparte.

Errores comunes (y cómo salir)

Próximo paso

Si ya lo tienes instalado, abre una carpeta con algo tuyo (una hoja de gastos, los textos de tu negocio) y pídele una tarea chica. Es la forma más rápida de entender qué puede hacer.

Para seguir:

• Qué es Claude y cómo usarlo gratis Próximamente
• ChatGPT vs. Claude vs. Gemini: cuál conviene Próximamente
• Qué son los agentes de IA Próximamente

Fuentes: documentación oficial de Claude Code (instalación, requisitos y cuentas), guía de inicio rápido, solución de problemas de instalación y precios de Claude. Consultadas el 15 de octubre de 2026.