Configure o Codex CLI com o GPTAll

Q: Posso manter minha conta OpenAI e o GPTAll lado a lado?

Sim. Declare os dois em model_providers do config.toml e troque o model_provider quando quiser.

Q: Dá para testar antes de assinar?

Dá. Peça uma chave de teste grátis, sem cartão, e siga este mesmo guia.

Uma assinatura, uma chave, três nomes de modelo — gpt-5.6-luna, gpt-5.6-sol e gpt-5.6-terra. Tudo pelo mesmo gateway https://api.tn1.top.

O Codex CLI é o agente de linha de comando da OpenAI, e é o que o GPTAll existe para atender. Se você ainda não tem uma chave, escolha um plano ou peça um trial grátis.

1. Pré-requisitos

Node.js 18+ instalado. No macOS recomendamos o nvm.
Sua chave GPTAll (chega por e-mail após o pagamento ou pedido de trial; também aparece no painel).

node --version    # >= v18

2. Instalar e configurar

Instale a CLI:

npm install -g @openai/codex

Confirme a versão:

codex --version

Crie (ou edite) ~/.codex/config.toml e cole o bloco abaixo. Ele declara um provedor chamado gptall e já o define como padrão:

model = "gpt-5.6-luna"
model_provider = "gptall"

[model_providers.gptall]
name = "GPTAll"
base_url = "https://api.tn1.top/v1"
env_key = "GPTALL_API_KEY"
wire_api = "responses"

Exporte a chave no ambiente: export GPTALL_API_KEY="sua-chave" (no Windows, setx GPTALL_API_KEY "sua-chave").
Rode codex na pasta do seu projeto. Não há login: ele usa a variável de ambiente.
Para um teste rápido sem abrir a interface: codex exec "responda apenas: OK".

O /v1 no final é obrigatório. A mensagem de erro culpa a chave, mas o endereço errado (sem /v1) é o motivo mais comum de um 401 que parece "chave inválida" sem ser.

3. Verificar conexão

Rode codex exec --skip-git-repo-check "responda apenas: OK". Uma resposta OK confirma que a chave, o endereço e o modelo estão certos.

De onde vem esta configuração. Ela foi extraída do código do OmniRoute, o roteador que o GPTAll usa por baixo. Ainda não executamos o Codex CLI contra o gateway com uma chave desta marca para conferir de ponta a ponta. Se algo divergir, escreva para suporte@tn1.top: corrigimos e creditamos o aviso.

4. Troubleshooting

Sintoma	O que fazer
`wire_api = "chat" is no longer supported`	As versões atuais do Codex só aceitam a Responses API. Troque a linha para `wire_api = "responses"`.
`401` dizendo que a chave está ausente ou inválida	Quase sempre o `base_url` está sem o `/v1` no fim. O endereço correto é `https://api.tn1.top/v1`.
`Refusing to create helper binaries under temporary dir`	O Codex se recusa a usar um `CODEX_HOME` dentro de `/tmp`. Use o caminho padrão `~/.codex`.
A chave não é lida	O `env_key` aponta para o nome da variável, não para o valor. Confira com `echo $GPTALL_API_KEY`.

5. FAQ

Preciso de conta na OpenAI?
Não. O Codex CLI é só o programa; quem responde é o GPTAll através da sua chave.

Posso manter minha conta OpenAI e o GPTAll lado a lado?
Sim. Declare os dois em model_providers e troque o model_provider quando quiser.

Preciso de cartão internacional?
Não. Você paga em reais — Pix, cartão nacional ou boleto — e usa o Codex CLI normalmente.

Dá para testar antes de assinar?
Dá. Peça uma chave de teste grátis e siga este mesmo guia.

Vão entrar mais ferramentas?
Sim — veja a lista completa em /ferramentas.html, todas pelo mesmo gateway e os mesmos modelos gpt-5.6-luna, gpt-5.6-sol e gpt-5.6-terra.