# Codex

来源: https://docs.aicentos.com/clients/codex

Language: zh-CN

> 在 Codex 中使用 aicentos —— CC Switch 一键导入，或手动配置 config.toml

Codex 兼容 OpenAI 协议，把模型提供商指向 aicentos 即可使用 aicentos 接入的全部模型。

下面提供两种接入方式：**用 CC Switch 一键管理**（推荐），或**手动编辑 config.toml**。

## 方式一：用 CC Switch（推荐）

CC Switch 同样支持管理 Codex 的 Provider 配置，多套配置一键切换。

详见 [接入 CC Switch →](https://docs.aicentos.com/clients/cc-switch)

## 方式二：手动配置

### 准备信息

| 项            | 值                         |
| ------------ | ------------------------- |
| Provider ID  | `aicentos`                |
| Provider 名称  | `aicentos`                |
| Base URL     | `https://aicentos.com/v1` |
| API Key 环境变量 | `AICENTOS_API_KEY`        |

先在控制台「API Key」页面创建一个专用 Key，建议命名里带上 `codex` 方便追踪用量。

### 设置 API Key

在终端配置环境变量：

```bash
export AICENTOS_API_KEY="sk-你的-API-Key"
```

持久化的话加到 `~/.zshrc` 或 `~/.bashrc`，然后重新加载：

```bash
source ~/.zshrc
```

确认变量已生效：

```bash
echo $AICENTOS_API_KEY
```

### 配置 Codex Provider

编辑 `~/.codex/config.toml`，加入：

```bash
model = "你的模型名"
model_provider = "aicentos"

[model_providers.aicentos]
name = "aicentos"
base_url = "https://aicentos.com/v1"
env_key = "AICENTOS_API_KEY"
wire_api = "responses"
```

把 `你的模型名` 换成控制台「模型广场」中列出的模型名，可参考 [支持的模型](https://docs.aicentos.com/billing/models-list)。

### 启动 Codex

```bash
codex
```

发一条简单请求，确认 Provider 正常工作。

## 排查问题

请求失败时，对照 Codex 终端输出和控制台用量日志排查。常见原因：

* 模型名写错（以模型广场为准）。
* Base URL 格式不对（只填到 `/v1`，不要多加路径）。
* 环境变量没被当前终端读取（重开终端或 `source` 配置文件）。