← 返回首页
⚡ Claude Code 安装教程

Windows 安装 Claude Code

从零开始,在 Windows 系统上安装并配置 Claude Code 智能编程助手

📦 所需资源下载

🟢
Node.js
JavaScript 运行时环境
前往下载
🔴
Git for Windows/x64
版本控制工具
前往下载
Windows Terminal
现代化终端工具
百度网盘
🔵
CC.Switch
API 配置切换工具
百度网盘
1

安装 Node.js

点击上方下载 Node.js 的 "Windows 安装程序 (.msi)",双击运行,全程默认下一步安装即可。

2

安装 Git for Windows

点击上方下载 "Git for Windows/x64 Setup",双击运行,全程默认下一步安装即可。

3

安装 Windows Terminal

下载上方的 WindowsTerminal.zip,保存到 D 盘后解压缩,进入目录,选中 WindowsTerminal 右键 → 发送到桌面快捷方式

💡 以下所有命令都在 Windows Terminal 界面中执行。
4

设置执行策略

双击打开桌面上的 Windows Terminal,复制以下命令粘贴并按回车:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
5

合并系统环境变量

在 Windows Terminal 中,复制以下命令粘贴并按回车:

$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
6

验证环境安装

依次执行以下命令,安装成功会显示版本号:

node -v
npm -v
git --version
7

设置国内镜像源

加速 npm 包下载:

npm config set registry https://registry.npmmirror.com

确认是否设置成功:

npm config get registry
8

全局安装 Claude Code

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

验证安装

claude --version
10

配置 CC.Switch

安装并打开上方下载的 CC.Switch,按以下步骤操作:

① 选择第一个 Claude 图标

② 选中并启用 "One API"

③ 点击 "使用中" 右边的 "编辑" 按钮

④ 粘贴从 One API 网站获取的 API Key

⑤ 展开 "高级选项",在 "模型映射" 中输入 One API 支持的模型

⑥ 点击 保存

💡 建议优先设置 Claude 模型,Claude Code 对自身的 Claude 模型兼容性最好。
11

启动 Claude Code

跳过所有权限检查,默认允许权限执行:

claude --dangerously-skip-permissions
12

开始使用

进入 Claude Code 界面后,即可让它帮你安装插件、编写代码。试试输入:

"请帮我在 D 盘创建一个 Test 目录,然后写一个首页介绍如何使用 Claude Code?"
13

更新 Claude Code

可每天执行一次更新:

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

更新成功后正常启动:

claude --dangerously-skip-permissions
14

故障排除

如报错,可重新下载 Node.js、Git for Windows、Windows Terminal、CC.Switch,然后执行:

# 1. 清除现有的安装
npm uninstall -g @anthropic-ai/claude-code

# 2. 清除 npm 缓存
npm cache clean --force

# 3. 重新安装
npm install -g @anthropic-ai/claude-code
⚠️ 提示:安装完一个智能体后,你就可以让它教你怎么安装其它智能体了。也可以在 VS Code 扩展中搜索 Cline 或 Claude Code 插件安装。