¿Quieres usar Claude Code en tu PC Windows pero no sabes por dónde empezar? Esta guía te muestra exactamente cómo instalar y configurar Claude Code en Windows 10 u 11, incluso si nunca has abierto una terminal en tu vida. La instalación completa toma unos 10 minutos y no requiere ningún conocimiento técnico previo. Vas a instalar Visual Studio Code, añadir la extensión Claude Code, configurar tu acceso API y crear tu primer proyecto. Cada paso está detallado con capturas de pantalla y explicaciones sencillas para que puedas seguir sin perderte.

¿Cuáles son los requisitos previos para instalar Claude Code en Windows?

Necesitas tres elementos antes de empezar: Windows 10 u 11 actualizado, 4 GB de RAM mínimo y una conexión a internet estable. Claude Code funciona en cualquier PC reciente, no necesitas una máquina de última generación.

Aquí está la lista completa de requisitos:

  • Sistema operativo: Windows 10 (versión 1809 o superior) o Windows 11
  • Memoria RAM: 4 GB mínimo, 8 GB recomendados para un confort óptimo
  • Espacio en disco: 500 MB para Visual Studio Code y la extensión
  • Conexión a internet: necesaria para descargar las herramientas y comunicarse con la API de Claude
  • Derechos de administrador: requeridos solo para la instalación inicial

No necesitas una tarjeta gráfica potente ni un procesador de última generación. Claude Code se ejecuta en la nube a través de la API de Anthropic, tu ordenador solo sirve como interfaz. Incluso un PC de escritorio básico de 2018 funciona perfectamente.

Si usas un Mac, consulta nuestra guía de instalación para macOS que detalla las especificidades de ese entorno.

¿Cómo descargar e instalar Visual Studio Code?

Ve a code.visualstudio.com, descarga el instalador de Windows e inícialo aceptando las opciones por defecto. La instalación toma 2 o 3 minutos como máximo.

Aquí está el proceso detallado:

  1. Abre tu navegador y ve a code.visualstudio.com
  2. Haz clic en el gran botón azul "Download for Windows"
  3. El archivo VSCodeUserSetup-x64-1.XX.X.exe se descarga automáticamente
  4. Haz doble clic en el archivo descargado en tu carpeta Descargas
  5. Acepta los términos de uso y haz clic en "Siguiente"
  6. Deja la ruta de instalación por defecto (C:\Users\TuNombre\AppData\Local\Programs\Microsoft VS Code)
  7. Importante: marca la casilla "Añadir a PATH" durante la instalación
  8. También marca "Crear un icono en el Escritorio" para un acceso fácil
  9. Haz clic en "Instalar" y espera 2 minutos
  10. Desmarca "Iniciar Visual Studio Code" por ahora y haz clic en "Finalizar"

Visual Studio Code (VS Code en abreviatura) es un editor de código gratuito desarrollado por Microsoft. Es la herramienta que usan los desarrolladores para escribir código, pero no necesitas saber programar para usarlo con Claude Code. Piensa en VS Code como un Word especializado para código.

El tamaño de la descarga es de unos 90 MB. Si tu antivirus te pide confirmación, acepta: VS Code es un software oficial y seguro, utilizado por más de 20 millones de desarrolladores según las estadísticas de Microsoft.

¿Cómo instalar la extensión Claude Code en VS Code?

Abre VS Code, haz clic en el icono Extensiones (cuatro cuadrados) en la barra lateral izquierda, escribe "Claude Code" en la búsqueda y haz clic en "Instalar". La extensión se instala en unos segundos.

Pasos detallados:

  1. Inicia Visual Studio Code desde el icono en tu Escritorio o el menú Inicio
  2. Localiza la barra de iconos vertical en el lado izquierdo de la ventana
  3. Haz clic en el icono que parece cuatro pequeños cuadrados (es el gestor de extensiones)
  4. En la barra de búsqueda que aparece en la parte superior, escribe exactamente: Claude Code
  5. La extensión oficial aparece en el primer resultado (verifica que esté publicada por Anthropic)
  6. Haz clic en el botón azul "Instalar" a la derecha del nombre
  7. Espera 10 o 15 segundos mientras se instala
  8. Un mensaje de confirmación aparece en la esquina inferior derecha: "Extensión instalada correctamente"
  9. Un nuevo icono de Claude (un pequeño logo naranja) aparece en tu barra lateral izquierda

Si no encuentras la extensión, verifica que hayas escrito "Claude Code" correctamente y no solo "Claude". Existen varias extensiones relacionadas con Claude, pero la que nos interesa se llama exactamente "Claude Code" o "Claude Dev" según las versiones.

La extensión pesa unos 15 MB y no ralentiza tu ordenador. Solo añade una interfaz en VS Code para comunicarse con Claude a través de la API de Anthropic.

¿Cómo obtener y configurar tu clave API de Claude?

Ve a console.anthropic.com, crea una cuenta gratuita, genera una clave API en los ajustes y pégala en VS Code cuando la extensión te lo pida. Esta clave permite que Claude Code se comunique con la inteligencia artificial Claude.

Procedimiento completo:

  1. Abre console.anthropic.com en tu navegador
  2. Haz clic en "Sign Up" en la esquina superior derecha
  3. Crea una cuenta con tu correo electrónico (recibes un correo de confirmación para validar)
  4. Una vez conectado, haz clic en tu nombre en la esquina superior derecha y luego "API Keys"
  5. Haz clic en el botón "Create Key" o "Crear clave"
  6. Dale un nombre a tu clave (por ejemplo: "Claude Code Windows")
  7. Haz clic en "Create": tu clave aparece (comienza con "sk-ant-")
  8. Crucial: copia inmediatamente esta clave y guárdala en un archivo de texto
  9. Nunca podrás volver a ver esta clave, si la pierdes tendrás que crear una nueva

Ahora, configura la clave en VS Code:

  1. Vuelve a Visual Studio Code
  2. Haz clic en el icono de Claude en la barra lateral izquierda
  3. Una ventana te pide tu clave API
  4. Pega la clave que acabas de copiar (Ctrl+V)
  5. Presiona Intro para validar
  6. Un mensaje confirma que la conexión funciona

La clave API es como una contraseña que permite que tu ordenador hable con los servidores de Claude. Anthropic ofrece 5 dólares de crédito gratuito al registrarse, lo que representa unos 200.000 palabras generadas por Claude según su documentación oficial de precios. Más que suficiente para tus primeros proyectos.

Atención: nunca compartas tu clave API públicamente (en GitHub, Discord, etc.). Si alguien la obtiene, puede usar tu crédito en tu lugar.

¿Cómo crear tu primer proyecto con Claude Code?

Crea una nueva carpeta en tu Escritorio, ábrela en VS Code a través de Archivo > Abrir carpeta, luego inicia Claude Code y pídele que cree una página web simple. En 30 segundos, verás a Claude escribir código para ti.

Aquí te muestro cómo hacerlo:

  1. Haz clic derecho en tu Escritorio de Windows
  2. Selecciona "Nuevo > Carpeta"
  3. Nombra la carpeta "mi-primer-proyecto-claude"
  4. En VS Code, haz clic en "Archivo" en el menú superior
  5. Selecciona "Abrir carpeta..."
  6. Navega hasta tu Escritorio y selecciona la carpeta que acabas de crear
  7. Haz clic en "Seleccionar carpeta"
  8. VS Code puede preguntarte si confías en los autores: haz clic en "Sí, confío"
  9. Ahora haz clic en el icono de Claude en la barra lateral izquierda
  10. En el cuadro de texto en la parte inferior, escribe: "Crea una página web simple que muestre Hola mundo en un título grande"
  11. Presiona Intro

Claude entonces:

  • Creará automáticamente un archivo index.html en tu carpeta
  • Escribirá el código HTML necesario
  • Te mostrará cada paso de lo que está haciendo
  • Te ofrecerá una vista previa del resultado

Para ver tu página web, haz clic derecho en el archivo index.html en el explorador de archivos a la izquierda, luego selecciona "Mostrar en el Explorador de archivos". Haz doble clic en el archivo: se abrirá en tu navegador.

Esta primera prueba te muestra el poder de Claude Code: describes lo que quieres en español normal, y Claude escribe el código técnico para ti. Este es exactamente el principio que enseñamos en Skilzy, donde aprendes a crear aplicaciones completas sin escribir una sola línea de código tú mismo.

Si quieres ir más lejos, descubre los 20 comandos esenciales que puedes darle a Claude Code para crear proyectos más complejos.

¿Cuáles son los problemas comunes y sus soluciones?

Los tres errores más frecuentes son: clave API inválida, problema de conexión a internet y conflicto con el antivirus. Cada uno se resuelve en unos minutos.

Error: "Invalid API Key"

Si ves este mensaje, tu clave API no está configurada correctamente. Soluciones:

  • Verifica que hayas copiado la clave completa (debe comenzar con "sk-ant-")
  • Asegúrate de no haber añadido espacios al principio o al final
  • Vuelve a console.anthropic.com y genera una nueva clave si es necesario
  • En VS Code, haz clic en el icono de engranaje en la esquina inferior izquierda > Configuración > Extensiones > Claude Code > Editar clave API

Error: "Connection timeout"

Claude Code no puede conectarse con los servidores de Anthropic. Verifica:

  • Tu conexión a internet funciona (abre un sitio web para probar)
  • Tu cortafuegos de Windows no es demasiado restrictivo (Configuración > Actualización y seguridad > Seguridad de Windows > Cortafuegos)
  • Añade una excepción para VS Code si es necesario
  • Si estás en una red empresarial, podría bloquear el acceso a la API

VS Code no se inicia después de la instalación

Raros casos en los que VS Code se niega a iniciar:

  • Reinicia tu ordenador (resuelve el 80% de los problemas)
  • Desinstala VS Code a través de Configuración > Aplicaciones > Visual Studio Code > Desinstalar
  • Descarga la última versión del sitio oficial
  • Reinstala como administrador (clic derecho en el instalador > Ejecutar como administrador)

La extensión Claude Code no aparece

Si no ves el icono de Claude después de la instalación:

  • Cierra completamente VS Code (Archivo > Salir)
  • Reabre VS Code
  • Ve a Extensiones y verifica que Claude Code esté en la lista "Instaladas"
  • Haz clic en el pequeño icono de recarga junto a la extensión si aparece
  • En último recurso, desinstala y reinstala la extensión

La comunidad de Claude Code en Discord y los foros de Anthropic también son excelentes recursos si encuentras un problema específico. También puedes comparar con Cursor, una alternativa que funciona de forma diferente y podría adaptarse mejor a algunas configuraciones de Windows.

Conclusión

Ahora tienes Claude Code funcionando en tu PC Windows. La instalación completa te ha tomado menos de 15 minutos: Visual Studio Code como base, la extensión Claude Code para la interfaz, tu clave API para acceder a la inteligencia artificial, y tu primer proyecto para probar que todo funciona. El siguiente paso es explorar lo que puedes crear con esta herramienta: sitios web, aplicaciones, automatizaciones. Comienza con proyectos simples e incrementa gradualmente la complejidad. Claude Code aprende de tus solicitudes y mejora a lo largo de las conversaciones.

En Skilzy, te mostramos cómo transformar esta instalación en una competencia profesional. Nuestro método de aprendizaje te guía paso a paso para crear aplicaciones reales, incluso si hoy no sabes la diferencia entre HTML y CSS. Consulta nuestro tutorial completo para principiantes para descubrir todo lo que puedes lograr con Claude Code.