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
| Proveedor | ANTHROPIC_BASE_URL | Notas |
|---|---|---|
| DeepSeek | https://api.deepseek.com/anthropic | Guía oficial. Los nombres claude-opus* se asignan a V4 Pro; todo lo demás, a V4 Flash |
| Ollama (local) | http://localhost:11434 | Integración oficial desde Ollama 0.14; ollama launch claude lo configura |
| Kimi (Moonshot) | https://api.moonshot.ai/anthropic | Guía oficial; kimi-k2.7-code necesita el modo thinking activado |
| Z.ai GLM | https://api.z.ai/api/anthropic | Guía oficial |
| Alibaba Coding Plan | https://coding-intl.dashscope.aliyuncs.com/apps/anthropic | Guía oficial; los endpoints de pago por uso son por región |
| OpenRouter | https://openrouter.ai/api | Solo garantizado con Anthropic como proveedor de origen; define ANTHROPIC_API_KEY como cadena vacía |
| LM Studio (local) | http://localhost:1234 | Pá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
claudeSon 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 claudeEso 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.5Ollama 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_controlde 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=1elimina 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_KEYsobrante, un inicio de sesión guardado o valoresenvantiguos ensettings.jsonpueden anular la configuración;/statusmuestra 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 oharnessoharness -m deepseek/deepseek-v4-flashDespués, a mitad de sesión, /model anthropic/claude-sonnet-5 para el paso que lo necesite, y vuelta atrás.
Fuentes
- Anthropic: gateways de LLM y variables de entorno
- DeepSeek: Claude Code y compatibilidad con la API de Anthropic
- Ollama: Claude Code y compatibilidad con Anthropic
- Kimi: Claude Code, Z.ai: Claude Code, Alibaba Model Studio: Claude Code
- OpenRouter: Claude Code, LM Studio: Claude Code
- Comprobado el 2026-09-25. Los proveedores cambian estos endpoints; sus páginas son la referencia.
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.