Codex CLI con GetAPI.ONE: clave API y configuración del proveedor personalizado

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.

• Crear una clave limitada
• Consultar modelos compatibles con el endpoint

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 | sh

codex --version

2. 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

1. Abra otro terminal si hizo persistente la variable de entorno; de lo contrario, conserve el terminal actual donde está definida.
2. Abra un directorio de proyecto y ejecute codex. Confirme que el proveedor y modelo mostrados corresponden a la configuración prevista.
3. Envíe una instrucción mínima solo cuando acepte que puede generar cargos.
4. Una verificación exitosa requiere una respuesta CLI válida y una solicitud de consola GetAPI.ONE o un registro de uso correspondiente.

Resolver problemas en orden

• Guía completa de resolución de problemas
• Preparar un informe seguro de asistencia