已经装好 Codex？粘贴密钥、选择模型，一次完成连接；需要时还能一键恢复。
这是一个面向普通用户的开源桌面配置工具。它不会下载、安装或重新打包 Codex App；客户只需输入自己的 API Key 并选择模型，工具会安全地把现有 Codex 指向固定地址：
https://www.ydata.space/v1
Note
本项目是独立社区工具，不隶属于 OpenAI，不包含 Codex、账号或预置密钥。API Key 始终由用户自行输入。
|
感谢 Ydata 赞助本项目的公开构建与持续维护。 Ydata 为本发行版提供固定的 OpenAI 兼容中转入口。需要使用本工具的用户，可先在 Ydata 获取自己的密钥，然后回到配置助手粘贴使用；无需手工编辑 TOML、JSON 或环境变量。 访问 Ydata 中转站 → |
赞助信息公开展示，不影响本项目的 MIT 开源许可。服务条款、价格与可用模型以 Ydata 网站的当前说明为准。
前往 GitHub Releases 下载最新版：
- Windows：
ydata-configurator-*-windows-x64-setup.exe，支持 64 位 Windows 10/11。 - macOS：
ydata-configurator-*-macos-universal.dmg，同时支持 Apple Silicon 和 Intel。 - 完整性校验：下载同一发布页中的
SHA256SUMS.txt。
使用只需五步：
- 独立安装并至少启动一次 ChatGPT / Codex App。
- 打开 Ydata 配置助手。
- 粘贴自己的 API Key。
- 读取并选择模型；接口暂时无法列出模型时，也可手工输入模型 ID。
- 点击“验证并完成配置”，完成后重新打开 ChatGPT / Codex App。
当前公开安装包尚未进行商业代码签名。macOS 首次打开时可在 Finder 中右键应用并选择“打开”；Windows 可能显示 SmartScreen 提示。商业分发建议配置 Apple Developer ID、公证和 Windows Authenticode 证书。
- 地址已经内置：固定使用
https://www.ydata.space/v1，客户不会误填中转地址。 - 不用手改配置：自动合并
~/.codex/config.toml与~/.codex/.env，保留已有 MCP、注释和其他设置。 - 安全可恢复：首次运行建立基线，每次修改前建立快照，写入失败自动回滚。
- 随时重新配置：可更换密钥或模型，也可一键恢复到首次使用本工具之前的状态。
- 密钥相互隔离：使用独立变量
YDATA_API_KEY，不覆盖官方登录缓存。 - 不碰登录凭据：不会读取、复制或修改
auth.json正文。 - 中文无需下载：检测 Codex 安装包已内置的中文资源，并设置
desktop.localeOverride = "zh-CN"；整个过程不访问外部语言包地址。 - 真正跨平台：同一套代码在 GitHub 原生 Windows 与 macOS Runner 上分别构建安装包。
工具会无损合并以下 Codex 配置：
model = "<用户选择的模型>"
model_provider = "ydata"
[model_providers.ydata]
name = "Ydata"
base_url = "https://www.ydata.space/v1"
env_key = "YDATA_API_KEY"
wire_api = "responses"
[desktop]
localeOverride = "zh-CN"密钥单独保存在当前用户的 ~/.codex/.env：
YDATA_API_KEY=<用户输入的密钥>首次基线和最近最多 10 次操作快照保存在当前用户的应用数据目录：
- macOS：
~/Library/Application Support/space.ydata.codex-configurator/ - Windows：
%APPDATA%\space.ydata.codex-configurator\
快照只保存在本机，可能包含历史 config.toml 和 .env，不会上传；auth.json 不进入快照。更多信息见 安全说明。
本项目也可作为白标模板使用。Fork 后只需修改根目录的 brand.config.json，即可在构建时固定自己的：
- 品牌名与安装包名称
- 请求地址与供应商节点
- API Key 环境变量名
- 应用包 ID 与独立恢复目录
- Windows、macOS 应用图标
最终用户仍然只需要输入密钥，不会看到运行时地址切换器。完整说明见 自定义品牌与中转站。
中转站维护者不需要逐个找文件。Fork 本仓库后，把项目目录交给 Codex、Claude Code 或其他可直接修改代码的 Agent，再准备以下资料：品牌名、固定 /v1 地址、环境变量名、唯一应用包 ID、官网地址、GitHub 仓库地址和一张有合法使用权的方形 Logo。
把下面这段提示词中的占位内容替换后，直接发给 Agent：
请把这个配置助手完整定制为我的中转站发行版，并在完成后构建验证。
品牌名：<品牌名>
产品名：<品牌名> ChatGPT 配置助手
固定请求地址：<https://你的域名/v1>
providerId：<小写英文标识>
密钥环境变量：<YOURBRAND_API_KEY>
应用包 ID：<com.yourbrand.codex-configurator>
官网：<https://你的官网>
GitHub 仓库：<owner/repo>
Logo 文件：<本地图片路径>
要求：
1. 最终用户只能输入自己的 API Key 和选择模型，不能修改固定请求地址，也不能预置任何密钥。
2. 统一更新 brand.config.json、应用/窗口/安装包名称、Rust 与 npm 包元数据、README、赞助区、仓库链接、发布文件名和所有平台图标。
3. providerId、环境变量名和 bundleIdentifier 必须独立，不能沿用原发行版，以免配置节点和恢复快照串用。
4. 保留无损合并、失败回滚、一键恢复、中文启用和“不读取或修改 auth.json 正文”的行为。
5. 用新 Logo 运行 npm run icon，生成 Windows ICO、macOS ICNS 和全部 PNG。
6. 全仓扫描并清除旧品牌、旧域名和旧包名；但不要修改依赖包中的无关文本。
7. 运行 brand:prepare、typecheck、renderer build、Rust tests、cargo fmt check 和 cargo check。
8. 将版本号升级一个 minor 版本，按 CHANGELOG 生成发布说明；不要提交密钥、target、dist 或 node_modules。
9. 输出 Windows x64 安装包、macOS Universal DMG、SHA256SUMS.txt，并核验发布页下载链接。
Agent 完成后，站长仍应亲自确认地址、品牌授权、安装包签名状态和真实密钥联调结果。更完整的字段约束与验收清单见 Agent 换牌指南。
需要 Node.js 22、Rust 1.85 或更高版本，以及平台对应的 Tauri 2 系统依赖。
npm ci
npm run dev提交前验证：
npm run brand:prepare
npm run typecheck
npm run build:renderer
npm run test:rust
cargo fmt --manifest-path src-tauri/Cargo.toml -- --check
cargo check --locked --manifest-path src-tauri/Cargo.toml本地构建当前平台安装包：
npm run build推送 v* Tag 后，发布流水线 会在 macOS 与 Windows 原生 Runner 上生成通用 DMG、x64 NSIS 安装包和 SHA-256 校验文件，并自动创建 GitHub Release。手动触发只构建测试产物，不创建正式发布页。
不会。它只配置已经安装好的 Codex / ChatGPT 桌面端和 Codex CLI。
Ydata 地址在构建时已经固定，客户只需粘贴密钥。这样可以减少误配置，也避免把配置助手变成复杂的供应商切换器。
可以。首次修改前会保存基线，点击“恢复原配置”即可还原 config.toml、.env 和语言设置。
不需要。本工具只启用 Codex 安装包中已经存在的简体中文资源。如果当前 Codex 版本没有内置中文资源，助手会明确提示，不会从外网下载未知文件。
