在 Windows 上部署 Claude Code：AI 代理实战教程

想在 Windows 上把 Claude Code 跑起来，其实不难，麻烦的主要是几个环境变量和国内网络。这篇教程从装 Node.js 开始，一步步把开发环境配好，最后带你跑通第一个 AI 代理任务。全程跟着命令走，新手也能搞定。

1. 安装 Node.js

右键以管理员身份运行 Node.js 安装程序。
勾选 Tools for Native Modules（Automatically install the necessary tools…）选项。
一直回车，直到出现 type enter to exit 提示后按 Enter 退出。

手动添加 PATH 环境变量：

此电脑 → 右键 → 属性 → 高级系统设置 → 环境变量
系统变量 → 找到 Path → 编辑 → 新建
添加路径：C:\Program Files\nodejs
确定保存 → 重启终端

校验：打开一个新终端输入 node -v，能打印出版本号，就说明 PATH 已生效；若提示“不是内部或外部命令”，回到上面重新核对路径。

2. 以管理员身份运行 PowerShell 终端

方法一：按 Win + R，输入 powershell，然后按 Ctrl + Shift + Enter 以管理员身份运行。
方法二：按 Win 键，输入 PowerShell，右键选择“以管理员身份运行”。

3. 设置执行策略并验证 Node.js

设置 PowerShell 执行策略，允许运行脚本：

Set-ExecutionPolicy Unrestricted

如果想更稳妥，可以把 Unrestricted 换成 RemoteSigned，只放行本地脚本、拦截未签名脚本。

验证 Node.js 安装是否成功：

node -v
npm -v

两条命令都有版本号输出，即表示 Node.js 安装成功。

4. 安装 Git

访问镜像站下载：https://registry.npmmirror.com/binary.html?path=git-for-windows/
搜索 v2.54.0.windows.1，下载 Git-2.54.0-64-bit.exe。
右键以管理员身份运行安装，一路 Next 完成。
刷新当前 PowerShell 窗口的环境变量：

$env:Path = [Environment]::GetEnvironmentVariable("Path", "Machine") + $env:Path

验证 Git 安装：

git --version

能输出版本号即安装成功；报错就重开一个管理员终端再试。

5. 配置 npm 国内镜像源并安装 Claude Code

安装 Claude Code（首次可能因国外源下载很慢）：

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

如果下载速度慢，按 Ctrl + C 终止，然后切换为国内镜像源：

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

再次安装：

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

换成 npmmirror 国内镜像后，下载速度会明显提升。

校验：安装完成后执行下面的命令确认已就位。看不到版本号，就重开管理员终端再装一次。

claude --version

6. 配置 `.claude.json`

进入 C:\Users\你的用户名\ 目录。
顶部菜单点击“查看”，勾选“隐藏的项目”和“文件扩展名”。
右键 → 新建文本文档 → 重命名为 .claude.json。
双击用记事本打开，输入以下内容（注意补全 JSON 格式）：

{
  "hasCompletedOnboarding": true,
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "你的API Key",
    "ANTHROPIC_BASE_URL": "模型厂商的URL",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,
    "ENABLE_TOOL_SEARCH": false
  }
}

校验：保存后做两处自查——一是文件名确实是 .claude.json（而不是 .claude.json.txt，扩展名一定要显示出来）；二是内容能被正确解析，可把 JSON 粘到任意在线校验工具里验一遍，避免漏逗号或大括号不配对。

7. 获取 API Key 和 Base URL

这里以 Kimi 为例，其他兼容的服务商操作类似：

前往 Kimi 官网 → Kimi Code 控制台，获取 API Key。
右上角“文档” → 最下方“其他 Coding Agent 使用” → 找到 Base URL。
把 API Key 和 Base URL 填进上一步的 .claude.json 配置文件里。

API Key 属于敏感凭证：不要写进会公开的代码、截图或仓库里。一旦泄露，请立刻在控制台重置。

8. 启动 Claude

在桌面空白处按住 Shift，右键打开 PowerShell 终端。
输入命令启动：

claude

选择第一个选项，信任该文件夹。

校验：能正常进入对话界面即启动成功。若提示 claude 不是命令，多半是 npm 全局 bin 目录没进 PATH，重开终端或补上路径再试。

9. 安装 VS Code 工具

前往 VS Code 官网下载安装包。
右键以管理员身份运行，一路下一步完成安装。
验证：打开 VS Code 后按 Ctrl + ` 调出终端，输入 claude，能拉起即说明编辑器与命令行环境接上了。

10. 安装 Watt Toolkit（加速 GitHub 访问）

前往 Watt Toolkit 官网，下载“Windows 官方下载 | 微软应用商店”版本。
打开应用 → 网络加速 → 勾选 GitHub → 一键加速。

注意：注册 GitHub 时请关闭加速器，以便正常接收验证邮件；注册完成后再打开加速器登录。

11. 实战操作

在桌面新建一个文件夹，进入文件夹。
Shift + 右键 → 在此处打开 PowerShell 终端。
输入命令：

claude

给 Claude 输入提示词：

读取 prompt.txt 并按其中要求做

第一次合作建议先用一个小任务试水，比如让它读取并总结一个文件，确认能正常读写当前目录后，再放手做更复杂的活。

常见问题排查

现象	可能原因	处理
`node` / `npm` 不是内部或外部命令	PATH 未生效	确认 `C:\Program Files\nodejs` 已加入系统 Path，重启终端
`claude` 找不到命令	npm 全局目录不在 PATH	找到 npm 全局 bin 路径加入 PATH，或重开管理员终端
启动后报鉴权错误	API Key 或 Base URL 填错	核对该行配置，注意引号、大小写与结尾逗号
安装包下载一直卡住	国外源太慢	切换 npmmirror 镜像后重新安装
提示脚本被禁用	执行策略未放开	重设 `Set-ExecutionPolicy RemoteSigned`
配置文件不生效	文件名带隐藏后缀	打开“文件扩展名”，确认文件名确为 `.claude.json`

环境搭好之后，Claude Code 能发挥多少，就取决于你怎么写提示词了。把常用任务整理成 prompt.txt，再让代理按图施工，是最省心的起步方式。