Skip to Content
Uso en herramientasCodex CLICodex Desktop

Codex Desktop

Tras completar la configuración del proveedor, compruebe qué configuración abre realmente Codex para escritorio. Que la CLI funcione no significa que la aplicación de escritorio esté verificada; la ubicación personalizada de la configuración y la versión de la aplicación pueden cambiar los ajustes que se leen.

Configura más rápido con Ofox Desktop. En un Mac con Apple silicon, Desktop detecta esta herramienta, guarda una copia de la configuración actual y aplica una Ofox API Key y un modelo compatible. Abrir Ofox Desktop .

Ofox Desktop  ofrece otra vía de configuración; antes de usarlo, revise los dispositivos y clientes compatibles. Ofox Desktop y Codex Desktop son aplicaciones distintas.

Verificar la configuración de la app de escritorio

Si quieres confirmar que la app de escritorio ha tomado la configuración de CC Switch, sigue estos pasos:

Paso 1: Ver config.toml en CC Switch

Abre CC Switch, haz clic en el proveedor para abrir la página de edición y cambia a la pestaña config.toml (TOML) en la parte superior para ver la configuración escrita actualmente.

Contenido del config.toml en CC Switch

Paso 2: Abrir config.toml de Codex Desktop

Abre Codex Desktop, ve al menú Configuración en la izquierda y haz clic en el botón Abrir config.toml en la esquina superior derecha. El archivo se abrirá en tu editor predeterminado.

Página de configuración de Codex Desktop

config.toml en el editor

Paso 3: Comparar las dos configuraciones

Compare el modelo seleccionado, model_provider y el base_url de ese proveedor. Que coincidan es solo un paso de la comprobación: la ruta debe confirmarse con una solicitud real.

Paso 4: Enviar un mensaje para verificar

Cree una conversación nueva y envíe una solicitud breve, por ejemplo «Responde solo OK». Esta solicitud se factura según los precios de la cuenta y del modelo. Después, compruebe la hora y el modelo en el registro de uso de Ofox; si no hay registro, revise primero la cuenta, el proveedor y la configuración activa antes de volver a intentarlo.

Recibir la respuesta y encontrar el registro correspondiente verifica la ruta de esta solicitud. No demuestra por sí solo la identidad del modelo subyacente ni sustituye la verificación por separado de llamadas a herramientas, entrada de imágenes o salida estructurada.

Codex Desktop funcionando

Problemas con la primera solicitud

SíntomaQué revisar primeroSiguiente paso
La CLI funciona, pero la aplicación de escritorio noLa configuración que abre cada una, el proveedor y el modelo seleccionadosCorrija los campos que no coinciden, guarde, reinicie el cliente correspondiente y verifique en una conversación nueva
Error de autenticaciónLas credenciales del proveedor actual y la cuenta que las emitióSustituya las credenciales no válidas mediante el proceso de configuración habitual; no pegue la Key en las incidencias
El modelo o el endpoint no existeID exacto del modelo, endpoint y protocoloCorríjalo según la guía de configuración del proveedor; no añada /v1 a una dirección que ya lo incluya
Hay respuesta, pero no registro de uso en OfoxCuenta, proveedor y hora de la solicitudCompruebe la ruta real de la solicitud; que el modelo diga quién es no demuestra que el enrutamiento sea correcto
El texto funciona, pero las herramientas fallanCapacidades del modelo, parámetros de la herramienta y respuesta de errorVerifíquelo por separado en un proyecto de prueba temporal y conserve el error sin datos sensibles y el identificador de solicitud disponible

Haga una copia de seguridad antes de modificar la configuración; si algo falla, restaure la última configuración que funcionaba y evite que varias herramientas de configuración se sobrescriban entre sí. Al informar de un problema, indique la versión del cliente, el sistema operativo, el ID exacto del modelo, la hora y zona horaria de la solicitud, el estado HTTP y el identificador de solicitud disponible, y elimine la Key, las cabeceras de autenticación, los prompts privados y el contenido del proyecto.

Siguientes pasos

Última actualización: