Versiones aplicables: CC Switch 3.16.0 y superiores. Este artículo está organizado según 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 son de la interfaz frontal actual y se generaron usando datos de ejemplo desensibilizados para evitar filtrar claves API reales o saldos de cuentas.
Por qué se necesita el enrutamiento local
La nueva versión de Codex CLI está orientada a la API de OpenAI Responses, 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 transmisión y las estructuras de retorno de estos dos protocolos son diferentes. Al llenar directamente una interfaz Chat en la configuración de Codex, a menudo se obtienen listas de modelos incorrectas, errores 404/400 o respuestas de transmisión que Codex no puede analizar correctamente.
El enfoque de CC Switch es hacer que Codex siempre se conecte a una ruta local, enviando solicitudes a través de la API Responses; la ruta identifica internamente si el proveedor actual está en formato Chat, reescribe la solicitud a Chat Completions para enviarla al proveedor ascendente y, finalmente, convierte la respuesta de Chat nuevamente 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 proveedor ascendente 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 proveedor ascendente responde, la ruta convierte el JSON o SSE de Chat nuevamente a JSON/SSE de Responses que Codex pueda entender.
Preparación
Primero debes preparar tres cosas:
- CC Switch instalado y listo para iniciar.
- Codex CLI instalado y ejecutado al menos una vez para que exista la estructura de directorios
~/.codex/config.toml. - Una clave API para DeepSeek o 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, así que prioriza el uso del preset en lugar de unir manualmente las rutas de la interfaz.
Paso 1: Agregar un 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 razonamiento/pensamiento, y activará automáticamente "Requiere mapeo de enrutamiento local". Puedes ajustar el modelo predeterminado o el nombre para mostrar 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 interruptores:
- 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 activa de Codex a la ruta local y gestionará la autenticación con marcadores de posición. La clave real de DeepSeek aún se guarda en la configuración del proveedor de CC Switch y la inyecta la ruta local durante el reenvío, por lo que no necesitas exponer la clave en la configuración activa de Codex.
Paso 3: Cambiar de proveedor y reiniciar Codex
Regresa 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 mensaje que dice "Se requiere el servicio de enrutamiento para un uso normal".
Después de cambiar, se recomienda reiniciar la sesión actual del terminal de Codex porque:
- El proceso de Codex puede haber leído ya el
config.tomlanterior. - 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, como DeepSeek V4 Flash. Actualmente, la aplicación Codex no admite la selección personalizada de múltiples modelos 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; prioriza su uso. 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 proveedor ascendente admite directamente la API de OpenAI Responses, no necesitas activar "Requiere mapeo de enrutamiento local"; en este caso, CC Switch puede conectarse directamente a través de Responses sin conversión de Chat.
Preguntas frecuentes
Codex reporta 404 o no puede encontrar /responses
Generalmente, esto se debe a que la toma de control de Codex no está habilitada, o escribiste manualmente la URL base de Chat del proveedor ascendente directamente en Codex. Verifica si ~/.codex/config.toml apunta a http://127.0.0.1:15721/v1.
El proveedor ascendente de DeepSeek reporta 404
Si usas el preset integrado de DeepSeek, primero confirma que el proveedor actual proviene del preset y que el enrutamiento de Codex está habilitado. Solo cuando usas 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 cargar el directorio de modelos en caliente.
Actualmente, la aplicación Codex no admite la selección de múltiples modelos y usa por defecto el primer modelo.
La ruta está activa pero las solicitudes aún van al proveedor incorrecto
Confirma que tres estados sean consistentes: 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 el modo de toma de control de enrutamiento local porque usar un proxy para acceder a la API oficial puede presentar riesgos para la cuenta. El enrutamiento es 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 la API de DeepSeek: Tu primera llamada a la API
- Documentación de la API de DeepSeek: Crear Chat Completion
- Documentación de la API de DeepSeek: Conversación de múltiples rondas
