3 métodos para solucionar el error de modelo no encontrado al configurar Claude Code con un servicio proxy de API de terceros

Nota del autor: Solución completa al error "modelo no encontrado" en Claude Code tras conectar una API de terceros: forma correcta de escribir la Base URL, método de configuración de settings.json y tabla comparativa de los nombres de modelos más recientes.

Al usar Claude Code, el error más común que suele aparecer es este:

There's an issue with the selected model (claude-sonnet-4-6). It may not exist or you may not have access to it. Run /model to pick a different model.

Este error ocurre generalmente en dos situaciones:

Estás usando una clave API oficial, pero el nombre del modelo está mal escrito (solo ejecuta /model y elige uno nuevo).
Estás conectado a un servicio proxy de API de terceros, y la Base URL no está configurada correctamente, lo que provoca un fallo en el enrutamiento del modelo.

Este artículo se centra en la solución completa para el segundo caso, tomando como ejemplo a APIYI (apiyi.com), cubriendo tanto la configuración por variables de entorno como por el archivo settings.json, además de incluir una tabla comparativa de los nombres de modelos de Claude más recientes.

Valor principal: Al terminar de leer, podrás configurar correctamente Claude Code con una API de terceros, eliminar el error de modelo no encontrado y utilizar todas las funciones de Claude Code de forma estable.

I. Localización rápida del problema: ¿Es el nombre del modelo o la Base URL?

Antes de empezar a configurar, tómate 30 segundos para identificar qué tipo de problema tienes:

Síntoma	Causa probable	Solución
Error: `Run /model to pick a different model`	El modelo no existe o no tienes permisos	Ejecuta `/model` para seleccionar de nuevo
Nombre de modelo correcto, pero sigue fallando	Problema en la configuración de la Base URL	Revisa `ANTHROPIC_BASE_URL`
Error de validación de clave API	Clave inválida o no configurada	Configura de nuevo `ANTHROPIC_API_KEY`
Tiempo de espera agotado / Conexión rechazada	Dirección del servicio proxy incorrecta	Revisa el formato de la Base URL
Todos los modelos fallan	El proxy no es compatible con el formato de Anthropic	Confirma que el proxy soporte el protocolo nativo de Anthropic

Si usas una clave API oficial de Anthropic y puedes acceder a anthropic.com normalmente, simplemente ejecuta el comando /model dentro de Claude Code para cambiar de modelo; no necesitas ninguna configuración adicional.

Si estás usando un servicio proxy de API de terceros (como apiyi.com), continúa leyendo las siguientes soluciones de configuración.

🎯 Sugerencia: Se recomienda usar la plataforma APIYI (apiyi.com) para conectar Claude Code. La plataforma es compatible con el formato nativo de Anthropic y soporta toda la serie de modelos más recientes como claude-3-5-sonnet-20241022, funcionando de manera estable.

2. Configuración principal para conectar Claude Code mediante un proxy de API de terceros

2.1 Formato correcto de la Base URL: Quita el /v1

Este es el paso más crítico y donde es más fácil cometer un error.

Claude Code tiene una lógica especial para manejar la Base URL: añade automáticamente /v1/messages al final de la URL que configures. Por lo tanto:

❌ Forma incorrecta: ANTHROPIC_BASE_URL=https://api.apiyi.com/v1
- La ruta de la solicitud real se convierte en: https://api.apiyi.com/v1/v1/messages (el /v1 se duplica).
- Resultado: El enrutamiento no encuentra el endpoint y el modelo devuelve un error.
✅ Forma correcta: ANTHROPIC_BASE_URL=https://api.apiyi.com
- La ruta de la solicitud real se convierte en: https://api.apiyi.com/v1/messages.
- Resultado: Conecta correctamente con la interfaz nativa de Anthropic.

📌 Regla de oro: Al configurar ANTHROPIC_BASE_URL, introduce solo la raíz del dominio, sin el sufijo /v1. Claude Code se encargará de completar la ruta automáticamente.

2.2 Obtener la clave API

Inicia sesión en el panel de APIYI para obtener tu token: Página de gestión de tokens de APIYI api.apiyi.com/token

Sugerencias para elegir tu token:

Tipo de token	Escenario de uso	Descuento
Token por defecto	Uso general, listo para usar	Precio estándar
Token del grupo ClaudeCode	Específico para Claude Code	12% de descuento

Al crear un nuevo token, selecciona el grupo ClaudeCode para disfrutar de un descuento del 12%, lo que reduce los costes a largo plazo.

三、Detalles de los dos métodos de configuración

Método 1: Configuración mediante variables de entorno (recomendado para pruebas temporales)

Ejecuta los siguientes comandos en la terminal. La configuración tendrá efecto inmediato (solo para la sesión actual):

# Configura la Base URL del servicio proxy de API (Nota: no añadas /v1)
export ANTHROPIC_BASE_URL="https://api.apiyi.com"

# Configura la clave API (sustitúyela por tu clave real)
export ANTHROPIC_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxx"

# Inicia Claude Code
claude

Verifica si la configuración ha surtido efecto:

# Verifica las variables de entorno actuales
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_API_KEY

# Debería mostrar:
# https://api.apiyi.com
# sk-xxxxxx...

Pros y contras:

✅ Rápido y sencillo, sin necesidad de modificar archivos.
✅ No afecta a la configuración de otras sesiones.
❌ Es necesario volver a configurarlo cada vez que abras una nueva terminal (a menos que lo añadas a .zshrc / .bashrc).

Solución permanente (escribiendo en el archivo de configuración del Shell):

# Para usuarios de zsh (predeterminado en macOS)
echo 'export ANTHROPIC_BASE_URL="https://api.apiyi.com"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="sk-tu-clave"' >> ~/.zshrc
source ~/.zshrc

# Para usuarios de bash
echo 'export ANTHROPIC_BASE_URL="https://api.apiyi.com"' >> ~/.bashrc
echo 'export ANTHROPIC_API_KEY="sk-tu-clave"' >> ~/.bashrc
source ~/.bashrc

Método 2: Configuración mediante settings.json (recomendado para uso a largo plazo)

Edita el archivo ~/.claude/settings.json (configuración global, afecta a todos los proyectos):

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.apiyi.com",
    "ANTHROPIC_API_KEY": "sk-TuClaveAPI"
  }
}

🎯 Práctica recomendada: Utiliza ~/.claude/settings.json para la configuración global; se configura una vez y funciona para siempre, sin tener que repetir las variables de entorno. Visita APIYI (apiyi.com) para obtener tu clave y elige los tokens de grupo de ClaudeCode para disfrutar de un 12% de descuento.

Si el archivo no existe, créalo manualmente:

# Crea el directorio .claude (si no existe)
mkdir -p ~/.claude

# Crea el archivo settings.json
cat > ~/.claude/settings.json << 'EOF'
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.apiyi.com",
    "ANTHROPIC_API_KEY": "sk-sustituye-por-tu-clave"
  }
}
EOF

Prioridad de configuración (de mayor a menor):

Prioridad	Origen de la configuración	Descripción
1 (Máxima)	Variables de entorno	export directo en la terminal
2	`.claude/settings.local.json`	Configuración local del proyecto (no se sube a git)
3	`.claude/settings.json`	Configuración compartida del proyecto
4 (Mínima)	`~/.claude/settings.json`	Configuración global de usuario

Para un mismo elemento, la prioridad alta sobrescribirá a la baja. Si también tienes un settings.json en el directorio de tu proyecto, recuerda esta jerarquía.

IV. Nombres de los últimos modelos compatibles con Claude Code

Opus 4.6 claude-opus-4-6 Capacidad más potente

Capacidad integral 95%

Profundidad de razonamiento 93%

Velocidad de respuesta 47%

Relación calidad-precio 35%

Código complejo · Análisis profundo · Documentos largos

Primera opción recomendada Sonnet 4.6 claude-sonnet-4-6 Equilibrio óptimo entre capacidad y velocidad

Capacidades integrales 83%

profundidad de razonamiento 75%

Velocidad de respuesta 80%

relación calidad-precio 75%

Programación diaria · Revisión de código · Redacción de documentación

Haiku 4.5 claude-haiku-4-5-20251001 Respuesta ultrarrápida

Capacidad integral 60%

profundidad de razonamiento 51%

Velocidad de respuesta 97%

Relación calidad-precio 94%

Completado rápido · Preguntas y respuestas sencillas · Tareas por lotes

🎯 Sugerencias de selección de escenarios para Claude Code Uso diario → Sonnet 4.6 (recomendado) | Arquitectura compleja → Opus 4.6 | Autocompletado de alta frecuencia → Haiku 4.5 Todos los modelos anteriores pueden invocarse a través de la interfaz unificada de APIYI apiyi.com, con una sola clave para acceder a toda la serie.

Estos son los nombres de los modelos Claude más recientes para 2026. Deben escribirse con precisión, respetando mayúsculas, minúsculas y números:

Modelos de inferencia estándar

Nombre del modelo	Serie	Posicionamiento de capacidad	Escenario de uso
`claude-opus-4-6`	Claude 4.6	Capacidad máxima	Código complejo, análisis profundo, documentos largos
`claude-sonnet-4-6`	Claude 4.6	Equilibrio entre potencia y velocidad	Programación diaria, revisión de código, redacción
`claude-haiku-4-5-20251001`	Claude 4.5	Respuesta ultra rápida	Preguntas simples, autocompletado, tareas rápidas

Modelos de razonamiento mejorado (Modo Thinking)

Al añadir el sufijo -thinking al nombre del modelo, puedes activar el modo de pensamiento extendido, donde el modelo realiza un razonamiento profundo antes de responder:

Nombre del modelo	Modelo base	Características
`claude-opus-4-6-thinking`	claude-opus-4-6	Razonamiento máximo, ideal para matemáticas/lógica/decisiones complejas
`claude-sonnet-4-6-thinking`	claude-sonnet-4-6	Equilibrio entre razonamiento y velocidad, opción preferida para uso diario
`claude-haiku-4-5-20251001-thinking`	claude-haiku-4-5-20251001	Razonamiento ligero

💡 Sugerencia de selección: Para el uso diario de Claude Code, se recomienda claude-sonnet-4-6, ya que ofrece el mejor equilibrio entre calidad de código y velocidad de respuesta. Para diseños de arquitectura complejos o depuración de bugs difíciles, puedes cambiar a claude-opus-4-6 o claude-sonnet-4-6-thinking.

V. Cómo cambiar de modelo en Claude Code

Una vez configurados el Base URL y la clave API, tienes dos formas de cambiar de modelo:

5.1 Usar el comando /model (lo más sencillo)

Escribe directamente en la conversación de Claude Code:

/model

Claude Code mostrará una lista de selección de modelos. Si utilizas un servicio proxy de API de terceros, es posible que no aparezcan todos los modelos automáticamente; en ese caso, tendrás que introducir el nombre del modelo manualmente.

5.2 Especificar modelos por defecto en settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.apiyi.com",
    "ANTHROPIC_API_KEY": "sk-TuClaveAPI",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-6"
  }
}

Mediante las variables de entorno ANTHROPIC_DEFAULT_*_MODEL, puedes asignar nombres de modelo precisos para cada nivel. Esto evita que Claude Code use los nombres predeterminados internos (que podrían no coincidir con los del servicio proxy).

🎯 Ejemplo de configuración completa: Se recomienda guardar esta configuración en ~/.claude/settings.json y utilizar un token de grupo de ClaudeCode de APIYI (apiyi.com) como ANTHROPIC_API_KEY.

VI. Errores comunes y soluciones (FAQ)

P1: ¿Claude Code no arranca tras configurar ANTHROPIC_BASE_URL?

Revisa si el formato JSON es correcto. Los errores más habituales son:

Una coma de más después del último par clave-valor (JSON no permite comas finales).
Uso de comillas curvas “” en lugar de comillas rectas inglesas "".

# Validar el formato JSON
cat ~/.claude/settings.json | python3 -m json.tool

Si la salida es normal, el formato es correcto; si da error, hay un problema de sintaxis.

P2: Me da el error Invalid API key, ¿pero mi clave es correcta?

Posibles causas:

Espacios en blanco: comprueba si has copiado espacios extra al principio o al final de la clave.
Clave caducada o desactivada: inicia sesión en api.apiyi.com/token y genera una nueva.
Prioridad de variables de entorno: puede que existan variables ANTHROPIC_API_KEY antiguas en tu sistema.

# Comprobar si hay variables de entorno de múltiples fuentes
env | grep ANTHROPIC

P3: El modelo responde, ¿pero la calidad es mala o el formato es extraño?

Causa probable: El servicio proxy no soporta completamente el formato de Anthropic, especialmente el manejo del system prompt.

Método de verificación: Prueba directamente con curl si el servicio proxy responde correctamente:

curl https://api.apiyi.com/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: sk-TuClave" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 100,
    "messages": [{"role": "user", "content": "Say hello"}]
  }'

Una respuesta normal debería incluir el campo content y el texto de salida real. Si devuelve algo extraño, el problema está en el servicio proxy.

🎯 Diagnóstico rápido: APIYI (apiyi.com) es totalmente compatible con el formato nativo de Anthropic, por lo que el test de curl anterior funcionará sin problemas. Si estás probando otro servicio, usa este comando para verificar su compatibilidad.

P4: ¿Cómo configurar las variables de entorno en Windows?

Para usuarios de Windows, lo más sencillo y fiable es usar el archivo settings.json:

// C:\Users\TuUsuario\.claude\settings.json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.apiyi.com",
    "ANTHROPIC_API_KEY": "sk-TuClaveAPI"
  }
}

Si prefieres usar PowerShell para configurar variables temporales:

$env:ANTHROPIC_BASE_URL = "https://api.apiyi.com"
$env:ANTHROPIC_API_KEY = "sk-TuClaveAPI"
claude

P5: ¿Cómo usar diferentes configuraciones de API en distintos proyectos?

Crea un archivo .claude/settings.json en la raíz de tu proyecto (este archivo tiene prioridad sobre la configuración global):

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.apiyi.com",
    "ANTHROPIC_API_KEY": "sk-ClaveEspecificaDelProyecto"
  }
}

Nota: Si este archivo contiene claves privadas, te recomendamos añadirlo al .gitignore para no subirlo al repositorio. Es más seguro usar .claude/settings.local.json (configuración local específica), ya que git suele ignorarlo por defecto.

VII. Lista de verificación de la configuración

Una vez completada la configuración, sigue estos pasos para verificarla:

# Paso 1: Confirmar que las variables de entorno están activas
echo "Base URL: $ANTHROPIC_BASE_URL"
echo "API Key: ${ANTHROPIC_API_KEY:0:10}..."

# Paso 2: Probar la conectividad de la API
curl -s https://api.apiyi.com/v1/models \
  -H "x-api-key: $ANTHROPIC_API_KEY" | head -c 200

# Paso 3: Iniciar Claude Code y probar
claude --version
claude

Escribe /status en el cuadro de diálogo de Claude Code para ver el estado actual de la conexión y confirmar que la Base URL y la configuración del modelo son correctas.

🎯 Tras la configuración: Se recomienda enviar un mensaje sencillo para confirmar que Claude Code responde con normalidad. La plataforma APIYI (apiyi.com) permite consultar el saldo, lo que te permite monitorear en tiempo real el uso de tokens de Claude Code desde el panel de control y gestionar los costos de manera eficiente.

Resumen

Si al conectar Claude Code a un servicio proxy de API de terceros aparece el error "modelo no encontrado", el 90% de las veces se debe a que el formato de la Base URL es incorrecto. Los principios fundamentales son:

No añadas /v1 a la Base URL: Ingresa https://api.apiyi.com; Claude Code añadirá automáticamente /v1/messages.
Coincidencia exacta del nombre del modelo: Utiliza nombres completos como claude-sonnet-4-6, claude-opus-4-6 o claude-haiku-4-5-20251001.
Configuración recomendada en settings.json: Escríbela en ~/.claude/settings.json para que sea permanente, sin necesidad de configurar variables de entorno en cada sesión.
Token exclusivo para ClaudeCode: Selecciona el grupo ClaudeCode en el panel de APIYI para disfrutar de un descuento del 12% (pagas solo el 88%).

Si solo utilizas la clave API oficial de Anthropic y tienes conexión directa a internet, simplemente ejecuta el comando /model en Claude Code para seleccionar el modelo, sin necesidad de realizar ninguna configuración adicional.

🎯 Obtén tu clave API: Regístrate en APIYI (apiyi.com) y crea un token del grupo ClaudeCode en la página de gestión de tokens (api.apiyi.com/token). La plataforma ofrece un modelo de pago por uso, sin consumo mínimo, facturando según el uso real de tokens, lo que la hace ideal tanto para usuarios individuales como para equipos.

Este artículo ha sido elaborado por el equipo técnico de APIYI, basado en pruebas reales con Claude Code v2.x. Si tienes problemas de configuración, no dudes en visitar el centro de ayuda de APIYI en help.apiyi.com para obtener soporte.

3 métodos para solucionar el error de modelo no encontrado al configurar Claude Code con un servicio proxy de API de terceros

I. Localización rápida del problema: ¿Es el nombre del modelo o la Base URL?

2. Configuración principal para conectar Claude Code mediante un proxy de API de terceros

2.1 Formato correcto de la Base URL: Quita el /v1

2.2 Obtener la clave API

三、Detalles de los dos métodos de configuración

Método 1: Configuración mediante variables de entorno (recomendado para pruebas temporales)

Método 2: Configuración mediante settings.json (recomendado para uso a largo plazo)

IV. Nombres de los últimos modelos compatibles con Claude Code

Modelos de inferencia estándar

Modelos de razonamiento mejorado (Modo Thinking)

V. Cómo cambiar de modelo en Claude Code

5.1 Usar el comando /model (lo más sencillo)

5.2 Especificar modelos por defecto en settings.json

VI. Errores comunes y soluciones (FAQ)

VII. Lista de verificación de la configuración

Resumen

Guía completa de configuración para la integración de Nano Banana Pro y Sora-2 en ComfyUI: la solución de integración de API más sencilla

Análisis de everything-claude-code: desglose completo de los 13 agentes y más de 40 habilidades de la colección de complementos de Claude Code con 50,000 estrellas

Guía completa del modo Enjambre de Claude: 5 pasos para dominar el nuevo paradigma de desarrollo de colaboración multiagente

3 métodos para resolver el error de conflicto entre thinking_budget y thinking_level en la Gemini API

OpenClaw integración con Claude: 2 métodos de configuración – Modo compatible con OpenAI vs Formato nativo de Claude – Tutorial completo

Guía completa de configuración para implementar la ventana de contexto de 1 millón de tokens de la API de Claude y 5 escenarios prácticos principales

I. Localización rápida del problema: ¿Es el nombre del modelo o la Base URL?

2. Configuración principal para conectar Claude Code mediante un proxy de API de terceros

2.1 Formato correcto de la Base URL: Quita el /v1

2.2 Obtener la clave API

三、Detalles de los dos métodos de configuración

Método 1: Configuración mediante variables de entorno (recomendado para pruebas temporales)

Método 2: Configuración mediante settings.json (recomendado para uso a largo plazo)

IV. Nombres de los últimos modelos compatibles con Claude Code

Modelos de inferencia estándar

Modelos de razonamiento mejorado (Modo Thinking)

V. Cómo cambiar de modelo en Claude Code

5.1 Usar el comando /model (lo más sencillo)

5.2 Especificar modelos por defecto en settings.json

VI. Errores comunes y soluciones (FAQ)

VII. Lista de verificación de la configuración

Resumen

Publicaciones Similares