---
title: "Codex 与 ChatGPT 桌面端配置其他模型"
description: "Codex CLI、IDE 扩展和 ChatGPT 桌面 App 里的 Codex 读同一份 ~/.codex/config.toml。加一段 CodingPass 的 provider，设好 API Key 就能用。"
url: https://codingpass.ai/zh/blog/use-custom-models-in-codex-and-chatgpt-desktop
language: zh-CN
updated: 2026-11-19
---
# Codex 与 ChatGPT 桌面端配置其他模型

Codex 的三个入口共用一份配置。加一段 provider、设好 Key，终端、IDE 和桌面 App 就都能用。

[CodingPass 团队](https://codingpass.ai/zh/about) 发布于 2026年11月19日 更新于 2026年11月19日 阅读约 12 分钟

终端里的 Codex CLI、编辑器里的 Codex 扩展和 ChatGPT 桌面 App 里的 Codex，读的是同一份 `~/.codex/config.toml`。在里面加一段 CodingPass 的 provider，三个入口都能用 CodingPass 的模型。只想看速查的，见 [Codex 接入指南](https://codingpass.ai/zh/tools/codex)。

## Codex 和它的三个入口

Codex 是 OpenAI 做的编程 Agent。它在你的项目目录里读代码、改文件、跑命令，命令在沙箱里执行，越过沙箱边界时停下来等你批准。除了对话式地写代码，它还能用 `/review` 审查改动，用 `codex exec` 在脚本和 CI 里非交互地跑任务。CLI 是开源的。

入口有三个：

- **终端**：`codex` 命令，用 npm 安装。
- **IDE 扩展**：VS Code 等编辑器里的 Codex 插件。
- **桌面 App**：现在装在 ChatGPT 桌面 App 里（macOS 上是 `ChatGPT.app`，内部标识仍是 `com.openai.codex`），App 自带一份 codex 程序，版本和你装的 CLI 不一定相同。

这三个都在本机运行，模型请求发到哪里，由 `config.toml` 里的 `model_provider` 决定。云端的 Codex 任务不读这份文件，接不了自定义 provider。

Codex 的内置模型目录只有 OpenAI 的模型。接上 CodingPass 以后，Go 档默认用 GPT-6.1 Terra，Plus 和 Pro 可以用 GPT-6.2 Sol；同一个 Key 也能调 Claude、Gemini 等其他模型，只是 Codex 没有这些模型的元数据，会打一行警告。

## 接入步骤

### 准备

- 装好 Codex CLI：`npm install -g @openai/codex@latest`。用桌面 App 的，装好 ChatGPT 桌面 App。
- 在 CodingPass 控制台的 Keys 页新建一个 Key，复制下来，格式是 `cp-live-…`。

### 第一步：写 config.toml

把下面这段放进 `~/.codex/config.toml`，文件不存在就新建：

```
model = "gpt-6.1-terra"
model_provider = "codingpass"

[model_providers.codingpass]
name = "codingpass"
base_url = "https://codingpass.ai/v1"
env_key = "CODINGPASS_API_KEY"
wire_api = "responses"
```

`base_url` 要带 `/v1`，少了会报 404。Go 档用 `gpt-6.1-terra`，Plus 和 Pro 可以把 `model` 换成 `gpt-6.2-sol`。

### 第二步：设好 Key

`env_key` 写的是环境变量的名字，不是 Key 本身。把 Key 写进 shell 的启动文件（zsh 是 `~/.zshrc`，bash 是 `~/.bashrc`），再开一个新终端：

```
export CODINGPASS_API_KEY="cp-live-…"
```

### 第三步：在终端里跑起来

进项目目录，运行 `codex`。状态栏显示 GPT-6.1 Terra，发一句话能拿到回复，就接好了。

![Codex CLI 0.170.0 终端界面：发送 Say hi in five words，回复 Hi there, friend! How are you?，状态栏显示 GPT-6.1 Terra](https://codingpass.ai/assets/img/tools/codex/tui-model.webp)

*不用登录 ChatGPT，状态栏显示 config.toml 里设的模型。*

想确认 Key 有没有被读到，运行 `codex doctor`，auth 一栏会写 `provider auth env var CODINGPASS_API_KEY (present)`。

### 第四步：在桌面 App 里用

完全退出桌面 App（macOS 上按 ⌘Q），再打开，新建一个会话发一句话。

![ChatGPT 桌面 App 里的 Codex 会话：发送 Say hi in five words，回复 Hi there, hope you are well!，模型位置显示 6.1 Terra](https://codingpass.ai/assets/img/tools/codex/desktop-session.webp)

*桌面 App 读同一份 config.toml，模型显示为 6.1 Terra。*

模型位置显示 6.1 Terra，后面跟的 Light 之类是推理强度。

我们实测从 Dock 打开的 App 能读到 `~/.zshrc` 里的 Key；万一你那边读不到，把配置里的 `env_key` 那行换成 `experimental_bearer_token = "cp-live-…"`，再重开 App。

以后改了 `config.toml`，终端里重开 `codex`，桌面 App 也要完全退出再打开。

作者 CodingPass 团队

CodingPass 由我们运营。每篇指南发布前，都会在对应工具的最新稳定版上实测一遍。发现内容过时了？写信到 [support@codingpass.ai](mailto:support@codingpass.ai)。

## 相关阅读。

指南

### [Codex 接入指南](https://codingpass.ai/zh/tools/codex)

provider 配置、各档位的默认模型，三步接入。

指南

### [CC Switch 接入指南](https://codingpass.ai/zh/tools/cc-switch)

从 Key 页一键导入，在 CodingPass 和官方登录之间切换。

规则

### [额度和上限怎么算](https://codingpass.ai/zh/usage-limits)

每个套餐、每个模型的额度和上限，以及 429 响应。
