ChatGPT 编程智能体

ChatGPT App 编程智能体配置

这份教程适合第一次使用 ChatGPT Desktop App 编程智能体的同事。OpenAI 现在把 Codex 放进 ChatGPT 里使用，你可以把它理解为 ChatGPT 里的 Codex 编程模式。

标注：旧截图和部分配置路径仍可能显示 Codex；实际使用入口以新版 ChatGPT Desktop App 为准，配置文件目录仍使用 .codex。

下载入口：chatgpt.com/download。

Coding Hub 入口：https://coding-hub.sonic.nyc.mn

11核心步骤
macOS / Windows双系统覆盖
codex订阅密钥分组
ChatGPT App 编程智能体配置全流程

导读

你可以让它写代码、改代码、查 bug、补测试、解释项目代码和整理技术文档。使用时只需要描述目标，例如“帮我看这个报错”“给这个项目加登录功能”“把需求整理成接口文档”。

为了兼容旧教程和本机配置，本文会在必要处保留 Codex 这个名字，例如 .codex 目录、codex订阅 分组和 Codex++ 工具名。

本教程只保留站点内必要内容，不包含外部文档附件或旧资料图片。

适用范围

你要做什么说明
申请 Coding Hub 账号使用邮箱在 https://coding-hub.sonic.nyc.mn 自助注册。
安装 ChatGPT AppmacOS / Windows 使用 OpenAI 官方 ChatGPT 下载入口。
配置模型接口在 Coding Hub 创建自己的 API 密钥，再把页面给出的配置写入 ChatGPT 的 Codex 配置目录。
开始使用模型配置完成后重启 ChatGPT App，发送一句测试问题确认可用。
API 密钥只给自己使用，不要发群、不要截图、不要写进公开网页或 Git 仓库。

1. 打开 Coding Hub

在浏览器打开下面的地址：

URL
https://coding-hub.sonic.nyc.mn

如果还没有账号，点击登录页下方的注册入口继续。

2. 注册账号

注册时填写你的邮箱，并设置一个至少 6 位的密码。建议使用企微邮箱，后续管理和排查问题会更清楚。

1
填写邮箱

使用你后续登录 Coding Hub 的邮箱。

2
设置密码

密码至少 6 位，避免和其他服务共用弱密码。

3
完成注册

注册成功后回到登录页。

3. 已有账号就直接登录

已有账号时，不需要重复注册。回到登录页输入邮箱和密码进入 Coding Hub。如果忘记密码，先联系管理员处理，避免创建多个账号导致密钥和额度分散。

4. 安装 ChatGPT App

新版入口使用 ChatGPT Desktop App。旧版 Codex App 用户可以直接更新到新版 ChatGPT；新用户从 ChatGPT 官方下载页安装。

系统下载地址
macOS，Apple Silicon / IntelDownload ChatGPT for macOS
WindowsDownload ChatGPT for Windows

macOS 用户

打开 ChatGPT 下载页后，按页面提示下载 macOS 安装包。安装完成后第一次打开，如果系统提示安全确认，按公司设备策略处理。

Windows 用户

  1. 打开 ChatGPT 官方下载页，或在 Microsoft Store 搜索 ChatGPT。
  2. 确认开发者为 OpenAI。
  3. 点击 获取 / 安装。
  4. 安装完成后从开始菜单启动，也可以固定到桌面或任务栏。
Windows 安装 ChatGPT App，旧截图中保留 Codex 字样
旧截图仅作入口示意；新版请搜索 OpenAI 发布的 ChatGPT。

安装完成后启动和初始化 ChatGPT App

打开 ChatGPT App 软件（Windows 可在开始菜单中找到并打开，建议从开始菜单拖动为桌面快捷方式）。

如果界面中仍显示 Codex，这是旧截图或旧入口名称；实际按 ChatGPT 的 Codex 编程智能体继续配置即可。初始化完成后先关闭 ChatGPT App，等后面写完配置再重新打开。

ChatGPT App 首次启动示意，旧截图中保留 Codex 字样
旧截图里显示 Codex；新版入口以 ChatGPT App 为准，后续仍写入 Coding Hub 的配置。

5. 在 Coding Hub 创建自己的 API 密钥

登录 Coding Hub 后进入密钥页面。如果你的系统提供快捷入口，可以从导航里进入；也可以尝试打开：

URL
https://coding-hub.sonic.nyc.mn/keys

点击 创建密钥。创建时重点检查 分组：

在 Coding Hub 创建自己的 API 密钥
创建密钥时填写名称，分组选择可用的 ChatGPT / Codex 分组，其他限制按需要开启。
  1. 名称可以写成 我的 ChatGPT 密钥 或其他方便识别的名称。
  2. 分组选择 codex订阅，这是历史分组名，当前仍用于 ChatGPT 编程智能体。
  3. 其他开关没有特殊要求时保持默认。
  4. 点击 创建，然后回到密钥列表。

6. 点击“使用密钥”，查看配置内容

在密钥列表里找到刚创建的密钥，点击 使用密钥。弹窗通常会给出三类信息：

  • config.toml 要写入的内容。
  • auth.json 要写入的内容。
  • macOS / Linux 和 Windows 对应的配置路径。

页面里的真实密钥只显示给你自己。下面示例里的 sk-这里替换成你自己的密钥 只是占位，实际操作时要复制 Coding Hub 页面显示的真实内容。

7. macOS 配置方法

7.1 创建配置目录

打开终端执行：

shell
mkdir -p ~/.codex

7.2 写入 config.toml

打开或新建这个文件：

plaintext
~/.codex/config.toml

把 Coding Hub 的“使用密钥”弹窗里 config.toml 内容复制进去，并放在文件最开头。示例：

toml
model_provider = "OpenAI"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://coding-hub.sonic.nyc.mn"
wire_api = "responses"
requires_openai_auth = true

7.3 写入 auth.json

打开或新建这个文件：

plaintext
~/.codex/auth.json

把 Coding Hub 页面里 auth.json 的内容复制进去。示例：

json
{
  "OPENAI_API_KEY": "sk-这里替换成你自己的密钥"
}

8. Windows 配置方法

8.1 打开配置目录

按 Win + R，输入：

plaintext
%userprofile%\.codex

如果目录不存在，就在用户目录下手动新建一个 .codex 文件夹。

8.2 写入 config.toml

在 .codex 文件夹里新建或打开：

plaintext
config.toml

把 Coding Hub 的“使用密钥”弹窗里 config.toml 内容复制进去，并放在文件最开头。示例：

toml
model_provider = "OpenAI"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://coding-hub.sonic.nyc.mn"
wire_api = "responses"
requires_openai_auth = true

8.3 写入 auth.json

在 .codex 文件夹里新建或打开：

plaintext
auth.json

把 Coding Hub 页面里 auth.json 的内容复制进去。示例：

json
{
  "OPENAI_API_KEY": "sk-这里替换成你自己的密钥"
}

9. 重启 ChatGPT App 并验证

配置完成后完全退出 ChatGPT App，再重新打开。Windows 直接点关闭有时不会结束后台进程，可以在任务管理器里结束 ChatGPT，或者直接重启电脑。

重新打开后发送一句测试问题：

plaintext
请用一句话介绍 Coding Hub。

如果能正常回复，说明配置已经生效。

10. Codex++ 使用教程

ChatGPT App 基础配置确认可用后，可以继续安装 Codex++。Codex++ 是独立工具名，当前仍按原名称保留；安装前先确认上一节的 ChatGPT App 已经能正常回复。

10.1 下载 Codex++

打开 CodexPlusPlus 的最新 Releases 页面，按自己的系统选择安装包。版本号会更新，不要只认固定版本，重点看文件名里的系统标识：

URL
https://github.com/BigPizzaV3/CodexPlusPlus/releases/latest
系统下载文件
Apple Silicon Mac，M1 / M2 / M3 / M4打开最新发布页
文件名包含 macos-arm64，后缀为 .dmg
Intel Mac打开最新发布页
文件名包含 macos-x64，后缀为 .dmg
Windows打开最新发布页
文件名包含 windows-x64，后缀为 .exe

10.2 Windows 安装

Windows：下载完成后直接一直下一步安装。安装结束后从开始菜单打开 Codex++ 或 Codex++ 管理工具。

10.3 macOS 安装

macOS：打开 dmg 文件，然后按图示把两个图标都拖到 Applications 中。

macOS 下载 Codex++ dmg 文件
下载完成后打开对应的 .dmg 文件。
把 Codex++ 和 Codex++ 管理工具拖到 Applications
把 Codex++ 和 Codex++ 管理工具 都拖到 Applications。

安装后，在应用程序中分别打开一次这两个应用。如果 macOS 弹出安全提示，进入 系统设置 → 隐私与安全性 → 安全性，点击允许后再打开。

macOS 打开 Codex++ 管理工具时的安全提示
首次打开时如果提示无法验证开发者，先进入系统设置处理。
macOS 隐私与安全性中允许 Codex++ 管理工具
在隐私与安全性里允许打开 Codex++ 管理工具。

10.4 配置 Codex++

打开 Codex++ 管理工具，进入网络配置页面，把 Coding Hub 提供的密钥和接口信息填进去。配置完成后点击 保存。

打开 Codex++ 管理工具
打开 Codex++ 管理工具后，进入网络配置。
Codex++ 管理工具中填写 Coding Hub 配置
按页面提示填写 Coding Hub 的 Key 和接口配置，然后点击保存。

保存后点击使用，然后重启 Codex++，即可解锁插件使用。

Codex++ 管理工具保存后点击使用
保存配置后点击“使用”，再重启 Codex++。

11. 如何把 ChatGPT 设置为中文界面

ChatGPT 默认界面可能是英文。可以进入设置手动切换中文：

  1. 打开 ChatGPT App。
  2. 点击左上角 ChatGPT 图标或菜单；Windows 可能需要从 File 进入。
  3. 进入 Settings。
  4. 选择 General。
  5. 找到 Language for the app UI，切换为中文。

常见问题

1. ChatGPT 打开后还是不能用

  1. 检查 auth.json 里的密钥是否完整复制。
  2. 检查 config.toml 是否放在文件最开头。
  3. 检查配置完成后是否完全重启 ChatGPT App。

2. Windows 找不到 .codex 文件夹

这是正常情况。按 Win + R 输入 %userprofile%，进入用户目录后手动新建 .codex 文件夹。

3. macOS 找不到 .codex 文件夹

打开终端执行：

shell
mkdir -p ~/.codex
open ~/.codex

4. 不知道应该复制哪段配置

回到 Coding Hub 的密钥列表，点击 使用密钥。页面会按系统给出配置内容：macOS / Linux 看对应标签，Windows 看 Windows 标签。

5. 密钥要不要分享给同事？

不要。每个人都应该创建自己的 API 密钥，这样额度、异常请求和问题排查都能定位到个人。