> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mossx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Codex

> 配置 Codex 供應商、本地 ~/.codex/ 授權、自訂模型和環境變數。

Codex 走 `@openai/codex-sdk`。配置寫入 `~/.codex/`，也可以授權讀取你已有的本地檔案。

先在 **設定 → SDK 依賴** 裝好 Codex SDK。安裝不完整（缺 CLI 完整性）時，狀態會顯示為未安裝。

<img src="https://mintcdn.com/mossx-docs/kz4nt5KFSKzkAZwe/images/vscode/provider-codex.png?fit=max&auto=format&n=kz4nt5KFSKzkAZwe&q=85&s=32bb525a650aadc438a9d088da341bc7" alt="Codex 供應商頁" width="100%" data-path="images/vscode/provider-codex.png" />

## 接入方式

### 新增供應商

點 **新增供應商**，填名稱和配置 JSON。介面按兩塊編輯：

* **config**：`model_provider`、`model`、`model_providers` 等
* **auth**：`OPENAI_API_KEY` 等認證欄位

也可以選 OpenAI 官方直連，或第三方 / 代理預設。官方直連使用 `https://api.openai.com`。

儲存後立即寫入 `~/.codex/`。

### 授權讀取本地配置

如果你已經在終端用過 Codex CLI：

1. 終端執行 `codex login`，確認能提問
2. 在 CC GUI 授權讀取 `~/.codex/config.toml` 和 `auth.json`
3. 重啟 VS Code

授權只讀，不覆蓋這兩個檔案。可隨時取消。

## 自訂模型和環境變數

每個 Codex 供應商可以追加模型：

* 模型 ID 必填，允許字母、數字、點、連字元、下劃線、斜槓、冒號
* 顯示名和描述可選
* 可單獨填上下文視窗（單位 K tokens）

還可以給兩類子程序加環境變數：

| 型別       | 用途            |
| -------- | ------------- |
| 訊息環境變數   | 發給 Codex 對話程序 |
| MCP 環境變數 | 發給 MCP 工具發現程序 |

變數名必須以字母或下劃線開頭。內建受保護變數不能覆蓋。

## 和 Claude 的差異

| 能力       | Codex                |
| -------- | -------------------- |
| 規劃模式     | 無                    |
| 許可權 / 沙箱 | 在 **設定 → 許可權配置** 單獨調 |
| Fast 模式  | 輸入框底部有開關             |
| 中止請求     | 安靜中斷，不彈 ERROR 氣泡     |
| 部分設定頁    | 個別入口可能暫未對齊 Claude    |

日常改程式碼用預設或代理模式即可。需要先出方案再改檔案時，換 Claude Code 的規劃模式。

## 使用統計

給模型補上輸入 / 輸出 / 快取價格後，**設定 → 使用統計** 才能估算費用。價格留空則用預設費率。

## 下一步

* [多供應商總覽](/zh-Hant/vscode/providers/overview)
* [檢測與安裝](/zh-Hant/vscode/providers/cli)
* [發出第一條訊息](/zh-Hant/vscode/start/first-task)