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

Codex 接入星尘 API

按系统安装快速开始

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

开始前准备

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

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

01

Windows:下载安装包

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

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

注册并登录星尘 API

Windows 用户点击安装器里的“打开 api.xingchen88.top”;macOS 用户直接打开下方链接。

星尘 API 首页,点击立即开始
首页点击“立即开始”。
星尘 API 登录页,底部有注册链接
首次使用先注册,已有账号直接登录。
03

创建 API Key

登录后进入左侧“API 密钥”,点击“创建密钥”。名称按自己的用途填写,例如 Codex。

创建密钥弹窗,填写名称并选择分组
填写密钥名称,选择合适分组。
分组选择界面,选择 plus 号池
用于 Codex 时,在 free、plus、pro 号池里选一个。
free 号池 0.15 元一刀
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:按原教程配置

macOS 先安装 Codex,再把配置写入 ~/.codex 目录里的两个文件。

使用 API 密钥弹窗,选择 Codex CLI 和系统类型
在星尘 API 网站里选择 Codex CLI,再切换到 macOS / Linux。

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 = "OpenAI"
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

密钥安全提醒

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

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