Configuração de Coding Agents

Extensão Codex VS Code: API própria e login oficial

Configure o config.toml compartilhado da extensão Codex para VS Code, use Responses da BetterToken e preserve o login oficial, os plugins e o Remote Control.

A extensão Codex para VS Code compartilha ~/.codex/config.toml com o Codex CLI/App. Use esta página quando precisar manter o login oficial, os plugins ou o Remote Control.

Configurações principais

Campo	Valor
API Key	`experimental_bearer_token = "YOUR_API_KEY"`
Base URL	`https://bettertoken.ai/v1`
Modelo	`gpt-6-astra`

Pré-requisitos

Instale a versão mais recente da extensão Codex para VS Code
Conclua o login oficial na extensão ou no Codex App
Crie uma BetterToken API Key
Copie um ID de modelo da model plaza ou da caixa Setup da chave

Cadastre-se e obtenha uma BetterToken API Key

Já tem uma conta? Entre, recarregue o saldo e crie uma chave no console.

Instalação

Instale a extensão pelo VS Code Marketplace e reinicie o VS Code.

Configuração manual

Se você definiu um CODEX_HOME personalizado, edite config.toml nesse diretório. Caso contrário, use ~/.codex/config.toml no macOS / Linux ou %USERPROFILE%\.codex\config.toml no Windows.

Feche o Codex completamente e faça backup dos arquivos config.toml e auth.json existentes. Atualize as configurações do provedor existente sem adicionar uma tabela de provedor duplicada.

Configure a extensão

Edite ~/.codex/config.toml:

model_provider = "bettertoken"
model = "gpt-6-astra"

[model_providers.bettertoken]
name = "BetterToken"
base_url = "https://bettertoken.ai/v1"
wire_api = "responses"
requires_openai_auth = true
experimental_bearer_token = "YOUR_API_KEY"
supports_websockets = false

Parâmetros de configuração

Parâmetro	Função e localização	Padrões e exemplos
`model_provider`	Raiz da configuração do usuário; seleciona o ID definido abaixo.	Padrão: `openai`; aqui `bettertoken`.
`model`	Raiz; Model ID completo da praça de modelos.	Exemplo: `gpt-6-astra`; substitua conforme necessário.
`name`	Tabela do provider; apenas o nome exibido.	`BetterToken` não é um Model ID.
`base_url`	Tabela do provider; Base URL da API do modelo.	Use `https://bettertoken.ai/v1`; Codex adiciona `/responses`.
`wire_api`	Tabela do provider; protocolo das requisições.	Atualmente só aceita `responses`, também usado por padrão.
`requires_openai_auth`	Tabela do provider; autenticação OpenAI e armazenamento de credenciais.	Padrão: `false`; aqui `true`. Não é um seletor para preservar arquivos de login.
`experimental_bearer_token`	Tabela do provider; Bearer Key para requisições de terceiros.	Informe BetterToken API Key. Não reescreve o login oficial. Armazenado em texto simples; a OpenAI desaconselha este campo.
`supports_websockets`	Tabela do provider; suporte a Responses WebSocket.	Padrão: `false`; aqui mantém HTTP/SSE.

Mantenha as credenciais do login oficial; não substitua por JSON de API Key. requires_openai_auth = true usa a autenticação oficial; experimental_bearer_token do provider atual fornece a chave de terceiros para os modelos. Com o primeiro ativo, Codex ignora env_key, portanto não o use como substituto direto do Bearer Key. Não compartilhe arquivos com chaves.

Para uma configuração alternativa de credenciais, consulte as orientações da OpenAI sobre autenticação por variável de ambiente e comando. Esses são modos de autenticação separados: não adicione uma tabela auth do provider junto com env_key, experimental_bearer_token ou requires_openai_auth, nem use env_key no lugar da Bearer Key neste exemplo que preserva o login.

Camadas de configuração e chaves antigas

Não coloque modelo ou raciocínio em [projects."<path>"]. O modelo de um projeto pode usar chaves raiz em .codex/config.toml de um projeto confiável; provider e autenticação ficam na configuração do usuário. Perfis atuais usam NAME.config.toml em CODEX_HOME, selecionado com codex --profile NAME, não tabelas antigas [profiles.NAME] nem o seletor raiz profile.

Salve o arquivo, execute Developer: Reload Window no VS Code e abra novamente o painel do Codex.

Teste a conexão

Crie uma nova sessão na extensão e envie uma tarefa curta. Uma resposta de gpt-6-astra, com os plugins e o Remote Control ainda disponíveis, confirma a configuração.

Alterne entre modelos

Altere model e, opcionalmente, review_model. Depois, execute Developer: Reload Window. Use um ID da caixa Setup ou da model plaza.

Erros comuns

Erro	Correção
A extensão pede login novamente	Restaure o login oficial e mantenha `requires_openai_auth = true`.
`401` ou `403`	Copie `experimental_bearer_token` novamente; não sobrescreva `auth.json`.
Tabela duplicada	Remova a outra tabela `[model_providers.bettertoken]` e mantenha um único modo de autenticação.
Modelo não encontrado	Substitua `gpt-6-astra` por um ID completo e atual.
Configuração não aplicada	Salve o arquivo e execute Developer: Reload Window.

Configuração avançada

Guias relacionados

Referências oficiais

Detalhes técnicos

Protocolo Responses

A extensão envia as solicitações do modelo para https://bettertoken.ai/v1 por meio do OpenAI Responses.