Como usar o Codex CLI com sua chave CodeAll

Q: Posso manter minha conta OpenAI e a CodeAll lado a lado?

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

Q: Onde fica a chave?

Numa variável de ambiente. O config.toml guarda só o nome dela, então a chave não vai para o disco.

O Codex CLI da OpenAI aceita um provedor de modelo próprio. Apontando ele para a CodeAll, o agente inteiro roda na sua assinatura, pagando em reais, sem cartão internacional.

Se você ainda não tem chave, escolha um plano ou peça um trial de 30 minutos grátis.

O detalhe que mais gera chamado: o endereço da API termina em https://api.tn1.top/v1. O /v1 no fim não é opcional — sem ele o gateway responde 401 dizendo que a chave está inválida, e você vai procurar o problema no lugar errado.

1. Pré-requisitos

Uma chave CodeAll ativa.
O Codex CLI instalado: npm install -g @openai/codex. O comando único abaixo também verifica e oferece instalar.

2. Configurar o Codex CLI

Instalação rápida (1 comando) — verifica o que está instalado, pergunta antes de instalar, pede a chave uma vez e grava a configuração. No menu de ferramentas, escolha Codex CLI (e, se quiser, Codex no app ChatGPT).

macOS · Linux

curl -fsSL https://codeall.tn1.top/install.sh | bash

Windows (PowerShell)

irm https://codeall.tn1.top/install.ps1 | iex

Para pular os menus, use CODEALL_TOOLS=codex (ou codex,codexapp), CODEALL_LANG e CODEALL_TOKEN. Sem terminal, CODEALL_INSTALL=yes autoriza a instalação do que faltar; o padrão é no.

curl -fsSL https://codeall.tn1.top/install.sh | CODEALL_TOKEN=sk-... CODEALL_TOOLS=codex CODEALL_INSTALL=yes bash

$env:CODEALL_TOKEN='sk-...'; $env:CODEALL_TOOLS='codex'; $env:CODEALL_INSTALL='yes'; irm https://codeall.tn1.top/install.ps1 | iex

Alternativa só para o Codex CLI, sem menu de ferramentas: curl -fsSL https://codeall.tn1.top/install-codex.sh | bash (macOS · Linux) ou irm https://codeall.tn1.top/install-codex.ps1 | iex (Windows). Depois abra um novo terminal e rode codex --profile codeall.

Prefere configurar manualmente? Siga abaixo.

Crie (ou edite) o arquivo de configuração e cole o bloco abaixo. Ele declara um provedor chamado codejato e já o define como padrão.

Sistema	Onde fica
macOS	`~/.codex/config.toml`
Linux	`~/.codex/config.toml`
Windows	`%USERPROFILE%\.codex\config.toml`

model = "gpt-6-luna"
model_provider = "codejato"

[model_providers.codejato]
name = "CodeAll"
base_url = "https://api.tn1.top/v1"
env_key = "CODEALL_API_KEY"
wire_api = "responses"

Exporte a chave no ambiente: export CODEALL_API_KEY="sua-chave" (no Windows, setx CODEALL_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".

Verificado nesta configuração. O comando abaixo foi rodado contra o gateway e respondeu OK:

CODEX_HOME=~/.codex codex exec --skip-git-repo-check "responda apenas: OK"   # model = "gpt-6-luna"

Codex no app ChatGPT

O app desktop do Codex hoje se chama ChatGPT e tem os modos ChatGPT e Codex. Ele existe para macOS e Windows no instalador. Para usá-lo com a CodeAll, marque a opção Codex (app ChatGPT) no menu, ou use CODEALL_TOOLS=codexapp. Se o app não estiver instalado, o script pergunta antes de instalar.

Esta opção muda o padrão do codex. O app não tem seletor de perfil: ele lê o config.toml principal. Por isso o script grava nele model e model_provider com o provedor codeall-app, e o codex sem --profile passa a usar a CodeAll também. Antes de gravar, o script guarda uma cópia em config.toml.bak-<data>. No macOS a chave fica em ~/.codex/codeall.key (permissão 0600); no Windows vai para a variável de usuário CODEALL_API_KEY.

Depois de rodar o script, feche o app por completo e abra de novo. No modo Codex, abra um chat novo e peça Reply with exactly: gateway-ok para conferir a conexão.

Como reverter: apague as linhas model e model_provider do topo do ~/.codex/config.toml (no Windows, %USERPROFILE%\.codex\config.toml) ou restaure o config.toml.bak-<data>, e reabra o app. O seu login do ChatGPT não é alterado. O perfil codeall do Codex CLI continua funcionando com codex --profile codeall.

3. Modelos disponíveis

O CodeAll junta as duas famílias na mesma chave: gpt-6-luna, da OpenAI, e os modelos da Anthropic (Opus 5.5, Sonnet 5.5, Haiku, Fable-5). Trocar de modelo é trocar uma linha do config.

No Codex CLI o modelo é informado por model no config.toml (com model_provider).

Modelo	Como escrever
`gpt-6-luna`	`gpt-6-luna`
`Opus 5.5`	`Opus 5.5`
`Sonnet 5.5`	`Sonnet 5.5`
`Haiku`	`Haiku`
`Fable-5`	`Fable-5`

4. O que funciona

Recurso	Status	Observação
Execução direta (`codex exec`)	Funciona	Testado nesta configuração: retorna a resposta e encerra.
Troca de modelo	Funciona	Testado: trocamos a linha `model` e rodamos de novo com outro modelo.
Modo agente (`codex`)	Não testamos	Mesma configuração; não abrimos a interface para verificar.
Login com conta OpenAI	Não	Não se aplica: a autenticação é a sua chave CodeAll.

5. 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"`. É o erro mais comum em tutoriais antigos.
`401` dizendo que a chave está ausente ou inválida	Quase sempre a `base_url` está sem o `/v1` no fim. O endereço correto é `https://api.tn1.top/v1`. A mensagem culpa a chave, mas o problema é o endereço.
`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 $CODEALL_API_KEY`.

6. FAQ

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

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

Onde fica a chave?
Numa variável de ambiente. O config.toml guarda só o nome dela, então a chave não vai para o disco.

Dúvida que não está aqui? Fale com a gente em suporte@tn1.top.

7. A mesma chave na próxima ferramenta

A sua chave CodeAll não é só do Codex CLI. Ela responde nos dois formatos — o da OpenAI e o da Anthropic — então a ferramenta que fala GPT e a que fala Claude usam a mesma chave e a mesma assinatura.

Na prática: você deixa o Codex CLI no modelo que preferir para a tarefa de agora e abre outra ferramenta com o modelo nativo dela, sem trocar de chave, sem uma segunda mensalidade e sem refazer configuração.

Ferramentas próximas do Codex CLI, cobertas pela mesma chave:

Ver todas as ferramentas compatíveis