Configurar Codex CLI para GetAPI.ONE

Escopo e pré-requisitos

Este guia cobre Codex CLI no terminal. Não comprova compatibilidade com todos os clientes de desktop, extensões IDE, modelos ou recursos Codex.

• Uma conta GetAPI.ONE com saldo utilizável ou pacote aplicável.
• Uma chave GetAPI.ONE nomeada, limitada e guardada em privado.
• Um modelo atual que liste explicitamente Responses.
• Permissão para instalar Codex CLI e editar a configuração do usuário.

• Criar uma chave com escopo limitado
• Consultar modelos compatíveis com o endpoint

1. Instalar e identificar Codex CLI

Use a página oficial atual do Codex CLI para o instalador do seu sistema. O instalador independente macOS/Linux revisado em 2026-09-07 usa o comando abaixo. No Windows, siga a aba Windows oficial em vez de executar cegamente um comando Unix.

curl -fsSL https://chatgpt.com/codex/install.sh | sh

codex --version

2. Carregar a chave no terminal

Defina a chave no shell atual antes de iniciar Codex. Os exemplos contêm deliberadamente um marcador.

export GETAPI_ONE_API_KEY="replace-with-your-private-key"

$env:GETAPI_ONE_API_KEY = "replace-with-your-private-key"

3. Configurar o provedor ONE

Abra o config.toml do usuário Codex (normalmente em .codex) e adicione o provedor abaixo. Substitua YOUR_RESPONSES_MODEL por um modelo atual GetAPI.ONE que declare explicitamente 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. Executar e verificar

1. Abra outro terminal se tornou a variável persistente; caso contrário, mantenha o terminal em que está definida.
2. Abra um diretório de projeto e execute codex. Confirme que provedor/modelo exibidos correspondem à configuração pretendida.
3. Envie uma instrução mínima somente se aceitar possível cobrança.
4. A verificação exige resposta CLI válida e registro correspondente de solicitação/uso no console GetAPI.ONE. Nenhum modelo foi chamado ao produzir este guia.

Diagnosticar em ordem

• Guia completo de solução de problemas
• Preparar um relatório seguro de suporte