Claude Code 在 Windows 下的部署与使用教程

教程

Claude Code 是 Anthropic 官方推出的命令行编程助手。它不是 IDE 插件，而是一个可以直接在终端里跟你对话的 AI 编程代理——能读代码、写代码、改代码、跑测试、提交 Git，全流程自动完成。

如果你用的是 Windows，这篇教程就是为你写的。从安装到实战，一步步来。

一、环境要求

  • Windows 10 或 Windows 11
  • Node.js >= 18（推荐 v20+）
  • Git（必须，Claude Code 需要 Git 仓库上下文）
  • Anthropic API Key 或 Claude Pro/Team/Enterprise 账号

二、安装 Node.js

如果你还没有 Node.js：

  1. 打开 nodejs.org，下载 LTS 版本
  2. 运行安装包，一路 Next 即可（默认会勾选"Add to PATH"）
  3. 打开新的 PowerShell，验证：
node --version
npm --version

如果看到版本号，说明安装成功。

三、安装 Git

Claude Code 需要 Git 仓库来理解你的代码结构：

  1. 打开 git-scm.com，下载 Windows 安装包
  2. 安装时建议勾选：
  • Git from the command line and also from 3rd-party software
  • Use Git from Git Bash only（如果你不常用 Git Bash 可选第二个）

验证：

git --version

四、安装 Claude Code

打开 PowerShell（建议用 Windows Terminal，体验更好）：

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

安装完成后验证：

claude --version

如果安装报错

Windows 上最常见的错误是权限问题。如果遇到 EPERM 或 EACCES：

方法一：用管理员权限运行 PowerShell

右键开始菜单 → Windows Terminal (管理员)，然后重新执行安装命令。

方法二：修改 npm 全局安装路径

mkdir $HOME\.npm-global
npm config set prefix $HOME\.npm-global
[Environment]::SetEnvironmentVariable("PATH", $env:PATH + ";" + $HOME + "\.npm-global", "User")

然后重新打开终端，再执行 npm install -g @anthropic-ai/claude-code。

五、认证登录

首次运行时，Claude Code 会让你登录：

claude

终端会弹出一个浏览器窗口，让你用 Anthropic 账号登录。登录成功后终端会自动获取 API Key。

如果你有 API Key，也可以手动设置：

$env:ANTHROPIC_API_KEY = "sk-ant-xxxxxxxxxxxxxxxx"
claude

或者写到环境变量里永久生效（在 PowerShell 中）：

[Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-ant-xxxxxxxxxxxxxxxx", "User")

六、创建或进入项目

Claude Code 需要在一个 Git 仓库里运行。如果你还没有项目：

mkdir my-project
cd my-project
git init
claude

如果你已有项目：

cd C:\Users\YourName\Projects\your-repo
claude

七、基本使用

启动后你会看到一个 > 提示符，可以直接跟 AI 对话：

让 AI 帮你写代码

> 帮我创建一个 Python Flask 应用，包含 /hello 路由

Claude Code 会直接创建文件并写入代码，你可以看到它做了什么。

让 AI 修改代码

> 把 app.py 里的 /hello 路由改成 /greet，返回 JSON 格式

让 AI 执行命令

> 运行 app.py 看看效果

它会执行命令并把输出给你看。如果命令有危险（比如删除文件），它会先问你是否确认。

让 AI 提交 Git

> 把刚才的改动提交到 Git，commit message 用英文

它会执行 git add 和 git commit，甚至 git push。

八、高级功能

多文件编辑

你可以让 Claude Code 同时修改多个文件：

> 把所有文件里的 console.log 替换成 logger.info

代码审查

> 审查最近一次提交的所有改动，指出潜在问题

调试

把错误信息贴给它：

> 运行 npm start 报了下面的错误，帮我修：
> Error: Cannot find module 'express'

自定义指令（CLAUDE.md）

在项目根目录创建一个 CLAUDE.md 文件，写上你的编码规范和项目说明，Claude Code 每次都会读取：

# 项目规范

- 使用 TypeScript
- 变量命名用 camelCase
- 每个函数必须有 JSDoc 注释
- 修改代码后自动运行测试

常用斜杠命令

| 命令 | 作用 |
|------|------|
| /help | 查看帮助 |
| /clear | 清空对话历史 |
| /model | 查看或切换模型 |
| /cost | 查看当前会话的 API 费用 |

九、Windows 特有注意事项

路径问题：Windows 使用反斜杠 \，Claude Code 能自动处理，但如果你手动指定路径，记得用双反斜杠或者正斜杠。

换行符：Windows 默认是 CRLF，如果项目需要 LF，在 Git 中设置：

git config --global core.autocrlf input

PowerShell 编码：如果遇到中文乱码，在 PowerShell 中设置：

[Console]::OutputEncoding = [System.Text.Encoding]::UTF8

杀毒软件拦截：某些杀毒软件会阻止 Node.js 创建的子进程。如果 Claude Code 执行命令失败，尝试把 Node.js 添加到杀毒软件的白名单。

WSL：如果你在 Windows Subsystem for Linux 中使用 Claude Code，一切和 Linux 上一样，不需要额外处理。

十、费用说明

Claude Code 使用的是 Anthropic 的 API，费用按 token 计算。大致参考：

  • 每次对话（输入+输出）大约消耗 0.01-0.1 美元
  • 正常开发使用，一天大概 0.5-2 美元
  • 如果是 Claude Pro/Team 订阅用户，有一定免费额度

可以用 /cost 命令随时查看当前会话的费用。

十一、常见问题

Q：Claude Code 和 Cursor 有什么区别？

Claude Code 是命令行工具，不需要特定 IDE。你可以在任何编辑器旁边开一个终端窗口用。Cursor 是独立编辑器。两者可以配合使用——Cursor 用来编辑，Claude Code 用来执行批量操作。

Q：支持中文对话吗？

完全支持。你可以直接用中文和它对话，它也能用中文回答和写注释。

Q：能在公司电脑上用吗？

可以，但要注意公司 IT 政策。代码不会被上传到 Anthropic 以外的地方（除了 API 调用本身）。

Q：断网了怎么办？

Claude Code 需要联网。断网后无法工作，恢复网络后继续使用即可。对话历史在终端关闭后不保存。

十二、快速上手

总结一下，只需四步：

  1. npm install -g @anthropic-ai/claude-code
  2. cd 你的项目目录
  3. claude
  4. 开始对话

就这么简单。

有问题的话，欢迎在评论区留言。