在 Windows 上安装 Claude Code

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

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

1. 在 Windows 上安装 Claude Code

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

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

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

claude --version

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

winget install Anthropic.ClaudeCode

官方建议安装 Git for Windows ↗，让 Claude Code 可以使用 Bash 工具。安装时可沿用默认选项，完成后重开终端。未安装 Git 时，当前 Claude Code 可使用 PowerShell 工具。

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

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

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

3. 用 CCswitch 导入并启用 PRISM

下载 CCswitch ↗，按自己的 Windows 或 macOS 系统选择安装包，安装后打开。
在这台电脑的浏览器中打开本站API 密钥页面，找到刚创建的 Key，点击同一行的「导入到 CCS」。
允许浏览器打开 CCswitch。核对导入窗口中的客户端为 Claude Code，确认是本站 Key 对应的配置后保存。客户端由 Key 的分组决定，选错时请回密钥页检查分组。
切换到 CCswitch 的 Claude 页签，找到刚导入的 PRISM 配置，点击「启用」，确认它成为当前使用的供应商。
退出已有 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

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

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

安装故障排除

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

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

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

从开始菜单搜索 cmd，右键「命令提示符」，选择以管理员身份运行。
在管理员 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 的分组权限、可用模型和订阅状态，以本站「使用密钥」说明为准。
额度不足：在仪表盘和我的订阅核对余额、有效期与剩余额度；兑换码到账情况可在本站核查。
有回复，但 PRISM 没有记录：核对使用记录筛选条件和请求时间；确认启用的是 PRISM、客户端已经重启，旧会话或旧环境变量没有继续使用原配置。

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

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