Appearance
Codex：用 CC Switch 配置
CC Switch（简称 CCS）用来管理和切换 API 配置。配置好以后，仍然需要打开 Codex 或 Claude Code 来使用。
本页适用于 Mac 上的 Codex。要配置 Claude Code？打开 独立的一键导入教程。
开始前，先创建星空 API 密钥，选择卡或套餐对应的分组，准备好完整 Key、网页提供的 API 端点和该分组允许的模型 ID。
⚠️ 配置前先保存已有设置
CCS 启用供应商时会更新对应工具的本地配置。已有 Codex 或 Claude Code 配置的话，先使用 CCS 的备份功能或自行备份。真实 Key、导入链接和含 Key 的配置文件都不要分享或提交到 GitHub。
开始前：安装好这两个工具
需要安装 CC Switch 和 Codex。 CC Switch 负责配置，Codex 负责实际对话。已经安装好的可以跳过。
安装 CC Switch（Mac）
- 打开 CC Switch 官方下载页。
- 找到 Assets（下载文件），点击名称带
macOS、后缀为.dmg的安装包；不要下载 Source code 源码包。 - 下载完成后，在 Finder 的“下载”文件夹中双击安装包，按窗口提示将 CC Switch 放入“应用程序”。
- 打开“应用程序”，双击 CC Switch，确认能看到左侧 Codex、Claude Code 等入口。
下载方式见 CC Switch 官方安装说明。
安装 Codex
桌面端用户打开 OpenAI 官方桌面端说明，按页面下载并安装 Mac 版；已有桌面端的，确认能打开 Codex 界面即可。
使用终端版 Codex CLI 的用户，安装方法放在 Codex 其他配置方式的折叠说明中。用 CCS 管理时，只完成其中的安装步骤，API 配置回到本页填写。
✅ 本节完成检查点：CC Switch 和要使用的编程工具都已安装。
Codex 第一步：进入 Codex，添加供应商
- 打开 CC Switch，点击左侧 ① Codex。不要停留在 Claude Code 页面。
- 这份教程使用原生 Responses 接入，顶部保持 直连。先不用配置路由或聚合。
- 点击右上角 ② 添加供应商。
✅ 本节完成检查点：已经进入“添加供应商 Codex”页面。
Codex 第二步：选择“自定义配置”
点击页面上方的 ③ 自定义配置，它的说明是“手动填写请求地址和 API Key”。
这里使用的是星空网关，不要选“OpenAI Official”账号登录，也不要因为想用 DeepSeek 模型就直接选 DeepSeek 官方预设。
✅ 本节完成检查点：页面顶部显示“自定义配置 · 手动填写所有字段”。
Codex 第三步：填写名称、Key、地址和默认模型
按顺序填写下表，再往下滚动。这时先不要急着点“添加”，下一步还要检查高级选项和模型列表。
| 页面字段 | 怎么填 |
|---|---|
| ④ 名称 | 星空 Codex，方便以后识别 |
| 备注 | 可留空，也可以记录自己使用的卡或套餐名称 |
| 官网链接 | 可留空；要填写就用 https://dashboard.inxk.com/，这里只是方便打开控制台 |
| ⑤ API Key | 粘贴星空完整 Key，不加 Bearer ；下方 auth.json 会自动填充 |
| ⑥ API 请求地址 | 网页获取的 API 端点加 /v1，例如 https://cdn.api.inxk.com/v1 |
| 完整 URL 开关 | 按本教程保持关闭，使用上一行的 API 基地址 |
| ⑦ 默认模型 | 先完成第四步“获取模型列表”，再回到这里填写选定模型的准确 ID；填好后才点击“添加” |
地址最容易填错，看这里
这两个字段用途不同：
- 官网链接：打开控制台管理账户，可以留空。
- API 请求地址：Codex 实际请求模型用的地址，必须正确填写。
网页给出的 API 端点是 https://cdn.api.inxk.com，本页 CCS 的请求地址填写 https://cdn.api.inxk.com/v1，最终 Responses 接口应对应 /v1/responses。
⚠️ 不要重复加路径
按本教程使用“完整 URL”关闭的方式，不要把 /v1/responses 整段填进去，也不要重复写成 /v1/v1。若网页提供的地址本身已经带 /v1，就不要再加一次。
默认模型怎么填
默认模型就是 Codex 新任务默认请求的模型。截图中的 gpt-5.6-sol 是当时界面的值，不代表你的卡或套餐一定支持。
优先按下一步点击 ⑩ 获取模型列表，确认可用模型的 ID 后再回这里填写。获取不到时，按 模型 ID 查找图解查看自己分组的说明；不要用显示名称代替模型 ID。
✅ 本节完成检查点：名称、Key 和 API 地址已填写，知道默认模型必须与当前分组权限匹配。
Codex 第四步：设置上游格式，获取模型列表
- 向下滚动，点击展开 ⑧ 高级选项。
- ⑨ 上游格式选择 Responses（原生）。
- 点击 ⑩ 获取模型列表。先填好 Key 和 API 请求地址，再获取。
- 在获取结果中找到自己套餐内要使用的模型，将它加入模型列表，并记下准确 ID。
- 检查“默认模型”与要使用的模型 ID 一致，需要时向上滚动修改。
想了解 Responses、直连和其他上游格式？
本页使用 直连 + Responses（原生），按截图选择即可。改成 Chat 或 Anthropic Messages 上游需要另一套转换配置，首次接入不用调整。
获取模型失败怎么办
先检查完整 Key、带 /v1 的 API 地址、密钥分组和可用额度。若平台不提供列表接口，但已经确认某个模型 ID 可以用，再点旁边的 手动添加，按字段说明填写。
“模型映射”区域的说明写着会生成 Codex 模型目录。获取列表、保存供应商、重启 Codex是不同步骤，获取成功后还没有全部完成。
其他高级选项，如自定义 User-Agent、远程压缩和上下文窗口，第一次接入先保持原有或默认设置，不需要照着截图额外打开。
✅ 本节完成检查点：上游格式为 Responses（原生），已获取模型列表或确认了可用模型 ID。
Codex 第五步：检查生成配置，点击添加
继续向下滚动，可以看到 auth.json 和 config.toml 两块配置。
| 检查位置 | 需要确认什么 |
|---|---|
⑪ auth.json | OPENAI_API_KEY 应已由上方 API Key 字段填入；截图中为空是未填写的示例，不要照着留空 |
⑫ config.toml | 核对生成的模型设置；model 应是你有权限使用的默认模型 ID |
你只需要检查，不必把截图里的整段代码抄一遍。截图里的 notify、电脑路径、已信任项目和其他全局选项来自原有环境，不是接入星空必须添加的内容。
- 如果
OPENAI_API_KEY仍是空字符串，回到上方 ⑤ API Key字段补填。 - 如果模型不对，回到 ⑦ 默认模型修改，再检查生成结果。
- 确认后点击右下角 ⑬ 添加（位置见图 4）。
⚠️ 这些配置含敏感信息
实际生成的 auth.json 可能包含完整 Key。不要为了求助直接截图或分享整个配置，先遮住密钥。修改全局配置也可能影响其他供应商，首次接入只改本教程要求的字段。
✅ 本节完成检查点：认证与模型配置已核对，供应商添加成功。
Codex 第六步：启用星空，重启并测试
- 返回 CCS 的 Codex供应商列表，找到刚添加的 星空 Codex。
- 使用该卡片提供的启用或切换操作，确认“使用中”的是 星空 Codex，而不是图 1 中原有的 OpenAI Official。
- 桌面端用户：按
Command + Q完全退出 Codex，再重新打开；只关窗口不算完全退出。 - 在 Finder → 桌面，按
Shift + Command + N新建文件夹，命名为星空测试。在 Codex 新建任务时选择这个文件夹，再检查当前模型。 - 发送：你好，请只回复一句问候，不要读取或修改文件。
- 收到回复后，按 完成检查核对星空使用记录。
我使用终端版 Codex CLI：展开启动步骤
退出旧会话后，在终端执行：
sh
# 创建并进入专门的测试目录。
mkdir -p ~/xkapi-codex-test
cd ~/xkapi-codex-test
# 启动已经安装好的 Codex CLI。
codex启动后输入 /model 检查模型，再发送上面的问候。若仍显示旧模型列表，先结束正在运行的任务，再按 CCS 顶部提示重启 Codex 后台进程（Restart Codex daemon）；部分版本只重开终端还不够。参见 CC Switch 官方说明。
💡 添加成功不等于已经切换
只在 CCS 列表里看到供应商名称还不够。先确认供应商处于使用中，再重启 Codex。模型能显示也不代表请求一定成功，最后仍要发一次问候测试。
✅ 本节完成检查点：CCS 使用中的是星空，Codex 已重启，并能成功回复问候。
Claude Code：网页一键导入
Claude Code 已拆成独立图解：安装 → 网页导入 → 启动测试。只配置 Claude Code 的用户直接阅读那一页即可。
没成功？按这里检查
| 遇到的情况 | 检查方法 |
|---|---|
| Codex 仍用官方账号 | CCS 是否启用了星空供应商，Codex 是否完全退出后重新启动 |
| 401 / 密钥错误 | 上方 API Key 是否完整，下方认证配置是否自动填入，Key 是否启用且未到期 |
| 404 / 接口不存在 | Codex 请求地址是否为正确的 /v1 基地址，完整 URL 是否关闭，上游是否为 Responses（原生） |
| 模型不可用 | 默认模型与模型列表里的 ID 是否属于当前分组；不能只看截图或客户端预设 |
/model 没有新模型 | 确认供应商已保存并启用；CLI 按 CCS 提示重启后台进程，桌面端完全退出后重开，详见第六步 |
| 获取模型列表失败 | 先核对 Key、地址和分组权限；确认 ID 可用后才手动添加 |
| 点击导入没有反应 | 是否已经安装并打开 CCS，浏览器是否阻止打开外部应用；返回网页重试，不要分享导入链接 |
| Claude Code 导入到错误分类 | 重新核对目标应用，确保启用的是 Claude Code 下的供应商，不是 Codex 下的供应商 |
| 额度不足或限速 | 核对卡或套餐分组、剩余额度和密钥限制，停止重复发送 |
✅ 本节完成检查点：知道要分别检查“添加、启用、重启、实际请求”，不会把其中一步成功当成全部完成。
收到回复了？完成最后的检查 →
仍然失败？查看排查与工单步骤 →