Claude CLI 从安装到使用完整教程(Windows 版)

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

前往 nodejs.org 下载最新 LTS 版本的 Windows 安装包(),按向导完成安装,安装时勾选”自动安装必要工具”选项。

安装完成后,打开 PowerShell 验证版本:



01-flowchart-install-flow.png

打开 PowerShell(以管理员身份运行),执行全局安装命令:


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

安装完成后,验证安装是否成功:



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


将输出的路径(如 )添加到系统环境变量 PATH 中:

  1. 右键”此电脑” → “属性” → “高级系统设置” → “环境变量”
  2. 在”用户变量”中找到 ,点击”编辑”
  3. 点击”新建”,粘贴上述路径claude code 教程
  4. 确定保存后,重新打开 PowerShell 使其生效

Claude CLI 需要 Anthropic API Key 才能正常工作。

  1. 访问 console.anthropic.com
  2. 注册或登录账号
  3. 进入 API Keys 页面
  4. 点击 Create Key 生成新的 API Key

临时设置(仅当前会话有效):


永久设置(推荐):

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


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

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

验证环境变量已生效:



在项目目录下打开 PowerShell,运行 ,进入交互式对话:


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

使用 参数执行一次性查询:


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







02-infographic-features-overview.png



操作 命令 / 快捷键 启动 Claude 单次查询 查看帮助 清空对话 退出 或 查看历史
  • — 查看所有可用命令
  • — 清除当前对话上下文
  • — 压缩对话历史以节省 Token
  • — 切换使用的模型
  • — 查看本次会话的 Token 消耗

在项目根目录创建 文件,Claude 会自动读取其中的内容作为项目背景:


在 PowerShell 中快速创建该文件:


在对话中使用 引用具体文件:



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

  • 全局
  • 项目

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


示例配置:


Claude CLI 有三种权限模式:

  • 默认模式:每次文件修改都需要用户确认
  • 自动批准: 自动执行所有操作(谨慎使用)
  • 只读模式:仅读取文件,不做修改

  1. 使用 Windows Terminal:比默认 PowerShell 窗口体验更好,支持多标签和彩色输出
  2. 始终在项目根目录启动:这样 Claude 能更好地理解项目结构
  3. 编写详细的 CLAUDE.md:提供技术栈、编码规范等背景信息
  4. 明确描述需求:越具体的指令,生成的结果越准确
  5. 分步执行复杂任务:将大任务拆分为小步骤,逐一确认
  6. 定期使用 :长对话时压缩上下文,避免 Token 超限

Q: 提示 ?

检查 npm 全局包路径是否在 PATH 中,参考”安装 Claude CLI”章节中的 PATH 配置步骤。


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

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


Q: API 请求失败,返回 401 错误?

检查 环境变量是否正确设置,或 Key 是否已过期:


Q: 响应速度慢?

可以切换到更快的模型,如 :



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

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

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

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请联系我们举报,一经查实,本站将立刻删除。

发布者:全栈程序员-站长,转载请注明出处:https://javaforall.net/239546.html原文链接:https://javaforall.net

(0)
上一篇 2026年3月16日 上午9:20
下一篇 2026年3月16日 上午9:20


相关推荐

关注全栈程序员社区公众号