HopBase DocsCodex App
Conecte la app de escritorio Codex de OpenAI a HopBase para usar modelos GPT.
Codex App es la app de escritorio Codex de OpenAI. Lee la misma configuración de usuario que Codex CLI, ~/.codex/config.toml. Prepare esa configuración y una clave, vuelva a abrir la app y funcionará con HopBase.
| Elemento | Valor |
|---|---|
| Archivos de configuración | ~/.codex/config.toml y ~/.codex/auth.json |
| Base URL | https://api.hop-base.com/v1 |
| Protocolo | wire_api = "responses" |
| Clave | Una clave del grupo Codex Plus o Codex Pro |
Recomendado: configuración con un clic o CC Switch
Ambas opciones escriben config.toml y auth.json, y Codex App los usa tal cual.
Escriba la configuración
En la página Claves API de la consola, busque una clave de un grupo Codex y elija una vía: seleccione Configuración con un clic, elija Codex CLI y ejecute el comando en una terminal; o siga la guía de CC Switch, seleccione Importar CCS y elija también Codex CLI.
Cierre Codex App por completo y vuelva a abrirla
Salga de toda la app y ábrala de nuevo; en macOS pulse Cmd+Q. Si solo cierra la ventana, la app no vuelve a leer la configuración.
Cree una tarea para verificar
Cree una tarea nueva y pida una respuesta de una sola palabra. Si funciona, la solicitud aparece en el registro de uso de la consola.
Configuración manual
Codex App se inicia desde el escritorio, así que puede no ver las variables de entorno definidas en su terminal. En la configuración manual, guarde la clave en auth.json en lugar de usar env_key.
| Sistema | Directorio de configuración |
|---|---|
| macOS / Linux | ~/.codex/ |
| Windows | C:\Users\<su-usuario>\.codex\ |
Cree los archivos si no existen.
config.toml:
model_provider = "hopbase"
model = "gpt-6-astra"
model_reasoning_effort = "high"
[model_providers.hopbase]
name = "HopBase"
base_url = "https://api.hop-base.com/v1"
wire_api = "responses"
requires_openai_auth = trueauth.json:
{
"OPENAI_API_KEY": "sk-su-clave"
}Use requires_openai_auth = true con auth.json, o bien env_key con una variable de entorno, pero no ambos. Con los dos en la misma configuración, en pruebas con Codex 0.153 no se envía ninguna clave y el gateway devuelve 401 missing_api_key.
Cambiar de modelo
Edite model y model_reasoning_effort en config.toml, cierre y vuelva a abrir Codex App, y luego cree una tarea nueva. Las tareas existentes pueden conservar el modelo con el que se crearon.
Los ID de modelo y niveles de razonamiento de los grupos Codex están en Codex CLI. La lista que devuelve GET /v1/models para su clave es la referencia.
Más detalles
- Codex App y Codex CLI editan el mismo archivo. Un cambio de modelo o proveedor en uno se aplica al otro tras reiniciarlo.
- Codex App también escribe sus propios ajustes en
config.toml. La configuración con un clic reescribe el archivo completo y antes guarda una copia del original comoconfig.toml.bak.<marca-de-tiempo>.
La búsqueda web llama a /v1/alpha/search y la compactación remota de contexto llama a /v1/responses/compact. Ninguno de los dos endpoints está disponible todavía, así que ambos devuelven 404. El chat normal y la edición de código no se ven afectados.
- La app sigue usando la cuenta de ChatGPT: compruebe que
model_providerapunta ahopbasey cierre y vuelva a abrir la app. - 401: revise la clave en
auth.jsony confirme que pertenece a un grupo Codex. Para otros errores, consulte Solución de problemas.
Próximos pasos
- Codex CLI: use la misma configuración en una terminal
- CC Switch: cambie entre varias claves
- Solución de problemas: busque un mensaje de error