CodePassCodePassAI Coding Pass

Guide

OpenAI Codex 接入教程

OpenAI Codex 是终端里的 AI 编程工具。配置入口在 config.toml，按下面 5 步完成接入。

config.tomlCursor 教程 Claude Code 教程
开发工具OpenAI Codex
配置入口config.toml
接入字段openai_base_url 或 model_providers.*.base_url
额度消耗共用 API 额度池
1

打开 Codex 的配置入口

如果你使用 Codex 面板，在右上角找到齿轮图标，进入配置文件。路径：Codex Settings → Open config.toml。只有命令行时，直接编辑 ~/.codex/config.toml。

2

在用户中心复制 Codex 接入信息

回到 CodePass 用户中心，找到 OpenAI Codex 卡片，复制 baseUrl 和 API Key。

3

在 config.toml 里填写 CodePass 地址

两种方式任选：方式一最简单，只改一行；方式二更清晰，定义一个独立的模型供应商。注意：openai_base_url 只能写在用户级 ~/.codex/config.toml，不能写在项目级配置中。

方式一（最简单）

~/.codex/config.toml
openai_base_url = "https://api.codepass.dev/openai/v1"

方式二（更清晰）

~/.codex/config.toml
model = "gpt-5-codex"
model_provider = "codepass"

[model_providers.codepass]
name = "CodePass"
base_url = "https://api.codepass.dev/openai/v1"
env_key = "CODEPASS_API_KEY"
wire_api = "responses"
4

设置 CodePass 用户 Token

把你的 CodePass 用户 Token（cp_user_ 开头）设为环境变量，须与第 3 步所选方式一致：方式一用 OPENAI_API_KEY，方式二用 CODEPASS_API_KEY（与 config.toml 中 env_key 一致）。每次只复制并执行其中一种。

方式一 · OPENAI_API_KEY · Windows PowerShell

PowerShell
$env:OPENAI_API_KEY="cp_user_xxxxxxxxxxxxxxxx"

方式一 · macOS / Linux

bash / zsh
export OPENAI_API_KEY="cp_user_xxxxxxxxxxxxxxxx"

方式二 · CODEPASS_API_KEY · Windows PowerShell

PowerShell
$env:CODEPASS_API_KEY="cp_user_xxxxxxxxxxxxxxxx"

方式二 · macOS / Linux

bash / zsh
export CODEPASS_API_KEY="cp_user_xxxxxxxxxxxxxxxx"
5

重启 Codex 并测试

保存 config.toml 后，关闭 Codex 面板或终端，再重新打开，然后发一个简单问题。

测试提问
请用一句话介绍你现在使用的模型。

常见问题

接入过程中遇到报错，可先对照以下情况排查。