Aviso de independencia y soporte: DeepSeek Español es un sitio informativo independiente operado por Ahmed Aly. No pertenece a DeepSeek ni a Anthropic y no está respaldado por ninguna de las dos empresas. DeepSeek publica esta receta de configuración, pero identifica Claude Code como una herramienta de terceros. La conexión se basa en un endpoint compatible y no implica garantía de paridad total ni soporte conjunto de DeepSeek y Anthropic.
Última verificación documental: 29 de julio de 2026. Las instrucciones se contrastaron con la guía vigente de DeepSeek y la documentación de Claude Code. No se usó una clave real ni se completó una sesión; la validación requiere una API key de DeepSeek con saldo y un repositorio de prueba sin secretos.
Respuesta rápida
Instala Claude Code con un método oficial actual, define ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic, coloca una clave de DeepSeek en ANTHROPIC_AUTH_TOKEN y asigna los modelos V4. La receta publicada por DeepSeek usa V4 Pro para la sesión principal y V4 Flash para Haiku y subagentes. Las solicitudes del modelo dirigidas a esa Base URL se cargan a la cuenta API de DeepSeek; esto no convierte DeepSeek en Claude ni implica soporte de Anthropic.
| Elemento | Valor correcto |
|---|---|
| Base URL | https://api.deepseek.com/anthropic |
| Credencial en Claude Code | ANTHROPIC_AUTH_TOKEN con una clave de DeepSeek |
| Modelo principal | deepseek-v4-pro[1m] |
| Modelo ligero | deepseek-v4-flash |
| Proveedor de inferencia | DeepSeek Open Platform |
| Producto cliente | Claude Code, de Anthropic |
| Soporte para modelos no Claude | Configuración publicada por DeepSeek; no respaldada por Anthropic |
Qué ocurre al conectar DeepSeek con Claude Code
Claude Code sigue siendo la aplicación que analiza el proyecto, solicita permisos, coordina herramientas y muestra los cambios. La generación remota se redirige al endpoint compatible con el formato Anthropic que mantiene DeepSeek. El código, los mensajes y los resultados incluidos en cada solicitud se transmiten al host de DeepSeek; por tanto, esta configuración no es local ni offline.
La compatibilidad es de protocolo, no de producto. No afirma que DeepSeek sea un modelo Claude ni que todas las funciones de la API de Anthropic tengan el mismo comportamiento. Antes de utilizar código propietario o datos personales, revisa las condiciones de DeepSeek Open Platform, la política de privacidad de DeepSeek y la documentación de uso de datos de Claude Code.
Requisitos antes de configurar la integración
- Una cuenta en DeepSeek Platform, una clave API activa y saldo utilizable.
- Claude Code instalado en un sistema compatible.
- Una terminal donde puedas definir variables de entorno.
- Un repositorio de prueba sin secretos ni datos sensibles.
- Permiso para enviar al proveedor remoto el código o texto que incluirás en las solicitudes.
El chat web de DeepSeek y su API son superficies distintas. Esta configuración utiliza la API; no sincroniza una conversación del chat oficial ni convierte una suscripción de otra aplicación en saldo API.
Instalar Claude Code con el método actual
Anthropic recomienda actualmente la instalación nativa. En macOS, Linux o WSL:
curl -fsSL https://claude.ai/install.sh | bashEn Windows PowerShell:
irm https://claude.ai/install.ps1 | iexCon WinGet:
winget install Anthropic.ClaudeCodeLa instalación global mediante npm continúa disponible:
npm install -g @anthropic-ai/claude-codeLa guía actual de instalación de Claude Code indica que, desde la versión 2.1.198, el paquete npm requiere Node.js 22 o posterior. La subsección de instalación de DeepSeek todavía muestra un requisito antiguo de Node 18+; para requisitos del cliente, prioriza la documentación de Anthropic.
claude --version
claude doctorConfigurar DeepSeek en macOS, Linux o WSL
Define las variables en la misma terminal desde la que ejecutarás Claude Code. Sustituye el marcador por una clave creada en DeepSeek Platform:
export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
export ANTHROPIC_AUTH_TOKEN="<TU_CLAVE_DE_DEEPSEEK>"
export ANTHROPIC_MODEL="deepseek-v4-pro[1m]"
export ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro[1m]"
export ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro[1m]"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash"
export CLAUDE_CODE_SUBAGENT_MODEL="deepseek-v4-flash"
export CLAUDE_CODE_EFFORT_LEVEL="max"No añadas /v1 al final de ANTHROPIC_BASE_URL. Claude Code construye la ruta de Messages a partir de esa base. No escribas la clave en el repositorio, en un bloque compartido de settings.json ni en una captura de pantalla.
Configurar DeepSeek en Windows PowerShell
$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="<TU_CLAVE_DE_DEEPSEEK>"
$env:ANTHROPIC_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash"
$env:CLAUDE_CODE_SUBAGENT_MODEL="deepseek-v4-flash"
$env:CLAUDE_CODE_EFFORT_LEVEL="max"Estas asignaciones duran mientras la ventana de PowerShell permanezca abierta. Es una forma adecuada de probar la conexión sin convertir la clave en configuración compartida. Para hacerla persistente, usa una ubicación privada y controlada; no la añadas a Git.
Qué hace cada variable
| Variable | Función en esta receta |
|---|---|
ANTHROPIC_BASE_URL | Dirige las solicitudes al endpoint compatible de DeepSeek. |
ANTHROPIC_AUTH_TOKEN | Entrega la clave de DeepSeek como credencial activa de Claude Code. |
ANTHROPIC_MODEL | Fija el modelo principal de la sesión. |
ANTHROPIC_DEFAULT_OPUS_MODEL | Asigna el alias Opus a V4 Pro. |
ANTHROPIC_DEFAULT_SONNET_MODEL | Asigna el alias Sonnet a V4 Pro mediante un override explícito. |
ANTHROPIC_DEFAULT_HAIKU_MODEL | Asigna Haiku y tareas ligeras a V4 Flash. |
CLAUDE_CODE_SUBAGENT_MODEL | Selecciona V4 Flash para subagentes. |
CLAUDE_CODE_EFFORT_LEVEL | La receta de DeepSeek establece max para este flujo; no implica un coste o una latencia fijos. |
Si ya existe ANTHROPIC_API_KEY de otra configuración, evita mantener dos fuentes de credenciales ambiguas en la misma sesión. Comprueba la configuración activa con /status dentro de Claude Code y revisa si un archivo de ajustes está sobrescribiendo las variables del shell.
Qué significa el sufijo [1m]
[1m] es la convención de Claude Code para seleccionar una ventana de contexto de un millón de tokens cuando el modelo subyacente la admite. La documentación de modelos de Claude Code indica que el cliente elimina el sufijo antes de enviar el ID al proveedor. DeepSeek publica 1M de contexto para V4 Pro y utiliza deepseek-v4-pro[1m] en su receta.
En una llamada directa con cURL o Anthropic SDK utiliza deepseek-v4-pro, sin el sufijo. Una ventana amplia no significa una salida de un millón de tokens ni garantiza que un repositorio completo pueda procesarse de una sola vez: archivos, instrucciones, resultados de herramientas y respuestas comparten el contexto.
Iniciar y verificar la conexión
- Abre una carpeta de prueba sin secretos.
- Ejecuta
claude --versionyclaude doctor. - Inicia
claudey abre/status. - Confirma la Base URL, la credencial activa y el modelo configurado.
- Realiza una petición de texto sin herramientas antes de conceder permisos de escritura.
Para una comprobación no interactiva que bloquee el uso de herramientas:
claude -p "Responde exactamente: conexión verificada" \
--output-format json \
--disallowedTools "*"La opción -p por sí sola no garantiza que una ejecución carezca de herramientas. Mantén --disallowedTools "*" y usa una carpeta de prueba. Una respuesta válida confirma endpoint y autenticación, pero una cadena de modelo mal escrita puede activar el fallback documentado a V4 Flash; comprueba el consumo en DeepSeek Platform.
Mapeo de modelos en Claude Code
| Selección o nombre | Resultado documentado |
|---|---|
| Sesión principal de la receta | deepseek-v4-pro[1m] en Claude Code |
| Override de Opus | DeepSeek V4 Pro |
| Override de Sonnet | DeepSeek V4 Pro |
| Override de Haiku | DeepSeek V4 Flash |
| Subagentes | DeepSeek V4 Flash |
Nombre literal que empieza por claude-opus | El backend de DeepSeek lo mapea a V4 Pro |
Nombre literal que empieza por claude-sonnet o claude-haiku | El backend de DeepSeek lo mapea a V4 Flash |
| Nombre no admitido | Fallback documentado a V4 Flash |
El override explícito de Sonnet a Pro en la receta y el mapeo de un nombre literal claude-sonnet… a Flash describen dos situaciones distintas. Para evitar ambigüedad, conserva los IDs y variables exactos.
Estado de deepseek-chat y deepseek-reasoner
DeepSeek fijó el 24 de julio de 2026 a las 15:59 UTC como fecha límite para retirar completamente deepseek-chat y deepseek-reasoner. Ese plazo ya ha vencido. La referencia actual de List Models solo enumera deepseek-v4-flash y deepseek-v4-pro; no utilices los aliases antiguos en configuraciones nuevas. Esta revisión no atribuye un error HTTP concreto a una llamada no autenticada con un ID retirado.
Funciones disponibles y límites reales
| Función | Estado o cautela |
|---|---|
Texto, system y streaming | Compatibilidad documentada por el endpoint de DeepSeek. |
| Tool use | Compatible en el formato estándar; Claude Code sigue controlando permisos y ejecución local. |
| Thinking | DeepSeek lo activa por defecto; la receta solicita esfuerzo max. |
| Web Search | DeepSeek lo documenta para Claude Code; puede generar llamadas y tokens adicionales. |
| Imágenes y documentos | Los bloques Anthropic image y document no están admitidos por este endpoint. |
anthropic-beta | Se ignora; no habilita funciones beta de Anthropic. |
| Bloques MCP administrados por la API | mcp_tool_use y mcp_tool_result no están admitidos. |
| MCP local de Claude Code | No debe confundirse con los bloques anteriores; prueba cada servidor y permiso de forma individual. |
Con una Base URL externa pueden faltar funciones propias de la infraestructura de Anthropic. La documentación actual indica, entre otros límites, que Remote Control no funciona cuando ANTHROPIC_BASE_URL apunta a otro host, que los conectores de claude.ai no se cargan con ANTHROPIC_AUTH_TOKEN y que la búsqueda MCP de herramientas puede quedar desactivada. No prometas paridad completa: prueba el flujo mínimo y cada extensión necesaria.
Para el detalle de campos admitidos, ignorados y no compatibles, consulta la guía separada de DeepSeek con Anthropic SDK.
Coste y facturación
Las solicitudes del modelo encaminadas mediante esta configuración consumen el saldo de DeepSeek API. No consumen una suscripción Claude mientras ANTHROPIC_AUTH_TOKEN sea la credencial activa del flujo. La estimación de coste que muestre una herramienta local no sustituye el consumo registrado por DeepSeek y puede asumir precios de otro proveedor.
V4 Pro para la sesión principal y V4 Flash para tareas ligeras es la distribución que publica DeepSeek. No garantiza un coste fijo: depende del tamaño del contexto, el razonamiento, las respuestas, las búsquedas y las llamadas a herramientas. Revisa las tarifas de DeepSeek API y la tabla oficial antes de presupuestar.
Seguridad, permisos y privacidad
- Prueba primero en un repositorio sin secretos y crea un commit o copia antes de cambios amplios.
- Usa Plan Mode o reglas de permisos para revisar comandos, escrituras y operaciones de red.
- No utilices
--dangerously-skip-permissionsfuera de un entorno aislado y expresamente preparado. - No incluyas la clave en Git, historial compartido, registros, tickets ni capturas.
- Revisa cada diff y comando; el proveedor del modelo no elimina el riesgo de ejecutar herramientas locales.
- No describas el flujo como retención cero, sin entrenamiento o con una residencia regional concreta si tu contrato y configuración no lo garantizan.
La documentación de seguridad de Claude Code explica su arquitectura de permisos, y las condiciones de DeepSeek exigen proteger la API key y aplicar controles técnicos y organizativos. Para reducir la exposición de credenciales a procesos hijo, Anthropic documenta opcionalmente CLAUDE_CODE_SUBPROCESS_ENV_SCRUB=1; pruébalo con los hooks y servidores MCP que realmente necesites.
Solución de problemas
| Problema | Comprobación inicial |
|---|---|
| Claude intenta usar Anthropic | Comprueba Base URL, credencial activa y overrides con /status. |
| 401 | Revisa la clave de DeepSeek y ANTHROPIC_AUTH_TOKEN; no sustituyas la clave por una de otro proveedor. |
| 402 | Comprueba el saldo de DeepSeek API. |
| 400 o 422 | Revisa Base URL, modelo, parámetros y tipos de contenido; no repitas el mismo cuerpo sin corregirlo. |
| 429 | Reduce concurrencia, pon solicitudes en cola y espera. |
| 500 o 503 | Aplica reintentos limitados tras una espera; usa Retry-After si está presente. |
| Modelo inesperado | Una errata puede activar el fallback a V4 Flash; usa IDs exactos y revisa consumo. |
claude: command not found | Abre una terminal nueva, comprueba PATH y ejecuta claude doctor. |
Consulta el estado oficial de DeepSeek y nuestra guía de códigos de error de DeepSeek API. Antes de compartir un registro, elimina claves, prompts sensibles, rutas privadas y datos personales.
Preguntas frecuentes
¿Necesito Claude Pro o Max?
La receta publicada por DeepSeek utiliza una clave y saldo de DeepSeek API, y no presenta una suscripción Claude como requisito del enrutamiento. Anthropic, sin embargo, no ofrece soporte para usar modelos no Claude mediante gateways.
¿Puedo usar deepseek-v4-pro sin [1m]?
Sí. deepseek-v4-pro es el ID real de la API. En Claude Code, la receta utiliza [1m] para declarar la ventana ampliada; en SDK o cURL usa el ID sin sufijo.
¿Puedo usar deepseek-chat o deepseek-reasoner?
No en una configuración actual. El plazo de retirada anunciado ya terminó y la lista oficial vigente solo muestra los dos IDs V4.
¿Anthropic respalda esta integración?
No existe una garantía de compatibilidad total ni un soporte conjunto. DeepSeek publica la receta y su endpoint compatible, mientras Claude Code sigue siendo un producto de Anthropic. Verifica las funciones necesarias con un repositorio de prueba antes de usar código sensible.
¿Todo el procesamiento permanece en mi equipo?
No. Claude Code ejecuta partes del flujo y herramientas localmente, pero envía al endpoint remoto de DeepSeek los mensajes, el código y los resultados incluidos en la solicitud.
Fuentes oficiales verificadas
- DeepSeek: Integrate with Claude Code.
- DeepSeek: Anthropic API compatibility.
- DeepSeek: List Models.
- DeepSeek V4 Preview Release.
- DeepSeek: Error Codes.
- Anthropic: instalación actual de Claude Code.
- Anthropic: model configuration y sufijo
[1m]. - Anthropic: Other LLM gateways.
- Anthropic: seguridad de Claude Code.
- DeepSeek Open Platform Terms of Service.
Guías relacionadas: DeepSeek con Anthropic SDK · DeepSeek API en español · Precios de DeepSeek API · Códigos de error.