There’s an issue with the selected model en Claude Code: 5 causas y soluciones probadas

Conectaste Claude Code a Ollama u OpenRouter, mandaste el primer mensaje y recibiste There's an issue with the selected model (qwen3:8b). It may not exist or you may not have access to it. Cambiaste el nombre del modelo un par de veces y sigue igual. Parece un problema de permisos de la cuenta, pero con un backend de terceros, there’s an issue with the selected model casi siempre significa un nombre de modelo o una URL incorrectos.

Instalamos Claude Code 2.1.312 en Linux, lo conectamos a un servidor local de Ollama 0.40.13 y reprodujimos el error de cinco maneras. Abajo tienes la solución de cada una. No teníamos clave de OpenRouter, así que esa parte sale de la documentación oficial de OpenRouter, y lo indicamos.

Qué significa there’s an issue with the selected model

La referencia de errores de Claude Code dice que el nombre de modelo configurado no se reconoció o que tu cuenta no tiene acceso a él. La pista final cambia según dónde lo uses: Run /model en la CLI interactiva y Run --model en el modo no interactivo -p.

En nuestras pruebas el mensaje apareció siempre que el backend respondió con un 404. Al llamar con curl a /v1/messages de Ollama con un modelo sin descargar, la respuesta fue {"type":"error","error":{"type":"not_found_error","message":"model 'qwen3:8b' not found"}}. Claude Code muestra esa respuesta como este error.

Si el backend no responde en absoluto, el mensaje es otro. Con Ollama apagado obtuvimos API Error: Connection refused — a firewall or proxy may be blocking it (ECONNREFUSED). Para ese tipo de error, mira Claude Code Unable to connect to API.

Cómo lo probamos

Entorno: Claude Code 2.1.312 con su propio CLAUDE_CONFIG_DIR para no tocar ninguna configuración existente, y Ollama 0.40.13 en el puerto 11434 con solo qwen2.5:0.5b descargado. Usamos las tres variables de la documentación de Ollama:

Estas pruebas corrieron en la computadora en la nube de uno de nuestros Grok Bot. No tiene GPU, por eso usamos un modelo tan pequeño. Cuánto cuesta y qué más hace está en Grok Bot: precio y uso real.

export ANTHROPIC_AUTH_TOKEN=ollama
export ANTHROPIC_API_KEY=""
export ANTHROPIC_BASE_URL=http://localhost:11434

Luego cambiamos solo el nombre del modelo o la URL en cada prueba y mandamos el mismo mensaje con claude -p:

Con el nombre correcto la petición pasó. Claude Code además avisó de que no reconoce el modelo y asume una ventana de contexto de 200k tokens. Un modelo de 0.5B es demasiado pequeño para seguir el prompt de herramientas de Claude Code y sus respuestas no venían al caso. Solo lo usamos para comprobar la conexión; para programar de verdad necesitas un modelo más grande.

Cuatro causas con Ollama

1. El modelo no está descargado o falta la etiqueta

ANTHROPIC_MODEL=qwen3:8b sin qwen3:8b en el disco falla. Poner solo qwen2.5 cuando lo que tienes es qwen2.5:0.5b también falla. Sin etiqueta Ollama busca :latest, así que un modelo descargado con otra etiqueta no coincide.

Solución: ejecuta ollama list y copia la columna NAME tal cual en --model o ANTHROPIC_MODEL, con los dos puntos y la etiqueta. Si el modelo no aparece, descárgalo antes con ollama pull.

2. ANTHROPIC_BASE_URL termina en /v1

Muchas guías dan http://localhost:11434/v1 como dirección de la API compatible con OpenAI de Ollama, y copiarla aquí rompe la conexión. Claude Code añade /v1/messages por su cuenta. En el log de Ollama la petición apareció como POST "/v1/v1/messages?beta=true" con un 404, y Claude Code mostró el mismo error. Un comentario en anthropics/claude-code#26408 describe el mismo problema de /v1/v1.

Solución: ANTHROPIC_BASE_URL=http://localhost:11434, sin /v1 y sin barra final.

3. No indicaste modelo y Claude Code envía el suyo por defecto

Si solo configuras la URL, Claude Code envía a Ollama su propio modelo por defecto. En nuestra prueba fue claude-opus-5-5, que Ollama obviamente no tiene.

Solución: arranca con --model tu-modelo o define ANTHROPIC_MODEL. La documentación de integración de Ollama con Claude Code también ofrece ollama launch claude, que configura las variables y abre Claude Code por ti. Nuestra versión 0.40.13 trae ese comando, pero los resultados de este artículo salen de la configuración manual de arriba.

4. Queda un modelo viejo en settings.json

Pusimos {"model":"claude-sonnet-4-6"} en el settings.json del directorio de configuración. Al ejecutar contra Ollama sin opciones, el error nombró claude-sonnet-4-6. Con el mismo archivo y --model qwen2.5:0.5b, la petición funcionó.

Coincide con el orden de prioridad de la documentación de configuración de modelos: primero /model dentro de la sesión, luego la opción --model, después ANTHROPIC_MODEL y solo al final la clave model de settings. Hay varios settings.json, también a nivel de proyecto; mira dónde está el settings.json de Claude Code.

Causas y soluciones en una tabla

Las cinco primeras filas las reprodujimos con Ollama. Las tres últimas vienen de la documentación:

«ANTHROPIC_BASE_URL olvidada» quiere decir que en algún momento exportaste la dirección de Ollama en el perfil de tu shell, luego volviste a tu cuenta de Anthropic, y Claude Code sigue mandando las peticiones a Ollama, así que todos los modelos de Claude dan 404. Un usuario en #26408 lo resolvió con unset ANTHROPIC_BASE_URL.

Configuración de OpenRouter (según la documentación oficial)

Esta sección no la probamos. La guía de OpenRouter para Claude Code usa:

export ANTHROPIC_BASE_URL="https://openrouter.ai/api"
export ANTHROPIC_AUTH_TOKEN="tu clave de OpenRouter"
export ANTHROPIC_API_KEY=""

• La dirección es https://openrouter.ai/api. No la conviertas en /api/v1.
• Pon ANTHROPIC_API_KEY explícitamente como cadena vacía. La documentación insiste en lo de «explícitamente»; no basta con no definirla.
• Si antes iniciaste sesión con una cuenta de Anthropic, ejecuta primero /logout en Claude Code. Según la documentación, una sesión en caché provoca errores de modelo no encontrado como este.
• Para elegir modelos, define ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL y ANTHROPIC_DEFAULT_HAIKU_MODEL con nombres de modelos de OpenRouter.
• Ejecuta /status en Claude Code para confirmar que habla con OpenRouter.

La documentación también advierte que Claude Code solo está garantizado con los modelos de Anthropic. Otros proveedores compatibles con Anthropic se configuran igual; para DeepSeek, Kimi y GLM mira Claude Code con DeepSeek.

Sin backend de terceros: usas una cuenta de Anthropic

Si nunca cambiaste ANTHROPIC_BASE_URL, la referencia oficial de errores sugiere:

• En la CLI, ejecuta /model y elige entre los modelos de tu cuenta. En modo -p, pasa un alias o un ID completo con --model.
• Usa alias como sonnet u opus. La documentación dice que apuntan a un modelo mantenido y no caducan; un ID completo escrito a mano sí puede quedarse viejo.
• Si el modelo equivocado vuelve una y otra vez, hay un ID viejo guardado en algún sitio. Revisa el orden de prioridad de arriba.
• Antes de la v2.1.206, una sesión caducada que no se podía renovar hacía fallar todos los modelos con este error. Ejecuta /login. Las versiones nuevas muestran Login expired.
• Si la URL apunta a un gateway de LLM y fallan todos los modelos así, prueba ENABLE_TOOL_SEARCH=false. Según la documentación, desde la v2.1.304 Claude Code envía por defecto los campos de búsqueda de herramientas a través de gateways, y algunos los rechazan.

El issue #62035 de GitHub informa de un model_not_found 404 en todos los modelos con una cuenta Pro. Parece un caso de cuenta o del servidor; compáralo si cambiar la configuración no ayuda. Para otros mensajes, búscalos en nuestra lista de errores de Claude Code.

Cuando el modelo local ya funciona

Después de este error, el siguiente problema suele ser el contexto. La documentación de Ollama recomienda al menos 64000 tokens de contexto para herramientas como Claude Code, y Ollama usa 4096 por defecto con menos de 24 GiB de VRAM. Aquí explicamos cómo cambiarlo: longitud de contexto en Ollama.

Preguntas frecuentes

¿Por qué el error nombra un modelo que nunca puse?

Algo con más prioridad define otro modelo, o no definiste ninguno y Claude Code usó el suyo por defecto. El nombre entre paréntesis es el que realmente se envió. Compáralo con /model, --model, ANTHROPIC_MODEL y cada settings.json.

ollama run funciona, pero Claude Code dice there’s an issue with the selected model

ollama run no pasa por ANTHROPIC_BASE_URL. Comprueba que la URL de Claude Code no tenga un /v1 de más y que el nombre del modelo coincida exactamente con ollama list.

¿Cómo veo a qué URL llamó Claude Code?

Lee el log del servidor de Ollama: cada petición deja una línea GIN con la ruta y el código de estado. Si ejecutas Claude Code con --debug, el 404 también queda en su log de depuración.