使用文档 / Codex 一键配置

Codex 一键配置

Windows 一键配置包，连接 Codex App、CLI 与本机 IDE 插件。选择你已安装的客户端，填入自己的 API Key。

Codex 是用于编程的官方客户端，可配置第三方推理服务。ChatGPT 聊天应用使用独立的账号与服务，本教程适用于 Codex。

(一) 前置要求

本页一键配置包适用于 Windows。请先安装 Codex App，或安装 Codex CLI；已有可用的 Codex App 无需先安装 npm 或 CLI。使用 CLI 时，可通过 npm install -g @openai/codex 安装（需要 Node.js）。
在玄枢控制台创建自己的 API Key。
配置包及相关文件请加 QQ 群 1131848390 获取。

(二) 一键配置包能做什么

写入 ~/.codex/config.toml：设置玄枢为推理提供方（base_url = "https://api.ai-trailblazer.com/v1"），默认模型 gpt-6.1-sol。
写入 ~/.codex/auth.json：存入你的 API Key（本地 DPAPI 加密备份，Key 不进日志）。
保留你现有的所有 Codex 配置：其他 model_provider、注释、自定义顶层键全部保留，只修改/插入玄枢相关部分。
支持一键恢复：双击 恢复配置.bat 把 config.toml 和 auth.json 精确还原到运行前状态。
本机 Codex CLI、Codex App 与 IDE 插件在同一用户、同一配置目录下可复用配置。自定义 CODEX_HOME、WSL、容器或远程开发环境，请分别确认实际使用的目录。

(三) 使用步骤

从 QQ 群 1131848390 获取配置包 ZIP，完整解压到任意可读目录（不要在 ZIP 预览里直接运行）。
在解压后的文件夹中，用记事本打开 gpt-config.json，搜索 apiKey 字段：
```
"apiKey": "",
```
在两个英文双引号之间粘贴你自己的完整 API Key：
```
"apiKey": "在这里粘贴你自己的完整 Key",
```
保存文件，保留英文引号与逗号，其余字段先保持原样。
双击 一键配置.bat（普通双击，不需要管理员）。
等待配置完成，重新打开 Codex App 或 IDE 插件；使用 CLI 时，在项目目录运行 codex。新建会话，发送一条简单消息确认回复。

(四) 可用模型

配置包默认 gpt-6.1-sol。想换默认模型时，修改 gpt-config.json 里的 defaultModel 字段，保存后重新运行 一键配置.bat，再重启相应客户端或新建会话，使写入的配置生效。支持的 GPT/Codex 模型：gpt-6.1-sol（默认）、gpt-6-astra、gpt-6-sol、gpt-5.6-terra、gpt-5.6-sol、gpt-5.5、codex-auto-review。

(五) 常见问题

401 / invalid_api_key：Key 填错或已禁用，回控制台核对。
model_not_found：模型名写错，参考上面列表。
连不上：确认 base_url 是 https://api.ai-trailblazer.com/v1（带 /v1）。
CLI 提示 codex 未找到：使用 CLI 时，先运行 codex --version 确认安装；未安装可执行 npm install -g @openai/codex（需要 Node.js）。只使用 Codex App 时，直接重新打开 App。
不想动现有 Codex 配置：双击 恢复配置.bat 完整还原。

先确认正在使用的配置目录。 默认是当前用户的 ~/.codex/；设置 CODEX_HOME 时，以该目录为准。Windows 本机、WSL、远程主机与容器各有自己的用户目录。本机一键配置不会同步到这些环境，请在运行客户端的环境中分别配置。

(六) 手动配置（可选）

不使用一键包时，可按 Codex 手动配置概览编辑实际配置目录中的 config.toml 与 auth.json。Windows 默认目录为 C:\Users\你的用户名\.codex\；使用 CODEX_HOME 时请改为其指定目录。Mac、Linux、WSL 与远程环境请使用对应平台教程。