Ir al contenido
GetAPI
Español
Menú

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.

Instalador oficial para macOS / Linux
curl -fsSL https://chatgpt.com/codex/install.sh | sh
Confirmar el comando instalado
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.

Shell de macOS / Linux
export GETAPI_ONE_API_KEY="replace-with-your-private-key"
Proceso actual de PowerShell
$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.

config.toml del usuario
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. 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íntomaComprobaciones
codex: command not foundRevise el instalador oficial de su sistema y confirme que el directorio de instalación está en PATH.
Missing API keyConfirme que GETAPI_ONE_API_KEY existe en el entorno que inicia Codex y que env_key está escrito exactamente.
401 / UnauthorizedCopie de nuevo la clave ONE, confirme que está habilitada y compruebe que usa https://www.getapi.one/v1.
404 / ruta incompatibleConfirme que /v1 sigue en base_url y que la pasarela declara /v1/responses.
Model not foundSustituya 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.