在 macOS 上安装 Claude Code

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

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

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

1. 在 macOS 上安装 Claude Code

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

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

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

claude --version

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

brew install --cask claude-code

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

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

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

3. 用 CCswitch 导入并启用 PRISM

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

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

安装故障排除

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

常见问题与需要帮助

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

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

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