Skip to main content
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

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

Instalação

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

Configuração manual

Configure a extensão

Edite ~/.codex/config.toml:
Salve o arquivo, execute Developer: Reload Window no VS Code e abra novamente o painel do Codex.
requires_openai_auth = true preserva o login oficial. experimental_bearer_token autentica as solicitações de modelo da BetterToken. Não grave a BetterToken API Key em auth.json.

Não combine a autenticação da CLI/App com a da extensão

As duas alternativas usam [model_providers.custom]. Mantenha apenas uma tabela no arquivo TOML.

Teste a conexão

Crie uma nova sessão na extensão e envie uma tarefa curta. Uma resposta de YOUR_MODEL_ID, 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

Configuração avançada

Provedores compatíveis

Os status se aplicam ao método de configuração do BetterToken descrito nesta página.
  • Configuração manual: informe a API Key, a Base URL e o Model.
  • Sem suporte: ainda não há um método verificado de conexão direta.

Guias relacionados

Referências oficiais

Detalhes técnicos

A extensão usa o login oficial em alguns recursos do Codex, por isso esta configuração mantém requires_openai_auth = true. Um provedor personalizado apenas para CLI/App usa uma variável de ambiente e requires_openai_auth = false. Ambos enviam solicitações OpenAI Responses por https://www.bettertoken.ai/v1.