# Codex CLI

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

Language: zh-TW

> 在 Codex CLI 中使用 aicentos —— 手動設定 config.toml 的 model_providers

Codex CLI 是 OpenAI 官方的命令列編碼代理，透過 `~/.codex/config.toml` 定義模型供應商。把自訂 provider 指向 aicentos，即可在終端機裡使用 aicentos 接入的模型。

如果你更想用圖形化方式管理多套設定，也可以走 [CC Switch](https://docs.aicentos.com/zh-TW/clients/cc-switch) 一鍵切換；本文只講手動設定。

## 準備工作

先在控制台「API Key」頁面為 Codex CLI 建立一個專用 Key（建議命名 `codex-cli`，方便追蹤用量）：

* 控制台：[https://aicentos.com](https://aicentos.com)
* 建立 Key：[https://aicentos.com/keys](https://aicentos.com/keys)
* 餘額不足時儲值：[https://aicentos.com/wallet](https://aicentos.com/wallet)

確認已安裝 Codex CLI：

```bash
codex --version
```

## 需要填寫的設定

| 欄位           | 值                         |
| ------------ | ------------------------- |
| Provider ID  | `aicentos`                |
| Provider 名稱  | `aicentos`                |
| API Key 環境變數 | `AICENTOS_API_KEY`        |
| Base URL     | `https://aicentos.com/v1` |
| 模型           | 控制台「模型廣場」中的模型名稱           |

## 設定步驟

### 1. 設定 API Key 環境變數

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

需要永久生效就寫進 `~/.zshrc` 或 `~/.bashrc`，然後 `source` 一下，並用 `echo $AICENTOS_API_KEY` 確認。

### 2. 編輯 config.toml

在 `~/.codex/config.toml` 中加入：

```toml
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)。

### 3. 啟動 Codex

```bash
codex
```

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

## 測試

```
codex exec "用一句話回答：1+1 等於幾"
```

能正常返回內容即接入成功，返回的內容會消耗少量額度，可在控制台用量日誌裡核對。

## 注意事項

* **Base URL 只填到 `/v1`**，不要補成 `/v1/chat/completions` 的完整路徑。
* `base_url`、`env_key` 等欄位只在使用者層級 `~/.codex/config.toml` 生效。寫在專案內的 `.codex/config.toml` 會被忽略，並可能出現啟動警告。
* `wire_api` 填 `responses`，對應 aicentos 的 [Responses 介面](https://docs.aicentos.com/zh-TW/api/chat/openai/responses)。官方文件目前只支援該取值；若你的版本回報 `unknown variant`，表示 CLI 過舊，建議先升級。
* `openai`、`ollama`、`lmstudio` 是保留的 provider ID，**不能**透過改寫內建 `openai` 的 base\_url 來指向第三方閘道，必須新起一個 provider 名稱（本文用的是 `aicentos`）。
* 排查順序：模型名稱是否與控制台一致 → Base URL 是否只到 `/v1` → 環境變數在**啟動 codex 的那個終端機**裡是否可見 → 帳戶餘額是否充足。

## 相關連結

* [接入 Codex（CC Switch 方式）](https://docs.aicentos.com/zh-TW/clients/codex)