# Codex

來源: https://docs.aicentos.com/zh-TW/clients/codex

Language: zh-TW

> 在 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/zh-TW/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/zh-TW/billing/models-list)。

### 啟動 Codex

```bash
codex
```

發一條簡單請求，確認 Provider 正常運作。

## 排查問題

請求失敗時，對照 Codex 終端機輸出和控制台用量日誌排查。常見原因：

* 模型名稱寫錯（以模型廣場為準）。
* Base URL 格式不對（只填到 `/v1`，不要多加路徑）。
* 環境變數沒被目前終端機讀取（重開終端機或 `source` 設定檔）。