Codex 接入指南
provider 配置、各档位的默认模型,三步接入。
终端里的 Codex CLI、编辑器里的 Codex 扩展和 ChatGPT 桌面 App 里的 Codex,读的是同一份 ~/.codex/config.toml。在里面加一段 CodingPass 的 provider,三个入口都能用 CodingPass 的模型。只想看速查的,见 Codex 接入指南。
Codex 是 OpenAI 做的编程 Agent。它在你的项目目录里读代码、改文件、跑命令,命令在沙箱里执行,越过沙箱边界时停下来等你批准。除了对话式地写代码,它还能用 /review 审查改动,用 codex exec 在脚本和 CI 里非交互地跑任务。CLI 是开源的。
入口有三个:
codex 命令,用 npm 安装。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 没有这些模型的元数据,会打一行警告。
npm install -g @openai/codex@latest。用桌面 App 的,装好 ChatGPT 桌面 App。cp-live-…。把下面这段放进 ~/.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。
env_key 写的是环境变量的名字,不是 Key 本身。把 Key 写进 shell 的启动文件(zsh 是 ~/.zshrc,bash 是 ~/.bashrc),再开一个新终端:
export CODINGPASS_API_KEY="cp-live-…"进项目目录,运行 codex。状态栏显示 GPT-6.1 Terra,发一句话能拿到回复,就接好了。

想确认 Key 有没有被读到,运行 codex doctor,auth 一栏会写 provider auth env var CODINGPASS_API_KEY (present)。
完全退出桌面 App(macOS 上按 ⌘Q),再打开,新建一个会话发一句话。

模型位置显示 6.1 Terra,后面跟的 Light 之类是推理强度。
我们实测从 Dock 打开的 App 能读到 ~/.zshrc 里的 Key;万一你那边读不到,把配置里的 env_key 那行换成 experimental_bearer_token = "cp-live-…",再重开 App。
以后改了 config.toml,终端里重开 codex,桌面 App 也要完全退出再打开。