Codex++ 对接 Xcompute API 教程

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

​

目录

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

​

工具简介

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

​

供应商模式说明

​

前置准备

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

​

安装 Codex++

​

Windows 安装

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

​

macOS 安装

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

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

​

获取 Xcompute API Key

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

​

配置 Xcompute 供应商

​

第一步：打开管理工具

​

第二步：创建纯 API 供应商

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

​

第三步：填写连接信息

https://intl.dualseason.com/v1

​

第四步：选择上游协议

​

第五步：添加模型

​

第六步：保存配置

​

测试连接

​

模型测试

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

​

Provider Doctor

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

curl https://xcompute.us/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

​

开始使用

​

激活 Xcompute 供应商

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

​

从 Codex++ 启动

​

界面增强功能

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

​

常见问题

​

Codex++ 菜单没有出现？

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

​

切换供应商后请求失败？

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

​

如何切换回官方 API？

​

如何配置聚合供应商？

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

​

macOS 提示“已损坏”？

​

数据位置

​

更多教程

• CC Switch 对接 Xcompute API 教程
• CodexHub 对接 Xcompute API 教程
• Codex 的安装与配置
• 移动端使用 Claude、Codex — Kelivo
• Codex 破甲指南

​

相关资源

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

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