Skip to main content
O Codex é o agente de programação da OpenAI e vem em três formas: Codex CLI no terminal, a extensão Codex no VS Code e o app Codex. Todos os três leem a mesma pasta ~/.codex, então uma única configuração cobre todos eles.

​
Instalação com um só comando

Substitua sk-xxx pela sua chave, abra um terminal, cole e pressione Enter. O script verifica a chave, lista todos os modelos que a chave pode chamar e permite que você escolha (Enter = recomendado: gpt-astra para Astra, gpt-5.6-sol para GPT, claude-opus-5 para Claude), instala o Codex CLI e escreve a configuração.
O script primeiro pergunta o idioma (1 = vietnamita, 2 = inglês; pule com --lang en ou --lang vi). Sem --key, ele solicita a chave. Para forçar um modelo, adicione --model gpt-astra ou --model gpt-5.6-sol.
Leia o código-fonte antes de executar se quiser: codex.sh, codex.ps1. O script é executado apenas no seu computador e envia a chave apenas para gpt.teamsoclo.site para verificação.

​
O que o script faz

  1. Verifica a chave com o gateway e escolhe o modelo para o seu pacote; uma chave incorreta para aqui sem tocar no seu computador.
  2. Faz backup do seu config.toml existente, se houver, como config.toml.bak.<timestamp>.
  3. Escreve ~/.codex/config.toml: modelo gpt-5.6-sol, o gateway da TeamSocLo, Responses API.
  4. Armazena a chave na variável de ambiente TEAMSOCLO_API_KEY (em ~/.zshrc / ~/.bashrc, ou como variável de usuário no Windows). A chave não está no arquivo de configuração, então você pode compartilhar config.toml sem vazá-la.
  5. Instala ou atualiza o Codex CLI com npm install -g @openai/codex.
Execute novamente a qualquer momento para alterar chaves ou pacotes; a configuração antiga sempre é copiada como backup antes.
Prefere não usar o terminal? TeamSocLo Key Tool é um app para Windows e macOS: cole sua chave uma vez para configurar o Codex, Claude Code e mais de 20 outras ferramentas.

​
Após instalar

1

Abra um novo terminal, execute codex

O terminal antigo não carregou a nova variável; abra uma nova aba. Pergunte qualquer coisa ao Codex para verificar.
2

VS Code: instale a extensão, feche completamente, reabra

VS Code → Extensões → pesquise Codex (o agente de programação da OpenAI) → Instalar. Depois feche o VS Code completamente: macOS Cmd + Q, Windows feche todas as janelas. Reload Window não é suficiente; a extensão lê a configuração apenas no início do processo.
3

App Codex

Reabra o app após executar o comando. No macOS, o comando configurou a variável para apps GUI via launchctl; no Windows, setx aplica aos apps iniciados depois.
Não é necessário login no OpenAI. requires_openai_auth = false diz ao Codex para usar a chave do gateway da variável de ambiente.

​
Configuração manual

Se você preferir editar por conta própria, ~/.codex/config.toml (Windows: %USERPROFILE%\.codex\config.toml) deve conter exatamente:
e a variável de ambiente TEAMSOCLO_API_KEY deve conter sua chave.
Mantenha wire_api = "responses". O Codex usa a Responses API; mudar para chat o quebra.
Abra a pasta de configuração rapidamente:

​
Alterar o modelo

O pacote GPT Astra usa gpt-astra. Edite a primeira linha do config.toml e reinicie o Codex:
Uma chave GPT chamando gpt-astra recebe “no available channel”, e vice-versa. O modelo segue o pacote que você comprou, ver Modelos e pacotes.

​
Desinstalar

Para manter o Codex mas voltar à configuração anterior, copie config.toml.bak.<timestamp> sobre config.toml.

​
Se não funcionar

  • Você abriu um novo terminal ou fechou o VS Code completamente após instalar.
  • echo $TEAMSOCLO_API_KEY (Windows: echo %TEAMSOCLO_API_KEY% no cmd) exibe a chave completa.
  • base_url termina com /v1, wire_api é responses.
  • A chave ainda é válida e tem limite: verificar aqui.
  • Caso contrário, veja Solução de problemas, que tem uma seção sobre o Codex.