Usar DeepSeek en Codex CLI: Guía de configuración de V4 Flash / Pro

Configura DeepSeek V4 Flash y Pro en Codex CLI a través del endpoint Responses de APIMaster. Incluye configuración de clave API, cambio de modelo, pruebas de herramientas y solución de problemas.

¿Puede Codex CLI usar DeepSeek? Nuestras pruebas con Codex CLI 0.153.4 usaron exitosamente deepseek-v4-flash y deepseek-v4-pro a través del endpoint Responses de APIMaster. Configura un proveedor personalizado con la URL base https://apimaster.ai/v1 y wire_api = "responses". Solo Chat Completions compatible con OpenAI no es suficiente para esta configuración.

Última prueba: 2026-09-07, Codex CLI 0.153.4, Linux. Ambos modelos devolvieron el texto esperado, invocaron una herramienta de shell para leer un archivo de prueba local y respondieron con su contenido. Todas las ejecuciones terminaron con código 0. Se produjeron advertencias de metadatos y eventos de transmisión; consulta la sección de solución de problemas. Se proporcionan comandos para Windows / macOS para la configuración, pero esta prueba se ejecutó en Linux. No se probaron sesiones largas, entrada de imágenes ni flujos de trabajo de codificación complejos.

1. Prepara Codex y tu clave API

Instala Codex siguiendo la guía de entorno y la guía de configuración de Codex, luego verifica:

codex --version

Crea una clave API de APIMaster con acceso al modelo DeepSeek seleccionado y cuota suficiente. Para este tutorial, usa la configuración dedicada a continuación; no necesitas reemplazar un auth.json existente ni cerrar sesión en otra cuenta.

2. Establece la clave en tu terminal

macOS / Linux:

export APIMASTER_API_KEY='YOUR_APIMASTER_API_KEY'

Windows PowerShell:

$env:APIMASTER_API_KEY = 'YOUR_APIMASTER_API_KEY'

La variable existe solo en esta sesión de terminal. La configuración almacena el nombre de la variable, no el secreto en sí.

3. Crea una configuración de proveedor separada

En un directorio que uses para este tutorial, crea deepseek.toml con este contenido. Mantén tu configuración existente de Codex sin cambios.

model = "deepseek-v4-flash"
model_provider = "apimaster_deepseek"

[model_providers.apimaster_deepseek]
name = "APIMaster DeepSeek"
base_url = "https://apimaster.ai/v1"
env_key = "APIMASTER_API_KEY"
wire_api = "responses"

Para una primera prueba copiable y aislada, pasa la misma configuración como anulaciones de línea de comandos. --ignore-user-config evita que otro proveedor en tu configuración normal tenga prioridad. --ephemeral evita guardar esta sesión de prueba.

codex exec --ignore-user-config --ephemeral --skip-git-repo-check --sandbox read-only --model deepseek-v4-flash -c 'model_provider="apimaster_deepseek"' -c 'model_providers.apimaster_deepseek.name="APIMaster DeepSeek"' -c 'model_providers.apimaster_deepseek.base_url="https://apimaster.ai/v1"' -c 'model_providers.apimaster_deepseek.env_key="APIMASTER_API_KEY"' -c 'model_providers.apimaster_deepseek.wire_api="responses"' "Reply with exactly: DEEPSEEK_TEST_OK"

Ejecuta el comando desde la terminal donde estableciste la clave. Respuesta final esperada: DEEPSEEK_TEST_OK. En versiones anteriores de Windows PowerShell, el entrecomillado de argumentos nativos puede diferir; usa PowerShell 7 o el método de perfil a continuación si los argumentos TOML son rechazados.

4. Guarda la configuración como un perfil reutilizable

Para la versión de CLI probada, coloca deepseek.toml en ~/.codex/deepseek.config.toml (Windows: %USERPROFILE%\.codex\deepseek.config.toml). Si CODEX_HOME está personalizado, usa ese directorio en su lugar. Este perfil con nombre mantiene la configuración de DeepSeek separada de tu config.toml normal.

macOS / Linux, desde el directorio que contiene deepseek.toml:

mkdir -p ~/.codex
cp deepseek.toml ~/.codex/deepseek.config.toml
codex --profile deepseek --model deepseek-v4-flash

Windows PowerShell:

New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex" | Out-Null
Copy-Item .\deepseek.toml "$env:USERPROFILE\.codex\deepseek.config.toml"
codex --profile deepseek --model deepseek-v4-flash

Haz una copia de seguridad de un archivo de perfil primero si ese nombre de archivo ya existe. La sintaxis de perfil depende de la versión: estos comandos están dirigidos a 0.153.4. Consulta codex --help en tu versión instalada; las versiones anteriores pueden usar perfiles dentro de config.toml en su lugar.

Para usar Pro:

codex --profile deepseek --model deepseek-v4-pro

Un perfil se superpone a tu configuración normal, por lo que los servidores MCP existentes u otras configuraciones pueden seguir aplicándose. El comando aislado del paso 3 es útil al diagnosticar conflictos de configuración.

5. Verifica una llamada de herramienta

Crea un archivo local llamado probe.txt que contenga:

TOOL_PROBE_739182

Desde el mismo directorio, ejecuta:

codex exec --profile deepseek --skip-git-repo-check --sandbox read-only --model deepseek-v4-flash "Use your file reading or shell tool to read probe.txt in the current directory. Reply with only the exact content. Do not guess."

Esperado: un comando de lectura de archivo se ejecuta correctamente, seguido de TOOL_PROBE_739182. Repite con --model deepseek-v4-pro. Esto verifica un viaje de ida y vuelta de solicitud / resultado de herramienta, más allá de una respuesta de texto simple. Mantén los avisos de permisos normales habilitados para el trabajo de proyecto real.

Solución de problemas

Síntoma	Explicación o siguiente paso
`Model metadata ... not found`	La CLI probada no tenía metadatos integrados para estos ID de modelo y usó metadatos de respaldo. Nuestras pruebas de texto y herramientas se completaron, pero los límites de contexto y otros valores predeterminados no deben tratarse como capacidades de modelo verificadas.
Error de análisis de lista de modelos	La lista de modelos de la puerta de enlace puede diferir del catálogo de metadatos de Codex. Especifica el modelo explícitamente y verifica si la solicitud real finaliza.
`OutputTextDelta without active item`	Visto en nuestra prueba de transmisión. La respuesta final y el viaje de ida y vuelta de la herramienta aún se completaron. Si la salida falta o se interrumpe, conserva la versión de CLI, la marca de tiempo y el error para soporte.
401 o la solicitud va a otro proveedor	Verifica `APIMASTER_API_KEY`, la selección de proveedor y la configuración heredada. Reintenta el comando aislado del paso 3.
404 o protocolo no compatible	La URL base termina en `/v1`, no en `/chat/completions`; establece `wire_api = "responses"`.
Opción de línea de comandos desconocida	Verifica la versión de CLI instalada. Las opciones documentadas se probaron con 0.153.4.

Preguntas frecuentes

¿Significa esto que cada endpoint de DeepSeek funciona en Codex?

No. Estos resultados se aplican a la configuración de la puerta de enlace de APIMaster. Un proveedor debe admitir el protocolo y el comportamiento de herramientas que Codex espera; aceptar /chat/completions no establece compatibilidad con Responses.

¿Necesito una suscripción a ChatGPT para esta configuración?

Este proveedor personalizado usa tu clave API de APIMaster y la cuota de tu cuenta. No usa la cuota de suscripción de ChatGPT. Consulta el marketplace de modelos para conocer las tarifas de API actuales.

¿Puedo reclamar compatibilidad total con Codex a partir de estas pruebas?

El alcance verificado es salida de texto corta y un viaje de ida y vuelta de herramienta de lectura de archivos local. Las advertencias anteriores siguen siendo relevantes; el comportamiento de contexto largo, cada herramienta y cada versión futura de CLI no están cubiertos.