Win电脑快速装配 Claude Code CLI + CC Switch 完整教程

🔧 Win 电脑快速装配 Claude Code CLI + CC Switch 完整教程

适用平台：Windows 10/11
更新日期：2026-07-02
预计耗时：15~30 分钟

📋 装配清单

第一步：安装 Node.js + npm

Claude Code 通过 npm 安装，需要先装 Node.js。

1-1 方式一：终端命令行安装（推荐，一条命令）

Windows 自带 winget 包管理器，打开PowerShell：

winget install OpenJS.NodeJS.LTS

安装完后关闭当前终端，重新打开让环境变量刷新。

备选包管理器（如果你电脑上已经装了）：

1-2 方式二：官网安装包（传统方式）

➡️ https://nodejs.org/zh-cn/download/

• 选择LTS 长期支持版（标签为绿色 LTS，如 22.x）
• 下载.msi安装程序
• 安装时确保勾选：✅Add to PATH

1-3 验证

打开PowerShell或命令提示符，输入：

node-v# 应输出类似：v22.14.0npm-v# 应输出类似：10.9.0

第二步：安装 Git（含 Git Bash）

Claude Code 在 Windows 上必须依赖 Git Bash才能运行。

2-1 下载安装

➡️ https://git-scm.com/downloads/win

• 使用默认安装选项即可
• 确保勾选：✅Add Git to PATH和 ✅Git Bash Here

2-2 找到 bash.exe 路径（记下来备用）

默认位置：

• 64 位系统：C:\Program Files\Git\bin\bash.exe

2-3 配置环境变量

Claude Code 需要通过环境变量找到 Git Bash。

1. 按Win + R，输入sysdm.cpl回车
2. 点击「高级」→「环境变量」
3. 在「用户变量」区域点击新建：
   • 变量名：CLAUDE_CODE_GIT_BASH_PATH
   • 变量值：C:\Program Files\Git\bin\bash.exe
4. 点击确定保存

验证：

echo$env:CLAUDE_CODE_GIT_BASH_PATH# 应输出：C:\Program Files\Git\bin\bash.exe

第三步：通过 npm 安装 Claude Code CLI

3-1 加速下载（可选，国内用户强烈建议）

npm configsetregistry https://registry.npmmirror.com

3-2 安装 Claude Code

npm install-g @anthropic-ai/claude-code

3-3 配置 PowerShell 执行策略

如果在 PowerShell 中运行claude报脚本禁止错误，以管理员身份打开 PowerShell，执行：

Set-ExecutionPolicyRemoteSigned

3-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-switch

4-2 下载安装

到 GitHub Releases 页面下载最新版.exe安装包：

➡️ https://github.com/farion1231/cc-switch/releases

下载CC-Switch-vX.X.X-Windows.msi，双击安装。

4-3 基本使用

1. 启动 CC Switch
2. 点击+添加新配置（可配置多个供应商）
3. 选择提供商，填入 API Key 和模型名称
4. 保存后即可一键切换

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 Vincent（obra）打造。它是一个完整的 AI 编程工作流框架，核心理念是Process over Prompt——让 Claude Code 真正拥有工程化开发能力。

➡️ GitHub 仓库：https://github.com/obra/superpowers

➡️ 中文汉化版：https://github.com/jnMetaCode/superpowers-zh

5-2 终端命令行安装（项目级，最简单）

进入你的项目目录，一条命令搞定：

git clone https://github.com/obra/superpowers.git.claude/skills/superpowers

如果是国内网络慢，可以用中文汉化版：

git clone https://github.com/jnMetaCode/superpowers-zh.git.claude/skills/superpowers

5-3 全局安装（让所有项目都能用）

mkdir-p$env:USERPROFILE\.claude\skills\superpowers git clone https://github.com/obra/superpowers.git$env:USERPROFILE\.claude\skills\superpowers

5-4 验证安装

安装后在 Claude Code 中输入/superpowers即可使用。

5-5 更新 Superpowers

cd.claude\skills\superpowers git pull origin main

⚠️ 常见问题速查

✅ 装配完成检查清单

• node -v能输出版本号
• npm -v能输出版本号
• git --version能输出版本号
• echo $env:CLAUDE_CODE_GIT_BASH_PATH输出正确的 bash.exe 路径
• claude --version能输出版本号
• CC Switch 已安装并可正常启动
• PowerShell 执行策略已设为 RemoteSigned
• Superpowers 已 git clone 到.claude/skills/superpowers

🔗 相关资源