Versiones aplicables: CC Switch 3.16.0 y superiores. Este artículo está organizado en base a la documentación y el código del repositorio, utilizando DeepSeek como ejemplo de una interfaz compatible con OpenAI Chat Completions. Las capturas de pantalla provienen de la interfaz frontal actual, generadas con datos de ejemplo desensibilizados para evitar filtrar claves API reales o saldos de cuentas.
Por qué es necesario el enrutamiento local
La nueva versión de Codex CLI está orientada a la API Responses de OpenAI, mientras que muchos proveedores como DeepSeek, Kimi, MiniMax y SiliconFlow exponen el formato OpenAI Chat Completions, que es /chat/completions. Los cuerpos de las solicitudes, los eventos de streaming y las estructuras de retorno de estos dos protocolos son diferentes. Rellenar directamente una interfaz Chat en la configuración de Codex a menudo provoca listas de modelos incorrectas, errores 404/400 o respuestas de streaming que Codex no puede analizar correctamente.
El enfoque de CC Switch es que Codex siempre se conecte a una ruta local, enviando las solicitudes a través de la API Responses; la ruta identifica internamente si el proveedor actual está en formato Chat, reescribe la solicitud en Chat Completions para enviarla al upstream y, finalmente, convierte la respuesta Chat de vuelta al formato Responses para devolverla a Codex.
Esta cadena se divide principalmente en cuatro pasos:
- Cuando Codex toma el control, la configuración local se escribe como
http://127.0.0.1:15721/v1y se fuerzawire_api = "responses". - El
meta.apiFormat = "openai_chat"del proveedor le indica a la ruta: el upstream real es Chat Completions. - La ruta reescribe
/responseso/v1/responsesa/chat/completionsy convierte el cuerpo de la solicitud Responses en un cuerpo de solicitud Chat. - Después de que el upstream devuelve la respuesta, la ruta convierte el JSON o SSE de Chat en JSON/SSE de Responses que Codex pueda entender.
Preparación
Necesitas preparar tres cosas primero:
- CC Switch instalado y listo para iniciar.
- Codex CLI instalado y ejecutado al menos una vez para que exista la estructura de directorio
~/.codex/config.toml. - Una clave API de DeepSeek o de un proveedor similar de Chat Completions.
La documentación oficial de DeepSeek actualmente indica que la URL base compatible con OpenAI es https://api.deepseek.com (otros proveedores suelen usar una URL base con el sufijo /v1), y la ruta de la API Chat es /chat/completions; el preset de DeepSeek en CC Switch ya está configurado con esta información, por lo que te recomendamos usar el preset en lugar de ensamblar manualmente las rutas de la interfaz.
Paso 1: Agregar proveedor de Codex
Abre CC Switch, cambia a la pestaña Codex en la parte superior y haz clic en el signo más en la esquina superior derecha para agregar un proveedor.
Selecciona DeepSeek de los presets integrados; solo necesitas hacer dos cosas:
- Ingresar la clave API de DeepSeek.
- Guardar el proveedor.
El preset ya incluye la dirección de solicitud de DeepSeek, el modelo predeterminado, el menú de modelos y los parámetros de pensamiento/razonamiento, y activará automáticamente "Requiere mapeo de enrutamiento local". Puedes ajustar el modelo predeterminado o el nombre mostrado del modelo según sea necesario; la conversión del protocolo la maneja la capa de enrutamiento.
Paso 2: Habilitar el enrutamiento local y tomar el control de Codex
Ve a la página de Enrutamiento en Configuración, expande Enrutamiento local y completa dos activaciones:
- Activa el Interruptor principal de enrutamiento para iniciar el servicio local. La dirección predeterminada es
127.0.0.1:15721. - Activa Codex en Habilitación de enrutamiento. Si solo quieres que Codex pase por la ruta, puedes mantener apagados Claude y Gemini.
Después de tomar el control, CC Switch apuntará la configuración en vivo de Codex a la ruta local y gestionará la autenticación con marcadores de posición. La clave real de DeepSeek sigue guardada en la configuración del proveedor de CC Switch y es inyectada por la ruta local durante el reenvío, por lo que no necesitas exponer la clave en la configuración en vivo de Codex.
Paso 3: Cambiar de proveedor y reiniciar Codex
Vuelve a la lista de proveedores de Codex y haz clic en Habilitar para el proveedor de DeepSeek. Si ves una etiqueta "Requiere ruta", significa que este proveedor debe usarse mientras la ruta esté en ejecución; si la ruta no está iniciada, CC Switch mostrará un aviso que dice "Se requiere el servicio de enrutamiento para el uso normal".
Después de cambiar, se recomienda reiniciar la sesión de terminal actual de Codex porque:
- Es posible que el proceso de Codex ya haya leído el
config.tomlantiguo. - Después de que se genere
modelcatalogjson, el menú/modelgeneralmente requiere un nuevo proceso para actualizarse.
Una vez en Codex, puedes usar /model para verificar si el modelo actual proviene del preset de DeepSeek, por ejemplo, DeepSeek V4 Flash. Actualmente, la aplicación Codex no admite la selección múltiple de modelos personalizados y usará por defecto el primer modelo en la configuración.
Cómo manejar otros proveedores de Chat
Los proveedores comunes de formato Chat como DeepSeek, Kimi, MiniMax y SiliconFlow ya tienen presets en CC Switch; úsalos prioritariamente. Solo para proveedores que no estén en los presets necesitas elegir una configuración personalizada; en ese caso, completa la clave API, la URL base y el modelo según su documentación, y establece el Formato de API en OpenAI Chat Completions (requiere enrutamiento).
Si el upstream admite directamente la API Responses de OpenAI, no necesitas activar "Requiere mapeo de enrutamiento local"; en ese caso, CC Switch puede conectarse directamente a través de Responses sin conversión Chat.
Preguntas frecuentes
Codex reporta 404 o no encuentra /responses
Generalmente, esto se debe a que no se ha habilitado la toma de control de Codex, o has escrito manualmente la URL base Chat del upstream directamente en Codex. Verifica si ~/.codex/config.toml apunta a http://127.0.0.1:15721/v1.
El upstream de DeepSeek reporta 404
Si usas el preset integrado de DeepSeek, primero confirma que el proveedor actual sea efectivamente del preset y que el enrutamiento de Codex esté habilitado. Solo cuando uses un proveedor personalizado necesitas verificar la URL base: debe ser la dirección raíz del servicio, no la ruta completa de la interfaz con /chat/completions.
/model no muestra los modelos de DeepSeek
Reinicia Codex después de guardar el proveedor. CC Switch genera cc-switch-model-catalog.json y escribe la ruta en modelcatalogjson, pero un proceso de Codex en ejecución puede no recargar el directorio de modelos en caliente.
Actualmente, la aplicación Codex no admite selección múltiple de modelos y usa por defecto el primer modelo.
La ruta está activa pero las solicitudes siguen yendo al proveedor equivocado
Confirma que tres estados sean coherentes: el proveedor actual en la pestaña Codex es DeepSeek; el servicio de enrutamiento local está en ejecución; y el interruptor de Codex en Habilitación de enrutamiento está activado.
¿Puedo usar la cuenta oficial de OpenAI Codex a través del enrutamiento local?
No se recomienda. CC Switch evita cambiar a proveedores oficiales en modo de toma de control con enrutamiento local porque usar un proxy para acceder a la API oficial puede conllevar riesgos para la cuenta. El enrutamiento está pensado principalmente para escenarios de terceros, agregación o conversión de protocolos.
Enlaces de referencia
- Manual de usuario de CC Switch: Agregar proveedores
- Manual de usuario de CC Switch: Servicio proxy
- Manual de usuario de CC Switch: Enrutamiento de aplicaciones
- Documentación de API de DeepSeek: Tu primera llamada API
- Documentación de API de DeepSeek: Crear chat completion
- Documentación de API de DeepSeek: Conversación de múltiples rondas
