Cómo usar Claude Code: la IA desde la terminal, para novatos

Hasta ahora, usar inteligencia artificial era más o menos así: abrís una página, escribís tu pregunta, la IA te responde y vos copiás esa respuesta a donde la necesites. Claude Code rompe ese esquema: es la IA de Anthropic corriendo dentro de la terminal de tu computadora, con permiso para leer tus archivos, modificarlos y ejecutar comandos por vos. En vez de darte texto para copiar, hace el trabajo. En esta guía te explico qué es, cuánto cuesta de verdad, cómo instalarlo paso a paso y los seis tropiezos clásicos que frenan a cualquier novato, con su solución exacta.

Qué es Claude Code, explicado en criollo

La "terminal" es esa ventana oscura donde se escriben comandos, la de las películas de hackers. Suena intimidante, pero es solo otra forma de hablar con tu compu: en vez de hacer clic en botones, escribís órdenes. Claude Code vive ahí. Lo abrís parado en la carpeta de un proyecto y le pedís cosas en español normal: "explicame qué hay en esta carpeta", "creá una página web simple con mi nombre", "buscá por qué esto da error y arreglalo".

La diferencia clave con el chat de claude.ai es que Claude Code no solo responde: actúa. Lee tus archivos, crea archivos nuevos, corrige los que ya existen, instala lo que falta y ejecuta el resultado para verificar que funciona. Es lo que se conoce como un agente de IA: le das un objetivo y encadena los pasos hasta cumplirlo, pidiéndote confirmación antes de cada acción importante. Un chat te explica cómo hacer algo; un agente lo hace.

Cuánto cuesta, sin humo

Aclaremos esto antes de que pierdas media hora instalando: Claude Code no viene incluido en el plan gratuito de Claude. Para usarlo necesitás una de estas dos cosas:

• Una suscripción paga de claude.ai: el plan Pro ronda los US$20 por mes a la fecha de escribir esto (el precio lo fija Anthropic y puede cambiar, y desde Argentina se le suman los impuestos a servicios del exterior). Iniciás sesión en Claude Code con esa misma cuenta y consumís el cupo de tu plan.
• Una API key con crédito: en vez de un abono fijo, cargás saldo y pagás por uso. Puede convenir si lo vas a usar poco o querés probar sin suscribirte.

Consejo honesto: si recién estás arrancando con la inteligencia artificial, no empieces por acá. Usá primero Claude desde el chat, que es gratis, y saltá a Claude Code cuando quieras que la IA trabaje sobre archivos y proyectos reales.

Cómo instalarlo paso a paso

1. Instalá Node.js. Es un programa gratuito que Claude Code necesita para funcionar. Entrá a nodejs.org, descargá la versión marcada como "LTS" e instalala aceptando todo por defecto.
2. Abrí la terminal. En Windows: menú de inicio, escribí "PowerShell" y abrilo. En Mac: buscá "Terminal" con Spotlight.
3. Instalá Claude Code escribiendo este comando y apretando Enter: npm install -g @anthropic-ai/claude-code
4. Parate en una carpeta de trabajo. Creá una carpeta nueva para tu proyecto (por ejemplo "mi-proyecto") y entrá a ella desde la terminal con el comando cd mi-proyecto.
5. Arrancalo. Escribí claude y Enter. La primera vez te pide iniciar sesión: te abre el navegador, entrás con tu cuenta y listo, ya estás chateando con la IA adentro de la terminal.

Los 6 tropiezos clásicos (y cómo salir de cada uno)

1. "npm no se reconoce como un comando"

Significa que Node.js no está instalado, o que lo instalaste y no cerraste la terminal. Instalá Node desde nodejs.org, cerrá la terminal y abrila de nuevo (este detalle se lleva puesta a la mitad de los principiantes) y probá otra vez.

2. PowerShell bloquea la ejecución de scripts

En Windows es muy común chocar con este error: "...no se puede cargar porque la ejecución de scripts está deshabilitada en este sistema". Es una protección de fábrica de PowerShell, no algo que rompiste vos. Se resuelve con un solo comando que habilita los scripts confiables para tu usuario:

Set-ExecutionPolicy -Scope CurrentUser RemoteSigned

Lo escribís, Enter, confirmás con "S" si te pregunta, y cerrás y volvés a abrir PowerShell. Listo.

3. Tenés un Node.js viejo

Si la instalación falla con errores raros de versión, tu Node quedó antiguo. Descargá de nuevo la versión LTS actual desde nodejs.org e instalala arriba de la anterior. Verificás con node -v.

4. Creer que con la cuenta gratis alcanza

Si al iniciar sesión te dice que tu plan no incluye Claude Code o que no tenés crédito, es lo que vimos arriba: necesitás el plan Pro o una API key con saldo. No es un error tuyo; es el requisito.

5. Abrirlo en cualquier carpeta

Claude Code trabaja sobre la carpeta donde lo abrís. Si lo arrancás "en cualquier lado" (por ejemplo, en la carpeta de usuario con todos tus documentos), le estás dando acceso y contexto gigantes sin necesidad. Creá siempre una carpeta por proyecto y abrilo ahí adentro.

6. Aceptar todo sin leer

Antes de tocar un archivo o ejecutar un comando, Claude Code te pide permiso. El tropiezo es apretar que sí en automático. Leé qué te propone, sobre todo si trabaja sobre archivos que te importan, y tené copia de seguridad de lo valioso. La IA se equivoca, y acá sus equivocaciones tocan archivos reales.

Qué puede hacer un agente que un chat no

Para que se entienda el salto, ejemplos de pedidos reales que Claude Code resuelve solo, de punta a punta:

• "Creá una página web simple con mi nombre y mis redes, y decime cómo verla en el navegador."
• "Leé todos los archivos de esta carpeta y explicame qué hace este proyecto, como si yo fuera nuevo."
• "Este programa tira este error cuando lo abro: [pegás el error]. Encontrá la causa y corregila."
• "Cambiale el nombre a esta función en todos los archivos donde aparezca y verificá que nada se rompa."

En un chat común, cada una de esas tareas implica copiar y pegar archivos de a uno, en un ida y vuelta eterno. Acá la IA navega el proyecto sola. Por eso, aunque hay varias IA muy buenas para programar, los agentes de terminal son el escalón siguiente: no te asisten mientras trabajás, trabajan ellos.

Límites honestos

Claude Code no es magia. Consume tu cupo rápido si le pedís tareas grandes (los planes tienen límites de uso que se renuevan cada tantas horas). Se equivoca con total confianza, como cualquier IA, así que revisá lo que produce antes de usarlo en serio. Y aunque no necesitás saber programar para arrancar, entender lo básico de qué es un archivo, una carpeta y un comando te destraba mil veces más rápido cuando algo sale raro.

El siguiente paso

Si esto hoy te queda grande, está perfecto: el orden correcto es aprender primero a pedirle bien a la IA, y recién después darle las llaves de tu compu. Para lo primero armamos el libro que te lleva de cero a experto: un ebook en español, barato y sin vueltas, que te lleva de cero a usar la inteligencia artificial con confianza, incluyendo estos temas nuevos como agentes y vibe coding. Y si ya te animaste a la terminal: instalá Node, corré el comando y dale. La primera vez que veas a la IA crear y corregir archivos sola en tu computadora, entendés de golpe hacia dónde va todo esto — y con la base de la guía que te enseña a usar la IA de verdad, lo aprovechás el doble.