GetAPI.ONE
Configurar Codex CLI para GetAPI.ONE
Instale Codex CLI desde la fuente oficial, mantenga la clave ONE en una variable de entorno, configure un proveedor personalizado compatible con Responses y verifique la conexión activa.
Alcance y requisitos previos
Esta guía abarca Codex CLI en el terminal. No acredita compatibilidad con todos los clientes de escritorio, extensiones IDE, modelos ni funciones de Codex.
- Una cuenta de GetAPI.ONE con saldo utilizable o un paquete aplicable.
- Una clave de GetAPI.ONE identificada, limitada y guardada de forma privada.
- Un modelo elegido del catálogo actual que incluya explícitamente el endpoint Responses.
- Permiso para instalar Codex CLI y editar la configuración de Codex del usuario.
1. Instalar e identificar Codex CLI
Consulte la página oficial actual de Codex CLI para elegir el instalador de su sistema. El instalador independiente oficial para macOS/Linux revisado el 2026-09-07 usa el comando siguiente. En Windows, siga la pestaña Windows de la página oficial en lugar de ejecutar a ciegas un comando de shell Unix.
curl -fsSL https://chatgpt.com/codex/install.sh | shcodex --version2. Cargar la clave en el terminal
Defina la clave para el shell actual antes de iniciar Codex. Estos ejemplos contienen deliberadamente un marcador de posición.
export GETAPI_ONE_API_KEY="replace-with-your-private-key"$env:GETAPI_ONE_API_KEY = "replace-with-your-private-key"3. Configurar el proveedor ONE
Abra el config.toml de usuario de Codex (normalmente en su directorio .codex) y añada el proveedor siguiente. Sustituya YOUR_RESPONSES_MODEL por un modelo actual del catálogo de GetAPI.ONE que declare explícitamente el endpoint Responses.
model_provider = "getapi_one"
model = "YOUR_RESPONSES_MODEL"
[model_providers.getapi_one]
name = "GetAPI One"
base_url = "https://www.getapi.one/v1"
env_key = "GETAPI_ONE_API_KEY"
wire_api = "responses"4. Ejecutar y verificar
- Abra otro terminal si hizo persistente la variable de entorno; de lo contrario, conserve el terminal actual donde está definida.
- Abra un directorio de proyecto y ejecute codex. Confirme que el proveedor y modelo mostrados corresponden a la configuración prevista.
- Envíe una instrucción mínima solo cuando acepte que puede generar cargos.
- La comprobación requiere una respuesta válida de la CLI y un registro correspondiente de solicitudes o uso en la consola de GetAPI.ONE. No se llamó a ningún modelo al elaborar esta guía.
Resolver problemas en orden
| Síntoma | Comprobaciones |
|---|---|
| codex: command not found | Revise el instalador oficial de su sistema y confirme que el directorio de instalación está en PATH. |
| Missing API key | Confirme que GETAPI_ONE_API_KEY existe en el entorno que inicia Codex y que env_key está escrito exactamente. |
| 401 / Unauthorized | Copie de nuevo la clave ONE, confirme que está habilitada y compruebe que usa https://www.getapi.one/v1. |
| 404 / ruta incompatible | Confirme que /v1 sigue en base_url y que la pasarela declara /v1/responses. |
| Model not found | Sustituya el marcador por un nombre exacto del catálogo visible para el grupo de la clave y marcado para Responses. |
| La configuración no cambió | Compruebe que editó el archivo de usuario cargado por Codex, que model_provider apunta a getapi_one y que reinició el terminal o cliente. |