# Codex 使用指南

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

## 准备工作

1. 创建 [WebberAI API Key](/docs/webberai/create-apikey)。
2. 在 [模型广场](https://webberai.top/models) 选择一个可用模型 ID。
3. 确认 OpenAI 兼容 Base URL 为 `https://webberai.top/v1`。

## Codex CLI 配置

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

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

编辑或创建 `config.toml`：

```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`：

```json
{
  "OPENAI_API_KEY": "YOUR_WEBBERAI_API_KEY"
}
```

## WebSocket 模式

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

```toml
supports_websockets = true

[features]
responses_websockets_v2 = true
```

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

## 验证

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

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

如果失败，先按 [故障排查](/docs/troubleshooting) 检查 API Key、Base URL 和模型 ID。