KozeKoze
← Volver al blog
Tutorial2026年3月23日·管理员

Tutorial de configuración de código de Claude

Tutorial de configuración de código de Claude

📋 Pasos preparatorios

Antes de comenzar, asegúrese de haber:

  • Registrado una cuenta de Koze e iniciado sesión
  • Creado una clave API en la página de administración de API
  • Instalado Claude Code (npm install -g @anthropic-ai/claude-code)

🚀 Paso 1: Configuración de variables de entorno

Ejecute los siguientes comandos en la terminal para configurar la dirección y la clave API como variables de entorno:

# Configure la dirección del proxy de Koze a la URL base
export ANTHROPIC_BASE_URL='https://api.kozeai.com/v1'

# Configure la clave API que creó en el backend de Koze
export ANTHROPIC_AUTH_TOKEN="Tu clave API"

💡 Consejo: Reemplaza https://api.kozeai.com con el dominio real de tu servicio. Las claves API se pueden ver o crear en la página "Administración de API → Claves existentes". Paso dos: Configuración del plugin de VS Code (opcional) Si utiliza el plugin Claude para VS Code, debe configurarlo en `~/.claude/config.json`: { "primaryApiKey": "Su clave API", "apiBaseUrl": "https://api.kozeai.com/v1" } Si el archivo no existe, créelo manualmente. macOS / Linux: ~/.claude/config.json

  • Windows: C:\Users\Tu nombre de usuario\.claude\config.json

    • 🎯 Paso 3: Iniciar Claude Code

    Después de configurar las variables de entorno, ejecútalo directamente en la terminal:

    claude

    Claude Code utilizará automáticamente la dirección proxy de Koze que configuraste para realizar las solicitudes.

    📌 Variables de entorno persistentes

    Para evitar restablecer las variables cada vez que abres la terminal, se recomienda escribirlas en el archivo de configuración del shell:

    # Usuario de Bash

echo 'exportar' ANTHROPIC_BASE_URL='https://api.kozeai.com/v1' >>> ~/.bashrc

echo 'export ANTHROPIC_AUTH_TOKEN='tu clave API' >>> ~/.bashrc

source ~/.bashrc

# Usuario Zsh

echo 'export ANTHROPIC_BASE_URL='https://api.kozeai.com/v1' >>> ~/.zshrc

echo 'export ANTHROPIC_AUTH_TOKEN='tu clave API' >> ~/.zshrc

source ~/.zshrc

    ✅ Verificar conexión

    Después de iniciar Claude Code, si ve una interfaz de diálogo normal, la configuración se ha realizado correctamente.

    Puedes ver los registros de llamadas en tiempo real en la página de "Estadísticas de uso" de Koze.

    ⚠️ Preguntas frecuentes

    Problema Solución
    Consejo: Clave API no válida Verifica que la clave API se haya copiado correctamente y que no haya espacios adicionales
    Tiempo de espera de conexión agotado Confirma que la URL base sea correcta y contenga el sufijo /v1
    Modelo no disponible Consulta la lista de modelos disponibles para la versión actual Paquete en el Koze Model Lobby

     

    Tutorial de configuración de código de Claude | Koze AI