Codex 接入指南
在 OpenAI Codex CLI 命令行编程工具与 Codex++ 桌面增强版启动器中配置 疾旋Token，畅享旗舰级代码重构与毫秒级终端补全。
OpenAI Codex 是一款专为开发者构建的终端 AI 交互式编程与代码自动化生成工具。它基于新一代 OpenAI Responses API 协议设计，支持对整个项目工作区进行语法感知、文件编辑和命令行沙箱执行。
除了官方终端 CLI 工具外，社区还推出了功能强大的 Codex++ 桌面增强版启动器，让您在无需修改任何底层二进制文件的前提下，可视化配置第三方 API 代理并自由切换主力推理模型。
🛠️ 第一部分：Codex CLI 终端配置指南
Codex CLI 的全局配置文件位于用户主目录下的 ~/.codex/ 文件夹中。
配置主配置文件 ~/.codex/config.toml
打开（或新建）~/.codex/config.toml 文件，并添加以下符合官方 Schema 规范的配置：
#:schema https://developers.openai.com/codex/config-schema.json
# 指定采用 API Key 鉴权方式
preferred_auth_method = "apikey"
# 指定当前激活的模型服务商与默认模型
model_provider = "jixuan"
model = "GPT-5.6-sol"
# 定义疾旋Token 专属提供商参数
[model_providers.jixuan]
name = "疾旋Token"
base_url = "https://token.astrumflow.com/v1"
wire_api = "responses"
requires_api_key = true
env_key = "OPENAI_API_KEY"配置要点说明：
wire_api = "responses"：指定采用 OpenAI 新一代 Responses 协议，确保长程代码生成与 Tool 执行回路的完整支持。base_url：请确保以/v1结尾，且末尾不要带额外的斜杠。
配置认证密钥 ~/.codex/auth.json
在 ~/.codex/auth.json 中保存您的 API 密钥：
{
"OPENAI_API_KEY": "sk-your-astrumflow-token-key"
}或者直接在环境变量中导出：
export OPENAI_API_KEY="sk-your-astrumflow-token-key"启动并验证 Codex CLI
在终端中执行以下命令校验配置并启动会话：
# 严格检查配置文件语法并启动
codex --strict-config进入交互终端后，即可输入代码生成或重构指令（例如：“为当前仓库编写 Dockerfile 和 CI 工作流”）。
💻 第二部分：Codex++ (桌面增强版启动器) 接入
Codex++（如 BigPizzaV3/CodexPlusPlus 或 b-nnett/codex-plusplus）是针对 Codex 桌面端开发的增强型启动器。它基于 Chromium DevTools Protocol (CDP) 动态注入能力，免去直接篡改主程序文件的风险，提供图形化的多服务商管理面板。
下载并安装 Codex++
前往 Codex++ 的 GitHub Releases 页面，下载对应操作系统的安装包：
- Windows：下载
.exe安装程序 - macOS：下载
.dmg镜像（支持 Intel 及 Apple Silicon 芯片）
添加疾旋Token 自定义服务商
- 启动 Codex++ 客户端。
- 进入 Settings (设置) -> Provider Management (服务商管理)。
- 点击 「Add Custom Provider (添加自定义服务商)」：
- Provider Name：
疾旋Token - Base URL：
https://token.astrumflow.com/v1 - API Key：粘贴您的
sk-your-astrumflow-token-key - Model IDs：填入
GPT-5.6-sol、GPT-5.6-terra等可用模型
- Provider Name：
- 点击 Save (保存)。
启动增强版 Codex 桌面端
在 Codex++ 首页选择 疾旋Token 节点，点击 「Launch Codex (启动增强版)」。系统将自动以注入模式拉起桌面客户端，您可以在图形界面中自由切换模型、导出 Markdown 会话记录并享受全权限系统调用。
🔍 配置优先级与故障排查
Codex CLI 的配置读取严格遵循以下优先级（由高到低）：
- 命令行参数（如
--config或--model） - Profile 配置文件（
$CODEX_HOME/<profile>.config.toml） - 项目级局部配置（受信任项目根目录下的
.codex/config.toml） - 全局用户配置（
~/.codex/config.toml）
项目级配置限制：出于安全考虑，项目目录下的 .codex/config.toml 无法覆盖敏感的安全字段（如 model_provider 或认证密钥），请务必在全局 ~/.codex/config.toml 中配置 [model_providers]。