Início → Guias → Codex com API personalizada: configurando o config.toml no Codex CLI e no Codex desktop

Codex com API personalizada: configurando o config.toml no Codex CLI e no Codex desktop

O Codex lê o provedor de um único arquivo. Cinco linhas de configuração e uma variável de ambiente trocam ao mesmo tempo a ferramenta de linha de comando e o app de desktop — e a maioria das falhas vem da variável, não da configuração.

A configuração

Adicione um provedor no config.toml e torne-o o padrão:

model = "gpt-6.1-sol"
model_provider = "apiclan"
model_reasoning_effort = "medium"

[model_providers.apiclan]
name = "APICLAN"
base_url = "https://apiclan.us/v1"
env_key = "APICLAN_API_KEY"
wire_api = "responses"

Três detalhes importam. O base_url termina em /v1, porque o Codex acrescenta /responses sozinho. wire_api = "responses" faz o Codex usar a API Responses, que este gateway atende. E env_key é o nome de uma variável de ambiente, não a chave.

Onde fica o arquivo

• macOS / Linux: ~/.codex/config.toml
• Windows: %USERPROFILE%\.codex\config.toml

Crie a pasta e o arquivo se não existirem. O app de desktop do Codex lê o mesmo arquivo que a ferramenta de linha de comando, então uma edição vale para os dois. Se preferir não editar TOML à mão, o CC Switch pode escrevê-lo para você — veja o guia de apps de desktop.

Definindo a chave para o Codex enxergar

macOS / Linux — adicione ao perfil do seu shell:

echo 'export APICLAN_API_KEY=sk-your-key' >> ~/.zshrc
source ~/.zshrc

Windows — salve para sua conta de usuário:

setx APICLAN_API_KEY "sk-your-key"

É aqui que a maioria das configurações quebra. Uma variável criada com export ou $env: só existe naquele terminal; o app de desktop, aberto pelo Dock ou pelo menu Iniciar, nunca a vê. O setx no Windows grava de forma permanente, mas só programas abertos depois a leem — feche o Codex por completo e abra de novo.

Escolhendo modelo e esforço de raciocínio

Mude model na configuração ou troque dentro da sessão com /model:

Modelo	Bom para
gpt-6.1-sol, gpt-5.6-terra	Código do dia a dia, edições, testes — o mais barato por chamada
gpt-5.6-sol	Quando seus prompts estão ajustados para o GPT-5.6
gpt-6-astra	Problemas difíceis em que uma resposta melhor vale cinco vezes o preço

model_reasoning_effort aceita low, medium, high e xhigh. Mais esforço escreve mais: no gpt-5.6-sol aqui, a chamada mediana em high devolveu 373 tokens de saída contra 139 em medium — 2,7 vezes mais, tudo cobrado como saída. Comece em medium. Os preços estão no guia de preços da API da OpenAI.

Como é o tráfego do Codex aqui

Nos últimos 30 dias, 87% de todas as chamadas GPT deste gateway vieram do Codex, todas via /v1/responses com streaming. A chamada mediana:

• levava cerca de 67.000 tokens de contexto, 86% vindos do cache
• levou 14 segundos no total, com o primeiro token após 10
• devolveu 214 tokens de saída

Os quatro erros mais comuns

• 401 Unauthorized → o Codex não enxerga APICLAN_API_KEY. Defina como acima e reinicie o Codex por completo. echo $APICLAN_API_KEY no mesmo ambiente deve mostrar a chave.
• 404 ou uma página HTML → falta /v1 no base_url, ou ele aparece duas vezes.
• model not found → o nome do modelo está errado ou sua chave pertence a um grupo que não o tem. A lista que vale é GET https://apiclan.us/v1/models.
• stream disconnected ou tempo esgotado em tarefas longas → um raciocínio muito longo passa da paciência de um proxy. Troque o base_url para https://api.apiclan.us/v1, que contorna o limite de 100 segundos.

O Claude Code segue a convenção oposta — sem /v1 —, explicada no guia de base URL do Claude Code.

Comece a usar

Sem assinatura, sem mínimo mensal, sem conversa com vendedor. Recarregue com USDT e gaste o que usar — 1 USDT dá 2 créditos de saldo de API.

Leia o início rápido de 30 segundos

Idioma: English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Türkçe · Português · Italiano · Bahasa Indonesia · Tiếng Việt · Bahasa Melayu · Polski · Čeština · فارسی · Русский

Os preços desta página são preenchidos automaticamente com dados reais de cobrança. Condições de terceiros são citadas da documentação deles.