Saltar al contenido principal

Claude Code con OpenRouter y DeepSeek: rutas, configuración y primeros errores

Para usar DeepSeek en Claude Code, elige OpenRouter con su clave e ID de modelo, o el endpoint Anthropic de DeepSeek con una clave de DeepSeek. Las dos conexiones tienen configuración directa; un proxy local es opcional.

LaoZhang AI TeamPublicadoActualizado 12 min de lectura
En esta página
Conexiones de Claude Code con OpenRouter, DeepSeek directo y un intermediario local

Puedes usar DeepSeek en Claude Code a través de OpenRouter o conectándolo directamente a DeepSeek. En ambos casos hay una configuración documentada que no necesita un proxy local: cambia la URL base, aporta la clave del servicio elegido y fija un modelo que ese servicio reconozca. La diferencia práctica es dónde se gestionan la credencial, el enrutamiento y el consumo. Las instrucciones actuales están en las guías de OpenRouter y DeepSeek.

Si quieres…ConexiónURL baseModelo del ejemplo
Usar el catálogo y el registro de consumo de OpenRouter, con sus opciones de proveedoresDeepSeek a través de OpenRouterhttps://openrouter.ai/apideepseek/deepseek-v4.1-flash
Usar una clave de DeepSeek y su API directamenteDeepSeek directohttps://api.deepseek.com/anthropicdeepseek-flash[1m]

Estos identificadores corresponden a la documentación y al catálogo público de OpenRouter consultados el 6 de octubre de 2026. No copies el ID de una fila en la otra: el prefijo deepseek/ pertenece a OpenRouter. En DeepSeek directo, deepseek-flash es actualmente un alias de DeepSeek-V4.1-Flash; el sufijo [1m] sirve para indicar contexto al cliente, no para crear otro modelo. Modelos y alias de DeepSeek.

La guía presupone que ya tienes Claude Code instalado y una clave autorizada del proveedor elegido. Los ejemplos usan Bash en macOS o Linux, piden la clave sin mostrarla y limitan los cambios de entorno a una sesión. Son ejemplos basados en documentación; para esta actualización no se han realizado llamadas de inferencia ni pruebas con cuentas reales.

Antes de empezar: comprueba qué configuración se aplica

Abre Bash en la terminal desde la que vas a iniciar Claude Code. Si estás usando otro intérprete, ejecuta bash primero. No pegues estas instrucciones en PowerShell: DeepSeek publica un ejemplo específico para Windows en su guía.

Relación entre las variables de Claude Code y las credenciales de cada servicio

Antes de introducir la clave, comprueba tres condiciones:

  • La sesión no está obligada a usar un gateway corporativo ni un proveedor cloud seleccionado, como Bedrock, Google Cloud o Foundry. Esos accesos tienen reglas propias; un export local no anula una política administrada.
  • Ningún bloque env de settings está imponiendo otra URL, credencial o modelo. Para la misma variable, el valor de settings puede aplicarse por encima del heredado de la shell.
  • Vas a iniciar el CLI desde esa terminal. Una aplicación abierta desde el Dock, Claude Desktop o una sesión cloud no queda configurada automáticamente por estos comandos.

Estas condiciones proceden de las guías de autenticación y conexión de gateways. Si no sabes de dónde sale un ajuste, consulta la configuración de claves, settings y gateways de Claude Code antes de cambiar archivos al azar.

No necesitas borrar credenciales guardadas para empezar. OpenRouter recomienda /logout cuando un inicio de sesión anterior de Anthropic interfiere con su configuración. Aplícalo solo si has identificado ese caso: cierra o revoca la credencial activa y no elimina una clave que siga definida en la shell. La documentación de Anthropic permite conservar el inicio de sesión guardado al usar una credencial de gateway. No borres el Llavero, el historial ni los archivos de credenciales como parte de esta prueba. Condiciones de OpenRouter y autenticación del gateway.

Configurar Claude Code con DeepSeek por OpenRouter

Necesitas una clave de OpenRouter, acceso al modelo y saldo o crédito aplicable en ese servicio. Una clave emitida por DeepSeek no sirve para autenticar esta conexión. OpenRouter recibe las peticiones de Claude Code con su implementación del formato Anthropic Messages; por eso la URL base documentada es https://openrouter.ai/api, aunque su catálogo de modelos se publique bajo /api/v1/models. Configuración de OpenRouter.

El siguiente bloque abre una subshell, pide la clave y fija el modelo principal, las tres familias habituales y los subagentes. Los paréntesis permiten que los exports desaparezcan al salir de Claude Code:

bash
(
  IFS= read -r -s -p 'Clave de OpenRouter: ' OPENROUTER_API_KEY
  printf '\n'
  if [ -z "$OPENROUTER_API_KEY" ]; then
    printf 'Falta la clave de OpenRouter.\n' >&2
    exit 1
  fi

  export ANTHROPIC_BASE_URL='https://openrouter.ai/api'
  export ANTHROPIC_AUTH_TOKEN="$OPENROUTER_API_KEY"
  export ANTHROPIC_API_KEY=''
  export ANTHROPIC_MODEL='deepseek/deepseek-v4.1-flash'
  export ANTHROPIC_DEFAULT_OPUS_MODEL='deepseek/deepseek-v4.1-flash'
  export ANTHROPIC_DEFAULT_SONNET_MODEL='deepseek/deepseek-v4.1-flash'
  export ANTHROPIC_DEFAULT_HAIKU_MODEL='deepseek/deepseek-v4.1-flash'
  export CLAUDE_CODE_SUBAGENT_MODEL='deepseek/deepseek-v4.1-flash'

  claude --model 'deepseek/deepseek-v4.1-flash'
)

La clave se define antes de expandir "$OPENROUTER_API_KEY". Instalar Claude Code o guardar una clave en un archivo .env no garantiza que esta terminal la haya cargado. Además, la receta de OpenRouter establece expresamente ANTHROPIC_API_KEY como cadena vacía; no mezcles esa variable con una antigua clave de Anthropic.

Los valores ANTHROPIC_DEFAULT_* configuran las familias que Claude Code puede solicitar. Cambiar solo ANTHROPIC_MODEL no indica que los modelos de tareas auxiliares y subagentes también hayan cambiado. Tampoco esta lista promete que cualquier función futura use el mismo modelo: recoge los controles documentados pertinentes a esta configuración. Familias y selección de modelos.

Si DeepSeek no aparece en el selector de modelos

Puedes fijar el ID directamente, como en el ejemplo, sin depender del selector. Si quieres que Claude Code descubra modelos del gateway, añade en la misma subshell, antes de arrancarlo:

bash
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1

Reinicia Claude Code tras activarlo. OpenRouter devuelve para esta función una selección de modelos, no necesariamente todo su catálogo. Que un modelo no aparezca ahí no demuestra que no exista. Si el descubrimiento está desactivado o no está disponible, Claude Code también admite una entrada personalizada:

bash
export ANTHROPIC_CUSTOM_MODEL_OPTION='deepseek/deepseek-v4.1-flash'

La entrada facilita elegirlo, pero no valida el ID ni concede acceso. Las restricciones availableModels, la cuenta y el proveedor siguen aplicándose. Descubrimiento de OpenRouter y modelos personalizados de Claude Code.

Ten cuidado al experimentar con /model: escribir el nombre o confirmar con Intro guarda el modelo predeterminado de usuario. La tecla s del selector aplica la elección solo a la sesión. El ejemplo anterior usa --model para el arranque sin guardar esa preferencia. Si ya había una selección persistente, comprueba cuál se aplica al volver a tu conexión habitual. Persistencia de la selección.

Configurar Claude Code con DeepSeek directo

Esta conexión necesita una clave de DeepSeek y acceso a su API. La URL https://api.deepseek.com/anthropic acepta el formato Anthropic; no la sustituyas por un endpoint de Chat Completions esperando que Claude Code cambie de protocolo. La receta del CLI usa la clave como bearer en ANTHROPIC_AUTH_TOKEN. El ejemplo de SDK Anthropic de DeepSeek usa otro campo, ANTHROPIC_API_KEY, para x-api-key: corresponde a ese SDK, no a la receta del CLI. Integración con Claude Code y API compatible con Anthropic.

Para seguir la configuración actual de modelos publicada por DeepSeek:

bash
(
  IFS= read -r -s -p 'Clave de DeepSeek: ' DEEPSEEK_API_KEY
  printf '\n'
  if [ -z "$DEEPSEEK_API_KEY" ]; then
    printf 'Falta la clave de DeepSeek.\n' >&2
    exit 1
  fi

  export ANTHROPIC_BASE_URL='https://api.deepseek.com/anthropic'
  export ANTHROPIC_AUTH_TOKEN="$DEEPSEEK_API_KEY"
  unset ANTHROPIC_API_KEY
  export ANTHROPIC_MODEL='deepseek-flash[1m]'
  export ANTHROPIC_DEFAULT_OPUS_MODEL='deepseek-flash[1m]'
  export ANTHROPIC_DEFAULT_SONNET_MODEL='deepseek-flash[1m]'
  export ANTHROPIC_DEFAULT_HAIKU_MODEL='deepseek-flash'
  export CLAUDE_CODE_SUBAGENT_MODEL='deepseek-flash'

  claude --model 'deepseek-flash[1m]'
)

Las comillas alrededor de [1m] evitan que Bash interprete los corchetes como un patrón de archivos. DeepSeek publica también ajustes de esfuerzo y de compactación en su receta; consulta allí los valores si necesitas reproducirla completa. No son un requisito general para cualquier gateway ni sustituyen las comprobaciones de URL, credencial y modelo.

El contexto anunciado por DeepSeek es de un millón de tokens. En modelos personalizados, [1m] comunica una expectativa de contexto a Claude Code; no concede capacidad al servidor. OpenRouter retira ese sufijo antes de enrutar la petición. En su catálogo actual, deepseek/deepseek-v4.1-flash anuncia 1.048.576 tokens, pero eso no convierte todos los modelos de OpenRouter en modelos de esa capacidad. Contexto de DeepSeek, catálogo de OpenRouter y comportamiento del cliente.

Por qué una respuesta correcta no confirma el modelo solicitado

DeepSeek documenta una traducción de nombres en su API compatible con Anthropic. Los nombres Claude de la familia Opus se asignan a deepseek-v4-pro; los de Haiku y Sonnet, a Flash. Los nombres no admitidos se redirigen a Flash. Por tanto, un ID equivocado puede responder sin devolver «modelo no encontrado». Usar un nombre Opus también puede llevar a consumo de Pro. Asignación de modelos de DeepSeek.

Para esta conexión, fija los nombres de DeepSeek de forma explícita y comprueba el modelo registrado por el servicio. No preguntes al asistente «¿qué modelo eres?» como prueba técnica: su respuesta es texto generado, no un registro del servidor. Los alias históricos deepseek-v4-flash y deepseek-v4-flash-vision-exp siguen aceptándose en la API directa, pero DeepSeek indica que sus llamadas se sirven mediante V4.1-Flash y se facturan a la tarifa Flash. Esa política no debe extrapolarse a un ID de OpenRouter con nombre parecido. Alias retirados y facturación directa.

Guardar ajustes sin guardar una clave por error

Cuando la conexión temporal funcione, decide cómo vas a conservar los ajustes y cómo vas a proporcionar el secreto. No uses una variable escrita dentro de JSON como si fuera una clave ya cargada:

json
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "$DEEPSEEK_API_KEY"
  }
}

Es JSON válido, pero $DEEPSEEK_API_KEY es una cadena: no demuestra que Claude Code la expanda ni que se haya recibido una credencial real. Una expansión documentada por un router de terceros pertenece a ese router, no automáticamente a settings de Claude Code.

Puedes guardar valores no secretos de OpenRouter de esta forma, manteniendo el token en el mecanismo autorizado que arranque el cliente:

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://openrouter.ai/api",
    "ANTHROPIC_API_KEY": "",
    "ANTHROPIC_MODEL": "deepseek/deepseek-v4.1-flash",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek/deepseek-v4.1-flash",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek/deepseek-v4.1-flash",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek/deepseek-v4.1-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek/deepseek-v4.1-flash"
  }
}

Este archivo no aporta el token; el lanzamiento debe seguir recibiendo ANTHROPIC_AUTH_TOKEN, como en el bloque de Bash. Para DeepSeek directo, conserva su URL y sus nombres de modelo del ejemplo anterior, con una credencial de DeepSeek. Si hay un token distinto en otro bloque env, el export de la shell puede no ser el que se aplique.

El archivo local documentado es .claude/settings.local.json. Claude Code excluye de Git uno que crea él mismo; si lo creas tú, debes comprobar su exclusión. Eso evita incorporarlo accidentalmente, pero no lo convierte en un almacén seguro de secretos. La resolución del archivo en proyectos Git y worktrees tiene condiciones propias. Ámbitos de settings y entorno del gateway.

Verificar la conexión antes de editar un repositorio

Comprobaciones del cliente y del proveedor antes de trabajar con Claude Code

Después de arrancar el CLI con una de las dos configuraciones, introduce /status. Comprueba el método de autenticación y la URL base que muestra. Si enumera Setting Sources, esa lista identifica archivos cargados; no es un desglose de qué archivo ganó para cada variable.

A continuación, con una petición cuyo consumo hayas autorizado, sigue esta secuencia:

  1. Pide una respuesta corta sin herramientas, por ejemplo: «Responde únicamente OK. No leas ni modifiques archivos». Obtenerla comprueba que ha habido una inferencia en esa sesión.
  2. Busca la petición en la actividad del servicio elegido. En OpenRouter, contrasta el modelo y el proveedor registrados; en DeepSeek directo, revisa el consumo o registro que ofrezca tu cuenta. Correlaciona hora y solicitud sin publicar la clave ni contenido privado. Si el panel no expone un dato, ese dato sigue sin confirmar.
  3. Prueba por separado una acción de lectura sobre un archivo de prueba no sensible, sin permisos de escritura: «Lee este archivo y resume su contenido; no modifiques nada». Comprueba que la herramienta se ejecuta y que el resultado permite continuar la conversación.
  4. Solo después pasa a una tarea real con los permisos que hayas decidido conceder. Una respuesta de texto no comprueba el ciclo de llamadas a herramientas.

La guía de OpenRouter propone contrastar el estado del cliente con su actividad. /status solo, la autodescripción del modelo o un panel sin actividad no identifican de forma concluyente el servidor que procesó una solicitud. Un panel vacío puede indicar otro destino, pero también retrasos, filtros o que la petición falló antes de generar un registro visible. Si no consigues relacionar la respuesta con el servicio esperado, detén la prueba y revisa el lanzamiento y los ajustes antes de enviar más trabajo.

La compatibilidad de protocolo tampoco equivale a todas las funciones de Claude. DeepSeek documenta mensajes, streaming y el intercambio de herramientas, pero ignora campos como cache_control y el presupuesto de thinking; determinados bloques MCP, resultados de ejecución y documentos no son compatibles. Su búsqueda web también puede añadir solicitudes y consumo para resumir resultados. Prueba la función que necesita tu proyecto, no solo un saludo. Compatibilidad y límites de DeepSeek.

Resolver el primer error sin cambiarlo todo

La primera decisión es saber si falló la autenticación, la selección del modelo o una función concreta. Conserva el texto del error y la URL de destino, sin incluir el secreto. Estos síntomas orientan la siguiente comprobación; por sí solos no demuestran una causa única.

Lo que vesQué comprobar primeroCómo continuar
401 o 403Clave del servicio correcto, presencia del token y restricciones de cuenta o políticaRepite la configuración de una sola conexión; si la clave no es válida o la política la impide, resuélvelo con ese servicio o administrador
404 o model not found en OpenRouterID completo con deepseek/, disponibilidad actual y modelo guardadoFija un ID existente con --model; no cambies al ID de DeepSeek directo
DeepSeek responde pese a un nombre extrañoTraducción o respaldo a Flash documentado por DeepSeekUsa deepseek-flash explícitamente y contrasta el registro; no interpretes la respuesta como validación del nombre
El cliente muestra otra URL o accesoSettings con env, selector cloud o gateway corporativoIdentifica el ajuste que lo impone; no intentes saltarte una política administrada
No aparece consumo en el panel esperadoDestino, intervalo y filtros del panel, respuesta o error realNo concluyas que no se procesó; correlaciona la petición antes de seguir
El texto funciona, pero las herramientas fallan o la sesión se queda esperandoEl primer intercambio de herramientas y sus formatosPrueba una lectura sencilla; contrasta los límites del proveedor y vuelve a una conexión conocida si la función necesaria no funciona
Error de saldo, límite o disponibilidadSaldo, cuota y acceso del servicio que recibió la peticiónConsulta ese servicio; cambiar el nombre del modelo no crea crédito ni acceso

En OpenRouter, empieza por los errores y condiciones de su integración. En DeepSeek directo, consulta su compatibilidad Anthropic. Un 404 genérico no prueba que la credencial sea válida: un servidor puede comprobar el modelo antes que la autenticación.

Volver a la configuración anterior

Sal de Claude Code. Los ejemplos con paréntesis terminan entonces la subshell y retiran sus propios exports; las variables y ajustes que existían antes siguen presentes. Si no cambiaste settings ni usaste /model para guardar una preferencia, puedes arrancar desde tu terminal habitual y comprobar de nuevo /status.

Si guardaste un ajuste, restaura únicamente ese cambio: URL, modelo, familias o token en el archivo o mecanismo donde lo añadiste. Si elegiste un predeterminado con /model, vuelve a seleccionar el modelo válido de tu conexión anterior; limpiar cuatro variables no borra esa preferencia. Si cerraste sesión, puede ser necesario autenticar otra vez. Evita borrar toda la configuración para recuperar una sola conexión. Selección de modelos y autenticación.

Preguntas frecuentes

¿Hace falta Claude Code Router para usar DeepSeek?

No para las dos conexiones documentadas aquí. OpenRouter y DeepSeek publican configuraciones directas para Claude Code. Claude Code Router puede ser un intermediario opcional para necesidades de enrutamiento propias; sus reglas, expansión de variables y compatibilidad se deben comprobar en su documentación. Los tutoriales de CCR de 2025 no prueban el comportamiento actual del CLI ni convierten un proxy en requisito. OpenRouter y DeepSeek.

¿Puedo usar una clave de DeepSeek en OpenRouter?

No en esta configuración. Para https://openrouter.ai/api necesitas la credencial de OpenRouter; para https://api.deepseek.com/anthropic, la de DeepSeek. Son accesos distintos aunque ambos utilicen un modelo DeepSeek. Las guías de OpenRouter y DeepSeek definen cada credencial.

¿DeepSeek en Claude Code es gratis o ilimitado?

Cambiar el proveedor no concede uso gratis ni ilimitado. DeepSeek descuenta el consumo de su saldo y publica tarifas por millón de tokens que distinguen entradas, salidas, caché y franjas horarias. OpenRouter aplica las condiciones de su propia cuenta y proveedores. No hay una comparación válida usando solo el precio más bajo de un catálogo: comprueba el modelo efectivo y el tipo de consumo de tu petición. Tarifas de DeepSeek y integración y consumo de OpenRouter.

¿Usar DeepSeek significa tener todas las funciones de Claude Code?

No se puede deducir del endpoint ni de una respuesta correcta. DeepSeek documenta capacidades y campos no admitidos de su API Anthropic; Anthropic tampoco garantiza el soporte de cualquier modelo de otro proveedor. Verifica las herramientas y funciones que vas a usar antes de delegar cambios. Límites de DeepSeek y condiciones de gateways de Anthropic.

Fuentes10

Páginas externas que cita esta guía, en el orden en que aparecen. Última actualización: 6 oct 2026.

  1. 1.OpenRouteropenrouter.ai/docs/cookbook/coding-agents/claude-code-integration
  2. 2.DeepSeekapi-docs.deepseek.com/quick_start/agent_integrations/claude_code
  3. 3.catálogo público de OpenRouteropenrouter.ai/api/v1/models
  4. 4.Modelos y alias de DeepSeekapi-docs.deepseek.com/quick_start/pricing
  5. 5.autenticacióncode.claude.com/docs/en/authentication
  6. 6.conexión de gatewayscode.claude.com/docs/en/llm-gateway-connect
  7. 7.autenticación del gatewaycode.claude.com/docs/en/llm-gateway
  8. 8.Familias y selección de modeloscode.claude.com/docs/en/model-config
  9. 9.API compatible con Anthropicapi-docs.deepseek.com/guides/anthropic_api
  10. 10.Ámbitos de settingscode.claude.com/docs/en/settings
Opciones para conectar Claude Code con documentación, repositorios y herramientas de desarrollo
Claude Code

Los mejores MCP para Claude Code: cuál instalar primero

Empieza con Context7 si necesitas documentación de la versión que usas, GitHub si te falta información de issues y PR, Playwright si debes explorar una interfaz o Sentry si investigas errores de producción. La conexión está comprobada cuando una herramienta devuelve un dato útil para tu tarea.

12 min