Codex 接入星空 API

第一次使用，建议直接跟着 CC Switch 图解操作：先安装工具，再添加星空供应商、获取模型并测试。

推荐方式完成后就可以开始使用，下面的其他配置方式不需要重复操作。

展开：网页配置脚本或 Codex CLI 手动配置

1. 安装 Codex

打开 Codex 官方下载入口，下载 Mac 版，按提示安装并打开。已有 Codex 可以跳过。

2. 在星空找到配置入口

1. 登录 星空控制台，进入 API 密钥。
2. 找到给 Codex 创建的密钥，在该行点击 一键配置（若当前分组提供）。
3. 选择 macOS，先阅读页面说明。已有 Codex 配置时，先备份 ~/.codex/ 下的配置文件，再核对脚本会修改哪些文件。
4. 按页面指引下载并运行配置脚本。若没有该入口，使用下方的命令行配置方法，或向平台确认当前分组的接入方式。

配置项	对应内容
Base URL	通常为 https://cdn.api.inxk.com/v1，以当前分组生成的配置为准
API Key	这把 Codex 密钥；一键配置可能直接写入本地认证文件
Model	当前分组支持 Responses 的模型 ID

⚠️ 注意

一键配置脚本可能覆盖旧配置，也可能含真实 Key。只在自己的电脑运行，不要分享或提交到 GitHub。

3. 重启并测试

1. 完全退出 Codex，再重新打开。
2. 新建任务，选一个空的测试目录，并选择已配置的模型。
3. 发送：你好，请只回复一句问候，不要读取或修改文件。
4. 收到回复后，回星空 使用记录核对请求。

我用的是 Codex CLI：展开完整配置步骤

安装与准备

1. Mac 按 Command+空格，输入“终端”，按回车打开。
2. 执行下面的安装命令。电脑没有 Node.js 时，先从 https://nodejs.org/ 安装当前 LTS 版本，关闭终端再重新打开。
3. 在星空创建适合 Codex 的 Key，确认它的分组支持 Responses。
4. 先完成本地密钥设置，把 Key 和模型载入当前终端。真实 Key 不要直接写进下面的配置文件。

# 安装 Codex CLI；使用 npm，不需要 pnpm。
npm install -g @openai/codex
# 查看是否安装成功。
codex --version
# 创建配置目录；~ 表示你的用户主目录。
mkdir -p ~/.codex

填写配置

1. 打开代码编辑器，选择“打开文件”，输入 ~/.codex/config.toml。文件不存在就新建，保存到 ~/.codex/，文件名必须是 config.toml。
2. 已有配置的话，先另存备份，再合并下面的字段，不要直接覆盖原内容。
3. 把 YOUR_MODEL_ID 改成当前分组允许的 Responses 模型 ID。

# 顶层配置放在任何 [分组标题] 之前。
model_provider = "xkapi"
model = "YOUR_MODEL_ID"

# 供应商名字要与上面的 model_provider 完全一致。
[model_providers.xkapi]
name = "星空 API"
base_url = "https://cdn.api.inxk.com/v1"
wire_api = "responses"
env_key = "XKAPI_API_KEY"
requires_openai_auth = false

配置项	填什么
Base URL / base_url	https://cdn.api.inxk.com/v1
API Key	放在环境变量 XKAPI_API_KEY 中，env_key 填的是变量名
Model / model	当前分组可用于 Responses 的真实模型 ID
协议 / wire_api	responses，不要改成 chat/completions

启动与测试

在同一个已经载入 .env 的终端中启动：

# 建一个空目录测试，避免一开始就让助手操作重要项目。
mkdir -p ~/xkapi-codex-test
cd ~/xkapi-codex-test
# 启动后阅读并按提示确认；保持工具操作的默认审批设置。
codex

输入“你好，请只回复一句问候，不要读取或修改文件”。收到回复后，回星空的使用记录核对请求。

没成功？先看这三项

现象	先查什么
提示认证失败	Key 是否完整、启用、未到期；重新打开客户端
模型不可用 / Responses 不支持	分组与模型是否适合 Codex，不要使用只支持普通聊天的分组
CLI 提示找不到密钥变量	在启动 Codex 的同一终端完成 本地密钥设置

更多报错见 常见问题。

✅ 本节完成检查点

• [ ] Codex 收到了问候回复，星空使用记录中能看到请求。

收到回复了？完成最后的检查 →

仍然失败？查看排查与工单步骤 →