DeepSeek V4 Flash y Pro en Claude Code: configuración y cambio de modelo

Configura DeepSeek en Claude Code usando APIMaster. Configura settings.json en Windows, macOS y Linux, ejecuta claude, selecciona un modelo con /model y comienza a chatear.

Configura APIMaster en settings.json, ejecuta claude y luego escribe /model MODEL_ID en la conversación para usar DeepSeek. Los IDs disponibles que se cubren aquí son deepseek-v4-flash y deepseek-v4-pro. Claude Code es el cliente; DeepSeek es el modelo que responde.

Antes de empezar

Completa la verificación del entorno y la configuración de Claude Code. Obtén una clave API de APIMaster con saldo suficiente y acceso a los modelos seleccionados.

claude --version

La URL base del gateway es https://apimaster.ai, sin /v1. Claude Code añade /v1/messages por sí mismo.

1. Abre el directorio de configuración

Windows

Presiona Win + R, introduce la siguiente ruta y presiona Enter:

%USERPROFILE%\.claude

Crea la carpeta si es necesario. Abre o crea settings.json. Asegúrate de que no se llame settings.json.txt.

macOS / Linux

En macOS, en Finder presiona Command + Shift + G e introduce:

~/.claude

En Linux, abre el mismo directorio con tu gestor de archivos o editor. Créalo si es necesario:

mkdir -p ~/.claude

Abre o crea settings.json allí. Si configuraste un directorio de configuración personalizado para Claude Code, usa ese directorio en su lugar.

2. Edita settings.json

Windows, macOS y Linux usan la misma configuración. Reemplaza YOUR_APIMASTER_API_KEY con tu clave de APIMaster:

{
  "model": "deepseek-v4-flash",
  "env": {
    "ANTHROPIC_BASE_URL": "https://apimaster.ai",
    "ANTHROPIC_API_KEY": "YOUR_APIMASTER_API_KEY",
    "ANTHROPIC_AUTH_TOKEN": "",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

Si el archivo ya existe, haz una copia de seguridad y fusiona estos campos en el objeto JSON existente y en el objeto env. Conserva otras configuraciones que necesites. No añadas un segundo objeto JSON ni dupliques la clave env. JSON no admite comentarios ni comas finales.

La guía general de Claude Code muestra la autenticación por token. Esta guía usa la autenticación por clave API que se ejercita en nuestras pruebas de integración. Mantén ANTHROPIC_AUTH_TOKEN vacío cuando uses ANTHROPIC_API_KEY, y elimina credenciales en conflicto de otras configuraciones o de tu terminal. Usa una clave de APIMaster para este gateway.

El campo model establece el modelo inicial. Puedes seleccionar otro después del lanzamiento. Mantén este archivo de configuración de usuario en privado; no confirmes claves reales en un repositorio compartido. Guarda el archivo y reinicia Claude Code para cargar la nueva configuración.

3. Inicia Claude Code

En una terminal abierta en el directorio de tu proyecto, ejecuta:

claude

Completa cualquier indicación normal de primera ejecución y revisa la solicitud de confianza del proyecto. El modelo inicial debería ser deepseek-v4-flash. Esta es una sesión interactiva normal con las herramientas y configuraciones de proyecto habituales.

4. Selecciona un modelo y comienza a chatear

En la conversación de Claude Code, escribe uno de los siguientes comandos y presiona Enter:

/model deepseek-v4-flash
/model deepseek-v4-pro

Ejecuta una línea a la vez, eligiendo el modelo que desees. Después de que Claude Code confirme el cambio, envía un mensaje corto:

Reply with exactly OK.

Una respuesta de texto normal confirma la conexión básica. Luego puedes continuar chateando o pedirle que trabaje en tu proyecto. Para cambiar de nuevo en la misma conversación, escribe otro comando /model MODEL_ID.

Escribir /model solo abre el selector de modelos. Los IDs de gateway personalizados pueden no aparecer en su lista predeterminada. Escribe el ID completo como se muestra arriba en su lugar. El comando de barra pertenece dentro de Claude Code, no en PowerShell ni Bash. Los nombres de los modelos describen modelos de DeepSeek, no Claude Sonnet ni Opus.

También puedes elegir un modelo al iniciar desde la terminal. Ejecuta un comando a la vez:

claude --model deepseek-v4-flash
claude --model deepseek-v4-pro

Para establecer el valor predeterminado de las sesiones futuras de forma explícita, edita model en settings.json. Un indicador de lanzamiento, la variable de entorno ANTHROPIC_MODEL, o una configuración de proyecto o administrada pueden afectar el modelo seleccionado; revisa estos elementos si el modelo inicial difiere de tu valor guardado.

Solución de problemas

Síntoma	Verificación
401 / solicitud de inicio de sesión inesperada	Verifica la clave de APIMaster, la URL base y las variables de autenticación en conflicto; reinicia la CLI después de editar la configuración.
404	Usa `https://apimaster.ai`, sin `/v1` ni `/v1/messages`.
La configuración no surte efecto	Verifica la ubicación del archivo, un JSON válido y las anulaciones de configuraciones de la terminal, del proyecto o administradas.
El modelo no aparece en el selector	Escribe `/model MODEL_ID` con el ID exacto, o inicia con `claude --model MODEL_ID`.
Modelo no disponible / 403	Verifica la ortografía, los modelos permitidos de la clave, el saldo de la cuenta y la disponibilidad actual de la ruta.
`unrecognized_model`	Observado con IDs personalizados en nuestras pruebas. Revisa la respuesta real y el resultado de la herramienta; los valores predeterminados de capacidad integrada de Claude no están verificados para DeepSeek.
Permiso denegado para archivo o comando	Revisa y aprueba la operación prevista a través de las solicitudes de permiso habituales.
429 / 5xx / respuesta interrumpida	Conserva el error, el ID del modelo, la versión de la CLI, la hora UTC y el ID de solicitud si están disponibles para soporte.

Validación y diagnósticos opcionales

Pruebas de integración registradas: 2026-09-07 UTC, Claude Code 2.1.239, Linux. Todos los modelos listados aquí devolvieron el texto esperado y leyeron un archivo local a través de una herramienta. Las tareas complejas de codificación estuvieron fuera del alcance de esa prueba. Windows y macOS no formaron parte de esas ejecuciones registradas.

Las comprobaciones automatizadas anteriores usaron el modo bare para aislar la configuración. El uso diario normal sigue los pasos de settings.json y los pasos interactivos anteriores. El modo bare y --setting-sources "" omiten las integraciones normales o las configuraciones guardadas, por lo que no deben añadirse al comando de inicio cotidiano de esta guía.

Para una comprobación rápida no interactiva usando tu configuración guardada:

claude --model deepseek-v4-flash -p "Reply with exactly OK."

Para una comprobación de herramienta, crea probe.txt que contenga FILE_PROBE_739182, inicia Claude Code en ese directorio y pídele que lea el archivo usando una herramienta y devuelva su contenido exacto. Confirma que la herramienta realmente se ejecuta.

Estas son comprobaciones de integración acotadas, no una garantía de todas las funciones de Claude Code, del comportamiento en sesiones largas ni del contexto máximo. La documentación del gateway de Anthropic no admite oficialmente el enrutamiento de Claude Code a modelos que no sean de Claude; esta guía describe la integración de APIMaster.

Preguntas frecuentes

¿Mi suscripción de Claude paga estas solicitudes?

No. Con esta configuración de APIMaster, las solicitudes usan tu clave y saldo de APIMaster.

¿Puedo seguir chateando después de cambiar de modelo?

Sí, usa el comando de cambio de modelo en la conversación abierta y espera la confirmación antes de enviar el siguiente mensaje. Para una comparación limpia entre modelos, inicia una sesión separada con claude --model MODEL_ID.