选一种使用方式,就从这里开始。
Claude Code 和 Codex 是帮你阅读、修改与运行代码的 AI 编程工具;VS Code 是编辑器,需要安装对应的 AI 扩展。选择你准备使用的一种,后面按同一条流程完成接入。
我是高手,跳过新人引导 →其他客户端、直接调用 API 与手动配置放在下方。
先装好你要使用的工具。
已经装好了?直接继续第 3 步:准备 PRISM 账号和额度。安装命令、官方来源与各系统的常见问题都在本站教程里。
安装 Claude Code
选择电脑系统,按步骤安装并确认能启动 Claude Code。两份教程都包含后续的 PRISM Key、CCswitch 配置和首次验证,可以直接从头做到完成。
查看 Claude Code 完整教程。教程在本站阅读;软件从教程列出的官方来源安装。
安装 Codex
选择电脑系统,按步骤安装 Codex CLI 并检查版本。两份教程都包含官方来源、PRISM Key、CCswitch 配置和首次验证。
查看 Codex 完整教程。教程会说明不同官方安装方式的适用范围,按自己的系统操作即可。
在 VS Code 中使用 AI 编程工具
- 还没有编辑器时,从 VS Code 官方下载页 ↗选择 Windows 或 macOS 版本并安装;已经安装则直接打开。
- 在扩展市场安装你要用的官方扩展:Claude Code 核对发布者为 Anthropic;Codex 核对发布者为 OpenAI。VS Code 本身不提供模型,也没有单独的 PRISM Key 分组。
- 继续按下方流程创建支持对应工具的 PRISM Key,在 CCswitch 的 Claude 或 Codex 页签导入并启用;完全退出并重开 VS Code 后再验证。
需要先安装对应工具或排查运行环境时,查看本站 Claude Code 教程或 Codex 教程。扩展能否读取配置以当前版本及本站「使用密钥」说明为准。
准备 PRISM 账号和可用额度。
在本站创建自己的 API Key。
API Key 是客户端访问 PRISM 的凭证,相当于这款工具的专用通行证。后面始终使用本站创建的 Key。
- 进入API 密钥,点击「创建密钥」,按用途命名,例如
claude-work或codex-work。 - 选择支持你所用工具且有使用权限的供应商与分组,确认模型、价格和额度后保存。使用 VS Code 时,按扩展对应的 Claude Code 或 Codex 选择。
- 在该 Key 所在行点击「使用密钥」,查看该分组的接入说明。接口地址、模型和认证方式都以这里显示的内容为准。
完整 Key 只保存在自己的客户端配置中;向客服求助时提供 Key 名称或脱敏截图,不要发送完整 Key。
下载 CCswitch,把 Key 导入客户端。
CCswitch 用来保存和切换 Claude Code、Codex 的接入配置。装好编程工具后,再用它把 PRISM 配置写到对应工具。
- 下载 CCswitch ↗,选择自己电脑的 Windows 或 macOS 安装包,安装后打开。
- 在要使用编程工具的这台电脑上打开本站API 密钥,找到刚创建的 Key,点击同一行的「导入到 CCS」。
- 允许浏览器打开 CCswitch,核对导入窗口中的客户端与 Key 分组匹配,确认是本站配置后保存。
点击启用,再完全退出并重开。
- 在 CCswitch 切到对应的 Claude 或 Codex 页签,找到刚导入的 PRISM 配置。
- 点击「启用」,确认它成为当前使用的供应商。导入只是保存配置,启用之后才会使用。
- 退出正在运行的编程工具,完全关闭并重新打开终端或客户端。使用 VS Code 时,完全退出所有 VS Code 窗口并重开,然后开启新会话。
如果仍显示默认登录界面,先检查 PRISM 配置是否已启用、CCswitch 和工具是否处在同一运行环境,再按本站「使用密钥」说明排查。
收到回复,也要在本站看到记录。
- 按本站「使用密钥」说明选择当前分组支持的模型,开启新会话。
- 发送一条简短消息:你好,请简单介绍一下你自己。确认工具正常回复。
- 打开本站使用记录,核对刚才请求的时间、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 URL | https://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 后,完全退出并重新启动工具,再验证请求与本站使用记录。不要把终端临时变量当作所有桌面应用都能读取的配置。
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;后台服务需要配置其服务环境。按当前版本校验配置、重启并测试。
教程与文档下载。
兼容模板:Codex config.toml · OpenClaw 配置片段。模板中的模型和 Key 均需自行填写,新用户无需下载配置文件。
需要协助?提交工单。
请准备工具名称与版本、系统、模型、发生时间、完整错误提示或请求 ID,以及已检查的步骤。Key 只提供名称或脱敏标识。
进入工单处理