Windows 环境准备
安装 Claude Code、Codex 等命令行工具之前，需要先准备好 PowerShell 执行策略、Git 和 Node.js。
只用 Cherry Studio？
Cherry Studio 是桌面客户端，不需要命令行环境。直接去 Cherry Studio 接入。
第 1 步：打开 PowerShell
按 Win 键，搜索 PowerShell，右键选择「以管理员身份运行」。
如果弹出「是否允许此应用对你的设备进行更改」，选 是。
你会看到一个蓝色（或黑色）的终端窗口，光标在等你输入命令。后面所有命令都在这个窗口里执行。
第 2 步：修改 PowerShell 执行策略
Windows 默认禁止执行脚本。Claude Code 和 npm 工具需要执行 .ps1 脚本，不改这个策略会报 running scripts is disabled。
在 PowerShell 里输入（整行复制粘贴后按回车）：
powershell
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned系统会问你是否确认，输入 Y 按回车。
验证是否生效：
powershell
Get-ExecutionPolicy -List在输出的表格中，CurrentUser 那一行应该显示 RemoteSigned。如果还是 Undefined 或 Restricted，说明没有成功，检查是否用了管理员权限运行。
第 3 步：安装 Git
Git 是代码版本管理工具，Claude Code 读取项目信息时需要用到。
方式一（推荐）：WinGet 安装
在 PowerShell 里执行：
powershell
winget install --id Git.Git -e --source winget安装完成后，关闭 PowerShell 窗口，再重新打开一个新的。
方式二：手动下载安装
从 git-scm.com 下载安装包。安装过程中，所有选项保持默认即可。安装完成后同样需要重开终端。
验证 Git 是否安装成功：
powershell
git --version应该显示 git version 2.xx.x。如果提示 git 不是命令，说明 PATH 没有配对，重新安装并勾选 Add Git to PATH。
第 4 步：安装 Node.js
Node.js 是 JavaScript 运行环境，Claude Code（npm 方式安装）和 Codex 都需要它。
不确定要不要装？
如果你用 Claude Code 的官方脚本安装（irm https://claude.ai/install.ps1 | iex），可以跳过 Node.js。但如果后面还想用 Codex、Gemini CLI 或其他 npm 工具，建议现在就装好。
从以下任一地址下载 LTS（长期支持）版本：
- Node.js 中文站 — 国内下载快
- Node.js 官网
选 Windows 安装包 (.msi) 64 位。安装时注意：
- 保留「Add to PATH」选项（默认勾选，不要取消）
- 其他选项保持默认
安装完成后，关闭 PowerShell 窗口，重新打开一个新的。验证：
powershell
node -v
npm -v应该分别显示版本号（如 v22.x.x 和 11.x.x）。如果提示命令不存在，说明 PATH 没有配对，重新安装。
第 5 步：设置 npm 国内镜像（推荐）
npm 默认从国外下载，国内网络可能很慢。切换到国内镜像：
powershell
npm config set registry https://registry.npmmirror.com验证镜像是否设置成功：
powershell
npm config get registry应该输出 https://registry.npmmirror.com/。
最终检查
在一个新的 PowerShell 窗口里执行以下三条命令：
powershell
git --version
node -v
npm -v三条都有版本号输出，环境就准备好了。接下来选一个工具开始配置：
常见问题
winget 命令不存在？
winget 是 Windows 自带的包管理工具，Windows 10 1709+ 和 Windows 11 都有。如果没有，去 Microsoft Store 搜索「App Installer」安装。或者直接用手动下载安装包的方式。
安装了但命令不存在？
安装完 Git 或 Node.js 后，必须关闭当前终端窗口，重新打开一个新的。环境变量只在新窗口中生效。
npm 安装包一直超时？
先设置国内镜像（第 5 步），如果还是不行，检查网络是否有代理。公司网络可能需要配置代理：
powershell
npm config set proxy http://代理地址:端口
npm config set https-proxy http://代理地址:端口