在 Windows 上安装 Codex

从安装到第一次请求，按下面步骤把 Codex 接入 PRISM。本文使用 Codex CLI（终端版）。推荐使用 Windows 11；较新且已更新的 Windows 10 为尽力支持环境。

其他系统：查看 macOS 安装教程 →

安装客户端 · 创建 PRISM Key · 导入配置 · 首次启动 · 验证接入

1. 在 Windows 上安装 Codex

1. 打开 Node.js 官方下载页 ↗，选择 LTS 和 Windows 安装程序，根据电脑架构下载。
2. 运行安装包，保留 npm 和加入 PATH 的默认选项，按安装向导完成安装。
3. 关闭旧终端。从开始菜单搜索并打开 PowerShell，依次运行下面的命令。前两行应输出 Node.js 与 npm 版本号，第三行安装官方 Codex 包。

node -v
npm.cmd -v
npm.cmd install -g @openai/codex

安装完成后检查版本：

codex.cmd --version

显示版本号表示安装成功。本文使用 npm.cmd 和 codex.cmd，避免 PowerShell 把同名的 .ps1 脚本拦下。

Codex 来自 OpenAI 官方发布的 @openai/codex 安装包，安装方式可查看 Codex 官方下载与安装说明 ↗。完成后继续配置 PRISM。

2. 注册 PRISM，创建自己的 Key

1. 打开本站注册页面完成注册；已有 PRISM 账号可直接登录。
2. 在仪表盘核对余额，在我的订阅核对分组、有效期与额度。持有兑换码时，到兑换页面兑换，再核对到账结果。
3. 进入API 密钥，点击「创建密钥」，给 Key 起一个方便识别的名称。
4. 选择支持 Codex 且有使用权限的供应商与分组，核对可用模型、价格和额度后保存。客户端与 Key 分组需要匹配。
5. 在新建 Key 所在行点击「使用密钥」，查看 PRISM 为该分组提供的接入说明。API Key、接口地址、模型名称均以这里显示的内容为准。

后续使用的都是你在 PRISM 创建的 Key。请把完整 Key 只保存在自己的客户端配置中；向客服求助时使用脱敏截图。

3. 用 CCswitch 导入并启用 PRISM

1. 下载 CCswitch ↗，按自己的 Windows 或 macOS 系统选择安装包，安装后打开。
2. 在这台电脑的浏览器中打开本站API 密钥页面，找到刚创建的 Key，点击同一行的「导入到 CCS」。
3. 允许浏览器打开 CCswitch。核对导入窗口中的客户端为 Codex，确认是本站 Key 对应的配置后保存。客户端由 Key 的分组决定，选错时请回密钥页检查分组。
4. 切换到 CCswitch 的 Codex 页签，找到刚导入的 PRISM 配置，点击「启用」，确认它成为当前使用的供应商。
5. 退出已有 Codex 会话，完全关闭并重新打开终端或客户端，再开始新会话。

点击导入没有反应，或需要手动添加？

先启动电脑上的 CCswitch，再点「导入到 CCS」并允许浏览器唤起应用。手机不能直接配置另一台电脑上的客户端，请在要使用 Codex 的电脑上操作。

也可以在 PRISM 密钥行点击「使用密钥」，按其中的 Codex 配置说明，在 CCswitch 对应页签手动添加自定义供应商，名称填「PRISM」。接口地址、Key、模型与认证方式逐项采用本站给出的值，保存后启用。不要凭示例猜接口路径，也不要重复拼接 /v1。

导入只是保存配置，还需要点击「启用」。如果仍出现默认登录界面，先退出客户端，重新核对 PRISM 配置是否启用、客户端和运行环境是否一致，再按本站「使用密钥」说明检查配置。

4. 启动 Codex

确认 CCswitch 已启用 PRISM，关闭并重新打开 PowerShell，在一个新建的测试目录中启动：

New-Item -ItemType Directory -Force "$env:USERPROFILE\prism-demo"
Set-Location "$env:USERPROFILE\prism-demo"
codex.cmd

首次提示信任目录或选择权限时，先核对目录，再按实际需求选择。按本站「使用密钥」说明选择当前分组支持的模型，先用一条文本消息验证 PRISM 接入。

如果已有 WSL 工作环境，请在 WSL 内安装、配置并运行 Codex。本文的 PowerShell 步骤用于原生 Windows，不要混用两套环境。

5. 确认请求已经走 PRISM

1. 按本站「使用密钥」说明选择当前分组支持的模型，在新会话中发送：你好，请简单介绍一下你自己。
2. 确认 Codex 收到正常文本回复。
3. 打开本站使用记录，核对本次请求的时间、Key 与模型。回复与记录都对应，才算完成接入。

测试请求按 PRISM 当前分组规则计费，首次验证发一条简短消息即可。完成后可返回新手引导继续确认步骤。

安装故障排除

• 找不到 node 或 npm：检查 Node.js LTS 是否安装完成，关闭并重开 PowerShell，确认安装时启用了 PATH 选项。
• PowerShell 提示禁止运行脚本：使用本文的 npm.cmd、codex.cmd 命令；受公司安装策略管理的电脑请联系管理员。
• 找不到 codex.cmd：先看 npm 安装命令是否报错，再重开 PowerShell；按安装提示检查 npm 全局可执行目录是否在 PATH 中。
• 沙箱初始化失败：核对 Windows 版本和错误提示；受公司策略管理的电脑请联系管理员。

常见问题与需要帮助

• 401 / Key 无效：在 PRISM 密钥页检查 Key 是否有效，重新导入并启用对应配置，再重开客户端。
• 403 / 模型不可用：检查 Key 的分组权限、可用模型和订阅状态，以本站「使用密钥」说明为准。
• 额度不足：在仪表盘和我的订阅核对余额、有效期与剩余额度；兑换码到账情况可在本站核查。
• 有回复，但 PRISM 没有记录：核对使用记录筛选条件和请求时间；确认启用的是 PRISM、客户端已经重启，旧会话或旧环境变量没有继续使用原配置。

仍无法接入，请到本站光之国支援站提供操作系统、客户端版本、报错文字与发生时间，截图中的完整 Key 请遮盖。

教程由 PRISM 编写。安装命令与系统要求参考 Codex 官方安装说明 ↗，核对日期：2026-10-21。接入参数以 PRISM 控制台为准。