Windows 安装 Claude Code 完整教程（避坑版）

一、前置准备1. 系统与权限要求系统Windows 10 / 1164 位权限需使用管理员权限的 PowerShell 或 CMD 终端2. 安装 Node.js必装依赖Claude Code 依赖 Node.js 运行推荐安装 LTS 版本≥ 20.x访问 Node.js 官网 下载 Windows 安装包运行安装程序建议默认安装到C:\Program Files\nodejs\全程点击下一步安装完成后打开管理员 PowerShell验证环境node-v npm-v正常输出版本号即为安装成功。二、安装 Claude Code官方正确步骤1. 切换国内镜像解决网络问题执行以下命令避免官方源导致的安装慢/失败npm configsetregistry https://registry.npmmirror.com2. 卸载之前的错误包如果安装过如果你之前安装了非官方的claude-code占位包必须先卸载npm uninstall-g claude-code3. 安装官方包⚠️ 关键提示官方包名是anthropic-ai/claude-codenpm install-g anthropic-ai/claude-code4. 验证安装claude--version正常输出版本号说明安装完全正常。5.查看 Claude Code 可执行文件路径安装路径where claude三、解决「命令找不到」问题如果提示claude无法识别按以下步骤解决1. 检查 PATH 环境变量执行以下命令查看 npm 全局路径npm prefix-g把输出的路径例如C:\Users\LENOVO\AppData\Roaming\npm添加到系统环境变量Path中关闭所有 PowerShell 窗口重新打开终端再试2. 直接使用完整路径临时方案C:\Users\LENOVO\AppData\Roaming\npm\claude--version四、绕过首次启动校验让程序正常打开1. 修改配置文件找到并编辑文件C:\Users\你的用户名\.claude.json如果文件不存在新建一个文本文件并重命名为.claude.json写入以下内容{hasCompletedOnboarding:true}保存文件关闭所有 PowerShell 窗口重新打开终端。2. 测试启动claude出现 Claude 欢迎界面说明校验已绕过。五、接入阿里云百炼国内可用无需代理1. 获取阿里云百炼 API Key访问 阿里云百炼控制台注册/登录账号进入「API-KEY 管理」页面创建新的 API Key复制保存备用格式如sk-xxxx2. 设置环境变量永久生效在管理员 PowerShell 中执行以下命令替换为你自己的 API Key# 设置 API Keysetx ANTHROPIC_API_KEYYOUR_DASHSCALE_API_KEY# 设置中转 URLsetx ANTHROPIC_BASE_URLhttps://dashscope.aliyuncs.com/apps/anthropic# 设置模型以 glm-5 为例setx ANTHROPIC_MODELglm-53. 验证配置是否生效重启终端后执行echo%ANTHROPIC_API_KEY%echo%ANTHROPIC_BASE_URL%echo%ANTHROPIC_MODEL%能看到配置的内容说明环境变量已生效。4. 启动 Claude Codeclaude此时 Claude Code 会自动使用阿里云百炼的模型无需访问 Anthropic 官方服务国内可直接使用。六、Claude Code 三种核心模式使用快捷键Shift Tab可以在终端内快速切换模式。模式命令 / 提示行为描述适用场景模式一? for shortcuts修改文件前必须询问用户确认对代码安全要求高、不希望程序自动修改文件时模式二accept edits on自动修改文件无需确认快速迭代开发、信任模型输出时模式三plan mode on只讨论方案不修改任何文件前期需求分析、架构设计、风险评估阶段模式使用方法启动claude进入交互界面按下Shift Tab切换模式终端会显示当前模式状态输入你的需求即可按模式执行七、快速上手使用1. 启动交互模式claude进入后可直接输入需求如帮我写一个 Spring Boot 的 Hello World 接口。2. 常用命令示例# 查看帮助claude--help# 生成指定代码文件claude code创建一个 Spring Boot 的 Hello World 接口八、常见问题与解决方案问题现象原因分析解决方法Wrong package!安装了非官方占位包卸载claude-code安装anthropic-ai/claude-code404 Not Found包名错误确保安装命令为npm install -g anthropic-ai/claude-code权限不足未使用管理员终端右键 PowerShell选择以管理员身份运行claude无法识别PATH 未配置将npm prefix -g的路径添加到系统Path安装速度极慢官方源网络问题执行npm config set registry https://registry.npmmirror.com切换国内镜像九、卸载方法备用如需重新安装可执行卸载命令npm uninstall-g anthropic-ai/claude-code