Claude Code 是 Anthropic 官方推出的命令行 AI 编程助手，可以直接在终端中与 Claude 对话，帮助你完成代码编写、调试、重构等任务。本教程带你在 Windows 系统上从零开始，快速上手 Claude CLI。
一、环境准备
在安装 Claude CLI 之前，需要确保你的系统满足以下条件：
- Node.js：版本 18 及以上
- npm：包管理工具（随 Node.js 一同安装）
- 操作系统：Windows 10 / Windows 11
- 终端：推荐使用 PowerShell 5.1+ 或 Windows Terminal
- 网络：能正常访问 Anthropic API,如果有自备的公益API也行，例如anyrouter
安装 Node.js
前往 nodejs.org 下载最新 LTS 版本的 Windows 安装包（.msi），按向导完成安装，安装时勾选"自动安装必要工具"选项。
安装完成后，打开 PowerShell 验证版本：
node --version
# 输出示例：v24.14.0
npm --version
# 输出示例：11.9.0
二、安装 Claude CLI
打开 PowerShell（以管理员身份运行），执行全局安装命令：
npm install -g @anthropic-ai/claude-code
提示：如果安装时报权限错误，请右键点击 PowerShell 选择"以管理员身份运行"后重试。
安装完成后，验证安装是否成功：
claude --version
更新到最新版本
npm update -g @anthropic-ai/claude-code
解决 PATH 问题
如果提示 claude 不是可识别的命令，需要将 npm 全局包路径加入系统 PATH：
# 查看 npm 全局包安装路径
npm config get prefix
将输出的路径（如 C:\Users\你的用户名\AppData\Roaming\npm）添加到系统环境变量 PATH 中：
- 右键"此电脑" → "属性" → "高级系统设置" → "环境变量"
- 在"用户变量"中找到
Path，点击"编辑" - 点击"新建"，粘贴上述路径
- 确定保存后，重新打开 PowerShell 使其生效
三、配置 API Key
Claude CLI 需要 Anthropic API Key 才能正常工作。
获取 API Key
- 访问 console.anthropic.com
- 注册或登录账号
- 进入 API Keys 页面
- 点击 Create Key 生成新的 API Key
设置环境变量（PowerShell）
临时设置（仅当前会话有效）：
$env:ANTHROPIC_API_KEY = "sk-ant-xxxxxxxxxxxxxxxx"
永久设置（推荐）：
方法一：通过 PowerShell 命令写入用户环境变量：
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-ant-xxxxxxxxxxxxxxxx", "User")
方法二：通过系统界面设置：
- 右键"此电脑" → "属性" → "高级系统设置" → "环境变量"
- 在"用户变量"区域点击"新建"
- 变量名填写
ANTHROPIC_API_KEY，变量值填写你的 API Key - 确定保存，重新打开 PowerShell 使其生效
验证环境变量已生效：
echo $env:ANTHROPIC_API_KEY
四、基础使用
启动交互模式
在项目目录下打开 PowerShell，运行 claude，进入交互式对话：
cd C:\Users\你的用户名\projects\your-project
claude
进入后，你会看到提示符，可以直接输入问题或指令。
单次查询模式
使用 -p 参数执行一次性查询：
claude -p "解释这个项目的目录结构"
处理文件
让 Claude 分析或修改特定文件：
claude -p "审查 src/index.js 中的代码，找出潜在的 bug"
五、核心功能演示
代码生成
> 用 Python 写一个读取 CSV 文件并计算每列平均值的脚本
代码解释
> 解释 @src/utils/parser.ts 这个文件的作用
代码重构
> 重构 @components/Button.jsx，将 class 组件改为函数组件，并添加 TypeScript 类型
调试协助
> 我的应用报错：TypeError: Cannot read property 'map' of undefined，帮我分析原因
生成测试
> 为 @src/api/user.js 中的所有函数生成单元测试
六、常用命令与快捷键
| 操作 | 命令 / 快捷键 |
|---|---|
| 启动 Claude | claude |
| 单次查询 | claude -p "问题" |
| 查看帮助 | claude --help |
| 清空对话 | /clear |
| 退出 | /exit 或 Ctrl+C |
| 查看历史 | /history |
常用 Slash 命令
/help— 查看所有可用命令/clear— 清除当前对话上下文/compact— 压缩对话历史以节省 Token/model— 切换使用的模型/cost— 查看本次会话的 Token 消耗
七、项目上下文管理
CLAUDE.md 文件
在项目根目录创建 CLAUDE.md 文件，Claude 会自动读取其中的内容作为项目背景：
# 项目说明
这是一个 React + TypeScript 的电商平台前端项目。
## 技术栈
- React 18
- TypeScript 5
- Tailwind CSS
- Zustand 状态管理
## 编码规范
- 使用函数组件和 Hooks
- 组件文件使用 PascalCase 命名
- 工具函数使用 camelCase 命名
在 PowerShell 中快速创建该文件：
New-Item -Path "CLAUDE.md" -ItemType File
notepad CLAUDE.md
引用文件
在对话中使用 @文件路径 引用具体文件：
> 参考 @src/components/Card.tsx 的风格，创建一个新的 Modal 组件
八、高级配置
配置文件
Claude CLI 支持通过配置文件自定义行为，配置文件位于：
- 全局：
C:\Users\你的用户名\.claude\settings.json - 项目：
.claude\settings.json
在 PowerShell 中查看全局配置目录：
explorer "$env:USERPROFILE\.claude"
示例配置：
{
"model": "claude-opus-4-6",
"theme": "dark",
"autoApprove": false
}
权限模式
Claude CLI 有三种权限模式：
- 默认模式：每次文件修改都需要用户确认
- 自动批准：
--dangerously-skip-permissions自动执行所有操作（谨慎使用） - 只读模式：仅读取文件，不做修改
九、最佳实践
- 使用 Windows Terminal：比默认 PowerShell 窗口体验更好，支持多标签和彩色输出
- 始终在项目根目录启动：这样 Claude 能更好地理解项目结构
- 编写详细的 CLAUDE.md：提供技术栈、编码规范等背景信息
- 明确描述需求：越具体的指令，生成的结果越准确
- 分步执行复杂任务：将大任务拆分为小步骤，逐一确认
- 定期使用
/compact：长对话时压缩上下文，避免 Token 超限
十、常见问题
Q: 提示 claude 不是内部或外部命令？
检查 npm 全局包路径是否在 PATH 中，参考"安装 Claude CLI"章节中的 PATH 配置步骤。
# 查看 npm 全局包路径
npm config get prefix
Q: PowerShell 提示脚本执行被禁止？
以管理员身份运行 PowerShell，执行以下命令允许本地脚本运行：
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Q: API 请求失败，返回 401 错误？
检查 ANTHROPIC_API_KEY 环境变量是否正确设置，或 Key 是否已过期：
echo $env:ANTHROPIC_API_KEY
Q: 响应速度慢？
可以切换到更快的模型，如 claude-haiku-4-5：
/model claude-haiku-4-5-20251001
总结
Claude CLI 是一个强大的 AI 编程助手，将 Claude 的能力无缝集成到你的开发工作流中。通过本教程，你已经掌握了在 Windows 上从安装配置到日常使用的完整流程。建议在实际项目中多加练习，充分利用 Claude 的能力提升开发效率。
更多文档请参考官方文档：docs.anthropic.com/claude-code
如果你喜欢本教程，记得点赞+收藏！关注我获取更多AI相关干货
