> ## 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/jetbrains/provider-codex.png?fit=max&auto=format&n=kz4nt5KFSKzkAZwe&q=85&s=42e82b5edf5481f5fbe9972e8de2bec0" alt="Codex 供应商页" width="100%" data-path="images/jetbrains/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. 重启 IDE

授权只读，不覆盖这两个文件。可随时取消。

## 自定义模型和环境变量

每个 Codex 供应商可以追加模型：

* 模型 ID 必填
* 显示名和描述可选
* 可单独填上下文窗口（单位 K tokens）

还可以给对话进程和 MCP 工具发现进程分别加环境变量。内置受保护变量不能覆盖。

## 和 Claude 的差异

| 能力      | Codex                     |
| ------- | ------------------------- |
| 规划模式    | 无                         |
| 权限 / 沙箱 | 在 **设置 → 权限配置** 单独调       |
| Fast 模式 | 输入框底部有开关                  |
| 中止请求    | 安静中断，不弹 ERROR 气泡          |
| Skills  | 支持 Codex Skills（`$` 前缀调用） |
| MCP     | 与 Claude 分开展示，互不覆盖        |

## 使用统计

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

## 下一步

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