星尘 Codex 教程 按系统选择安装方式 下载 Windows 安装包

Codex 接入星尘 API

按系统安装快速开始

Windows 用户下载星尘 Codex 安装包，在安装器里粘贴 API Key 后完成安装。 macOS 用户按下方教程打开 ~/.codex，写入 config.toml 和 auth.json。

Windows 安装 macOS 配置

开始前准备

  • Windows x64 电脑或 macOS 电脑
  • 一个可正常登录的星尘 API 账号
  • 创建一个用于 Codex 的 API Key
  • 安装完成后打开 Codex 进行验证

Windows 走安装器；macOS 走手动配置。

01

Windows：下载安装包

下载星尘 Codex 0.1.2 x64 安装包，双击运行安装程序。

星尘 Codex 0.1.2 x64 安装包
星尘 Codex 安装程序界面
安装器里包含打开星尘 API 网站、填写 API Key、选择默认模型和安装按钮。
02

注册并登录星尘 API

先注册登录，再进入左侧的 API 密钥页面创建密钥。

https://api.xingchen88.top/

登录后先点击左侧 API密钥，再点 创建密钥。密钥创建完成后， 返回列表点击 使用密钥 查看接入方式。

星尘 API 首页，点击立即开始
首页点击“立即开始”。
星尘 API 登录页，底部有注册链接
首次使用先注册，已有账号直接登录，然后进入 API 密钥页面。
03

创建 API Key

登录后进入左侧“API 密钥”，点击“创建密钥”。创建完成后，返回列表点击“使用密钥”查看接入方式。

创建密钥弹窗，填写名称并选择分组
填写密钥名称，选择合适分组。
分组选择界面，选择 plus 号池
用于 Codex 时，在 free、plus、pro 号池里选一个。
free 号池 0.15 元一刀
plus 号池 0.2 元一刀，推荐
pro 号池 0.4 元一刀

创建完成后复制 API Key。API Key 通常以 sk- 开头，后面会填入 Windows 安装器或 macOS 的 auth.json。

04

Windows：填入安装器

回到安装程序，把复制好的 API Key 粘贴到输入框。默认模型填 gpt-5.5，然后点击“安装”。

安装器中填写 API Key 和默认模型
填写 API Key、确认默认模型，点击“安装”。

API Key

把星尘 API 网站生成的 API Key 粘贴到安装器输入框，或直接填入配置文件。

默认模型

默认模型填写 gpt-5.5。

开始安装

点击“安装”，等待安装程序完成。

05

macOS：官方软件下载与接入

先下载官方 Codex，再按注册登录、创建密钥、使用密钥的顺序完成接入。

OpenAI 官方软件下载链接

这个页面是官方软件下载入口。下载并安装后，先去星尘 API 登录， 点击 API密钥 创建密钥，再点击 使用密钥 进入接入页面。

使用 API 密钥弹窗，选择 Codex CLI 和系统类型
注册登录后，先进入 API 密钥，再点击使用密钥，选择 Codex CLI 和系统类型。

Finder 配置方式

  1. 打开访达 Finder，按 Command + Shift + G。
  2. 输入 ~/.codex 并前往。
  3. 打开 config.toml，复制下方配置并保存。
  4. 打开 auth.json，把你创建的 API Key 写入下方 JSON 示例并保存。

终端配置方式

  1. 运行 mkdir -p ~/.codex 创建配置目录。
  2. 运行 vim ~/.codex/config.toml，按 i 进入编辑。
  3. 粘贴下方 config.toml 内容，按 Esc 后输入 :wq 保存。
  4. 运行 vim ~/.codex/auth.json，写入下方 auth.json 内容并保存。
config.toml 
model_provider = "OpenAI"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.OpenAI]
name = "xingchen"
base_url = "https://api.xingchen88.top/v1"
wire_api = "responses"
requires_openai_auth = true
auth.json 
{
  "OPENAI_API_KEY": "把星尘 API 网站生成的 sk-... 密钥粘贴到这里"
}
06

打开 Codex 开始使用

Windows 从开始菜单打开 Codex；macOS 从应用程序或启动台打开 Codex。发起一次对话进行验证。

Windows

按 Windows 键搜索 Codex，打开后发起一次对话。

macOS

完成两个配置文件后重新打开 Codex。

检查配置

确认 API Key 完整、默认模型正确、星尘 API 账号余额可用。

07

Q&A：502 Bad Gateway 报错

如果 Codex 页面出现 Error running remote compact task unexpected status 502 Bad Gateway， 按下面步骤修改 config.toml 里的模型服务名称。

Codex 502 Bad Gateway 报错截图
截图中的 502 报错来自 https://api.xingchen88.top/v1/responses。

Windows 打开 config.toml

  1. 按 Win + R，输入下面路径并回车。
    %userprofile%\.codex\config.toml
  2. 选择记事本或其他文本编辑器打开文件。
  3. 找到 base_url = "https://api.xingchen88.top/v1" 上方的 name = "OpenAI"。
  4. 把这一行改成 name = "xingchen"，按 Ctrl + S 保存。
  5. 回到 Codex，输入 Exit 并回车退出，然后从开始菜单重新打开 Codex。

macOS 打开 config.toml

  1. 打开访达 Finder，按 Command + Shift + G。
  2. 输入下面路径并前往。
    ~/.codex
  3. 用文本编辑器打开 config.toml。
  4. 找到 base_url = "https://api.xingchen88.top/v1" 上方的 name = "OpenAI"。
  5. 把这一行改成 name = "xingchen"，按 Command + S 保存。
  6. 回到 Codex，输入 Exit 并回车退出，然后重新打开 Codex。

也可以在终端运行 open -a TextEdit ~/.codex/config.toml 直接打开配置文件。

修改前 
[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://api.xingchen88.top/v1"
修改后 
[model_providers.OpenAI]
name = "xingchen"
base_url = "https://api.xingchen88.top/v1"
08

密钥安全提醒

API Key 相当于账户消费凭证，泄露后别人可能会使用你的额度。

  • 录屏、截图或直播时，遮住完整的 sk- 密钥。
  • 密钥泄露后，在星尘 API 后台删除旧密钥，再创建新密钥。
  • API Key 和 auth.json 只保存在自己的设备上。