Codex CLI

Codex CLI 通过 Responses API 在 https://api.uberllm.dev/v1 与 UberLLM 通信。Codex 0.95 及更高版本只支持 Responses API (wire_api = "chat" 已移除)，并且 UberLLM 在所有聊天模型上提供此服务。已在 2026年10月30日上使用 Codex 0.166.0 进行测试：shell 命令、文件编辑和多步任务。

设置

在控制面板 → 密钥中创建密钥并充值。
将其导出到您的 shell 配置文件中 (~/.zshrc 或 ~/.bashrc)：
```
export UBERLLM_API_KEY="ull_..."
```

添加到 ~/.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"

打开新终端并在您的项目中运行 codex。

base_url 必须以 /v1 结尾：Codex 会添加 /responses。 env_key 是用于保存密钥的环境变量的名称。

实时模型选择及今日价格：Codex 设置指南。

选项

设置	原因
`model`	来自目录的任何聊天模型 ID。每次运行可通过 `codex -m <id>` 覆盖。
`model_context_window`	对于 OpenAI 自身列表之外的模型，Codex 假定 272,000 个 token。设置模型的实际上下文大小，以便 Codex 及时压缩对话。
`model_reasoning_effort`	`"low"`、`"medium"` 或 `"high"`，传递给会思考的模型。
`web_search = "disabled"`	Codex 的网络搜索在 OpenAI 的服务器上运行，其他提供商不提供此功能；UberLLM 无论如何都会排除此工具。

用于脚本和 CI 的非交互式运行：

codex exec --skip-git-repo-check "fix the failing test in tests/test_api.py"

工作原理

Codex 在每次对话轮次中都会发送整个对话内容，并附带 store: false。UberLLM 在两次调用之间不保留任何信息，Codex 也不需要保留任何信息。
Codex 的工具（exec_command、apply_patch、update_plan、您添加的 MCP 服务器）是来自 API 端的函数工具和自定义工具，因此它们适用于任何支持 tool calls 的模型。
每次调用都会显示在 Dashboard → Activity 中，并带有应用名称 codex 及其费用。

故障排除

症状	解决方法
`wire_api = "chat"` 不再受支持	设置 `wire_api = "responses"`。
`Missing environment variable: UBERLLM_API_KEY` 或 `401`	在 Codex 运行的终端中导出 key。
每次都 `404`	`base_url` 必须是 `https://api.uberllm.dev/v1`。
"Model metadata for … not found. Defaulting to fallback metadata"	对于 OpenAI 列表之外的模型无害；设置 `model_context_window`。
模型会回答但从不运行命令	使用具有可靠工具调用功能的模型（DeepSeek, GLM, Kimi, Qwen Coder, Claude, GPT）。
`402`	添加信用额度，或提高 key 的消费限额。