PRISM棱镜 · 文档中心
PRISM / GET CONNECTED

装好工具,
连接 PRISM。

Claude Code / Codex,从安装到首次回复。
按顺序完成一次,之后直接开始工作。

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

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

我是高手,跳过新人引导 →其他客户端、直接调用 API 与手动配置放在下方。

选方式安装工具准备账号与 KeyCCswitch 导入启用并重开请求验证

先装好你要使用的工具。

已经装好了?直接继续第 3 步:准备 PRISM 账号和额度。安装命令、官方来源与各系统的常见问题都在本站教程里。

安装 Claude Code

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

查看 Claude Code 完整教程。教程在本站阅读;软件从教程列出的官方来源安装。

准备 PRISM 账号和可用额度。

  1. 在本站注册;已有账号直接登录。
  2. 在仪表盘查看余额,在我的订阅查看所属分组、有效期和额度。
  3. 持有兑换码时,进入兑换页面提交,再核对到账结果。余额兑换看仪表盘,订阅兑换看「我的订阅」。

在本站创建自己的 API Key。

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

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

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

下载 CCswitch,把 Key 导入客户端。

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

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

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

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

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

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

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

接入后,在哪里看用量?

  • 仪表盘:查看余额、请求量与消费趋势。
  • 使用记录:按时间、Key 与模型核对请求和消耗。
  • 我的订阅:查看分组、有效期与剩余额度。
  • API 密钥:为不同应用单独创建 Key,停用不再使用的 Key;发现泄漏立即停用并检查异常用量。

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

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

前往模型广场查看当前展示的模型与价格;实际可调用的模型,还要在API 密钥 → 使用密钥中按所属分组确认。

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

接入卡住时,按现象检查。

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

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

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

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

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

使用 WSL 2 时遇到这类报错,可用管理员 CMD 启用 Windows 的虚拟机平台组件,完成后重启电脑。具体命令和 BIOS/UEFI 虚拟化检查步骤见Windows 安装教程 → 虚拟化排障。

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

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

404地址或模型不存在

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

429请求频率或额度受限

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

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

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

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

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

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

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

其他客户端与高级配置。

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

用途入口
接入参数与认证方式API 密钥 → 使用密钥
通用 API Base URLhttps://prismind.one/v1
模型与价格模型广场,并核对 Key 分组
请求记录使用记录
直接调用 API · 查看请求模板

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

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

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}'
$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

请求按当前分组规则计费;发送后在本站使用记录核对。

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

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

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 配置模板 ↓

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

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

{
  "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 配置片段 ↓

教程与文档下载。

兼容模板:Codex config.toml · OpenClaw 配置片段。模板中的模型和 Key 均需自行填写,新用户无需下载配置文件。

需要协助?提交工单。

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

进入工单处理