登录选套餐
博客 · 接入指南

Codex 与 ChatGPT 桌面端配置其他模型

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

终端里的 Codex CLI、编辑器里的 Codex 扩展和 ChatGPT 桌面 App 里的 Codex,读的是同一份 ~/.codex/config.toml。在里面加一段 CodingPass 的 provider,三个入口都能用 CodingPass 的模型。只想看速查的,见 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
不用登录 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
桌面 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 也要完全退出再打开。

出发

Codex 照用,账单按月固定。

加一段 provider,GPT-6.1 Terra 每月 起。不会意外扣费,随时取消。

  • 每个响应都带请求 ID
  • 用量不超过 5% 可全额退款
  • 不会意外扣费
选 GoCodex 指南

每月 $10,直到你取消。