Claude CLI 从安装到使用完整教程（Windows 版）

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 验证版本：

powershell 复制代码

node --version
# 输出示例：v24.14.0

npm --version
# 输出示例：11.9.0

二、安装 Claude CLI

打开 PowerShell（以管理员身份运行），执行全局安装命令：

powershell 复制代码

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

提示：如果安装时报权限错误，请右键点击 PowerShell 选择"以管理员身份运行"后重试。

安装完成后，验证安装是否成功：

powershell 复制代码

claude --version

更新到最新版本

powershell 复制代码

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

解决 PATH 问题

如果提示 claude 不是可识别的命令，需要将 npm 全局包路径加入系统 PATH：

powershell 复制代码

# 查看 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）

临时设置（仅当前会话有效）：

powershell 复制代码

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

永久设置（推荐）：

方法一：通过 PowerShell 命令写入用户环境变量：

powershell 复制代码

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

方法二：通过系统界面设置：

右键"此电脑" → "属性" → "高级系统设置" → "环境变量"
在"用户变量"区域点击"新建"
变量名填写 ANTHROPIC_API_KEY，变量值填写你的 API Key
确定保存，重新打开 PowerShell 使其生效

验证环境变量已生效：

powershell 复制代码

echo $env:ANTHROPIC_API_KEY

四、基础使用

启动交互模式

在项目目录下打开 PowerShell，运行 claude，进入交互式对话：

powershell 复制代码

cd C:\Users\你的用户名\projects\your-project
claude

进入后，你会看到提示符，可以直接输入问题或指令。

单次查询模式

使用 -p 参数执行一次性查询：

powershell 复制代码

claude -p "解释这个项目的目录结构"

处理文件

让 Claude 分析或修改特定文件：

powershell 复制代码

claude -p "审查 src/index.js 中的代码，找出潜在的 bug"

五、核心功能演示

代码生成

markdown 复制代码

> 用 Python 写一个读取 CSV 文件并计算每列平均值的脚本

代码解释

shell 复制代码

> 解释 @src/utils/parser.ts 这个文件的作用

代码重构

kotlin 复制代码

> 重构 @components/Button.jsx，将 class 组件改为函数组件，并添加 TypeScript 类型

调试协助

javascript 复制代码

> 我的应用报错：TypeError: Cannot read property 'map' of undefined，帮我分析原因

生成测试

shell 复制代码

> 为 @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 会自动读取其中的内容作为项目背景：

markdown 复制代码

# 项目说明

这是一个 React + TypeScript 的电商平台前端项目。

## 技术栈
- React 18
- TypeScript 5
- Tailwind CSS
- Zustand 状态管理

## 编码规范
- 使用函数组件和 Hooks
- 组件文件使用 PascalCase 命名
- 工具函数使用 camelCase 命名

在 PowerShell 中快速创建该文件：

powershell 复制代码

New-Item -Path "CLAUDE.md" -ItemType File
notepad CLAUDE.md

引用文件

在对话中使用 @文件路径 引用具体文件：

shell 复制代码

> 参考 @src/components/Card.tsx 的风格，创建一个新的 Modal 组件

八、高级配置

配置文件

Claude CLI 支持通过配置文件自定义行为，配置文件位于：

全局：C:\Users\你的用户名\.claude\settings.json
项目：.claude\settings.json

在 PowerShell 中查看全局配置目录：

powershell 复制代码

explorer "$env:USERPROFILE\.claude"

示例配置：

json 复制代码

{
  "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 配置步骤。

powershell 复制代码

# 查看 npm 全局包路径
npm config get prefix

Q: PowerShell 提示脚本执行被禁止？

以管理员身份运行 PowerShell，执行以下命令允许本地脚本运行：

powershell 复制代码

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Q: API 请求失败，返回 401 错误？

检查 ANTHROPIC_API_KEY 环境变量是否正确设置，或 Key 是否已过期：

powershell 复制代码

echo $env:ANTHROPIC_API_KEY

Q: 响应速度慢？

可以切换到更快的模型，如 claude-haiku-4-5：

bash 复制代码

/model claude-haiku-4-5-20251001

总结

Claude CLI 是一个强大的 AI 编程助手，将 Claude 的能力无缝集成到你的开发工作流中。通过本教程，你已经掌握了在 Windows 上从安装配置到日常使用的完整流程。建议在实际项目中多加练习，充分利用 Claude 的能力提升开发效率。

更多文档请参考官方文档：docs.anthropic.com/claude-code

如果你喜欢本教程，记得点赞+收藏！关注我获取更多AI相关干货