
Win 电脑快速装配 Claude Code CLI CC Switch 完整教程适用平台Windows 10/11更新日期2026-07-02预计耗时15~30 分钟 装配清单工具用途安装方式Node.js npm运行环境winget 命令行 / 官网安装包Git (含 Git Bash)命令行运行时官网安装包Claude Code CLIAnthropic 官方命令行 AI 助手npm 全局安装CC Switch图形化管理配置 API 切换GitHub ReleaseSuperpowers高星技能包赋能工程化开发git clone第一步安装 Node.js npmClaude Code 通过 npm 安装需要先装 Node.js。1-1 方式一终端命令行安装推荐一条命令Windows 自带 winget 包管理器打开PowerShellwinget install OpenJS.NodeJS.LTS安装完后关闭当前终端重新打开让环境变量刷新。备选包管理器如果你电脑上已经装了包管理器命令winget(系统自带)winget install OpenJS.NodeJS.LTSChocolateychoco install nodejs-ltsScoopscoop install nodejs-lts1-2 方式二官网安装包传统方式➡️ https://nodejs.org/zh-cn/download/选择LTS 长期支持版标签为绿色 LTS如 22.x下载.msi安装程序安装时确保勾选✅Add to PATH1-3 验证打开PowerShell或命令提示符输入node-v# 应输出类似v22.14.0npm-v# 应输出类似10.9.0第二步安装 Git含 Git BashClaude Code 在 Windows 上必须依赖 Git Bash才能运行。2-1 下载安装➡️ https://git-scm.com/downloads/win使用默认安装选项即可确保勾选✅Add Git to PATH和 ✅Git Bash Here2-2 找到 bash.exe 路径记下来备用默认位置64 位系统C:\Program Files\Git\bin\bash.exe2-3 配置环境变量Claude Code 需要通过环境变量找到 Git Bash。按Win R输入sysdm.cpl回车点击「高级」→「环境变量」在「用户变量」区域点击新建变量名CLAUDE_CODE_GIT_BASH_PATH变量值C:\Program Files\Git\bin\bash.exe点击确定保存验证echo$env:CLAUDE_CODE_GIT_BASH_PATH# 应输出C:\Program Files\Git\bin\bash.exe第三步通过 npm 安装 Claude Code CLI3-1 加速下载可选国内用户强烈建议npm configsetregistry https://registry.npmmirror.com3-2 安装 Claude Codenpm install-g anthropic-ai/claude-code3-3 配置 PowerShell 执行策略如果在 PowerShell 中运行claude报脚本禁止错误以管理员身份打开 PowerShell执行Set-ExecutionPolicyRemoteSigned3-4 验证安装claude--version# 输出版本号即安装成功3-5 补充如果你不装 CC Switch需手动绕过首次启动向导CC Switch 配置时会自动处理.claude.json不需要你手动操作。如果打算裸跑 Claude Code 不用 CC Switch才需要手动创建C:\Users\你的用户名\.claude.json{hasCompletedOnboarding:true}第四步安装 CC Switch图形化配置管理4-1 CC Switch 是什么CC Switch 是图形化管理工具让你切换 Claude Code / Codex / Gemini CLI 的 API 供应商配置像换衣服一样简单。不用手动编辑 JSON 配置文件。➡️ GitHub 仓库https://github.com/farion1231/cc-switch4-2 下载安装到 GitHub Releases 页面下载最新版.exe安装包➡️ https://github.com/farion1231/cc-switch/releases下载CC-Switch-vX.X.X-Windows.msi双击安装。4-3 基本使用启动 CC Switch点击添加新配置可配置多个供应商选择提供商填入 API Key 和模型名称保存后即可一键切换4-4 不用 CC Switch 也行手动配置如果不想装桌面工具直接编辑C:\Users\你的用户名\.claude\settings.json{env:{ANTHROPIC_BASE_URL:https://你的API地址,ANTHROPIC_AUTH_TOKEN:sk-你的API密钥,ANTHROPIC_MODEL:claude-sonnet-4-20250514,ANTHROPIC_DEFAULT_SONNET_MODEL:claude-sonnet-4-20250514,ANTHROPIC_DEFAULT_OPUS_MODEL:claude-opus-4-20250514,ANTHROPIC_DEFAULT_HAIKU_MODEL:claude-haiku-4-20250514}}第五步安装 Superpowers 技能包git clone强烈推荐5-1 Superpowers 是什么Superpowers 是 GitHub 上最火的 Claude Code 技能包233k stars由 Jesse Vincentobra打造。它是一个完整的 AI 编程工作流框架核心理念是Process over Prompt——让 Claude Code 真正拥有工程化开发能力。➡️ GitHub 仓库https://github.com/obra/superpowers➡️ 中文汉化版https://github.com/jnMetaCode/superpowers-zh5-2 终端命令行安装项目级最简单进入你的项目目录一条命令搞定git clone https://github.com/obra/superpowers.git.claude/skills/superpowers如果是国内网络慢可以用中文汉化版git clone https://github.com/jnMetaCode/superpowers-zh.git.claude/skills/superpowers5-3 全局安装让所有项目都能用mkdir-p$env:USERPROFILE\.claude\skills\superpowers git clone https://github.com/obra/superpowers.git$env:USERPROFILE\.claude\skills\superpowers5-4 验证安装安装后在 Claude Code 中输入/superpowers即可使用。5-5 更新 Superpowerscd.claude\skills\superpowers git pull origin main⚠️ 常见问题速查问题解决方案npm不是内部或外部命令Node.js 安装时未勾选 Add to PATH手动将C:\Program Files\nodejs\加入系统 PATHnpm 下载速度慢npm config set registry https://registry.npmmirror.comclaude命令找不到检查 npm 全局安装路径是否在 PATH 中运行npm config get prefix查看PowerShell 禁止运行脚本管理员身份打开 PowerShell执行Set-ExecutionPolicy RemoteSignedClaude Code 报 git-bash 错误检查CLAUDE_CODE_GIT_BASH_PATH环境变量是否正确指向bash.exe权限被拒 (EACCES)以管理员身份打开终端或设置 npm 全局目录到用户目录winget 找不到Windows 10 早期版本可能没有 winget改用手动下载 .msi 安装Superpowers 国内下载慢使用中文汉化版github.com/jnMetaCode/superpowers-zhCC Switch 连不上 API在 CC Switch 中检查 API 地址和 Key 是否正确✅ 装配完成检查清单node -v能输出版本号npm -v能输出版本号git --version能输出版本号echo $env:CLAUDE_CODE_GIT_BASH_PATH输出正确的 bash.exe 路径claude --version能输出版本号CC Switch 已安装并可正常启动PowerShell 执行策略已设为 RemoteSignedSuperpowers 已 git clone 到.claude/skills/superpowers 相关资源资源地址Claude Code npm 包https://www.npmjs.com/package/anthropic-ai/claude-codeCC Switch GitHub 仓库https://github.com/farion1231/cc-switchCC Switch Releases 下载https://github.com/farion1231/cc-switch/releasesSuperpowers GitHubhttps://github.com/obra/superpowersSuperpowers 中文汉化版https://github.com/jnMetaCode/superpowers-zhNode.js 下载https://nodejs.org/zh-cn/download/Git for Windowshttps://git-scm.com/downloads/win