CC-Switch Codex
Esta página explica cómo gestionar proveedores (providers) de Codex mediante CC Switch. No es lo mismo que configurar directamente el cliente o la CLI de Codex: el enfoque aquí consiste en administrar primero los proveedores en CC Switch y luego aplicarlos a Codex.
Información oficial Las descargas y la documentación están sujetas al sitio oficial.
Qué explica esta página
Codex suele operar a través de interfaces de OpenAI o compatibles con OpenAI, por lo que debes centrarte en verificar tres elementos: Base URL, Key y el nombre del modelo. Que la Base URL deba incluir /v1 depende de lo que se muestre en el panel del proveedor.
Comprobaciones previas
| Qué comprobar | Cómo verificarlo | Por qué |
|---|---|---|
| Codex se abre con normalidad | Primero, confirma que la CLI de Codex o el cliente correspondiente funcionen por sí mismos | CC Switch no instala Codex por ti |
| El proveedor admite interfaces compatibles con OpenAI | El panel muestra la dirección de la API, la Base URL, la compatibilidad con OpenAI u otras instrucciones | Codex necesita poder enviar solicitudes a la interfaz compatible |
| El modelo se puede usar en escenarios de Codex | El nombre del modelo disponible se puede ver en la lista de modelos del panel | No introduzcas nombres de modelos de Claude/Gemini en Codex |
| El estado de la Key es normal | El token del panel no ha caducado, no está deshabilitado y el saldo es suficiente | La mayoría de los errores 401 deben comenzar revisando la Key |
Cómo rellenar los campos
| Parámetro | Modo de llenado | Atención principiantes |
|---|---|---|
| Provider Name | Escribe el nombre del proveedor o su propósito | Por ejemplo, 'Proveedor principal compatible con OpenAI' |
| Target Tool / Preset | Selecciona Codex o preajustes relacionados con OpenAI/Codex | No selecciones Claude Code ni Gemini |
| Base URL | Copia el enlace de la API proporcionado en el panel del proveedor | Por lo general, es la dirección de la API facilitada por el proveedor; sigue el ejemplo del panel para saber si debe incluir /v1 |
| API Key | Copia la clave completa | No añadas espacios adicionales al principio ni al final, no copies el nombre de una nota |
| Model Name | Copia exactamente el nombre de la lista de modelos del panel | Si falla la obtención de la lista de modelos, agrégalo manualmente copiando exactamente el nombre del panel |
Aplicar a Codex
- Abre CC Switch y ve a la sección de gestión de proveedores (Provider).
- Añade un nuevo proveedor o elige uno compatible con OpenAI ya existente.
- Selecciona Codex o preajustes relacionados con OpenAI/Codex como herramienta de destino.
- Rellena la Base URL, la API Key y el nombre del modelo, y guarda los cambios.
- Ejecuta Apply / Switch para aplicar este proveedor a Codex.
- Cierra la ventana actual de la terminal, vuelve a abrirla y haz una nueva prueba.
Probar si funciona
Prueba primero la solicitud con una pregunta muy breve para comprobar si responde. Cuando la prueba sea correcta, continúa utilizándolo en tu proyecto real.
Prueba mínima de Codex
codex "Please reply only: CC-Switch Codex is active"Si el error indica que el modelo no existe, comprueba primero el nombre del modelo; si la respuesta es de no autorizado (unauthorized), revisa primero la Key; si la conexión se agota por tiempo de espera (timeout), verifica primero la Base URL y la red.