Usar DeepSeek en Claude Code: Guía de configuración de V4 Flash / Pro

Ejecuta DeepSeek V4 Flash y Pro en Claude Code a través de APIMaster. Configura la puerta de enlace y la clave API, cambia de modelo, verifica las herramientas de lectura de archivos y corrige errores de configuración.

¿Puede Claude Code usar DeepSeek? Nuestras pruebas con Claude Code 2.1.239 usaron exitosamente deepseek-v4-flash y deepseek-v4-pro a través del endpoint de Messages de APIMaster. Establece ANTHROPIC_BASE_URL a https://apimaster.ai, proporciona una clave de APIMaster y selecciona el modelo explícitamente. Esta configuración ejecuta DeepSeek, aunque el cliente se llame Claude Code.

Última prueba: 2026-09-07, Claude Code 2.1.239, Linux. Ambos modelos devolvieron el texto esperado y completaron un ciclo de ida y vuelta con la herramienta de lectura de archivos. Todas las ejecuciones terminaron con código 0. La CLI imprimió unrecognized_model, pero las solicitudes probadas tuvieron éxito. Estas comprobaciones no establecen soporte para cada característica de Claude Code, sesiones largas o versiones futuras. Se incluyen comandos de configuración para Windows / macOS; la prueba registrada se ejecutó en Linux.

1. Preparar la CLI y la clave API

Sigue la guía de entorno y la guía de configuración de Claude Code para la instalación. Verifica tu versión:

claude --version

Obtén una clave API de APIMaster con acceso al modelo DeepSeek seleccionado y cuota suficiente. Usa la configuración de sesión a continuación para este tutorial; no es necesario sobrescribir tu settings.json normal.

2. Configurar la puerta de enlace y la clave

Abre una nueva terminal para mantener estos ajustes separados de tu sesión CLI habitual.

macOS / Linux:

export ANTHROPIC_BASE_URL='https://apimaster.ai'
export ANTHROPIC_API_KEY='YOUR_APIMASTER_API_KEY'
unset ANTHROPIC_AUTH_TOKEN

Windows PowerShell:

$env:ANTHROPIC_BASE_URL = 'https://apimaster.ai'
$env:ANTHROPIC_API_KEY = 'YOUR_APIMASTER_API_KEY'
Remove-Item Env:ANTHROPIC_AUTH_TOKEN -ErrorAction SilentlyContinue

Usa el origen del sitio aquí, sin /v1: Claude Code añade /v1/messages. La clave API debe provenir de APIMaster. Estos comandos afectan a esta terminal y sus procesos hijos, no a tus archivos de inicio de sesión guardados. No pongas una clave real en un archivo de configuración compartido o en un repositorio.

3. Enviar una solicitud de prueba mínima

claude --bare --setting-sources "" --no-session-persistence --model deepseek-v4-flash --tools "" --output-format json -p "Reply with exactly: DEEPSEEK_TEST_OK"

Esperado: is_error es false, result es DEEPSEEK_TEST_OK, y el proceso termina con código 0. Cambia --model a deepseek-v4-pro y ejecuta de nuevo.

El modo --bare de la versión probada usa autenticación explícita con clave API y omite las integraciones de fondo normales. --setting-sources "" excluye las fuentes de configuración guardadas, mientras que --tools "" desactiva las herramientas para esta prueba de texto única. Estos son ajustes de diagnóstico deliberados, no requisitos para desactivar herramientas durante el uso normal. Las versiones anteriores de la CLI pueden no aceptar todas estas opciones.

4. Verificar las herramientas de lectura de archivos

Crea probe.txt en el directorio actual con este contenido:

TOOL_PROBE_739182

Ejecuta:

claude --bare --setting-sources "" --no-session-persistence --model deepseek-v4-flash --tools Read --allowedTools Read --output-format json -p "Use the Read tool to read probe.txt in the current directory. Reply with only the exact content. Do not guess."

Esperado: la CLI lee el archivo y devuelve TOOL_PROBE_739182. Repite con deepseek-v4-pro. Esto comprueba que el modelo puede solicitar una herramienta, recibir su resultado y luego responder. Solo la herramienta Read está habilitada para esta prueba.

Para trabajo interactivo normal con la misma configuración de terminal:

claude --bare --setting-sources "" --model deepseek-v4-flash

Para comenzar con Pro:

claude --bare --setting-sources "" --model deepseek-v4-pro

Los comandos interactivos omiten --tools "", por lo que las herramientas predeterminadas están disponibles. Revisa los avisos de permisos como de costumbre. --bare omite conveniencias como hooks e instrucciones automáticas del proyecto; habilita tu configuración normal deliberadamente después de que la configuración mínima funcione, y verifica que no anulen la puerta de enlace o el modelo. Cierra esta terminal al terminar para dejar atrás el entorno de esta sesión.

Solución de problemas

Síntoma	Qué verificar
`unrecognized_model`	Observado para ambos IDs de DeepSeek en 2.1.239. No impidió que nuestras solicitudes se completaran. Verifica el resultado final en lugar de tratar la advertencia sola como un fallo.
401 o un aviso de inicio de sesión inesperado	Confirma que `ANTHROPIC_API_KEY` está configurada, elimina un `ANTHROPIC_AUTH_TOKEN` conflictivo en esta terminal y reintenta el modo bare.
404	`ANTHROPIC_BASE_URL` debe ser `https://apimaster.ai`, no el endpoint completo `/v1/messages` ni una base que termine en `/v1`.
Opción `--bare` desconocida	Verifica tu versión contra la probada 2.1.239. Usa la guía de instalación general para actualizar si es apropiado.
No se puede leer `probe.txt`	Ejecuta desde el directorio del archivo. Para la prueba de herramienta, habilita Read en lugar de usar `--tools ""`.
Se selecciona un modelo diferente	Pasa el ID de modelo completo con `--model` y verifica la configuración guardada o las anulaciones de alias de modelo antes de habilitarlas.
Límite de velocidad, cuota insuficiente o error de upstream	Lee el cuerpo del error, verifica la cuota y los permisos del modelo, y registra la marca de tiempo para soporte.

Preguntas frecuentes

¿Es esto lo mismo que usar un modelo Claude?

No. Claude Code es el cliente aquí; el modelo seleccionado es DeepSeek. Las características que dependen de un modelo Claude particular no están cubiertas automáticamente por esta configuración.

¿Por qué la URL base es diferente del ejemplo del SDK de Python?

El SDK de OpenAI para Python usa https://apimaster.ai/v1 y añade /chat/completions. Claude Code usa https://apimaster.ai y añade /v1/messages. Usa el formato base documentado de cada cliente.

¿Puedo usar una clave oficial de DeepSeek con esta puerta de enlace?

Este tutorial requiere una clave emitida por APIMaster. Las claves son específicas del proveedor que las emite; cambiar solo el endpoint no transfiere credenciales ni cuota.

¿Se probó el uso real de herramientas, o solo una respuesta de texto?

Ambos se probaron para ambos modelos. La prueba de herramienta leyó un archivo local y devolvió su contenido. No establece que todas las herramientas, agentes en segundo plano o tareas de codificación largas sean compatibles.