> ## 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 的规划模式。

## 使用统计

给模型补上输入 / 输出 / 缓存价格后，**设置 → 使用统计** 才能估算费用。价格留空则用默认费率。

## 下一步

* [多供应商总览](/vscode/providers/overview)
* [检测与安装](/vscode/providers/cli)
* [发出第一条消息](/vscode/start/first-task)