# 棱镜 PRISM 接入指南

更新日期：2026-10-24

在线文档：https://prismind.one/prism/

<a id="guide"></a>

## 选一种使用方式，就从这里开始。

Claude Code 和 Codex 是帮你阅读、修改与运行代码的 AI 编程工具；VS Code 是编辑器，需要安装对应的 AI 扩展。选择你准备使用的一种，后面按同一条流程完成接入。

[我是高手，跳过新人引导 →](https://prismind.one/prism/#advanced)其他客户端、直接调用 API 与手动配置放在下方。

<a id="install"></a>

## 先装好你要使用的工具。

已经装好了？直接继续[第 3 步：准备 PRISM 账号和额度](https://prismind.one/prism/#redeem)。安装命令、官方来源与各系统的常见问题都在本站教程里。

### 安装 Claude Code

选择电脑系统，按步骤安装并确认能启动 Claude Code。两份教程都包含后续的 PRISM Key、CCswitch 配置和首次验证，可以直接从头做到完成。

[**Windows 安装教程 →** — 安装准备、官方安装方式与启动检查](https://prismind.one/prism/guides/claude-code-windows.html)[**macOS 安装教程 →** — 终端安装、启动检查与常见问题](https://prismind.one/prism/guides/claude-code-macos.html)

[查看 Claude Code 完整教程](https://prismind.one/prism/guides/claude-code.html)。教程在本站阅读；软件从教程列出的官方来源安装。

### 安装 Codex

选择电脑系统，按步骤安装 Codex CLI 并检查版本。两份教程都包含官方来源、PRISM Key、CCswitch 配置和首次验证。

[**Windows 安装教程 →** — 安装准备、官方安装方式与启动检查](https://prismind.one/prism/guides/codex-windows.html)[**macOS 安装教程 →** — 终端安装、启动检查与常见问题](https://prismind.one/prism/guides/codex-macos.html)

[查看 Codex 完整教程](https://prismind.one/prism/guides/codex.html)。教程会说明不同官方安装方式的适用范围，按自己的系统操作即可。

### 在 VS Code 中使用 AI 编程工具

1. 还没有编辑器时，从 [VS Code 官方下载页 ↗](https://code.visualstudio.com/download)选择 Windows 或 macOS 版本并安装；已经安装则直接打开。
1. 在扩展市场安装你要用的官方扩展：Claude Code 核对发布者为 Anthropic；Codex 核对发布者为 OpenAI。VS Code 本身不提供模型，也没有单独的 PRISM Key 分组。
1. 继续按下方流程创建支持对应工具的 PRISM Key，在 CCswitch 的 Claude 或 Codex 页签导入并启用；完全退出并重开 VS Code 后再验证。

需要先安装对应工具或排查运行环境时，查看本站 [Claude Code 教程](https://prismind.one/prism/guides/claude-code.html)或 [Codex 教程](https://prismind.one/prism/guides/codex.html)。扩展能否读取配置以当前版本及本站「使用密钥」说明为准。

当前浏览器未启用 JavaScript：可以直接打开 [Claude Code 教程](https://prismind.one/prism/guides/claude-code.html)、[Codex 教程](https://prismind.one/prism/guides/codex.html)，或从 [VS Code 官网](https://code.visualstudio.com/download)安装编辑器及所需官方扩展。

<a id="redeem"></a>

## 准备 PRISM 账号和可用额度。

1. 在本站[注册](https://prismind.one/register)；已有账号直接[登录](https://prismind.one/login)。
1. 在[仪表盘](https://prismind.one/dashboard)查看余额，在[我的订阅](https://prismind.one/subscriptions)查看所属分组、有效期和额度。
1. 持有兑换码时，进入[兑换页面](https://prismind.one/redeem)提交，再核对到账结果。余额兑换看仪表盘，订阅兑换看「我的订阅」。

**先确认能用，再创建 Key**

你要使用的工具、Key 分组和可用额度需要匹配。安装软件不代表已经获得 PRISM 额度；兑换订阅也不一定会增加账户余额。

<a id="keys"></a>

## 在本站创建自己的 API Key。

API Key 是客户端访问 PRISM 的凭证，相当于这款工具的专用通行证。后面始终使用本站创建的 Key。

1. 进入[API 密钥](https://prismind.one/keys)，点击「创建密钥」，按用途命名，例如 `claude-work` 或 `codex-work`。
1. 选择支持你所用工具且有使用权限的供应商与分组，确认模型、价格和额度后保存。使用 VS Code 时，按扩展对应的 Claude Code 或 Codex 选择。
1. 在该 Key 所在行点击「使用密钥」，查看该分组的接入说明。接口地址、模型和认证方式都以这里显示的内容为准。

完整 Key 只保存在自己的客户端配置中；向客服求助时提供 Key 名称或脱敏截图，不要发送完整 Key。

<a id="connect"></a>

## 下载 CCswitch，把 Key 导入客户端。

CCswitch 用来保存和切换 Claude Code、Codex 的接入配置。装好编程工具后，再用它把 PRISM 配置写到对应工具。

1. [下载 CCswitch ↗](https://ccswitch.io/zh/)，选择自己电脑的 Windows 或 macOS 安装包，安装后打开。
1. 在**要使用编程工具的这台电脑**上打开本站[API 密钥](https://prismind.one/keys)，找到刚创建的 Key，点击同一行的「导入到 CCS」。
1. 允许浏览器打开 CCswitch，核对导入窗口中的客户端与 Key 分组匹配，确认是本站配置后保存。

**导入没有反应？**

先启动 CCswitch，再点击「导入到 CCS」并允许浏览器唤起应用。手机浏览器不能直接配置另一台电脑。如需手动添加，在「使用密钥」中查看对应工具的参数，在 CCswitch 对应页签添加自定义供应商「PRISM」，逐项填写并保存。

<a id="enable"></a>

## 点击启用，再完全退出并重开。

1. 在 CCswitch 切到对应的 **Claude** 或 **Codex** 页签，找到刚导入的 PRISM 配置。
1. 点击「启用」，确认它成为当前使用的供应商。**导入只是保存配置，启用之后才会使用。**
1. 退出正在运行的编程工具，完全关闭并重新打开终端或客户端。使用 VS Code 时，完全退出所有 VS Code 窗口并重开，然后开启新会话。

如果仍显示默认登录界面，先检查 PRISM 配置是否已启用、CCswitch 和工具是否处在同一运行环境，再按本站「使用密钥」说明排查。

<a id="verify"></a>

## 收到回复，也要在本站看到记录。

1. 按本站「使用密钥」说明选择当前分组支持的模型，开启新会话。
1. 发送一条简短消息：**你好，请简单介绍一下你自己。**确认工具正常回复。
1. 打开本站[使用记录](https://prismind.one/usage)，核对刚才请求的时间、Key 和模型。回复与记录都对应，就完成接入了。

**验证完成后就可以开始使用**

首次请求会按当前分组规则计费，发一条简短消息即可。如果有回复但本站找不到对应记录，先核对是否仍在使用其他供应商，再检查当前启用的 PRISM 配置。

<a id="operations"></a>

## 接入后，在哪里看用量？

- [仪表盘](https://prismind.one/dashboard)：查看余额、请求量与消费趋势。
- [使用记录](https://prismind.one/usage)：按时间、Key 与模型核对请求和消耗。
- [我的订阅](https://prismind.one/subscriptions)：查看分组、有效期与剩余额度。
- [API 密钥](https://prismind.one/keys)：为不同应用单独创建 Key，停用不再使用的 Key；发现泄漏立即停用并检查异常用量。

费用突然增加时，先检查请求数量、重复重试、长对话和后台循环任务，再核对模型与分组计费。

<a id="models"></a>

## 模型和价格，以当前分组为准。

前往[模型广场](https://prismind.one/model-plaza)查看当前展示的模型与价格；实际可调用的模型，还要在[API 密钥 → 使用密钥](https://prismind.one/keys)中按所属分组确认。

Claude Code、Codex 是工具名称，模型是工具请求的 AI。不要把工具名称直接当成模型 ID，也不要把旧教程中的模型版本照搬到自己的配置。

<a id="faq"></a>

## 接入卡住时，按现象检查。

### IMPORT点击「导入到 CCS」没有反应

确认 CCswitch 已安装并启动，使用的是同一台电脑上的浏览器，浏览器已允许打开外部应用。仍无法导入时，在「使用密钥」查看对应工具配置，再到 CCswitch 对应页签手动添加、保存并启用。

### ENABLE导入成功，但工具仍要求原来的登录

先在 CCswitch 确认 PRISM 配置已「启用」，完全退出工具和终端或 VS Code 后重开。核对 Key 分组、CCswitch 页签与运行环境一致；例如 Windows 与 WSL 是不同运行环境。配置方式以本站「使用密钥」为准。

### WINDOWSClaude Code 提示虚拟化不可用或虚拟机平台未启用

使用 WSL 2 时遇到这类报错，可用管理员 CMD 启用 Windows 的虚拟机平台组件，完成后重启电脑。具体命令和 BIOS/UEFI 虚拟化检查步骤见[Windows 安装教程 → 虚拟化排障](https://prismind.one/prism/guides/claude-code-windows.html#windows-virtualization)。

### 401 / 403密钥或访问权限异常

检查 Key 是否完整、有无空格、是否已停用，并核对分组权限、订阅有效期及限制设置。使用的是 PRISM API Key，不能填写网页登录密码。

### 404地址或模型不存在

将客户端参数与「使用密钥」逐项对照，检查是否重复拼接 `/v1` 或使用了不支持的模型。`model_not_found` 时重点核对 Key 所属分组的模型 ID。

### 429请求频率或额度受限

核对余额、订阅额度与分组限制，按错误提示降低并发或间隔重试，避免无间隔自动重试。

### 502 / 503服务暂时不可用或流式中断

结合错误内容检查网络、代理、客户端超时和站内公告。重复提交前先看使用记录；持续失败时，向工单提供客户端版本、模型、发生时间和请求 ID。

### TOOLS能聊天，但不能读文件或运行命令

检查工具本身的目录、工具开关与权限设置。确认当前通道支持所需协议和工具调用；能收到文本回复不代表所有工具都已验证。需要协助时提供客户端版本、模型、报错时间和请求 ID。

### ACCOUNT兑换后余额或额度没有变化

余额兑换看仪表盘，订阅兑换看「我的订阅」。确认兑换记录与分组，再检查 Key 是否选择了对应分组。仍有疑问时通过工单提交脱敏截图与操作时间。

<a id="advanced"></a>

## 其他客户端与高级配置。

熟悉 API 与配置文件的用户，可以直接查看本站 Key 的接入说明。下面保留直接请求、Codex 手动配置和 OpenClaw 模板，供已有配置的用户参考。

| 用途 | 入口 |
| --- | --- |
| 接入参数与认证方式 | [API 密钥 → 使用密钥](https://prismind.one/keys) |
| 通用 API Base URL | `https://prismind.one/v1` |
| 模型与价格 | [模型广场](https://prismind.one/model-plaza)，并核对 Key 分组 |
| 请求记录 | [使用记录](https://prismind.one/usage) |

**以下都是待填写的模板**

`YOUR_MODEL_ID` 是占位符，必须替换为自己分组实际支持的模型 ID；`PRISM_API_KEY` 是本机环境变量名称，必须自行设置真实 Key。不要把模板直接当作可用配置，也不要直接覆盖已有配置。新用户按上方 CCswitch 流程即可。

<a id="api"></a>

### 直接调用 API · 查看请求模板

### 先按 Key 的接入说明确认协议

下面仅演示支持 Responses 的分组。先在当前终端设置 `PRISM_API_KEY`，再将 `YOUR_MODEL_ID` 替换为该分组可用模型。其他协议请采用「使用密钥」给出的参数。

```bash
curl --fail-with-body "https://prismind.one/v1/responses" \
  -H "Authorization: Bearer $PRISM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"YOUR_MODEL_ID","input":"请回复：连接成功","stream":false}'
```

```powershell
$headers = @{ Authorization = "Bearer $env:PRISM_API_KEY" }
$body = @{ model = "YOUR_MODEL_ID"; input = "Reply: connected"; stream = $false } | ConvertTo-Json
Invoke-RestMethod -Method Post -Uri "https://prismind.one/v1/responses" -Headers $headers -ContentType "application/json" -Body $body
```

请求按当前分组规则计费；发送后在本站[使用记录](https://prismind.one/usage)核对。

<a id="codex"></a>

### Codex 手动配置 · 查看兼容模板

优先使用 CCswitch 或本站「使用密钥」的对应配置。确需手动配置时，先备份用户级 `config.toml`，再合并字段。macOS 通常位于 `~/.codex/config.toml`，Windows 位于 `%USERPROFILE%\.codex\config.toml`；自定义了 `CODEX_HOME` 时以该目录为准。

```toml
model_provider = "prism"
model = "YOUR_MODEL_ID"

[model_providers.prism]
name = "棱镜 PRISM"
base_url = "https://prismind.one/v1"
wire_api = "responses"
env_key = "PRISM_API_KEY"
requires_openai_auth = false
```

`YOUR_MODEL_ID` 必须替换。为 Codex 进程设置 `PRISM_API_KEY` 后，完全退出并重新启动工具，再验证请求与本站使用记录。不要把终端临时变量当作所有桌面应用都能读取的配置。

[下载 Codex 配置模板 ↓](https://prismind.one/prism/downloads/config.toml)

<a id="openclaw"></a>

### OpenClaw 与其他客户端 · 查看配置参考

其他客户端使用本站「使用密钥」中对应协议的配置。以下 OpenClaw 片段仅供支持 Responses 的分组参考；先核对当前客户端版本与配置格式，备份后再合并，保留已有频道、工作区与工具权限。

```json
{
  "models": {
    "mode": "merge",
    "providers": {
      "prism": {
        "baseUrl": "https://prismind.one/v1",
        "apiKey": "${PRISM_API_KEY}",
        "api": "openai-responses",
        "authHeader": true,
        "models": [
          {
            "id": "YOUR_MODEL_ID",
            "name": "YOUR_MODEL_ID"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "prism/YOUR_MODEL_ID"
      }
    }
  }
}
```

模型 ID 和默认模型中的 `YOUR_MODEL_ID` 都要替换，确保两处一致。为实际运行的进程设置 `PRISM_API_KEY`；后台服务需要配置其服务环境。按当前版本校验配置、重启并测试。

[下载 OpenClaw 配置片段 ↓](https://prismind.one/prism/downloads/openclaw.example.json)

<a id="downloads"></a>

## 教程与文档下载。

- [**Claude Code 站内完整教程** — Windows / macOS · 安装、Key、CCswitch 与验证](https://prismind.one/prism/guides/claude-code.html)
- [**Codex 站内完整教程** — Windows / macOS · 安装、Key、CCswitch 与验证](https://prismind.one/prism/guides/codex.html)
- [**下载本文** — Markdown · 离线阅读和编辑](https://prismind.one/prism/downloads/prism-guide.md)

兼容模板：[Codex config.toml](https://prismind.one/prism/downloads/config.toml) · [OpenClaw 配置片段](https://prismind.one/prism/downloads/openclaw.example.json)。模板中的模型和 Key 均需自行填写，新用户无需下载配置文件。

<a id="support"></a>

## 需要协助？提交工单。

请准备工具名称与版本、系统、模型、发生时间、完整错误提示或请求 ID，以及已检查的步骤。Key 只提供名称或脱敏标识。

[进入工单处理 ](https://prismind.one/support/)

---

# 在 Windows 上安装 Codex

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

其他系统：[查看 macOS 安装教程 →](https://prismind.one/prism/guides/codex-macos.html)

[安装客户端](https://prismind.one/prism/guides/codex-windows.html#install) · [创建 PRISM Key](https://prismind.one/prism/guides/codex-windows.html#prism-key) · [导入配置](https://prismind.one/prism/guides/codex-windows.html#prism-connect) · [首次启动](https://prismind.one/prism/guides/codex-windows.html#first-run) · [验证接入](https://prismind.one/prism/guides/codex-windows.html#prism-verify)

## 1. 在 Windows 上安装 Codex

1. 打开 [Node.js 官方下载页 ↗](https://nodejs.org/zh-cn/download)，选择 **LTS** 和 Windows 安装程序，根据电脑架构下载。
1. 运行安装包，保留 npm 和加入 PATH 的默认选项，按安装向导完成安装。
1. 关闭旧终端。从开始菜单搜索并打开 **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 官方下载与安装说明 ↗](https://developers.openai.com/codex/cli/)。完成后继续配置 PRISM。

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

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

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

## 3. 用 CCswitch 导入并启用 PRISM

1. [下载 CCswitch ↗](https://ccswitch.io/zh/)，按自己的 Windows 或 macOS 系统选择安装包，安装后打开。
1. 在这台电脑的浏览器中打开本站[API 密钥](https://prismind.one/keys)页面，找到刚创建的 Key，点击同一行的「导入到 CCS」。
1. 允许浏览器打开 CCswitch。核对导入窗口中的客户端为 Codex，确认是本站 Key 对应的配置后保存。客户端由 Key 的分组决定，选错时请回密钥页检查分组。
1. 切换到 CCswitch 的 Codex 页签，找到刚导入的 PRISM 配置，点击「启用」，确认它成为当前使用的供应商。
1. 退出已有 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. 按本站「使用密钥」说明选择当前分组支持的模型，在新会话中发送：**你好，请简单介绍一下你自己。**
1. 确认 Codex 收到正常文本回复。
1. 打开本站[使用记录](https://prismind.one/usage)，核对本次请求的时间、Key 与模型。回复与记录都对应，才算完成接入。

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

## 安装故障排除

- **找不到 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 的分组权限、可用模型和订阅状态，以本站「使用密钥」说明为准。
- **额度不足：**在[仪表盘](https://prismind.one/dashboard)和[我的订阅](https://prismind.one/subscriptions)核对余额、有效期与剩余额度；兑换码到账情况可在本站核查。
- **有回复，但 PRISM 没有记录：**核对使用记录筛选条件和请求时间；确认启用的是 PRISM、客户端已经重启，旧会话或旧环境变量没有继续使用原配置。

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

教程由 PRISM 编写。安装命令与系统要求参考 [Codex 官方安装说明 ↗](https://developers.openai.com/codex/cli/)，核对日期：2026-10-21。接入参数以 PRISM 控制台为准。

---

# 在 macOS 上安装 Codex

从安装到第一次请求，按下面步骤把 Codex 接入 PRISM。本文使用 **Codex CLI（终端版）**。

其他系统：[查看 Windows 安装教程 →](https://prismind.one/prism/guides/codex-windows.html)

[安装客户端](https://prismind.one/prism/guides/codex-macos.html#install) · [创建 PRISM Key](https://prismind.one/prism/guides/codex-macos.html#prism-key) · [导入配置](https://prismind.one/prism/guides/codex-macos.html#prism-connect) · [首次启动](https://prismind.one/prism/guides/codex-macos.html#first-run) · [验证接入](https://prismind.one/prism/guides/codex-macos.html#prism-verify)

## 1. 在 macOS 上安装 Codex

1. 打开 [Node.js 官方下载页 ↗](https://nodejs.org/zh-cn/download)，选择 **LTS** 和 macOS 安装程序（`.pkg`）。根据电脑选择 Apple 芯片或 Intel 版本，按安装向导完成安装。
1. 按 ⌘ + 空格，搜索「终端」并打开；如果安装前开过终端，先退出并重开。
1. 依次运行下面的命令。前两行应输出 Node.js 与 npm 版本号，第三行安装官方 Codex 包。

```
node -v
npm -v
npm install -g @openai/codex
```

安装完成后检查版本：

```
codex --version
```

显示版本号表示安装成功。已使用 Homebrew 或 Node.js 版本管理器的用户，可以沿用现有的 Node.js 环境。

### npm 安装提示 EACCES：改用用户目录安装

如果通过上面的 Node.js 官方 `.pkg` 安装后，npm 提示 `EACCES` 或无权写入全局目录，可以把 npm 的全局安装目录改到自己的用户目录，**无需使用 sudo**。以下命令适用于使用 macOS 默认 zsh、且没有使用 nvm、fnm 等 Node.js 版本管理器的用户。

依次复制执行下面的命令。第二行只需运行一次，它会把目录加入新终端的 PATH；第三行使当前终端立即生效。

```
npm config set prefix "$HOME/.local"
printf '\nexport PATH="$HOME/.local/bin:$PATH"\n' >> "$HOME/.zprofile"
export PATH="$HOME/.local/bin:$PATH"
npm install -g @openai/codex
codex --version
```

最后显示 Codex 版本号即可继续。已有 nvm、fnm 等版本管理器时，不要设置上面的 npm prefix；先确认版本管理器已在当前终端启用、切换到了可用的 Node.js 版本，再重新安装 Codex。

Codex 来自 OpenAI 官方发布的 `@openai/codex` 安装包，安装方式可查看 [Codex 官方下载与安装说明 ↗](https://developers.openai.com/codex/cli/)。完成后继续配置 PRISM。

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

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

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

## 3. 用 CCswitch 导入并启用 PRISM

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

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

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

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

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

## 4. 启动 Codex

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

```
mkdir -p ~/prism-demo
cd ~/prism-demo
codex
```

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

## 5. 确认请求已经走 PRISM

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

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

## 安装故障排除

- **找不到 node 或 npm：**检查 Node.js LTS 是否安装完成，关闭并重开终端，确认 PATH 配置生效。
- **npm 提示 EACCES 权限错误：**查看上方[用户目录安装步骤](https://prismind.one/prism/guides/codex-macos.html#npm-eacces)，按适用条件处理，无需使用 sudo。已有 nvm、fnm 时先检查版本管理器环境，不要额外设置 npm prefix。
- **找不到 codex：**先看 npm 安装命令是否报错，再重开终端；按安装提示检查 npm 全局可执行目录是否在 PATH 中。

## 常见问题与需要帮助

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

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

教程由 PRISM 编写。安装命令与系统要求参考 [Codex 官方安装说明 ↗](https://developers.openai.com/codex/cli/)，核对日期：2026-10-21。接入参数以 PRISM 控制台为准。

---

# 在 Windows 上安装 Claude Code

从安装到第一次请求，按下面步骤把 Claude Code 接入 PRISM。本文使用 **Claude Code 终端版**。要求 Windows 10 1809 或更新版本，也可使用 Windows 11。

其他系统：[查看 macOS 安装教程 →](https://prismind.one/prism/guides/claude-code-macos.html)

[安装客户端](https://prismind.one/prism/guides/claude-code-windows.html#install) · [创建 PRISM Key](https://prismind.one/prism/guides/claude-code-windows.html#prism-key) · [导入配置](https://prismind.one/prism/guides/claude-code-windows.html#prism-connect) · [首次启动](https://prismind.one/prism/guides/claude-code-windows.html#first-run) · [验证接入](https://prismind.one/prism/guides/claude-code-windows.html#prism-verify)

## 1. 在 Windows 上安装 Claude Code

1. 从开始菜单搜索并打开 **PowerShell**。窗口提示符通常以 `PS` 开头；下面的命令用于 PowerShell。
1. 复制下面的官方安装命令，粘贴到 PowerShell，按回车。下载时可能暂时没有进度显示，请等待执行结束。

```
irm https://claude.ai/install.ps1 | iex
```

使用原生安装方式，无需先安装 Node.js 或 WSL。安装完成后，关闭并重新打开 PowerShell，再检查：

```
claude --version
```

显示版本号表示安装成功。如果电脑可使用 WinGet，也可以选择下面的安装方式，二选一即可：

```
winget install Anthropic.ClaudeCode
```

官方建议安装 [Git for Windows ↗](https://git-scm.com/downloads/win)，让 Claude Code 可以使用 Bash 工具。安装时可沿用默认选项，完成后重开终端。未安装 Git 时，当前 Claude Code 可使用 PowerShell 工具。

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

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

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

## 3. 用 CCswitch 导入并启用 PRISM

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

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

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

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

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

## 4. 启动 Claude Code

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

```
New-Item -ItemType Directory -Force "$env:USERPROFILE\prism-demo"
Set-Location "$env:USERPROFILE\prism-demo"
claude
```

首次启动按提示选择界面主题。遇到信任当前目录、确认使用配置中的 Key 等提示时，先核对路径和配置来源，再确认继续。随后选择 PRISM 当前分组支持的模型。

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

## 5. 确认请求已经走 PRISM

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

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

## 安装故障排除

- **提示 irm 不是命令：**确认打开的是 PowerShell；CMD 窗口无法直接使用本文的 `irm` 命令。
- **找不到 claude：**先重开 PowerShell，再按安装器提示检查 PATH；原生安装通常位于 `%USERPROFILE%\.local\bin`。
- **下载失败或脚本被系统策略阻止：**检查官方安装地址是否可访问；有 WinGet 时可使用上面的安装命令。公司电脑的安装策略请联系管理员处理。
- **配置只在某个终端有效：**检查 CCswitch 与 Claude Code 是否运行在相同的 Windows 用户及环境下，再重新启用 PRISM。

### 提示虚拟化不可用或“虚拟机平台”未启用

如果使用 WSL 2 安装、启动 Claude Code 时遇到这类报错，先检查 Windows 的**虚拟机平台（Virtual Machine Platform）**组件。

1. 从开始菜单搜索 `cmd`，右键「命令提示符」，选择**以管理员身份运行**。
1. 在管理员 CMD 窗口中执行下面的命令，等待组件启用完成。

```
dism /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
```

**完成后保存工作并重启电脑**，再重试安装或启动。命令中的 `/norestart` 只是不自动重启，仍需手动重启才能生效。

这条命令启用 Windows 组件。若重启后仍提示硬件虚拟化未开启，请在「任务管理器 → 性能 → CPU」查看「虚拟化」状态；显示「已禁用」时，还需要在电脑的 BIOS/UEFI 中启用 Intel VT-x 或 AMD-V/SVM。原生 Windows 安装无需为了运行 Claude Code 先安装 WSL。

## 常见问题与需要帮助

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

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

教程由 PRISM 编写。安装命令与系统要求参考 [Claude Code 官方安装说明 ↗](https://code.claude.com/docs/en/setup)，核对日期：2026-10-21。接入参数以 PRISM 控制台为准。

---

# 在 macOS 上安装 Claude Code

从安装到第一次请求，按下面步骤把 Claude Code 接入 PRISM。本文使用 **Claude Code 终端版**。要求 macOS 13 或更新版本。

其他系统：[查看 Windows 安装教程 →](https://prismind.one/prism/guides/claude-code-windows.html)

[安装客户端](https://prismind.one/prism/guides/claude-code-macos.html#install) · [创建 PRISM Key](https://prismind.one/prism/guides/claude-code-macos.html#prism-key) · [导入配置](https://prismind.one/prism/guides/claude-code-macos.html#prism-connect) · [首次启动](https://prismind.one/prism/guides/claude-code-macos.html#first-run) · [验证接入](https://prismind.one/prism/guides/claude-code-macos.html#prism-verify)

## 1. 在 macOS 上安装 Claude Code

1. 按 ⌘ + 空格，搜索「终端」并打开。
1. 复制下面的官方安装命令，粘贴到终端，按回车。安装器下载时可能暂时没有进度显示，请等到执行结束。

```
curl -fsSL https://claude.ai/install.sh | bash
```

这是 Claude Code 官方安装脚本，使用原生安装方式，无需先安装 Node.js。脚本完成后关闭并重新打开终端，再检查：

```
claude --version
```

显示版本号表示安装成功。若已经使用 Homebrew，也可以选择下面的安装方式，二选一即可：

```
brew install --cask claude-code
```

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

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

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

## 3. 用 CCswitch 导入并启用 PRISM

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

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

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

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

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

## 4. 启动 Claude Code

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

```
mkdir -p ~/prism-demo
cd ~/prism-demo
claude
```

首次启动按提示选择界面主题。遇到信任当前目录、确认使用配置中的 Key 等提示时，先核对路径和配置来源，再确认继续。随后选择 PRISM 当前分组支持的模型。

## 5. 确认请求已经走 PRISM

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

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

## 安装故障排除

- **command not found: claude：**先重开终端；按安装器提示检查 PATH，原生安装通常位于 `~/.local/bin`。
- **下载失败、403 或返回 HTML：**检查电脑是否能访问官方安装地址，确认 macOS 版本满足要求；已有 Homebrew 时也可改用上面的 Homebrew 安装方式。
- **已安装但配置没生效：**确认在 CCswitch 的 Claude 页签启用了 PRISM，并退出旧的 Claude Code 会话、重开终端。

## 常见问题与需要帮助

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

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

教程由 PRISM 编写。安装命令与系统要求参考 [Claude Code 官方安装说明 ↗](https://code.claude.com/docs/en/setup)，核对日期：2026-10-21。接入参数以 PRISM 控制台为准。