🖥️ Claude AI para PC — Windows

¿Qué es Claude Code CLI?

Claude Code es la herramienta de línea de comandos (CLI) de Anthropic que se usa directamente en tu editor de código o terminal de Windows. Te permite pedirle a Claude que lea, edite y organice tus archivos de proyecto — sin tener que copiar y pegar código en el navegador.

Con Claude Code puedes: refactorizar código, depurar errores, organizar proyectos completos, leer múltiples archivos y ejecutar tareas complejas de desarrollo directamente desde tu terminal o VS Code.

¿Está incluido en el plan gratuito?

Claude Code CLI requiere autenticación con una cuenta claude.ai. Con el Plan Pro ($20/mes) puedes usarlo sin pagar por tokens adicionales — el consumo está cubierto en el precio fijo.

Con la API de Anthropic pagas por token (~$3–$15 por millón), lo que puede ser más económico si tu uso es esporádico, pero más costoso si trabajas horas seguidas.

Diferencia entre claude.ai web y Claude Code CLI

Característicaclaude.ai (web)Claude Code (CLI)
Dónde viveNavegador webTerminal / VS Code
Accede a tus archivosNo (debes pegar el código)Sí directamente
Edita múltiples archivosNo
Ideal paraConversaciones, análisisDesarrollo de software
Requiere instalaciónNoSí (Node.js)

⚙️ Instalación en Windows (paso a paso)

Requisitos previos

  • ✅ Windows 10 u 11 (64 bits)
  • ✅ Node.js versión 18 o superior — descárgalo en nodejs.org
  • ✅ Cuenta en claude.ai (gratuita o Plan Pro)
  • ✅ Terminal: PowerShell, CMD o Windows Terminal

Instalación

  1. Instala Node.js
    Ve a nodejs.org → descarga la versión LTS → instala con las opciones por defecto.
  2. Verifica la instalación de Node
    Abre PowerShell y escribe: node --version — debe mostrar v18 o superior.
  3. Instala Claude Code
    En PowerShell escribe: npm install -g @anthropic-ai/claude-code
  4. Verifica la instalación
    Escribe: claude --version — debe mostrar la versión instalada.
  5. Inicia sesión con tu cuenta
    Escribe: claude → se abrirá el navegador → inicia sesión en claude.ai → aprueba el acceso.
  6. ¡Listo! Navega a tu proyecto con cd ruta\de\tu\proyecto y empieza a usar Claude Code.

⚠️ Problemas comunes en Windows

ErrorSolución
claude: no se reconoce como comandoReinicia PowerShell y vuelve a intentarlo. Si persiste, verifica que Node.js esté en el PATH del sistema.
npm: acceso denegadoAbre PowerShell como Administrador y ejecuta el comando de instalación nuevamente.
El navegador no abre para el loginCopia el link que aparece en la terminal y pégalo manualmente en tu navegador.
Rutas con espacios dan errorUsa comillas: cd "C:\mis proyectos\super app"

💳 API vs Plan Pro — ¿Cuál te conviene?

⚡ API Pay-per-use

Variable
  • 💸 Pagas por cada token que consumes
  • 📊 ~$3 entrada / ~$15 salida por millón de tokens
  • 🔑 Usas una ANTHROPIC_API_KEY
  • ⚠️ Conversaciones largas = factura alta
  • 🚀 Sin límite de rate si tienes crédito
  • Ideal si usas Claude Code ocasionalmente

🌟 Plan Pro

$20 /mes
  • 📅 Pago fijo mensual — sin sorpresas
  • 🖥️ Incluye claude.ai web + Claude Code CLI
  • 🔒 Login con cuenta claude.ai (sin API key)
  • Cuota generosa para uso diario
  • ⚠️ Tiene límite de uso por hora
  • Ideal si usas Claude Code todos los días

💡 ¿Cuándo usar cada uno?

SituaciónRecomendación
Uso esporádico (menos de 30 min/día)API — pagas solo lo que usas
Uso diario moderado (1–3 horas/día)Pro $20 — más económico
Uso intensivo (más de 5 horas/día)Max $100 — sin limitaciones
Equipo de desarrolloTeam $30/usuario/mes
Quieres claude.ai web incluidoPro $20 o superior

🗂️ Todos los planes — Claude Code CLI incluido en todos

PlanPrecioClaude Codeclaude.ai WebLímite uso
🔑 APIVariableNoSin límite (con crédito)
⭐ Pro$20/mesModerado por hora
🚀 Max 5×$100/mesSí (5× Pro)Alto
💎 Max 20×$200/mesSí (20× Pro)Muy alto
👥 Team$30/usuarioAlto

🔧 Cambiar de API → Plan Pro en Windows

  1. Suscríbete al Plan Pro
    Ve a claude.ai → Settings → Billing → Upgrade to Pro → paga con tarjeta.
  2. Cierra sesión de la API en Claude Code
    En PowerShell escribe: claude logout
  3. Inicia sesión con tu cuenta claude.ai
    Escribe: claude → se abre el navegador → inicia sesión → aprueba el acceso.
  4. (Opcional) Elimina la API key del sistema
    Ve a Panel de control → Sistema → Variables de entorno y elimina ANTHROPIC_API_KEY si existe.
  5. Verifica que funciona
    Navega a un proyecto: cd ruta\proyecto → escribe claude → ya estás usando el Plan Pro.

💡 Tips para usar Claude en Windows

🖱️ Integración con VS Code

Abre VS Code, activa la terminal integrada (Ctrl + `) y usa Claude Code directamente desde el editor. Puedes ver los cambios en tiempo real.

📁 Navegar entre proyectos

Usa cd "C:\ruta\proyecto" para moverte entre proyectos. Claude Code trabaja siempre en el directorio actual — asegúrate de estar en la carpeta correcta.

📋 Copiar rutas rápido en Windows

En el Explorador de Archivos: Shift + clic derecho sobre una carpeta → "Copiar como ruta" → pégala en la terminal.

⌨️ Atajos útiles en PowerShell

↑ ↓ para historial de comandos. Tab para autocompletar rutas. Ctrl + C para cancelar una operación en curso.

🔄 Mantener Claude actualizado

Actualiza Claude Code periódicamente con: npm update -g @anthropic-ai/claude-code para tener las últimas funciones y correcciones.

🛡️ Permisos en Windows 11

Si PowerShell bloquea scripts, abre como Administrador y ejecuta: Set-ExecutionPolicy RemoteSigned para permitir scripts de npm.

🎬 Videos: Claude Code CLI en Windows

Claude Code CLI — Introducción y primeros pasos

Instalar Claude Code en Windows paso a paso

Claude Code con VS Code — integración y flujo de trabajo

API vs Plan Pro — cuál conviene según tu uso

🧪 Taller Práctico: Claude Code en Windows

Sigue estos pasos en tu equipo con Windows. Necesitas conexión a internet y una cuenta claude.ai.

1. Instalar Node.js

  • Ve a nodejs.org y descarga la versión LTS.
  • Instala con las opciones por defecto (incluye npm).
  • Abre PowerShell y verifica: node --version
  • Debe mostrar v18 o superior.

2. Instalar Claude Code

  • En PowerShell (como Administrador) ejecuta:
  • npm install -g @anthropic-ai/claude-code
  • Verifica: claude --version
  • Inicia sesión: claude → aprueba en el navegador.

3. Primera prueba

  • Crea una carpeta de prueba en el Escritorio.
  • Navega: cd "%USERPROFILE%\Desktop\prueba"
  • Escribe a Claude: "Crea un archivo HTML con un saludo animado."
  • Verifica que el archivo fue creado correctamente.

4. Comparar API vs Pro

  • Si tienes API key: úsala durante una sesión de trabajo normal.
  • Calcula cuánto consumiste en tokens (disponible en console.anthropic.com).
  • Compara ese costo con $20/mes del Plan Pro.
  • Decide cuál plan te conviene según tu uso real.

5. Integrar con VS Code

  • Abre VS Code con tu proyecto.
  • Activa la terminal: Ctrl + `
  • Escribe claude en la terminal integrada.
  • Pide a Claude que lea y explique un archivo del proyecto.

6. Tarea de organización

  • Navega a un proyecto existente con varios archivos.
  • Pide: "Analiza todos los archivos y dime cómo está organizado este proyecto."
  • Luego: "¿Qué mejorarías en la estructura?"
  • Aplica una sugerencia que te parezca útil.

🏆 Reto Final: Usa Claude Code para organizar completamente una carpeta de un proyecto que tengas pendiente. Pídele que lea todos los archivos, sugiera mejoras y realice una de ellas automáticamente. Observa cuánto tiempo te ahorra.

⌨️ Comandos de terminal — Claude Code CLI

Claude Code es la CLI oficial de Anthropic que permite usar Claude directamente desde la terminal. Se instala con npm i -g @anthropic-ai/claude-code y se ejecuta escribiendo claude en cualquier carpeta de proyecto.

Inicio y sesión
ComandoQué hace
claudeAbre el chat interactivo en la terminal dentro del proyecto actual.
claude loginInicia sesión con tu cuenta de Anthropic (abre el navegador para autenticarte).
claude logoutCierra la sesión activa.
claude --versionMuestra la versión instalada de Claude Code.
claude updateActualiza Claude Code a la última versión disponible.
Modos de ejecución
ComandoQué hace
claude "pregunta o tarea"Ejecuta una tarea puntual sin abrir el chat interactivo (modo no interactivo).
claude -p "tarea"Igual que el anterior; el flag -p pasa el prompt directamente.
claude --dangerously-skip-permissionsEjecuta Claude en modo autónomo sin pedir confirmación en cada acción (usar con precaución).
claude --model claude-opus-4-5Fuerza el uso de un modelo específico para esa sesión.
Comandos de barra ( / ) dentro del chat
ComandoQué hace
/helpLista todos los comandos disponibles en la sesión actual.
/clearBorra el historial de la conversación actual sin salir.
/compactResume el contexto actual para liberar espacio en la ventana de tokens.
/costMuestra el costo en tokens y dólares gastado en la sesión.
/statusMuestra el estado del sistema: modelo activo, contexto usado, plan de suscripción.
/modelCambia el modelo de IA sin reiniciar la sesión.
/initAnaliza el proyecto actual y genera un archivo CLAUDE.md con instrucciones base.
/reviewPide a Claude que revise los cambios pendientes en git antes de hacer commit.
/commitGenera automáticamente un mensaje de commit y confirma los cambios en git.
/prCrea un pull request en GitHub con título y descripción generados por Claude.
/vimActiva el modo de entrada estilo Vim dentro del chat.
/exitSale de la sesión interactiva de Claude Code.
Gestión de memoria y contexto
Comando / ArchivoPara qué sirve
CLAUDE.mdArchivo en la raíz del proyecto con instrucciones permanentes que Claude lee en cada sesión.
/memoryGestiona los archivos de memoria: lista, edita o elimina recuerdos persistentes entre sesiones.
/compactComprime el contexto activo cuando la conversación se vuelve muy larga.
Ejemplos prácticos de uso en terminal
Qué escribesResultado
claude "explica este código"Claude lee los archivos del proyecto y los explica.
claude "arregla el bug en login.js"Localiza el error, propone el fix y lo aplica con tu aprobación.
claude "crea una función que ordene un array"Genera el código y lo inserta en el archivo indicado.
cat error.log | claude -p "analiza este error"Pasa el contenido del log directamente a Claude por stdin.
claude "genera tests para utils.js"Lee el archivo y crea un archivo de pruebas automáticamente.
Tip: Puedes usar Claude Code directamente en VS Code instalando la extensión oficial Claude Code desde el Marketplace — obtén el mismo poder de la terminal sin salir del editor.

📝 Cuestionario