PeakkAI 接入 Codex Desktop 教程

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

一、什么是 Codex Desktop

Codex Desktop 是 OpenAI 推出的桌面端 AI 编程助手。

相比传统聊天窗口，Codex Desktop 支持：

代码仓库分析

AI Agent

自动修改项目

Shell 执行

Git 操作

多任务并行

本地工具调用

开发者可以直接使用自己的 API 服务商，而无需强制使用 OpenAI 官方 API。

二、PeakkAI 是否支持 Codex Desktop

支持。

PeakkAI 提供 OpenAI Compatible/Responses API。

因此可以直接作为：

Custom Provider

OpenAI Compatible Endpoint

接入 Codex Desktop。

仅需配置：

API Key

Base URL

Model

即可完成接入。

三、准备工作

准备以下内容：

项目	说明
Codex Desktop	已安装
PeakkAI API Key	sk-xxxx
PeakkAI API 地址	https://api.peakk.ai/v1
模型名称	https://www.peakk.ai

四、下载并安装 Codex Desktop

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

五、获取 peakk API 信息

前往 PeakkAI 开放平台申请 sk。

peakk 开放平台

获取以下内容：

配置项	示例
Base URL	https://api.peakk.ai
API Key	sk-xxxx
Model	Claude 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 配置

打开终端：

加入：

保存后执行：

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

打开：

CMD

PowerShell

Windows Terminal

执行以下命令即可。

CMD 配置方式

设置 API Key

setx OPENAI_API_KEY "sk-xxxx"

设置 Base URL

setx OPENAI_BASE_URL "https://api.peakk.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，并且测试是否可以正常使用，如下：

或者：

帮我生成一个 Spring Boot 示例项目

若正常返回结果，则说明：

API Key 正常

Base URL 正常

Model 正常

PeakkAI 接入成功

八、常见问题

Unauthorized

检查：

API Key 是否正确

Provider Connection Failed

检查：

https://api.peakk.ai/v1

是否填写正确。

Model Not Found

检查模型名称。

确保填写：

GPT-5.5

或 PeakkAI 平台支持的其它模型。

九、总结

通过 Codex Desktop 的 Custom Provider 功能，可以直接接入 PeakkAI OpenAI Compatible API。

配置完成后即可在 Codex Desktop 中使用：

GPT-5.5

GPT-5.6

GPT-6-Astra
实现统一 API、多模型 AI 编程体验。

PeakkAI API 对接Codex Desktop

PeakkAI 接入 Codex Desktop 教程#

一、什么是 Codex Desktop#

二、PeakkAI 是否支持 Codex Desktop#

三、准备工作#

四、下载并安装 Codex Desktop#

五、获取 peakk API 信息#

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

1. Mac / Linux 配置#

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

CMD 配置方式#

设置 API Key#

设置 Base URL#

设置模型#

配置完成后#

七、验证配置#

八、常见问题#

Unauthorized#

Provider Connection Failed#

Model Not Found#

九、总结#