DeepSeek V4 Flash y Pro en Codex: configuración y selección de modelo
Configura DeepSeek en Codex con APIMaster. Encuentra config.toml en Windows, macOS y Linux, establece tu clave de API, inicia un chat interactivo y selecciona un modelo.
Configura tu clave de API de APIMaster y el config.toml de Codex, y luego ejecuta codex para chatear con DeepSeek. Usa deepseek-v4-flash, deepseek-v4-pro. Codex se conecta a través de la API de Responses en https://apimaster.ai/v1.
Antes de empezar
Completa la verificación del entorno, instala Codex siguiendo la guía general y obtén una clave de API de APIMaster con acceso a estos modelos y saldo suficiente.
codex --version
1. Abre el directorio de configuración
Windows
Pulsa Win + R, introduce la siguiente ruta y pulsa Enter:
%USERPROFILE%\.codex
Crea la carpeta si no existe. Abre o crea config.toml con un editor de texto. Asegúrate de que el nombre del archivo no sea config.toml.txt.
macOS / Linux
En macOS, en Finder pulsa Command + Shift + G e introduce:
~/.codex
En Linux, abre el mismo directorio con tu gestor de archivos o editor. Si es necesario, créalo desde la terminal:
mkdir -p ~/.codex
Abre o crea config.toml en este directorio. Si usas un directorio de estado personalizado de Codex, usa ese directorio en su lugar.
2. Configura config.toml
Ambas plataformas usan el mismo contenido:
model = "deepseek-v4-flash"
model_provider = "apimaster"
model_reasoning_summary = "none"
model_supports_reasoning_summaries = false
[model_providers.apimaster]
name = "APIMaster"
base_url = "https://apimaster.ai/v1"
env_key = "APIMASTER_API_KEY"
wire_api = "responses"
Si el archivo ya existe, haz una copia de seguridad y combina estas configuraciones. Reemplaza las claves de nivel superior existentes en lugar de duplicarlas, y colócalas antes del primer encabezado [tabla]. Combina la sección del proveedor si ya existe. Esto cambia el proveedor y el modelo predeterminados para las nuevas sesiones de Codex.
La URL base incluye /v1. Mantén wire_api = "responses"; un endpoint de Chat Completions por sí solo es insuficiente para este flujo de trabajo. Las configuraciones de resumen desactivan los resúmenes de razonamiento opcionales, no el pensamiento interno del modelo.
Para conservar tu proveedor predeterminado existente, coloca esta configuración en ~/.codex/deepseek.config.toml en su lugar (Windows: %USERPROFILE%\.codex\deepseek.config.toml). Luego añade --profile deepseek a los comandos de inicio siguientes. Los archivos de perfil con nombre requieren Codex 0.134.0 o posterior y heredan las demás configuraciones base.
3. Establece tu clave de API
Reemplaza YOUR_APIMASTER_API_KEY con la clave de APIMaster. La configuración TOML almacena el nombre de la variable de entorno, no la clave en sí.
Windows PowerShell
Ejecuta en la terminal donde iniciarás Codex:
$env:APIMASTER_API_KEY = 'YOUR_APIMASTER_API_KEY'
Para guardarla también para futuras terminales:
[Environment]::SetEnvironmentVariable('APIMASTER_API_KEY', 'YOUR_APIMASTER_API_KEY', 'User')
Abre una nueva terminal después de guardar una variable persistente, o sigue usando la terminal actual donde ejecutaste el primer comando.
macOS / Linux
export APIMASTER_API_KEY='YOUR_APIMASTER_API_KEY'
Esto se aplica a la terminal actual. Para reutilizarla en nuevas terminales, añade la misma línea de exportación al archivo de inicio de tu shell, como ~/.zshrc para Zsh o ~/.bashrc para Bash interactivo, y luego abre una nueva terminal. Mantén privados los archivos que contengan claves reales y fuera de repositorios compartidos.
4. Inicia Codex y chatea
Abre una terminal en el directorio de tu proyecto y ejecuta:
codex
Después de los mensajes normales de primera ejecución o de confianza del proyecto, verifica que el modelo activo sea deepseek-v4-flash . En la conversación de Codex, introduce:
Reply with exactly OK.
Una respuesta normal confirma la conexión básica. Luego puedes pedirle que explique código, lea un archivo o haga un cambio. Revisa los mensajes habituales de permisos de archivos y comandos.
5. Selecciona otro modelo
Para estos ID de modelos personalizados, elige el modelo explícitamente al iniciar Codex. Ejecuta un comando a la vez en tu terminal:
codex --model deepseek-v4-flash
codex --model deepseek-v4-pro
Cada comando abre una conversación interactiva. Para cambiar desde una sesión abierta, introduce /exit y luego ejecuta el comando para el modelo deseado. Para continuar una conversación guardada existente con otro modelo, usa codex resume SESSION_ID --model MODEL_ID en lugar de iniciar una nueva conversación.
En Codex, /model abre su catálogo de modelos y /status muestra el modelo activo. El menú no lista automáticamente todos los modelos del marketplace de modelos de APIMaster. Si tu modelo de DeepSeek no aparece, usa --model como se indicó. No asumas que la sintaxis /model MODEL_ID de Claude Code funciona en Codex; no es la ruta verificada de selección de modelos personalizados aquí.
Para el perfil con nombre opcional, por ejemplo:
codex --profile deepseek --model deepseek-v4-flash
Para cambiar el valor predeterminado en futuros inicios, edita el valor de nivel superior model en la configuración que uses.
Solución de problemas
| Síntoma | Verificación |
|---|---|
| Falta la clave de API / 401 | Establece APIMASTER_API_KEY en la terminal que inicia Codex; verifica la validez de la clave y el saldo. |
| Sigue usando otro proveedor | Revisa model_provider, el perfil seleccionado, las anulaciones del proyecto y los indicadores de inicio. Reinicia después de editar la configuración. |
| Error de análisis de TOML | Evita claves o tablas duplicadas; las configuraciones de nivel superior deben preceder a los encabezados de tabla. |
| 404 / protocolo no compatible | Usa https://apimaster.ai/v1 y wire_api = "responses". |
| Modelo ausente en /model | Usa el ID completo del modelo con codex --model. El catálogo integrado no es la lista de modelos de la gateway. |
| Advertencia de metadatos del modelo o de lista de modelos | Estos ID pueden carecer de metadatos de Codex. Revisa la respuesta final; los límites de contexto de respaldo no son capacidades verificadas del modelo. |
| Advertencia de flujo de razonamiento/salida | Revisa la respuesta final y los resultados de las herramientas. Reporta la salida interrumpida con el modelo, la versión de la CLI, la hora UTC y el ID de solicitud si está disponible. |
Validación y verificación opcional de herramientas
Pruebas de integración registradas: 2026-09-07 UTC, Codex CLI 0.153.4, Linux. Todos los modelos listados aquí devolvieron el texto esperado y usaron una herramienta para leer un archivo local. Las tareas complejas de programación estuvieron fuera del alcance de esa prueba. Se proporcionan instrucciones de configuración para Windows y macOS, pero esos sistemas operativos no formaron parte de las ejecuciones registradas. Estas comprobaciones no establecen compatibilidad completa de funciones, comportamiento en sesiones largas ni límites máximos de contexto.
Para verificar las herramientas de archivos, crea probe.txt en un proyecto temporal que contenga:
FILE_PROBE_739182
Inicia Codex allí con tu modelo elegido y luego introduce:
Read probe.txt using a tool and reply with its exact contents. Do not guess.
Confirma que se ejecuta una herramienta de lectura de archivos y que la respuesta coincide con el archivo. Usa esto después de que la conversación básica funcione.
FAQ
¿Esto usa mi suscripción de ChatGPT?
Las solicitudes usan tu clave y saldo de APIMaster. Codex es el cliente; DeepSeek es el modelo seleccionado. Esta configuración no convierte a DeepSeek en un modelo de OpenAI.
¿Por qué Claude Code usa una URL diferente?
Codex usa https://apimaster.ai/v1 para Responses. Claude Code usa la raíz del sitio https://apimaster.ai y añade /v1/messages por sí mismo.