1. AI应用
AboAI-Doc
中文
  • 中文
  • English
  • 首页
  • AboAi-API
    • 模型Model
      • 原生OpenAI格式
      • 原生Gemini格式
    • 聊天Chat
      • 原生OpenAI格式
      • 原生Gemini格式
      • 原生Claude格式
      • Responses 请求(openai)
    • 音频Audio
      • Gemini Live
      • 原生OpenAI格式 TTS
      • 原生Gemini格式 TTS
    • 图像Images
      • 原生OpenAI格式 图像生成
      • 原生Gemini格式 图像生成
      • 原生OpenAI格式 图像编辑（JSON）
      • 原生OpenAI格式 图像编辑（Multipart）
    • 视频Video
      • Seedance2.0格式
        • 创建视频生成任务
        • 查询视频生成任务状态
    • 向量 Vector
      • Embeddings
        • 创建 Embedding
    • 翻译Translation
      • 语音翻译
    • 日账单
      • 查询消费明细列表
      • 查询日粒度汇总（无明细）
    • 知识库knowledge
      • 知识库管理
        • 查询知识库列表
        • 创建知识库
        • 获取知识库详情
        • 更新知识库
        • 删除知识库
      • 附件管理
        • 查询附件列表
        • 上传附件
        • 获取附件处理状态
        • 获取附件详情
        • 删除附件
      • 检索问答
        • 语义检索
        • RAG 问答
  • AI应用
    • AboAI API 对接Claude Code
    • AboAI API 对接Cursor
    • AboAI API 对接Codex-cli
    • AboAi API 对接Codex Desktop
    • AboAI API 对接 Hermes-Agent
  1. AI应用

AboAi API 对接Codex Desktop

AboAI 接入 Codex Desktop 教程#

本教程适用于：
OpenAI Codex Desktop
AboAI API
macOS
Windows
OpenAI Compatible API

一、什么是 Codex Desktop#

Codex Desktop 是 OpenAI 推出的桌面端 AI 编程助手。
相比传统聊天窗口，Codex Desktop 支持：
代码仓库分析
AI Agent
自动修改项目
Shell 执行
Git 操作
多任务并行
本地工具调用
开发者可以直接使用自己的 API 服务商，而无需强制使用 OpenAI 官方 API。

二、AboAI 是否支持 Codex Desktop#

支持。
AboAI 提供 OpenAI Compatible/Responses API。
因此可以直接作为：
Custom Provider
OpenAI Compatible Endpoint
接入 Codex Desktop。
仅需配置：
API Key
Base URL
Model
即可完成接入。

三、准备工作#

准备以下内容：
项目说明
Codex Desktop已安装
AboAI API Keysk-xxxx
AboAI API 地址https://vipapi.aboai.ai/v1
模型名称https://maas.aboai.ai

四、下载并安装 Codex Desktop#

前往：https://openai.com/zh-Hans-CN/codex/get-started/
OpenAI 官方下载页面安装最新版 Codex Desktop。
安装完成后启动应用。

五、获取 aboai API 信息#

前往 AboAI 开放平台申请 sk。
aboai 开放平台
image-20260514140602533.png
image-20260514140819323.png
获取以下内容：
配置项示例
Base URLhttps://vipapi.aboai.ai
API Keysk-xxxx
ModelClaude Opus 4.6 / GPT 5.5 ...

六、配置环境变量方式配置(对于openAi 推荐的接入方式)#

Codex CLI 本质使用 OpenAI SDK，因此只需要配置环境变量。
但是此方式只能适用于OpenAI相关模型
正例： GPT-5.5,GPT-6-Astra
反例：Claude Haiku 4.5 , Gemini 2.5 Pro 此种方式不支持

1. Mac / Linux 配置#

打开终端：
加入：
image.png
保存后执行：

2. Windows 配置（命令行方式）#

打开：
CMD
PowerShell
Windows Terminal
执行以下命令即可。

CMD 配置方式#

设置 API Key#

setx OPENAI_API_KEY "sk-xxxx"

设置 Base URL#

setx OPENAI_BASE_URL "https://vipapi.aboai.ai/v1"

设置模型#

setx OPENAI_MODEL "GPT-5.6-Sol"

配置完成后#

关闭当前终端。
重新打开 CMD 或 PowerShell。
验证：
echo %OPENAI_API_KEY%
echo %OPENAI_BASE_URL%
echo %OPENAI_MODEL%

七、验证配置#

打开codex Desktop
确认是否已经配置api，并且测试是否可以正常使用，如下：
image.png
或者：
帮我生成一个 Spring Boot 示例项目
若正常返回结果，则说明：
API Key 正常
Base URL 正常
Model 正常
AboAI 接入成功

八、常见问题#

Unauthorized#

检查：
API Key 是否正确

Provider Connection Failed#

检查：
https://vipapi.aboai.ai/v1
是否填写正确。

Model Not Found#

检查模型名称。
确保填写：
GPT-5.5
或 AboAI 平台支持的其它模型。

九、总结#

通过 Codex Desktop 的 Custom Provider 功能，可以直接接入 AboAI OpenAI Compatible API。
配置完成后即可在 Codex Desktop 中使用：
GPT-5.5
GPT-5.6
GPT-6-Astra
实现统一 API、多模型 AI 编程体验。
Modified at 2026-09-20 12:34:13
Previous
AboAI API 对接Codex-cli
Next
AboAI API 对接 Hermes-Agent
Built with