Usa DeepSeek en Claude Code: configuración de la API de Anthropic
Apunta Claude Code al endpoint de DeepSeek compatible con Anthropic — un solo bloque de variables de entorno mapea Opus, Sonnet y Haiku a deepseek-v4-pro o flash, y cada petición se cobra a precios de la API de DeepSeek.
La versión corta
- DeepSeek expone un endpoint compatible con Anthropic, así que Claude Code le habla directo — sin herramienta de proxy.
- Todo el cambio es un bloque de entorno: ANTHROPIC_BASE_URL más ANTHROPIC_AUTH_TOKEN y los mapeos por modelo.
- Mapea los modelos alias con intención: los slots de Opus y Sonnet a deepseek-v4-pro, los de Haiku y subagentes a deepseek-v4-flash.
- La facturación pasa a la API de pago por uso de DeepSeek — la sesión de demo del video construyó y probó una app completa por centavos, con el gasto a la vista en el tablero de la plataforma.
DeepSeek v4 Pro on Claude Code - Full Setup Tutorial
Canal: Prince does AI8:08
Use Claude Code with ANY AI Model GPT, Gemini, DeepSeek
Canal: AyyazTech17:00
Anthropic-compatible API — official DeepSeek documentation
Documentación: api-docs.deepseek.com
Las capturas vienen del walkthrough de configuración de Prince does AI — una grabación de pantalla completa y limpia. La comparación del router sigue el tour de cualquier modelo de AyyazTech, y los datos del endpoint vienen de la documentación de la API de DeepSeek.
Los fotogramas pertenecen a sus respectivos creadores y se acreditan aquí con enlaces directos a los momentos exactos; el texto es nuestro.
De npm install a una app funcionando en DeepSeek
Parte 1 · Instala y configura
- 1
Instala Claude Code y verifica
Instala el CLI con npm y corre claude --version — el walkthrough muestra un 2.1.89 impreso. El único prerrequisito es Node.js, y la misma instalación sirve en macOS, Linux y Windows.
El chequeo de versión confirmando Claude Code 2.1.89 instalado.Ver en 0:46 - 2
Consigue una llave de API de DeepSeek
Inicia sesión en platform.deepseek.com, recarga un monto pequeño desde la página Billing, abre API keys en la barra lateral y crea una llave nueva. Cópiala de inmediato — la plataforma solo la muestra una vez.
La consola de la plataforma DeepSeek con API keys en la barra lateral.Ver en 0:49 - 3
Pon el bloque de variables de entorno
En PowerShell, pon ANTHROPIC_BASE_URL al endpoint Anthropic de DeepSeek y ANTHROPIC_AUTH_TOKEN a tu llave, luego mapea los slots de modelos: ANTHROPIC_MODEL y los valores por defecto de OPUS y SONNET a deepseek-v4-pro, el de HAIKU y CLAUDE_CODE_SUBAGENT_MODEL a deepseek-v4-flash. Pega el bloque de una pieza y presiona enter.
El bloque de entorno: endpoint, token y mapeos de modelos.Ver en 1:35
Parte 2 · Arranca sobre DeepSeek
- 4
Arranca Claude Code
Escribe claude en la misma ventana de PowerShell y acepta el aviso de confianza de la carpeta. Las variables puestas con el prefijo env viven solo en esa ventana — relanzar después significa pegar el bloque otra vez, salvo que lo persistas en tu perfil.
Arrancando Claude Code desde la ventana de PowerShell configurada.Ver en 2:05 - 5
Confirma el badge de facturación por API
La pantalla de bienvenida muestra un badge de API Usage Billing en lugar del nombre de un plan — esa es la señal de que el endpoint de DeepSeek está vivo. La fila del modelo puede decir Opus con 1M de contexto: es el nombre mapeado; quien responde es deepseek-v4-pro.
La pantalla de bienvenida mostrando Opus 4.6 con API Usage Billing.Ver en 2:25 - 6
Corre tu primer prompt
El walkthrough arranca con los permisos saltados para una demo sin interrupciones; sin ese flag, Claude Code pregunta antes de cada edición como siempre. Empieza con una pregunta de razonamiento para probar la tubería.
Arranque con permisos saltados para la sesión de demo.Ver en 2:50 - 7
Hazle la prueba de fuego a las respuestas
La demo plantea una pequeña pregunta de lógica — ¿camino o manejo hasta el lavado de autos? — y recibe la respuesta correcta con su razonamiento. Diez segundos aquí ahorran diez minutos de depuración después.
La prueba del lavado de autos respondida bien vía DeepSeek.Ver en 3:18
Parte 3 · Que demuestre lo que vale
- 8
Dale un build de verdad
Pide algo sustancial — la demo pide una app Electron impresionante y deja que el modelo planee primero. El flujo de planear y luego construir funciona idéntico en DeepSeek: aprueba el plan y mira cómo se van tachando los pasos.
El modelo planeando ClipMaster, un gestor de portapapeles.Ver en 4:22 - 9
Deja que termine y abre la app
Claude Code arma el esqueleto, escribe el código y lanza el resultado — el ClipMaster de la demo monitorea el portapapeles, guarda historial y registra atajos globales. Todo lo que esperas de un ciclo planear-aprobar-construir.
La app ClipMaster terminada con su lista de funciones.Ver en 5:25 - 10
Prueba el resultado como usuario
Copia unas cuantas cosas en cualquier parte de tu sistema y mira cómo aparecen en el historial de la app generada. Probar gana a confiar — la demo copia desde un segundo monitor para probar que la captura es real.
Los elementos copiados aterrizando en el historial en vivo de ClipMaster.Ver en 5:55 - 11
Revisa cuánto costó
De vuelta en la plataforma de DeepSeek, la página Usage muestra peticiones, tokens y gasto de la sesión. El titular del creador: cerca de dos millones de tokens por ocho centavos. Tus números caen en el mismo tablero casi en tiempo real.
El tablero de uso tras la sesión completa de construcción y pruebas.Ver en 7:00
¿Endpoint directo o claude-code-router?
Hay dos caminos para correr Claude Code sobre DeepSeek. Esta guía usa el endpoint directo compatible con Anthropic; la herramienta router es el otro camino.
- 1Endpoint directo, esta guía: cero herramientas extra — solo variables de entorno, y Claude Code habla directo con api.deepseek.com.
- 2claude-code-router: un proxy local que agrega cambio de modelo a mitad de sesión y enrutado multi-proveedor, al costo de instalar y configurar otro servicio.
- 3Elige directo cuando DeepSeek es tu caballito de todos los días; elige el router cuando malabareas varios proveedores o cambias de modelo según la tarea.
- 4En ambos casos la experiencia de Claude Code es la misma — planes, herramientas y permisos se comportan igual; solo cambian la facturación y el modelo detrás del alias.
Nuestro tutorial del Claude Code router recorre la vía del proxy paso a paso, incluida su propia configuración de DeepSeek.
Cuando la configuración se porta mal
Casi todo fallo aquí es una variable de entorno o una ventana vieja. Repasa esta lista antes de tocar cualquier otra cosa.
- 1Te sigue cobrando tu plan de Claude: la pantalla de bienvenida muestra un nombre de plan en vez de API Usage Billing — el bloque de env se puso en otra ventana de terminal. Vuelve a correrlo donde lanzas claude.
- 2Errores de autenticación: pegaron el token con comillas o espacios, o la llave no tiene saldo. Crea una llave nueva, recarga y vuelve a poner ANTHROPIC_AUTH_TOKEN.
- 3Errores del modelo que mencionan tool use: las versiones viejas de DeepSeek llevaban mal algunas llamadas a herramientas — deja deepseek-v4-pro en los slots principales y flash para subagentes, como en el paso 3.
- 4Parece que responde otro modelo: recuerda el alias. La UI dice Opus o Sonnet mientras tus mapeos deciden el modelo real — revisa ANTHROPIC_MODEL primero, no la etiqueta.
- 5La configuración se pierde entre sesiones: las variables de PowerShell expiran con la ventana. Persiste el bloque en tu perfil de shell, o envuélvelo en un script chiquito que corras antes de programar.
Para volver a la facturación de Anthropic, limpia las variables — remove-env ANTHROPIC_BASE_URL y sus compinches en la misma ventana — y reinicia Claude Code.