🪄 Integrando Claude Code con modelos personalizados de CodingPlanX

Claude Code es un potente asistente de programación de IA lanzado por Anthropic. Se integra directamente en tu terminal, comprende tu base de código y colabora perfectamente contigo para escribir, refactorizar y depurar código.

Este tutorial te guiará a través de la preparación del entorno, la instalación de herramientas y la configuración exclusiva para la interfaz proxy de codingplanx.ai.

📋 Requisitos del sistema

Antes de comenzar, asegúrate de que tu sistema cumpla con los siguientes requisitos mínimos:

Node.js: Versión >= 18.0
Sistema operativo: macOS, Linux, Windows (se recomienda WSL)

🚀 Inicio rápido

1. Instalar Node.js

💡 Consejo: Si ya tienes instalado Node.js 18.0 o superior, omite este paso directamente.

🍎 Usuarios de macOS

Se recomienda instalar a través de Homebrew:

# 1. Instalar herramientas de línea de comandos de Xcode
sudo xcode-select --install

# 2. Instalar Homebrew (si aún no está instalado)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 3. Instalar Node.js a través de Homebrew
brew install node

# 4. Verificar la instalación
node --version

🐧 Usuarios de Ubuntu / Debian

Usa el script oficial de NodeSource para instalar la versión LTS:

# 1. Descargar y ejecutar el script de instalación
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo bash -

# 2. Instalar Node.js
sudo apt-get install -y nodejs

# 3. Verificar la instalación
node --version

🪟 Usuarios de Windows

Se recomienda usar la línea de comandos winget para la instalación, o ir al Sitio web oficial de Node.js para descargar el instalador:

# Instalar la versión LTS de Node.js usando winget
winget install OpenJS.NodeJS.LTS

# Verificar la instalación (Es posible que debas reiniciar la terminal después de la instalación)
node --version

2. Instalar Claude Code

Abre tu terminal y usa npm para instalar Claude Code globalmente:

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

# Verificar si la instalación fue exitosa
claude --version

(Nota: Si encuentras errores de permisos, es posible que los usuarios de macOS/Linux necesiten usar sudo npm install -g @anthropic-ai/claude-code)

3. Configurar y empezar a usar

🔑 Obtener la información de configuración necesaria

Para utilizar este servicio, debes preparar las siguientes dos variables de entorno:

Configuración	Descripción	Cómo obtenerlo
`ANTHROPIC_AUTH_TOKEN`	Token de autenticación de API	Después de registrarte, ve a la página API Tokens y haz clic en Add Token (Comienza con `sk-`)
`ANTHROPIC_BASE_URL`	Dirección del servicio API	Completa exactamente: `https://api.codingplanx.ai`

📝 Sugerencias al crear un token:

Name (Nombre): Nómbralo como quieras (ej., claude-code-cli)

Quota (Cuota): Establécelo en Unlimited Quota (Cuota ilimitada)

Group (Grupo): Selecciona Claude code exclusive (Exclusivo de Claude code) o Official Claude 3 & above Proxy

Otras opciones: Mantén la configuración predeterminada

💻 Iniciar Claude Code

Elige el comando de inicio correspondiente según tu sistema operativo y terminal. Por favor, navega primero al directorio de tu proyecto:

cd tu-carpeta-de-proyecto

🟢 Linux / macOS (Bash/Zsh)

# Configurar variables de entorno (efectivo para la sesión de terminal actual)
export ANTHROPIC_AUTH_TOKEN="sk-TuTokenReal"
export ANTHROPIC_BASE_URL="https://api.codingplanx.ai"
export API_TIMEOUT_MS="300000"  # Establecer el tiempo de espera en 300 segundos para evitar desconexiones en respuestas largas

# Iniciar Claude Code
claude

🔵 Windows PowerShell

# Configurar variables de entorno (efectivo para la sesión de terminal actual)
$env:ANTHROPIC_BASE_URL = "https://api.codingplanx.ai"
$env:ANTHROPIC_AUTH_TOKEN = "sk-TuTokenReal"
$env:API_TIMEOUT_MS = "300000"

# Iniciar Claude Code
claude

⚫ Windows CMD

set ANTHROPIC_BASE_URL=https://api.codingplanx.ai
set ANTHROPIC_AUTH_TOKEN=sk-TuTokenReal
set API_TIMEOUT_MS=300000

claude

💡 Consejo profesional: Si no deseas ingresar variables de entorno cada vez, puedes agregar las declaraciones export anteriores a tu archivo ~/.bashrc o ~/.zshrc (Mac/Linux), o agregar variables de entorno permanentes en la configuración del sistema de Windows.

⚙️ Asistente de configuración de la primera ejecución

Al iniciar claude por primera vez, el sistema te guiará a través de la configuración básica:

Tema 👉 Selecciona tu esquema de color de terminal preferido, presiona Enter para confirmar.
Seguridad 👉 Lee y confirma los avisos de seguridad, presiona Enter.
Terminal 👉 Se recomienda la configuración predeterminada, presiona Enter.
Confianza 👉 Confirma que confías en el directorio de trabajo actual, presiona Enter.

✨ ¡Felicidades! Cuando veas el mensaje de entrada, ¡puedes comenzar a chatear con tu compañero de programación de IA! Intenta escribir: "Ayúdame a explicar la estructura principal de este proyecto".

❓ Preguntas frecuentes (FAQ)

P: ¿Aparece el error `Invalid API Key · Please run /login`?

R: Esto indica que Claude Code no pudo leer tus variables de entorno. Verifica:

Si ANTHROPIC_AUTH_TOKEN y ANTHROPIC_BASE_URL están configurados correctamente.
Si el formato del token es correcto (debe comenzar con sk- y no contener espacios adicionales ni comillas).
Si configuraste variables de entorno permanentes, asegúrate de haber reiniciado tu terminal para que surtan efecto.

P: ¿Por qué la esquina inferior izquierda de la terminal muestra el estado `offline` (fuera de línea)?

R: Claude Code hace un ping predeterminado a google.com para verificar el estado de la red. En ciertos entornos de red restringidos, mostrar offline es normal y no afectará en absoluto tu uso normal ni la generación de código.

P: ¿Por qué falla pedirle a Claude que navegue por la web (Fetch)?

R: Antes de acceder a páginas web externas, Claude Code necesita llamar a los servicios oficiales para realizar comprobaciones de seguridad. Si encuentras fallas en Fetch:

Asegúrate de que tu computadora tenga una conexión a Internet internacional estable.
Si es necesario, habilita un proxy de terminal global (ej., export https_proxy=...).

P: ¿Por qué las solicitudes siempre indican `fetch failed` o tiempo de espera agotado?

R: Esto generalmente se debe a fluctuaciones de la red o al reenvío del proxy. Soluciones:

Verifica si la variable de entorno de tiempo de espera está configurada correctamente: API_TIMEOUT_MS=300000.
Intenta cambiar tu nodo de proxy local.
Presiona Ctrl+C para salir de la sesión actual y vuelve a ejecutar el comando claude.

P: ¿Error de inicio de sesión web?

R: Si encuentras anomalías en la página web al obtener un Token, intenta borrar la caché de Cookies de tu navegador o usa el modo Incógnito para iniciar sesión en yunwu.ai nuevamente.

📌 Notas importantes

🛡️ Aviso de interfaz: Este sitio se conecta directamente al servicio de reenvío oficial de Claude Code, perfectamente adaptado para la herramienta CLI.
🚦 Límites de tasa: La configuración actual solo admite el tráfico de la API de Claude Code y no admite llamadas API estándar para otros clientes de terceros.
🔒 Advertencia de seguridad: Mantén a salvo tu token de API (sk-...). Nunca lo codifiques de forma rígida en tus scripts ni lo subas a repositorios públicos de GitHub.