Tutorial de uso de Claude Code: instálalo y empieza en Windows/macOS en un solo artículo

Este tutorial de uso de Claude se centra específicamente en Claude Code: desde la instalación y la verificación hasta la vinculación de la clave API (API Key), y luego la solución de errores comunes. Sigue los pasos y en 10 minutos podrás ejecutar Claude Code en la terminal para generar código, corregir errores y realizar colaboración sencilla en el desarrollo.

I. Preparativos antes de instalar: no te equivoques con la versión de Node.js

Claude Code depende del entorno de Node.js; se recomienda instalar Node.js 18 o superior y luego abrir una nueva ventana de terminal. Los usuarios de Windows pueden usar el instalador y pulsar “Siguiente” hasta terminar; en macOS se puede instalar con el instalador oficial o con un gestor de paquetes. Tras instalar, introduce node -v en la terminal para confirmar que el número de versión es correcto.

II. Instalar Claude Code: instalación global con npm y espejos dentro de China

Ejecuta en la terminal el comando de instalación global: npm install -g @anthropic-ai/claude-code; esta es la forma más común de instalar Claude Code. Si tu red accede lentamente al registro oficial de npm, puedes cambiar a un registro espejo: npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com. Cuando termine la instalación, vuelve a abrir la terminal e introduce claude --version para verificar que Claude Code está disponible.

III. Primer inicio y vinculación de la API Key: hacer que Claude Code sea realmente utilizable

Claude Code necesita la autorización de una API Key de Anthropic; la primera vez que ejecutes claude normalmente te guiará para configurar la clave. Un método más fiable es configurar primero en el sistema la variable de entorno ANTHROPIC_API_KEY y luego iniciar Claude Code, para evitar tener que introducirla repetidamente. Después, entra en el directorio del proyecto y abre la terminal; basta con describir la tarea en lenguaje natural, por ejemplo, pedirle a Claude Code que analice un error, genere un parche de corrección y te indique cómo verificarlo.

IV. Problemas comunes de Claude Code: cómo manejar bloqueos, errores e interrupciones

Si Claude Code falla en las solicitudes o se interrumpe con frecuencia, comprueba primero la estabilidad de la red y si has activado el limitador de tasa (rate limit) del servidor; cambiar a una red más estable suele mejorar notablemente. Si aparecen errores de instalación, la mayoría se deben a una versión de Node.js demasiado baja o a permisos globales; actualizar Node.js y reinstalar con permisos de administrador/sudo suele resolverlo. Si claude --version no muestra salida, se recomienda confirmar que la ruta global de npm se haya añadido a PATH y volver a ejecutar Claude Code en una terminal nueva.