HopBase DocsCodex CLI
Configure Codex CLI para usar la API compatible con OpenAI Responses de HopBase.
Codex CLI es el agente de codificación de OpenAI. Se recomienda la configuración con un clic; la configuración manual necesita config.toml y OPENAI_API_KEY.
Recomendado: configuración con un clic
Seleccione una clave de grupo Codex
Inicie sesión en la consola, abra Claves API y busque una clave del grupo Codex Plus o Codex Pro.
Genere el comando de configuración
Seleccione Configuración con un clic junto a la clave, elija Codex CLI, confirme macOS / Linux o Windows PowerShell, haga clic en Generar comando de configuración y cópielo.
Ejecute y verifique
Pegue el comando en Terminal en macOS, en cualquier terminal en Linux (necesita curl instalado) o en PowerShell en Windows, y ejecútelo. Cuando finalice, vuelva a abrir la terminal y ejecute codex. El script instala Codex CLI con npm: si falta Node.js, solo escribe la configuración; instale Node.js LTS y luego ejecute npm install -g @openai/codex.
Para una configuración gráfica, siga la guía de CC Switch, seleccione Importar CCS en el menú de la clave y elija Codex CLI.
El archivo existente se respalda como config.toml.bak.<timestamp>. La nueva configuración define model = "gpt-6-astra", model_reasoning_effort = "xhigh" y requires_openai_auth = true; la clave se escribe en ~/.codex/auth.json, y no se define ninguna variable de entorno. xhigh es el nivel de razonamiento más alto y usa más tokens; cambie a high o medium para el uso diario.
Niveles de razonamiento y grupos
| Ajuste | Detalles |
|---|---|
model_reasoning_effort | low / medium / high / xhigh; los niveles más altos piensan más tiempo y usan más tokens |
| Grupos Codex Plus / Codex Pro | Ambos grupos ofrecen los mismos modelos: gpt-6-astra, gpt-6-sol, gpt-6-luna, gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna y gpt-5.5. La respuesta de GET /v1/models con la clave actual es la referencia |
| Generación de imágenes | Los grupos Codex no ofrecen gpt-image-*. Para imágenes, añada el grupo GPT Image (todos los modelos) a su clave; consulte API de generación de imágenes |
Configuración manual: edite config.toml
| Sistema | Archivo de configuración |
|---|---|
| macOS / Linux | ~/.codex/config.toml |
| Windows | C:\Users\your-name\.codex\config.toml |
Cree el archivo si no existe y agregue lo siguiente:
model_provider = "hopbase"
model = "gpt-5.6-sol"
[model_providers.hopbase]
name = "HopBase"
base_url = "https://api.hop-base.com/v1"
wire_api = "responses"
env_key = "OPENAI_API_KEY"La configuración manual lee la clave de una variable de entorno mediante env_key; la configuración con un clic usa requires_openai_auth = true con auth.json. No combine requires_openai_auth = true con el método de variable de entorno en una misma configuración: en pruebas con Codex 0.153, esa combinación no envía ninguna clave y el gateway devuelve 401 missing_api_key.
Configure la clave e inicie Codex:
La configuración temporal solo se aplica a la ventana de terminal actual:
export OPENAI_API_KEY=sk-your-key
codexLa configuración persistente debe colocarse en el archivo de inicio de su shell:
# zsh (la opción predeterminada en macOS)
echo 'export OPENAI_API_KEY=sk-your-key' >> ~/.zshrc
source ~/.zshrc
# bash (habitual en Linux; use este bloque en lugar del de zsh)
echo 'export OPENAI_API_KEY=sk-your-key' >> ~/.bashrc
source ~/.bashrcLa búsqueda web de Codex solicita /v1/alpha/search, y la compactación remota de contexto solicita /v1/responses/compact. Ninguno de los dos endpoints es compatible todavía; ambos devuelven 404. El 404 de la búsqueda web no afecta a las conversaciones normales. Desactive la búsqueda web en Codex si no desea verlo.
Use una clave de un grupo Codex (Codex Plus / Codex Pro). Para respuestas lentas o errores 502 / 503, siga Códigos de error y reintentos. Consulte Solución de problemas si la configuración falla.
Próximos pasos
- CC Switch: conecte Codex App o cambie entre varias claves
- OpenAI SDK: llame a los mismos modelos GPT desde su propio código
- Solución de problemas: busque un mensaje de error