Codex CLI
Codex CLI se comunica com o UberLLM através da
Responses API em https://api.uberllm.dev/v1. O Codex 0.95 e posteriores
somente falam a Responses API (wire_api = "chat" foi removida), e o UberLLM a serve
em todos os modelos de chat. Testado com o Codex 0.166.0 em 30 de outubro de 2026: comandos de shell, edições de
arquivo e tarefas multi-etapas.
Configuração
Crie uma chave em Dashboard → Chaves e adicione crédito.
Exporte-a no seu perfil de shell (
~/.zshrcou~/.bashrc):export UBERLLM_API_KEY="ull_..."Adicione a
~/.codex/config.toml:model = "deepseek/deepseek-v4.1-flash" model_provider = "uberllm" web_search = "disabled" [model_providers.uberllm] name = "UberLLM" base_url = "https://api.uberllm.dev/v1" env_key = "UBERLLM_API_KEY" wire_api = "responses"Abra um novo terminal e execute
codexno seu projeto.
base_url deve terminar em /v1: Codex adiciona /responses. env_key é o nome da
variável de ambiente que guarda a chave.
Escolhas de modelos ao vivo com os preços de hoje: Guia de configuração do Codex.
Opções
| Configuração | Por que |
|---|---|
model |
Qualquer ID de modelo de chat do catálogo. Substitua por execução com codex -m <id>. |
model_context_window |
Codex assume 272,000 tokens para modelos fora da lista da própria OpenAI. Defina o tamanho real do contexto do modelo para que o Codex compacte a conversa a tempo. |
model_reasoning_effort |
"low", "medium" ou "high", passado para modelos que pensam. |
web_search = "disabled" |
A pesquisa web do Codex é executada nos servidores da OpenAI e não é oferecida por outros provedores; o UberLLM omite a ferramenta de qualquer forma. |
Execuções não interativas para scripts e CI:
codex exec --skip-git-repo-check "fix the failing test in tests/test_api.py"
Como funciona
- Codex envia a conversa inteira a cada turno com
store: false. UberLLM não guarda nada entre as chamadas e Codex não precisa que nada seja guardado. - As ferramentas do Codex (
exec_command,apply_patch,update_plan, servidores MCP que você adiciona) são ferramentas de função e personalizadas do lado da API, então elas funcionam com qualquer modelo que suporte chamadas de ferramentas (tool calls). - Cada chamada aparece em Painel → Atividade com o nome do aplicativo
codexe seu custo.
Solução de Problemas
| Sintoma | Solução |
|---|---|
wire_api = "chat" não é mais suportado |
Defina wire_api = "responses". |
Missing environment variable: UBERLLM_API_KEY ou 401 |
Exporte a chave no terminal em que o Codex é executado. |
404 a cada turno |
base_url deve ser https://api.uberllm.dev/v1. |
| "Model metadata for … not found. Defaulting to fallback metadata" | Inofensivo para modelos fora da lista da OpenAI; defina model_context_window. |
| O modelo responde, mas nunca executa comandos | Use um modelo com chamadas de ferramenta confiáveis (DeepSeek, GLM, Kimi, Qwen Coder, Claude, GPT). |
402 |
Adicione crédito, ou aumente o limite de gastos da chave. |