Usar AICentOS con Claude Code

¿Primera vez? Primero completa el Registro de cuenta.

1. Preparación del entorno

Instalar Node.js

Claude Code se instala via npm. Verifica primero que Node.js esté disponible.

macOS - Verificar

node -v
npm -v

macOS - Instalar con Homebrew

brew install node

Windows - Verificar (CMD/PowerShell)

node -v
npm -v

Si no está instalado, descarga desde nodejs.org/es/download el instalador para tu plataforma. Windows requiere reiniciar después de la instalación.

Solo Windows: instalar Git Bash

Claude Code requiere un entorno bash. Los usuarios de Windows deben instalar Git Bash:

1. Descarga desde git-scm.com/install/windows e instala la versión correspondiente.
2. Verificación: clic derecho en el escritorio — si aparece Open Git Bash here, la instalación fue exitosa.

---

2. Instalar Claude Code via ZCF

npm

npx zcf

---

3. Configurar AICentOS

1. Escribe npx zcf en la terminal y pulsa Enter. Cuando aparezca Ok to proceed? (y), escribe y y pulsa Enter.

2. Selecciona el idioma de ZCF: Elige English.

3. Tras la instalación, selecciona: 1. Full Initialization - Install Claude Code + Import Workflows + Configure API or CCR Proxy + Configure MCP Services

4. ¿Modificar la configuración del idioma de plantilla? Selecciona No

5. Idioma de salida de la IA: Selecciona English

6. ¿Instalar Claude? Selecciona Yes

7. Modo de configuración de API: Selecciona Custom API Configuration

8. Proveedor de API: Selecciona Custom Configuration

9. Nombre de la configuración: Introduce un nombre en inglés a tu elección

10. Tipo de autenticación: Selecciona API Key

11. URL base de la API:

    https://www.aicentos.com

12. API Key: Introduce el token generado en la consola de AICentOS

13. Configuración del modelo: Pulsa Enter para saltar con los valores por defecto

14. Tipo de workflow: Selecciona General Tools

15. Estilo de salida: Elige según tu preferencia

16. ¿Configurar MCP? Selecciona Yes

17. Servicios MCP: Usa la barra espaciadora para seleccionar los servicios deseados y pulsa Enter para continuar

18. Configurar CCometixLine: Pulsa Enter directamente

19. Desde el menú principal escribe:

    q

20. En la terminal escribe:

    claude

    • Selecciona Yes, I trust this folder
    • En la selección de API, asegúrate de elegir YES (la primera opción)

---

4. Iniciar

cd mi-proyecto
claude

---

5. Selección de modelo

Escribe /model dentro de Claude Code para cambiar de modelo:

Opción	Modelo real	Notas
Default	claude-sonnet-4-5-20250929 + claude-haiku-4-5-20251001	Selección automática según la tarea. Recomendado para uso diario.
Opus	claude-opus-4-5-20251101	Razonamiento más potente, mayor costo
Haiku	claude-haiku-4-5-20251001	Ligero y rápido

También puedes fijar un modelo mediante variable de entorno:

macOS/Linux

export ANTHROPIC_MODEL=claude-sonnet-4-5-20250929
claude

Windows PowerShell

$env:ANTHROPIC_MODEL="claude-sonnet-4-5-20250929"
claude

Actualizar Claude Code

Si la versión del modelo parece desactualizada, ejecuta el comando de actualización y reinicia tus herramientas:

npm install -g @anthropic-ai/claude-code

---

6. Integración con IDE

IntelliJ IDEA

Ruta: Archivo → Configuración → Plugins → Marketplace → buscar claude code → encontrar Claude Code Terminal e instalar:

Reinicia IDEA tras la instalación y verifica que el plugin se haya cargado:

INFO

Si el plugin no aparece en el Marketplace, tu versión de IDEA es demasiado antigua — actualízala a la última versión.

VSCode

Presiona Ctrl + Shift + X para abrir el panel de extensiones, busca claude code y encuentra Claude Code for VSCode para instalar.

Una vez instalado, el plugin ofrece tres métodos de conexión:

Se recomienda conectar AICentOS mediante settings.json. Haz clic en el icono de engranaje en la esquina inferior derecha del plugin → Editar en settings.json:

Añade lo siguiente en el settings.json de VSCode:

{
  "claudeCode.preferredLocation": "panel",
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "reemplaza con tu API Key" },
    { "name": "ANTHROPIC_BASE_URL", "value": "https://www.aicentos.com/" }
  ]
}

Tras guardar, cierra y vuelve a abrir VSCode; el plugin se conectará correctamente a AICentOS.

---

7. Preguntas frecuentes

Error 403

El saldo del token es insuficiente. Recarga en la consola y vuelve a intentarlo.

Windows: error de conexión o 400/401

Ejecuta estos comandos en PowerShell para escribir variables del sistema permanentes y luego reabre la terminal:

setx ANTHROPIC_AUTH_TOKEN "sk-xxx"
setx ANTHROPIC_BASE_URL "https://www.aicentos.com/"

"Unable to connect to Anthropic services"

Error completo:

Unable to connect to Anthropic services
Failed to connect to api.anthropic.com: ERR_BAD_REQUEST
Please check your internet connection and network settings.

Esto ocurre porque Claude Code no ha completado el onboarding y sigue intentando conectarse a api.anthropic.com. No se necesita VPN. Abre ~/.claude.json (el archivo .claude.json en tu directorio home — no .claude/settings.json) y añade "hasCompletedOnboarding": true al final:

{
  "installMethod": "unknown",
  "autoUpdates": true,
  "projects": { ... },
  "hasCompletedOnboarding": true
}

TIP

Añade una coma después del campo anterior antes de agregar la nueva entrada (requisito de sintaxis JSON). Reinicia claude después de guardar.