Codex++ 接入 TokenFlash

Codex++ 是面向 OpenAI Codex / ChatGPT 桌面应用的外部启动器与管理工具。本教程将指导你通过 Codex++ 接入 TokenFlash API 中转站。

目录

1. 工具简介
2. 前置准备
3. 安装 Codex++
4. 获取 TokenFlash API Key
5. 配置 TokenFlash 供应商
6. 测试连接
7. 开始使用
8. 常见问题

工具简介

Codex++ 通过 Chromium DevTools Protocol（CDP）和本地辅助服务增强 Codex 桌面应用，不修改官方应用的 app.asar，也不向安装目录写入补丁文件。

CDP 原理简述

CDP 是 Chrome/Chromium 的底层调试协议。Codex 桌面端基于 Electron（Chromium 内核），其界面本质是一个"网页"。Codex++ 通过 CDP 连接 Codex 的渲染进程，在运行时注入增强脚本，实现供应商切换、协议转换等功能，而无需修改任何原始文件。

Codex++ 启动 → 启动原版 Codex → CDP 连接渲染进程 → 注入增强脚本 → 增强功能生效

卸载只需删除 Codex++，Codex 完全不受影响。

主要功能包括：

• 供应商切换：支持官方登录、纯 API、混合模式和聚合供应商
• 协议转换：将 Chat Completions 转换为 Codex 使用的 Responses 协议
• 会话管理：支持批量删除、Markdown 导出和 Token 用量历史
• 界面增强：提供中文界面、插件管理、会话宽度和滚动恢复
• 聚合供应商：支持多个 API 供应商之间的故障转移和轮转

项目地址：https://github.com/BigPizzaV3/CodexPlusPlus

供应商模式说明

前置准备

开始之前，请确保：

• 已安装 OpenAI Codex 桌面应用
• 已注册 TokenFlash 账号
• 操作系统为 Windows 10+ 或受 Codex 桌面应用支持的 macOS

安装 Codex++

访问 Codex++ Releases 下载最新安装包：

Windows 安装

1. 双击运行 Windows 安装程序
2. 按照安装向导完成安装
3. 安装后确认桌面或开始菜单中存在两个入口

macOS 安装

1. 根据处理器类型下载对应的 DMG
2. 打开 DMG 文件
3. 将 Codex++.app 和 Codex++ 管理工具.app 安装到应用程序目录
4. 从启动台打开 Codex++ 管理工具

如果 macOS 提示应用“已损坏”或无法打开，可以执行：

sudo xattr -rd com.apple.quarantine /Applications/Codex++\ 管理工具.app
sudo xattr -rd com.apple.quarantine /Applications/Codex++.app

获取 TokenFlash API Key

1. 登录 TokenFlash 控制台
2. 进入 API 密钥页面
3. 点击 创建新密钥
4. 根据要使用的模型选择渠道分组
5. 复制生成的 API Key（以 sk- 开头）

配置 TokenFlash 供应商

第一步：打开管理工具

首次使用时先打开 Codex++ 管理工具，确认 Codex 应用路径和运行状态正确。

第二步：创建纯 API 供应商

1. 打开 供应商配置
2. 点击 添加供应商
3. 选择 纯 API 模式
4. 将供应商名称填写为 TokenFlash

第三步：填写连接信息

第四步：选择上游协议

第五步：添加模型

为每个模型选择合适的上下文窗口。Codex++ 支持 1M、200K 或纯数字，并会生成对应的模型目录配置。

第六步：保存配置

选择一个可用模型作为测试模型，然后点击 保存。

测试连接

模型测试

1. 打开 TokenFlash 供应商详情
2. 确认 Base URL、API Key、协议和测试模型均已填写
3. 运行 模型测试
4. 检查响应状态和错误信息

Provider Doctor

如果模型测试失败，运行 Provider Doctor。它会检查：

• Base URL 和 API Key 是否完整
• 当前协议和测试模型是否匹配
• 纯 API 配置是否正确写入
• 本地代理和环境变量是否存在冲突

也可以使用 TokenFlash 的模型接口排查网络和密钥：

curl https://tokenflash.cn/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

开始使用

激活 TokenFlash 供应商

1. 在供应商列表中选择 TokenFlash
2. 点击 启用
3. 确认当前供应商已切换为 TokenFlash

从 Codex++ 启动

从 Codex++ 入口启动 Codex，或在管理工具中点击启动按钮。不要直接打开官方 Codex 应用，否则本地协议转换和部分增强功能可能不会加载。

在 Codex 中发送一条测试消息。能够正常收到回复即表示配置成功。

界面增强功能

Codex++ 的增强功能可以单独开启或关闭：

• 会话管理：批量删除、Markdown 导出、项目移动和 Token 用量历史
• 插件增强：插件市场、模型白名单和插件自动展开
• 界面优化：中文界面、会话宽度、滚动恢复和服务层级控制
• 开发工作流：Upstream worktree、线程 ID、Goals 和 Stepwise
• 用户脚本：安装、启用和管理自定义脚本

附录：一键连通性测试

保存为 test_tokenflash.py，快速验证 API 连通性：

from openai import OpenAI

client = OpenAI(
    api_key="sk-你的TokenFlash密钥",
    base_url="https://tokenflash.cn/v1",
)

try:
    response = client.chat.completions.create(
        model="gpt-5.5",
        messages=[{"role": "user", "content": "你好，请回复'连接成功'"}],
        max_tokens=50,
    )
    print(f"✅ 连接成功！回复：{response.choices[0].message.content}")
except Exception as e:
    print(f"❌ 连接失败：{e}")

pip install openai && python test_tokenflash.py

常见问题

Codex++ 菜单没有出现？

1. 确认从 Codex++ 入口启动，而不是直接打开官方应用
2. 在管理工具的 安装维护 页面检查 Codex 应用路径
3. 在 关于 页面查看启动状态和诊断日志

切换供应商后请求失败？

1. 运行模型测试和 Provider Doctor
2. 确认 Base URL 包含 /v1
3. 确认协议、API Key 和测试模型匹配
4. 确认 TokenFlash 账户有余额且密钥未过期
5. Chat Completions 模式下确认从 Codex++ 启动器进入

如何切换回官方 API？

在供应商列表中选择 官方登录 配置并启用，然后重新启动 Codex++。也可以在管理工具中恢复 Codex 原有配置。

如何配置聚合供应商？

1. 先添加至少一个已填写 Base URL 和 API Key 的普通 API 供应商
2. 创建 聚合供应商
3. 勾选要加入路由的供应商
4. 选择故障转移、按会话轮转、按请求轮转或权重轮转

macOS 提示“已损坏”？

执行安装章节中的 xattr 命令解除隔离，然后重新打开应用。

数据位置

更多教程

• CC Switch 接入 TokenFlash
• CodexHub 接入 TokenFlash
• Codex 安装与配置进阶
• Kelivo 接入 TokenFlash
• Codex 提示词进阶

相关资源

• Codex++ GitHub：https://github.com/BigPizzaV3/CodexPlusPlus
• Codex++ Releases：https://github.com/BigPizzaV3/CodexPlusPlus/releases
• TokenFlash API 文档：https://tokenflash.cn
• 问题反馈：GitHub Issues
• 交流群：QQ群 830629290

最后更新：2026-07-13

本内容由 Coze AI 生成，请遵循相关法律法规及《人工智能生成合成内容标识办法》使用与传播。