Como usar o Codex CLI com sua chave CodeJato

Q: Posso manter minha conta OpenAI e a CodeJato 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 CodeJato, 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 CodeJato 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 = "Sonnet"
model_provider = "codejato"

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

Exporte a chave no ambiente: export CODEJATO_API_KEY="sua-chave" (no Windows, setx CODEJATO_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 = "Sonnet"

3. Modelos disponíveis

O CodeJato vende os modelos da Anthropic em reais. Use Opus 4.8 no trabalho pesado, Sonnet no dia a dia e Haiku quando velocidade importa mais que profundidade.

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

Modelo	Como escrever
`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 CodeJato.

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 $CODEJATO_API_KEY`.

6. FAQ

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

Posso manter minha conta OpenAI e a CodeJato 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.

Ver todas as ferramentas compatíveis