Skip to main content
Codex Desktop lee la misma configuración de Codex a nivel de usuario que Codex CLI. Puedes añadir Flatkey como proveedor de modelo personalizado sin sustituir tu inicio de sesión oficial de ChatGPT o Codex.

​
Requisitos previos

​
Configuración manual

​
1. Configura la clave API

Guarda la clave en una variable de entorno de usuario en lugar de escribirla en un archivo de configuración.
Después de cambiar la variable, cierra completamente Codex Desktop antes de volver a abrirlo.

​
2. Actualiza config.toml

Abre el archivo de configuración de Codex a nivel de usuario: Antes de sustituir los ajustes de nivel superior model y model_provider, anota sus valores actuales para poder restaurarlos más tarde. A continuación, actualiza ambos ajustes. Si alguna de las claves ya existe, sustituye su valor en lugar de añadir una clave duplicada. Conserva todos los ajustes no relacionados. Añade la tabla de proveedor que aparece a continuación; si [model_providers.flatkey] ya existe, actualiza esa tabla en lugar de crear una duplicada:
gpt-5.4 está disponible en el Directorio de Modelos de Flatkey en el momento de escribir esto. Comprueba el directorio antes de cambiar a un ID de modelo distinto.
Las credenciales oficiales pueden almacenarse en auth.json o en el almacén de credenciales de tu sistema operativo. Nunca edites, sustituyas, sobrescribas, exportes ni compartas ninguno de estos almacenes de credenciales para la configuración de Flatkey. Nunca pegues una clave API de Flatkey en ninguno de ellos. config.toml controla el enrutamiento de modelos y proveedores.

​
3. Reinicia y verifica

Cierra completamente Codex Desktop, vuelve a abrirlo y envía una petición pequeña. Abre los Registros de Uso de Flatkey y confirma el modelo, el recuento de tokens, la latencia y el coste.

​
Configurar con CC Switch

CC Switch es un gestor de configuración de terceros, no un producto de Flatkey. También puedes descargarlo desde el repositorio de GitHub de CC Switch. Los pasos siguientes siguen la interfaz actual de CC Switch. La configuración manual y CC Switch son métodos de configuración alternativos. Usa un solo método para el proveedor activo. Codex Desktop y Codex CLI comparten ~/.codex/config.toml en macOS y Linux, o %USERPROFILE%\.codex\config.toml en Windows. CC Switch controla los ajustes de modelo y proveedor en ese archivo compartido. Conserva los ajustes y proveedores no relacionados.

​
1. Completa un inicio de sesión oficial

Abre Codex Desktop y completa un inicio de sesión oficial de ChatGPT o Codex antes de cambiar de proveedor. Hazlo al menos una vez para que la aplicación de escritorio tenga una sesión oficial válida para el acceso a la cuenta y su catálogo de modelos. Las credenciales oficiales se almacenan en auth.json o en el almacén de credenciales de tu sistema operativo. Trata ambos como sensibles.

​
2. Conserva el inicio de sesión oficial para los cambios directos

En CC Switch, abre Settings > General > Codex App Enhancements y activa Keep official login for direct switches. Este ajuste evita que un cambio de proveedor directo elimine el inicio de sesión oficial que Codex Desktop todavía necesita. Activa el ajuste actual de conservación del inicio de sesión oficial para Codex
Nunca abras auth.json para copiarlo, lo sustituyas ni lo sobrescribas, pegues una clave API de Flatkey en él, ni lo compartas. Nunca expongas tu clave API de Flatkey en capturas de pantalla ni en exportaciones de proveedores de CC Switch. Si alguna de las credenciales queda expuesta, rótala o revócala de inmediato.

​
3. Añade Flatkey como proveedor personalizado

Abre el panel Codex en CC Switch y añade un Custom Provider. Usa los siguientes valores. Este tutorial no depende de un proveedor Flatkey integrado. Abre el panel de proveedor de Codex y selecciona el botón de añadir proveedor en CC Switch Introduce los campos actuales del proveedor Flatkey en CC Switch

​
4. Configura el modelo

Ajusta el Default Model del proveedor al ID exacto del modelo de Flatkey que quieras usar. La captura de pantalla muestra gpt-5.6-sol como ejemplo. Comprueba el Directorio de Modelos de Flatkey antes de elegir un ID. Haz clic en Fetch Models para cargar los ID actuales. Añade el modelo al Model Mapping del proveedor cuando quieras que aparezca en el menú /model de Codex. También puedes establecer un ID exacto como Default Model del proveedor o pasarlo desde Codex CLI con codex --model <id>. En Codex Desktop, considera el proveedor activo y el modelo predeterminado como la ruta prevista aunque el selector no muestre el modelo personalizado. Confirma la ruta real con los Registros de Uso de Flatkey después de enviar una petición. Elige Responses native y configura el mapeo de modelos de Codex Flatkey admite de forma nativa la API de Responses. Mantén Local Routing desactivado; no es necesario para esta configuración.

​
5. Guarda, activa y reinicia

Guarda el proveedor personalizado y actívalo para Codex. No elimines ajustes ni proveedores no relacionados del config.toml compartido. Confirma que el proveedor Flatkey Codex está en uso Cierra completamente Codex Desktop. Asegúrate de que no queda ningún proceso antiguo de Codex Desktop y luego vuelve a abrir la aplicación para que lea los nuevos ajustes de proveedor.

​
6. Verifica la ruta real

Inicia una nueva conversación con un contexto pequeño y envía una petición mínima. Después, abre los Registros de Uso de Flatkey y confirma el modelo, el recuento de tokens, la latencia y el coste de esa petición. Verifica la ruta de Flatkey con una respuesta mínima de Codex Desktop Conservar el inicio de sesión oficial no significa que la petición use la facturación de OpenAI. Los ajustes actuales de proveedor y modelo en el config.toml compartido controlan la ruta. Los Registros de Uso de Flatkey son la confirmación definitiva de que la petición llegó a Flatkey. Los prompts de sistema, las herramientas, el historial de la conversación, los archivos adjuntos y la salida de comandos pueden aumentar los tokens de entrada más allá del texto de tu prompt visible. Un recuento mayor de tokens de entrada puede aumentar el coste facturado.

​
Si el modelo no es visible

Codex Desktop puede mostrar el catálogo de modelos oficial y omitir un modelo personalizado en su selector. Que un modelo personalizado no aparezca en la interfaz no prueba que el enrutamiento haya fallado.
  1. Confirma que el inicio de sesión oficial de ChatGPT o Codex sigue activo.
  2. Confirma que Settings > General > Codex App Enhancements > Keep official login for direct switches está activado.
  3. Confirma que el proveedor Flatkey está activo y que su Default Model contiene el ID de modelo exacto.
  4. Comprueba el mapeo de modelos del proveedor. Usa Fetch Models cuando quieras que el modelo aparezca en el menú /model.
  5. Confirma que el config.toml compartido contiene el proveedor y el modelo activos previstos sin haber cambiado ajustes no relacionados.
  6. Cierra por completo todos los procesos de Codex Desktop y vuelve a abrir la aplicación.
  7. Envía una petición mínima y comprueba los Registros de Uso de Flatkey para verificar la ruta real.

​
Volver al proveedor oficial

Si usaste CC Switch, activa el proveedor Codex oficial. Cierra completamente Codex Desktop, asegúrate de que no queda ningún proceso antiguo y vuelve a abrirlo. No es necesario que elimines el proveedor personalizado de Flatkey. Si usaste la configuración manual, restaura los valores anteriores de nivel superior model y model_provider en config.toml. Conserva los ajustes y tablas de proveedor no relacionados. Deja intactas las credenciales oficiales en auth.json o en el almacén de credenciales del sistema operativo. Cierra completamente Codex Desktop, asegúrate de que no queda ningún proceso antiguo y vuelve a abrirlo.

​
Solución de problemas con CC Switch