Codex 使用指南

Codex 适合代码生成、修改、审查和仓库内自动化任务。WebberAI 可作为 OpenAI 兼容模型供应商接入。

准备工作

1. 创建 WebberAI API Key。
2. 在 模型广场 选择一个可用模型 ID。
3. 确认 OpenAI 兼容 Base URL 为 https://webberai.top/v1。

Codex CLI 配置

Codex 的本地配置目录通常是：

Windows: %USERPROFILE%\.codex
macOS / Linux: ~/.codex

编辑或创建 config.toml：

model_provider = "webberai"
model = "从模型广场复制的模型 ID"
review_model = "从模型广场复制的模型 ID"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true

[model_providers.webberai]
name = "WebberAI"
base_url = "https://webberai.top/v1"
wire_api = "responses"
requires_openai_auth = true

编辑或创建 auth.json：

{
  "OPENAI_API_KEY": "YOUR_WEBBERAI_API_KEY"
}

WebSocket 模式

如果你使用的 Codex 版本和 WebberAI 密钥支持 Responses WebSocket，可在 config.toml 中追加：

supports_websockets = true

[features]
responses_websockets_v2 = true

如果启动失败，先移除 WebSocket 相关配置，使用普通 HTTP 模式验证。

验证

重启 Codex 后发送一个简单任务，例如：

读取当前目录文件并总结项目结构。

如果失败，先按 故障排查 检查 API Key、Base URL 和模型 ID。