Chave de API do Codex no VS Code: use um endpoint personalizado

O que você está configurando

Assistentes de código no VS Code se comunicam com um modelo via HTTP. A maioria usa o formato da API OpenAI, o que significa que aceitam uma URL base e uma chave personalizadas em vez do padrão do fornecedor. Este serviço é compatível com OpenAI, então ele se conecta a qualquer ferramenta que ofereça essa opção.

Esteja claro sobre o que está no outro lado. É um único modelo de pesos abertos executado por um provedor independente, ajustado para responder sem recusas de conteúdo para uso adulto legal. Não é o modelo Codex da OpenAI nem a API oficial de nenhum outro fornecedor. É apenas texto, com uma janela de 100.000 tokens, chamada de funções e modo JSON. Se quiser os detalhes das rotas no estilo OpenAI, leia a documentação; se precisar apenas do endereço, consulte a página sobre a URL base da API Codex.

Aqui estão os três valores a usar em todos os lugares:

Obtenha uma chave e teste-a primeiro

Crie uma conta na página da chave de API com Google ou com e-mail e senha. Novos usuários podem reivindicar $0,50 de crédito de teste com um clique, válido por 7 dias, sem necessidade de cartão. Em seguida, teste a chave em um terminal antes de mexer no VS Code. Uma chamada curl funcional comprova a chave e a URL, então erros posteriores serão relacionados à extensão.

Copy# macOS or Linux, add to ~/.zshrc or ~/.bashrc
export CODEX_API_KEY="YOUR_KEY"

# then verify the endpoint answers
curl https://api.getcodexapi.com/v1/chat/completions \
  -H "Authorization: Bearer $CODEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Write a Python one-liner that reverses a string."}]}'

A resposta é JSON de conclusão de chat, e a resposta traz o cabeçalho X-Balance-USD com seu crédito restante. Mantenha a chave em uma variável de ambiente ou no armazenamento de segredos da extensão, nunca em um repositório.

Extensão e CLI do Codex: arquivo de configuração

As ferramentas Codex da OpenAI suportam provedores de modelos personalizados por meio de um arquivo de configuração TOML no seu diretório home, e a extensão do VS Code é documentada para compartilhar essa configuração com o CLI. Verifique isso na documentação atual do Codex para sua versão, já que o formato evoluiu.

Copy# ~/.codex/config.toml
model = "uncensored"
model_provider = "custom"

[model_providers.custom]
name = "Custom endpoint"
base_url = "https://api.getcodexapi.com/v1"
env_key = "CODEX_API_KEY"
wire_api = "chat"

Pontos a verificar:

• base_url termina em /v1, sem /chat/completions.
• env_key é o nome da variável de ambiente, não a chave em si.
• wire_api seleciona o formato da requisição. Este serviço aceita tanto POST /v1/chat/completions quanto POST /v1/responses. Tente "chat" primeiro; use "responses" se sua versão do Codex exigir.
• Inicie o VS Code a partir de um shell com a variável definida ou reinicie-o após adicionar a variável ao seu perfil. Uma inicialização por interface gráfica no macOS geralmente não reconhece as variáveis exportadas no shell.

Ferramentas do tipo agente dependem de chamada de ferramentas. Isso é suportado aqui, incluindo chamadas de ferramentas em streaming, mas a qualidade varia conforme o modelo, então execute uma tarefa pequena primeiro. A página relacionada sobre usando a API no Cursor cobre uma configuração semelhante em outro editor.

Continue, Cline e outras extensões

Extensões de terceiros têm suas próprias telas, mas o padrão é constante: escolha um provedor "OpenAI" ou "Compatível com OpenAI", depois preencha a URL base, a chave e o modelo. O Continue usa uma configuração YAML:

Copy# Continue (config.yaml), model entry
models:
  - name: Hosted uncensored
    provider: openai
    model: uncensored
    apiBase: https://api.getcodexapi.com/v1
    apiKey: YOUR_KEY

Cline e Roo Code oferecem um provedor "OpenAI Compatible" no painel de configurações com os mesmos três campos. Nomes e menus mudam frequentemente, então pesquise na própria documentação da extensão por "OpenAI compatible" ou "custom base URL". Se uma extensão não tiver um campo para a URL base, ela não pode usar este endpoint.

Dicas que economizam tempo:

• Desative a conclusão de tabulação contra o modelo hospedado, a menos que você queira uma requisição a cada pausa. Ações de chat e edição são mais baratas.
• Defina um contexto menor na extensão para edições do dia a dia. Enviar repositórios inteiros para o modelo custa tokens de entrada toda vez.
• Use uma chave separada por ferramenta para saber qual delas está usando seu crédito.

Quais tarefas do editor se adequam a este modelo

Um modelo de texto geral com uma janela grande é uma boa opção para várias tarefas cotidianas: explicar código desconhecido, escrever testes unitários para uma função, converter um script entre linguagens, redigir docstrings e expressões regulares, e reescrever um módulo quando você cola o arquivo inteiro. A janela de 100.000 tokens significa que alguns arquivos médios mais suas instruções cabem em uma única requisição, e a conclusão pode usar o que sobrar.

Seja realista sobre o resto. Não é um modelo de codificação especializado com treinamento específico para editores, então execuções de agentes com vários arquivos podem exigir mais orientação e mais verificação do que você daria a uma ferramenta construída para isso. Peça diffs em vez de arquivos inteiros, revise cada alteração antes de aceitá-la e execute seus testes. Se uma tarefa precisar de conteúdo que um assistente filtrado recusaria, como a estruturação de ficção madura ou texto de pesquisa de segurança para uso legal, um endpoint sem recusas de conteúdo é o motivo para usar este.

Quanto custa em um editor

Os preços são $0,15 por 1M de tokens de entrada e $0,50 por 1M de tokens de saída. Ferramentas de código enviam muito contexto, então observe a entrada primeiro.

Exemplo: uma solicitação de edição com 8.000 tokens de contexto de arquivo e uma resposta de 600 tokens custa 8.000 x $0,15 / 1M + 600 x $0,50 / 1M = $0,0012 + $0,0003 = $0,0015. Um dia com 150 dessas solicitações custa 150 x $0,0015 = $0,225. Vinte dias úteis: $4,50.

Um agente que lê muitos arquivos pode enviar 40.000 tokens por etapa. Nesse tamanho, uma etapa custa $0,006 mais a saída, então 100 etapas custam cerca de $0,60 mais a saída. Fique de olho nos loops de agentes. Solicitações falhas ou recusadas não são cobradas, e o crédito nunca expira. Recargas de $20 a $500 podem ser pagas com cartão (Visa, Mastercard, Apple Pay, Google Pay) ou cripto. Os planos atuais estão listados na página de preços.

Solução de Problemas

401 Não Autorizado

A chave está ausente, tem um espaço solto ou a variável de ambiente não está visível para o VS Code. Reinicie o editor a partir de um terminal que tenha a variável.

404 ou "modelo não encontrado"

Use o modelo exato uncensored e a URL base com /v1 no final.

Erros 429

Uma chave completa permite 8 requisições simultâneas e 300 por minuto; a chave de teste permite 2 e 60. Uma extensão que dispara várias requisições simultâneas, como autocompletar mais chat, pode atingir o limite de concorrência. O código de erro é concurrency para muitos ao mesmo tempo e rate_limited para limites por minuto. Um cabeçalho Retry-After: 5 significa sobrecarga temporária.

Streaming travado

Alguns proxies corporativos armazenam em buffer eventos enviados pelo servidor. Teste em uma rede diferente ou desative o streaming na extensão.

As respostas diferem do que você viu com outro assistente

Isso é esperado. Este é um modelo diferente com seus próprios pontos fortes. Dê instruções claras e específicas e teste-o com código do seu próprio projeto.

Mais guias

• API Codex em Python: Chamando um LLM de Codificação
• URL Base da API Codex: Como Configurar Seu Cliente para o Nosso