Como usar o Codex CLI com sua chave CodeAll
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 24h 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
2. Configurar o Codex CLI
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-5.5"
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
codexna 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-5.5"3. Modelos disponíveis
O CodeAll junta as duas famílias na mesma chave: gpt-5.5 da OpenAI e os modelos da Anthropic (Opus 4.8, Sonnet, Haiku). 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-5.5 | gpt-5.5 |
Opus 4.8 | Opus 4.8 |
Sonnet | Sonnet |
Haiku | Haiku |
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: