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

9,903 阅读3分钟

最近越来越多人在用 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(社区原生运行)⚠️ 有坑但可用

比如说: 在 Windows 上,Claude Code CLI 支持输入框带图片,但目前只能接收 拖放的文件路径,不能像 macOS/Linux 那样直接把剪贴板里的位图透过 Ctrl + V 带进终端。


三、安装流程

🧱 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 即可。

image.png

image.png

七、一些个人认为一定要的配置

auto-run

找到这个文件 C:\Users\Admin.claude 然后添加:

{
  "permissions": {
    "allow": ["Edit(*)", "Bash(*)", "Read(*)", "Write(*)"]
  }
}

这样就不用每次都手工确认自动运行了。我个人还是很放心claude的,相反总是让我确认会中断任务运行。