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

打开 PowerShell(以管理员身份运行),执行全局安装命令:
提示:如果安装时报权限错误,请右键点击 PowerShell 选择”以管理员身份运行”后重试。
安装完成后,验证安装是否成功:
如果提示 不是可识别的命令,需要将 npm 全局包路径加入系统 PATH:
将输出的路径(如 )添加到系统环境变量 PATH 中:
- 右键”此电脑” → “属性” → “高级系统设置” → “环境变量”
- 在”用户变量”中找到 ,点击”编辑”
- 点击”新建”,粘贴上述路径claude code 教程
- 确定保存后,重新打开 PowerShell 使其生效
Claude CLI 需要 Anthropic API Key 才能正常工作。
- 访问 console.anthropic.com
- 注册或登录账号
- 进入 API Keys 页面
- 点击 Create Key 生成新的 API Key
临时设置(仅当前会话有效):
永久设置(推荐):
方法一:通过 PowerShell 命令写入用户环境变量:
方法二:通过系统界面设置:
- 右键”此电脑” → “属性” → “高级系统设置” → “环境变量”
- 在”用户变量”区域点击”新建”
- 变量名填写 ,变量值填写你的 API Key
- 确定保存,重新打开 PowerShell 使其生效
验证环境变量已生效:
在项目目录下打开 PowerShell,运行 ,进入交互式对话:
进入后,你会看到提示符,可以直接输入问题或指令。
使用 参数执行一次性查询:
让 Claude 分析或修改特定文件:

- — 查看所有可用命令
- — 清除当前对话上下文
- — 压缩对话历史以节省 Token
- — 切换使用的模型
- — 查看本次会话的 Token 消耗
在项目根目录创建 文件,Claude 会自动读取其中的内容作为项目背景:
在 PowerShell 中快速创建该文件:
在对话中使用 引用具体文件:
Claude CLI 支持通过配置文件自定义行为,配置文件位于:
- 全局:
- 项目:
在 PowerShell 中查看全局配置目录:
示例配置:
Claude CLI 有三种权限模式:
- 默认模式:每次文件修改都需要用户确认
- 自动批准: 自动执行所有操作(谨慎使用)
- 只读模式:仅读取文件,不做修改
- 使用 Windows Terminal:比默认 PowerShell 窗口体验更好,支持多标签和彩色输出
- 始终在项目根目录启动:这样 Claude 能更好地理解项目结构
- 编写详细的 CLAUDE.md:提供技术栈、编码规范等背景信息
- 明确描述需求:越具体的指令,生成的结果越准确
- 分步执行复杂任务:将大任务拆分为小步骤,逐一确认
- 定期使用 :长对话时压缩上下文,避免 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
