Codex no VS Code na Rússia: login oficial e sua própria API
Mantenha o login oficial da extensão Codex enquanto as solicitações ao modelo passam por um provedor da Responses API e um token Bearer separado.
A extensão Codex para VS Code lê o arquivo compartilhado ~/.codex/config.toml. Ela pode usar um provedor personalizado e, ao mesmo tempo, manter o login oficial da extensão. Essa configuração exige OpenAI Responses, uma Base URL compatível e um token Bearer separado. Depois de alterar o arquivo, recarregue a janela do VS Code e crie uma sessão nova.
Quer manter o login oficial do Codex e encaminhar solicitações do modelo com a sua própria chave de API? Crie uma conta BetterToken e confira os valores no guia atual do Codex para VS Code. Essa configuração não substitui o login oficial da OpenAI nem altera os requisitos regionais do Marketplace, da conta ou da extensão.
Antes de começar
Prepare:
- a versão atual da extensão Codex para VS Code no Marketplace oficial;
- um login oficial concluído na extensão ou no Codex App;
- sua própria API Key da BetterToken;
- um Model ID atual da Model Plaza da BetterToken;
- uma cópia de segurança do
config.toml, caso ele já esteja configurado.
O Codex CLI, o aplicativo e a extensão de IDE compartilham um único arquivo no nível do usuário. Por isso, um provedor personalizado antigo pode afetar várias interfaces de uma vez. Abra o arquivo antes de editá-lo e identifique as seções que já existem.
Se ainda não decidiu onde executar o Codex, leia primeiro a comparação entre Codex CLI e Desktop App. Ela separa terminal, aplicativo, VS Code e as diferenças de autenticação do provedor personalizado.
Caminho no macOS e Linux:
No Windows:
1. Verifique o login oficial
Instale a extensão, abra o painel Codex e conclua o login oficial. Não adicione o provedor personalizado antes dessa etapa; caso contrário, será difícil distinguir um erro de conta de um erro de API.
Depois do login, envie uma solicitação curta por um modo oficial compatível. Se a extensão não abrir ou se o callback de autenticação não for concluído, corrija isso primeiro com a documentação oficial do Codex para IDE.
2. Adicione o provedor BetterToken
Abra o seu config.toml de usuário e adicione uma única configuração de provedor:
Os campos exatos, a Model ID atual e o método de autenticação não são fixados neste artigo, porque dependem da versão atual da extensão. Abra o guia atual da BetterToken para Codex VS Code e informe no seu config.toml de usuário somente os valores indicados nele.
Substitua YOUR_MODEL_ID pelo identificador exato disponível no momento e YOUR_API_KEY pela sua própria chave. O arquivo fica no diretório de usuário .codex, mas não deve ser enviado ao Git, incluído em um arquivo do projeto nem publicado em um Gist.
Confirme os campos, caminhos e a versão da autenticação no guia atual específico da extensão do VS Code. Não grave a API Key da BetterToken em auth.json.
3. Não misture dois modos de autenticação
A CLI, o Desktop App e a extensão do VS Code podem usar configurações de autenticação distintas e dependentes da versão. Não copie campos entre clientes; confirme os campos, caminhos e a versão no guia atual específico da extensão do VS Code.
O guia Codex CLI ou Codex App: como escolher e conectar um provedor personalizado explica por completo a escolha entre esses modos. Não copie campos de um cliente para outro sem consultar as instruções atuais.
Se você já configurou a CLI, confirme a configuração ativa conforme o guia atual. Não cole em uma issue configurações ou saídas que exponham um token real.
4. Recarregue o VS Code
Salve o arquivo. Abra a Paleta de Comandos e execute:
Depois, abra novamente o painel Codex e crie uma sessão nova. Uma sessão antiga pode manter o provedor ou o modelo anterior.
5. Valide a solicitação
Abra um diretório de teste e envie uma solicitação que não altere arquivos:
A configuração está confirmada se:
- a extensão continua autenticada oficialmente;
- a resposta chega sem
401,403oumodel not found; - o
YOUR_MODEL_IDselecionado é usado; - o Dashboard da BetterToken mostra a solicitação correspondente, o status e o consumo de tokens.
Plugins e Remote Control dependem do login oficial e da versão atual do Codex. A BetterToken cobre a API de modelo e não promete que esses recursos estejam disponíveis em todas as condições.
Erros comuns
A extensão pede login novamente
Restaure o login oficial e confirme os campos e caminhos de autenticação no guia atual específico da extensão do VS Code. Não substitua auth.json por uma chave da BetterToken.
401 ou 403
Compare as configurações de autenticação com o guia atual específico da extensão do VS Code e informe sua chave novamente com cuidado se necessário. Não publique o arquivo inteiro.
Duplicate table
O TOML não permite declarar [model_providers.custom] duas vezes. Mantenha um provedor e um modo de autenticação. Se precisar de variantes, guarde configurações verificadas separadas e alterne entre elas conscientemente.
Modelo não encontrado
Substitua os dois valores YOUR_MODEL_ID pelo ID completo atual. Um nome antigo visto em um artigo ou captura de tela não é uma fonte confiável.
As alterações não foram aplicadas
Remova campos antigos de provider ou profile que estejam em conflito, salve o arquivo, execute Developer: Reload Window e inicie uma sessão nova. Se o problema persistir, feche o VS Code completamente e verifique o arquivo de usuário que a extensão realmente lê.
Os campos dessa configuração avançada podem mudar com o Codex. Antes de configurar novamente, abra a documentação BetterToken para Codex VS Code e a referência oficial do Codex.