Usar Claude Code con DeepSeek, Ollama u otros modelos

Apunta Claude Code al endpoint compatible con Anthropic de un proveedor con ANTHROPIC_BASE_URL y ANTHROPIC_AUTH_TOKEN, e indica los modelos del proveedor en ANTHROPIC_MODEL y en las variables ANTHROPIC_DEFAULT_*_MODEL. Funciona, pero Anthropic no lo admite oficialmente, cada sesión habla con un solo proveedor y funciones como el prompt caching pueden ignorarse en silencio.

Actualizado el

Cómo funciona

Claude Code envía cada solicitud en el formato Messages de Anthropic a lo que indique ANTHROPIC_BASE_URL. Un proveedor que sirva ese formato puede sustituir a Anthropic, y Claude Code no nota la diferencia hasta que una solicitud usa algo que el proveedor no ha implementado. La documentación de gateways de Anthropic deja claro que esto no está admitido: «no admite enrutar Claude Code a modelos que no son de Claude a través de ningún gateway».

Endpoints que funcionan

ProveedorANTHROPIC_BASE_URLNotas
DeepSeekhttps://api.deepseek.com/anthropicGuía oficial. Los nombres claude-opus* se asignan a V4 Pro; todo lo demás, a V4 Flash
Ollama (local)http://localhost:11434Integración oficial desde Ollama 0.14; ollama launch claude lo configura
Kimi (Moonshot)https://api.moonshot.ai/anthropicGuía oficial; kimi-k2.7-code necesita el modo thinking activado
Z.ai GLMhttps://api.z.ai/api/anthropicGuía oficial
Alibaba Coding Planhttps://coding-intl.dashscope.aliyuncs.com/apps/anthropicGuía oficial; los endpoints de pago por uso son por región
OpenRouterhttps://openrouter.ai/apiSolo garantizado con Anthropic como proveedor de origen; define ANTHROPIC_API_KEY como cadena vacía
LM Studio (local)http://localhost:1234Página de integración oficial

Ejemplo: DeepSeek

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<your DeepSeek 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

Son los valores de la propia página de Claude Code de DeepSeek. Define todos los niveles, no solo ANTHROPIC_MODEL: un nivel sin definir sigue enviando un nombre de modelo de Claude que el endpoint no conoce, y fallan las tareas en segundo plano y los subagentes que lo usan.

Ejemplo: un modelo local con Ollama

ollama launch claude

Eso configura Claude Code por ti. A mano, son tres variables y un modelo que admita llamadas a herramientas:

export ANTHROPIC_BASE_URL=http://localhost:11434
export ANTHROPIC_AUTH_TOKEN=ollama
export ANTHROPIC_API_KEY=""
claude --model qwen3.5

Ollama recomienda una ventana de contexto de 64K tokens o más para repositorios grandes; un agente de código vuelve a enviar la conversación en cada turno y una ventana pequeña se llena rápido.

Qué falla

  • Marcadores de prompt caching. DeepSeek y Ollama ignoran el cache_control de Anthropic, y Kimi solo lo respeta en el nivel superior. No hay ningún error; que sigas obteniendo precios de caché depende del caché propio del proveedor.
  • Cambiar de proveedor. Claude Code lee un único ANTHROPIC_BASE_URL, así que pasar de DeepSeek a Claude implica reiniciar con otra configuración, no un comando /model.
  • Búsqueda web. La herramienta WebSearch de Claude Code se ejecuta en los servidores de Anthropic. DeepSeek dice que su endpoint la admite; Ollama dice que la búsqueda web alojada no está totalmente admitida.
  • Campos de solicitud desconocidos. Claude Code trata un nombre de modelo no reconocido como un modelo actual de Claude y envía campos de thinking y esfuerzo que algunos endpoints rechazan con un 400. CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 elimina los campos beta, a costa de la búsqueda de herramientas MCP.
  • Funciones de la cuenta. Remote Control y el dictado por voz no están disponibles mientras haya una credencial de gateway definida.
  • Credenciales antiguas. Un ANTHROPIC_API_KEY sobrante, un inicio de sesión guardado o valores env antiguos en settings.json pueden anular la configuración; /status muestra cuál se está usando.

Cuándo encaja mejor un agente independiente del modelo

Si quieres un proveedor cada vez y ya trabajas en Claude Code, la configuración de arriba basta. Si quieres Claude, DeepSeek y un modelo local dentro de la misma tarea, OHarness lo hace de forma nativa: cada proveedor viene integrado, la conversación se guarda en un formato neutral respecto al proveedor y /model cambia de proveedor sin reiniciar. OHarness vs. Claude Code compara los dos directamente.

npm install -g oharness
oharness -m deepseek/deepseek-v4-flash

Después, a mitad de sesión, /model anthropic/claude-sonnet-5 para el paso que lo necesite, y vuelta atrás.

Fuentes

Preguntas frecuentes

¿Claude Code puede usar modelos de DeepSeek?

Sí, de forma no oficial. DeepSeek sirve un endpoint compatible con Anthropic en https://api.deepseek.com/anthropic: define ANTHROPIC_BASE_URL con esa dirección, ANTHROPIC_AUTH_TOKEN con una clave API de DeepSeek y las variables de modelo con los nombres de modelo de DeepSeek. Anthropic no admite modelos que no sean de Claude en Claude Code.

¿Claude Code puede usar un modelo local con Ollama?

Sí. Ollama 0.14 y posteriores sirven el formato Messages de Anthropic, y `ollama launch claude` configura Claude Code para usarlo. Elige un modelo que admita llamadas a herramientas y dale una ventana de contexto de 64K tokens o más.

¿Claude Code puede alternar entre Claude y DeepSeek en una misma sesión?

No. Claude Code lee un único ANTHROPIC_BASE_URL, así que una sesión de Claude Code habla con un solo proveedor. OHarness cambia entre Anthropic, DeepSeek, OpenAI, Gemini y modelos locales a mitad de sesión con /model.

¿Por qué Claude Code devuelve errores 400 con el endpoint de otro proveedor?

Claude Code supone que un modelo no reconocido es un modelo actual de Claude y envía campos como el thinking adaptativo y el esfuerzo que algunos endpoints rechazan. Definir todas las variables ANTHROPIC_DEFAULT_*_MODEL con los nombres del proveedor, y CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1, elimina la mayoría.

Relacionado