Codex CLI

Deixar meu agente fazer a configuraçãoCopy Anchor Link

Copie esta tarefa para um agente que já esteja funcionando no seu computador:

Leia este guia e me ajude a conectar Codex CLI ao TokenLab:
https://tokenlab.sh/docs/pt/integrations/codex-cli
Verifique primeiro minha versão instalada e a configuração ativa.
Preserve as contas, os provedores, as permissões e os demais ajustes existentes.
Faça backup dos arquivos locais e mostre as alterações propostas.
Deixe que eu insira localmente as chaves de API necessárias; nunca as solicite, exiba ou cole no chat.
Verifique primeiro se a configuração é carregada corretamente.
Explique separadamente o custo de qualquer teste com requisições pagas antes de executá-lo.

Visão geralCopy Anchor Link

O Codex CLI se conecta ao TokenLab por /v1/responses. O modelo escolhido deve incluir openai_responses em tokenlab.accepted_request_formats; os recursos podem variar por modelo.

A compactação remota do Codex CLI é compatível em POST /v1/responses/compact. O Codex envia o model da sessão atual em body.model para /compact e auto-compactação, então o modelo usado para compactar deve estar disponível no caminho Responses. Não configure /v1/compact.

Requisitos do SistemaCopy Anchor Link

Siga o guia CLI oficial para macOS, Linux ou Windows. Windows nativo e WSL são ambientes separados; veja o guia Windows. npm é uma opção, não um requisito dos binários nativos.

InstalaçãoCopy Anchor Link

npm install -g @openai/codex@0.149.0

Verifique a instalação:

codex --version

ConfiguraçãoCopy Anchor Link

Passo 1: Definir Chave de APICopy Anchor Link

Siga as etapas de terminal do início rápido para macOS, Linux, WSL ou Windows PowerShell e defina TOKENLAB_API_KEY sem gravar a chave no histórico. Inicie o Codex nesse terminal. Para uso persistente, utilize um gerenciador local de segredos, sem acrescentar a chave em texto simples ao perfil do shell.

Passo 2: Configure tokenlab.config.tomlCopy Anchor Link

Com Codex 0.149.0, use um arquivo tokenlab.config.toml separado no CODEX_HOME ativo (normalmente ~/.codex). Crie-o apenas se o nome estiver livre ou faça backup do perfil TokenLab existente antes de editar. codex --profile tokenlab carrega o perfil explicitamente sem alterar config.toml, auth.json, contas ou permissões. Não use a tabela antiga [profiles.tokenlab]. Inicie sem esse perfil para voltar à configuração habitual. Consulte a configuração oficial de perfis.

model_provider = "tokenlab"
model = "gpt-5.6-sol"
model_reasoning_effort = "xhigh"

[model_providers.tokenlab]
env_key = "TOKENLAB_API_KEY"
name = "TokenLab"
base_url = "https://api.tokenlab.sh/v1"
wire_api = "responses"
supports_websockets = true
websocket_connect_timeout_ms = 15000

Este modo WebSocket é uma ponte Responses-over-WebSocket para clientes Codex. Ele aceita somente eventos oficiais response.create; stream é implícito, e background e response.cancel não estão disponíveis nesse transporte. Não é a API OpenAI Realtime e não aceita session.update, conversation.item.*, input_audio_buffer.*, áudio binário nem envelopes Realtime aninhados response.create.response.

O Codex atual usa wire_api = "responses", não chat/completions. Omita requires_openai_auth ou use false para que este provedor utilize env_key.

Uso BásicoCopy Anchor Link

Iniciar modo interativo:

codex --profile tokenlab

Comando direto:

codex --profile tokenlab "Fix the bug in main.py line 42"

Especificar modelo:

codex --profile tokenlab -m gpt-5.6-sol "Build a REST API server"

Escolha um modeloCopy Anchor Link

Escolha um modelo cujo tokenlab.accepted_request_formats inclua atualmente openai_responses. Compare em suas tarefas e consulte os preços na página de modelos.

Comandos InterativosCopy Anchor Link

Verificar ConfiguraçãoCopy Anchor Link

Verifique apenas se a variável de ambiente está definida, sem exibir seu valor. Essa verificação não valida a chave:

if [ -n "${TOKENLAB_API_KEY:-}" ]; then
  printf '%s\n' 'TOKENLAB_API_KEY is set'
else
  printf '%s\n' 'TOKENLAB_API_KEY is not set'
fi

Inicie o Codex e execute /status para conferir o modelo ativo e as permissões. Se usar um perfil, inicie esse mesmo perfil. Consulte o comando oficial de status.

Quando estiver pronto para enviar uma requisição real, execute o comando abaixo. Ele usa seu saldo TokenLab. Confira a resposta e o registro correspondente em Requisições. Uma variável definida ou uma inicialização bem-sucedida, por si só, não comprova o sucesso de uma requisição.

codex --profile tokenlab "Reply only with OK. Do not use tools or modify files."

Casos de Uso ComunsCopy Anchor Link

Revisão de código:

git diff | codex --profile tokenlab "Review these code changes"

Gerar mensagens de commit:

git diff --staged | codex --profile tokenlab "Generate a commit message for these changes"

Corrigir erros:

codex --profile tokenlab "Fix the TypeScript errors in src/components/"

Explicar código:

cat main.py | codex --profile tokenlab "Explain what this code does"

Solução de ProblemasCopy Anchor Link