Windows 也能用 Claude Code 了！完整安装教程+避坑指南

最近越来越多人在用 Claude Code，这款由 Anthropic 推出的编程助手 CLI 工具。它可以让你在本地终端用 Claude 来改代码、生成函数、写测试、理解报错，类似于本地版 Copilot CLI。

一、Claude Code 是什么？能干嘛？

Claude Code 是 Anthropic 团队开发的本地 CLI 工具，核心功能包括：

• 用自然语言生成代码片段 / 函数
• 自动补充测试用例
• 重写函数逻辑
• 分析报错、解释复杂代码段
• 和你的代码上下文保持对话

体验上类似于本地 Copilot，但 Claude 表现出更强的语言理解和代码重构能力，特别适合中高级开发者。

二、Windows 上能不能用？

✅ 现在可以了！

Claude Code 官方目前提供了两种 Windows 支持方式：

方式	是否推荐
Git Bash / WSL 安装	✅ 官方推荐
win-claude-code（社区原生运行）	⚠️ 有坑但可用

---

三、安装流程

🧱 Step 1：准备环境

1. 确保你装了 Node.js ≥ 18

   命令检查：

   node -v
   npm -v

2. 建议切换 npm 镜像（墙内用户）

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

3. 用管理员权限打开 PowerShell

   避免全局安装失败。

---

🧰 Step 2：安装 Claude Code CLI

这是最关键的一步！不要写错命令！

npm install -g @anthropic-ai/claude-code --ignore-scripts --force

验证：

claude --help

能正常输出命令帮助即安装成功。

---

⚡ Step 3：启用 win-claude-code 原生运行

如果你不想用 Git Bash，也可以直接运行：

npx win-claude-code@latest

首次运行会自动创建 Windows 下的 claude.cmd，方便之后直接输入 claude 调用。

---

四、常见报错与解决方案

报错信息	原因	解决方式
Permission denied (publickey)	误用 GitHub SSH 地址	改用正确的 npm 包名
Could not read from remote repository	没有 SSH key 权限	不要用 Git 仓库安装
postinstall chmod 报错	Windows 不支持 chmod	加 --ignore-scripts
EACCES / EPERM	权限不足	用管理员 PowerShell

---

五、登录

一步一步登录 claude 账户就可以了，也可以设置自己的claude api key。

pro用户就可以用，但是限额比较少。真的要沟通，得买200美元的版本。

Pro $20/月 平均 可发送约 45 条聊天消息 或 约 10 -- 40 个 Claude Code prompt

---

六、Claude Code + IDE：生产力爆炸

你可以在 Cursor、Trae 等现代 AI IDE 中直接接入 Claude Code CLI，让你的本地 IDE 编程助手切 Claude 模型！

在 Cursor 中，只需打开设置 → Terminal Assistant → CLI path 填入 claude 即可。