Configuración del entorno Windows para Claude Code

Requisitos del sistema Windows

• Windows 10 o superior
• Privilegios de administrador (para instalar software)
• Al menos 2GB de espacio libre en disco

Instalación de Node.js

Método 1: Paquete de instalación oficial (Recomendado)

node --version
npm --version

Método 2: Usando Chocolatey

# Instalar Chocolatey (si no está instalado)
Set-ExecutionPolicy Bypass -Scope Process -Force
[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072
iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))

# Instalar Node.js
choco install nodejs

Método 3: Usando Winget

winget install OpenJS.NodeJS

Configuración de variables de entorno

Configuración temporal (válida para la sesión actual)

set ANTHROPIC_BASE_URL=https://i7dc.com/api
set ANTHROPIC_AUTH_TOKEN=你的key
cd your-project-folder
claude

$env:ANTHROPIC_BASE_URL="https://i7dc.com/api"
$env:ANTHROPIC_AUTH_TOKEN="你的key"
cd your-project-folder
claude

Configuración permanente (Recomendado)

# Establecer variables de entorno para el usuario actual
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://i7dc.com/api", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的key", "User")

# Verificar la configuración
[Environment]::GetEnvironmentVariable("ANTHROPIC_BASE_URL", "User")
[Environment]::GetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "User")

Configuración de Windows Terminal (Recomendado)

Para una mejor experiencia de uso, se recomienda instalar Windows Terminal:

# Instalación a través de Microsoft Store
winget install Microsoft.WindowsTerminal

# O instalación a través del gestor de paquetes
choco install microsoft-windows-terminal

Configuración del perfil de inicio de Windows Terminal

1. Abra Windows Terminal
2. Presione Ctrl + , para abrir la configuración
3. En el menú izquierdo, seleccione "Perfiles" → "Agregar nuevo perfil"
4. Configure como sigue:
   • Nombre: Claude Code
   • Línea de comandos: powershell.exe
   • Directorio de inicio: 你的项目目录
   • Agregue variables de entorno en la configuración avanzada

Resolución de problemas comunes

Problema 1: El comando node no se reconoce

Solución:

# Verificar la variable de entorno PATH
echo %PATH%

# Agregar Node.js al PATH manualmente (temporal)
set PATH=%PATH%;C:\Program Files\nodejs

Problema 2: Instalación de npm lenta

Solución:

# Usar un mirror local
npm config set registry https://registry.npmmirror.com

Problema 3: Restricción de política de ejecución de PowerShell

Solución:

# Permitir temporalmente la ejecución de scripts
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

# Configuración permanente (requiere privilegios de administrador)
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope LocalMachine

Problema 4: El firewall bloquea la conexión

Solución:

1. Abra la configuración del Firewall de Windows
2. Haga clic en "Permitir una aplicación o característica a través del Firewall de Windows"
3. Encuentre Node.js y marque las redes "Privada" y "Pública"

Verificación de la configuración

Después de completar la configuración, reinicie el Símbolo del sistema o PowerShell y ejecute los siguientes comandos para verificar:

echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_AUTH_TOKEN%
claude --version

Si se muestran los valores correctos de las variables de entorno y la información de la versión, ¡la configuración ha sido exitosa!

Próximos pasos

Después de completar la configuración del entorno, puede:

1. Ejecutar claude en cualquier directorio de proyecto para comenzar a usar
2. Elegir su tema favorito
3. Confirmar el aviso de seguridad y confiar en el directorio de trabajo
4. ¡Comenzar a colaborar con su compañero de programación IA!🚀