在 ChatGPT App 中使用 Kitcoding

ChatGPT App 内置了 Codex，会直接复用 Codex CLI 的供应商配置。根据你的需求选一种接入方式：

你的情况	用哪种	难度
想保留 ChatGPT 登录态（Codex Mobile、插件、官方额度查询照常用），同时让请求走 Kitcoding	方案 A ⭐ 最常用	改 2 个文件，约 5 分钟
不在乎 ChatGPT 登录，只想让 App 用上 Kitcoding	方案 B	最简单
App 卡在登录页进不去	方案 C	备用

---

方案 A：保留 ChatGPT 登录 + 用 Kitcoding 额度

开始之前，准备三样东西

#	需要什么	怎么确认
1	一个 ChatGPT 账号	免费号也行，能登录 ChatGPT App 即可
2	装好 Codex	终端跑 codex --version 有版本号输出。没装见 安装 Codex
3	一个 Kitcoding 令牌	分组要含 Codex 可用模型（推荐 Codex专用）。没有就去 创建 API 令牌

---

第 1 步：先登录 ChatGPT（顺序不能反）

⚠️ 必须先登录，再改配置

如果先改配置文件再登录，登录流程会把你写的配置覆盖掉，前功尽弃。所以第一步一定是登录。

1. 打开 ChatGPT App（或终端运行 codex，选择用 ChatGPT 账号登录）。
2. 完成登录，能正常发消息。
3. 确认登录成功后，先把 App 完全退出（Cmd + Q / Ctrl + Q），再往下做。

---

第 2 步：找到 Codex 配置目录

两个要改的文件都在这个目录里：

macOS

~/.codex

打开方式：访达 → 按 Command + Shift + G → 粘贴 ~/.codex → 回车
（这是隐藏目录，直接翻文件夹是看不到的）

Windows

%userprofile%\.codex

打开方式：按 Win + R → 粘贴 %userprofile%\.codex → 回车

目录或文件不存在？

说明 Codex 还没跑过。先在终端运行一次 codex（随便发一句话再退出），它会自动创建 ~/.codex/ 和里面的文件。

如果目录在但缺某个文件，手动新建一个同名文件即可（注意不要带 .txt 后缀）。

---

第 3 步：改 auth.json

用文本编辑器打开 ~/.codex/auth.json。

⚠️ 不要清空这个文件

你刚登录完，这个文件里有 tokens、account_id 之类的字段——那是你的 ChatGPT 登录凭据，删了就得重新登录。

这一步只是改两个字段的值，其余原样不动。

打开后，只确保这两个字段是下面的值（有就改、没有就加）：

"auth_mode": "chatgpt",
"OPENAI_API_KEY": null,

改完整个文件大概长这样（tokens 那些是你自己的，不用管）：

{
  "auth_mode": "chatgpt",
  "OPENAI_API_KEY": null,
  "tokens": { "...": "登录后自动生成的，原样保留" },
  "last_refresh": "..."
}

这两个字段的作用：

• "auth_mode": "chatgpt" —— 告诉 Codex：鉴权方式仍然是 ChatGPT 登录态，别把我登出
• "OPENAI_API_KEY": null —— 清空这里的 Key（真正的 Kitcoding 令牌下一步写到另一个文件里）

---

第 4 步：改 config.toml

打开 ~/.codex/config.toml，加入以下内容（文件里已有其他配置的话，把这些追加进去，[model_providers.custom] 整段放在文件末尾）：

model = "gpt-5.6-sol"
model_provider = "custom"

[model_providers.custom]
name = "custom"
base_url = "https://kitcoding.com/v1"
wire_api = "responses"
experimental_bearer_token = "把这里换成你的 Kitcoding 令牌"
requires_openai_auth = true

逐行说明：

字段	作用	能不能改
model	用哪个模型	可以，但必须照抄 模型广场 的 ID
model_provider	指向下面那段配置	要和 [model_providers.xxx] 里的 xxx 一致
base_url	Kitcoding 的入口	必须带 /v1
experimental_bearer_token	你的 Kitcoding 令牌	换成自己的
requires_openai_auth	保住 ChatGPT 登录态的关键	别删

---

第 5 步：完全退出 App，再重新打开

⚠️ 只关窗口没用

ChatGPT App 会驻留后台，继续用旧配置。这是「我明明改了配置却不生效」的头号原因。

• macOS：菜单栏 ChatGPT → Quit ChatGPT，或 Cmd + Q
• Windows：文件 → Quit，或 Ctrl + Q

退干净之后再重新打开。

重新打开后发一条消息，能正常回复即配置完成。

---

方案 B：复用 Codex CLI 配置

1. 先确认 Codex CLI 已配好，终端里运行 codex 能正常对话。
2. 安装并打开 ChatGPT App，它读到现有的 ~/.codex/config.toml 后即可直接使用。

---

方案 C：在 App 里直接填 API Key

如果打开后仍停在 登录 ChatGPT 页面：

1. 先按上面的方法完全退出 App，确认 CLI 配置有效，再重新打开一次。
2. 仍是登录页 → 点 使用其他方式登录。
3. 把 Kitcoding 令牌（含 Codex 可用模型的分组，如 Codex专用）粘进 OpenAI API 密钥，点 继续。
4. 进入后发一条测试消息，能正常回复即配置成功。

---

排查

现象	原因与解法
改了配置没反应	App 没完全退出。用 Cmd/Ctrl + Q，别只关窗口
额度没扣到 Kitcoding	base_url 漏了或没带 /v1，请求打到了 OpenAI 官方
横幅显示 provider: openai	model_provider 没写，或拼写和 [model_providers.xxx] 对不上
被登出了 ChatGPT	顺序反了——先登录再改配置。重新登录一次，然后只改 config.toml
历史对话全不见了	改过 provider 名。会话按 provider 名隔离，改回原名即可找回；或用 codex-provider-sync 迁移
报 reserved built-in provider	provider 名不能叫 openai 或 ollama，换个名字
报未知配置字段	跑 codex --strict-config exec "hi" 定位，多半是抄了老模板里的废弃字段
模型不存在 / 404	模型 ID 要照抄 模型广场；确认令牌分组里含这个模型
报鉴权错误	去掉 requires_openai_auth 试试，改用 env_key = "KITCODING_API_KEY" 并在环境变量里设置该 Key

---

会话迁移

从 Codex 官方账户切换到 Kitcoding 后，如需保持对话历史，可使用 codex-provider-sync 工具进行会话同步。

还有问题？

• 完整的 Codex 配置说明 → 配置 Codex
• 加客服微信 kitcoding 咨询