Claude Code 安装教程与 Windows 环境部署

Claude Code安装教程：安装前先检查工作机

在工作机内打开“设置 → 系统 → 关于”，查看操作系统版本、处理器架构和可用内存。官方安装文档列出 Windows 10 1809 及以上版本或 Windows Server 2019 及以上版本，要求至少 4GB 内存以及 x64 或 ARM64 处理器。软件最低要求只是能运行的门槛，多任务编辑、编译与浏览器使用还需要给项目留下资源。

确认你能正常访问官方安装与认证服务，项目所在磁盘有足够空间，并有权限写入用户目录。远程桌面已连通并不代表第三方软件已具备使用资格，账户准备可以阅读支持地区与账户使用条件。

二、选择原生 Windows 或 WSL

如果你主要使用 Windows 软件，可以从原生安装开始。项目本身依赖 Linux 工具链时，再考虑 WSL；云环境是否允许开启虚拟化和 WSL 2，应先向客服确认。不要把 Windows 终端中的安装位置与 WSL 的安装位置混为一谈，两个环境的用户目录与运行工具并不完全相同。

三、在 PowerShell 中安装

在工作机开始菜单打开 PowerShell，确认提示符以 PS 开头，然后运行当前官方提供的原生安装命令。安装涉及下载并执行官方脚本，先核对下面地址，再在你自己的工作机中执行。

irm https://claude.ai/install.ps1 | iex

下载期间可能没有进度输出，等待安装命令返回即可，不要因为窗口暂时没有文字就重复启动多次。完成后关闭旧终端，打开新的 PowerShell 窗口。官方也提供 WinGet 安装方式，可根据自己的软件管理习惯选择一条安装路径。

winget install Anthropic.ClaudeCode

两种方式择一使用。WinGet 安装后的升级由包管理器管理；原生安装方式的更新机制与其不同。

四、验证版本并进入项目

claude --version
claude doctor

版本命令用于确认程序是否可找到，doctor 用于检查安装环境。这里不预设输出的版本号或诊断结果，以你的终端实际输出为准。然后在终端中进入自己的项目目录再启动工具。

Set-Location "C:\Projects\my-project"
claude

my-project 是示例目录，替换为你自己的代码位置。首次运行按软件实际提示进行认证，并确认当前会话有权访问项目。建议先用可恢复的小任务熟悉权限提示和文件变更，再处理正式项目。

五、准备 Git 与编辑器

在远程桌面中安装 VS Code，并按项目要求准备 Git、运行时与依赖。Git for Windows 可提供 Git Bash 工具；是否需要 Bash 与具体功能有关，不要把 Node.js 当作所有原生安装方式都必需的前置条件。

git --version
git config --global user.name "Your Name"
git config --global user.email "you@example.com"

上面的姓名与邮箱是示例，提交代码前替换为自己实际使用的身份。将工作机中的仓库连接到获授权的远程仓库，设置 .gitignore，把缓存、密钥和本地环境文件排除在版本控制之外。更多维护方法见长期开发工作站管理指南。

六、安装失败时怎样排查

• 提示 irm 不是命令：通常是在 CMD 中运行了 PowerShell 命令，换到 PowerShell 后再执行。
• 提示 claude 未识别：先重新打开终端，再检查安装目录是否进入用户 PATH。不要直接把问题归因于套餐资源。
• 下载报错：记录状态码与错误文字，检查网络、代理或企业安全策略，再核对官方安装说明。
• 项目工具运行失败：分别检查当前目录、文件权限、运行时版本和依赖，不要只重复安装 Claude Code。

使用 WinGet 安装的版本可通过 winget upgrade Anthropic.ClaudeCode 升级。原生安装的版本管理、诊断与其他选项继续以官方文档为依据，避免将不同渠道的维护命令混用。

Claude Code安装教程常见问题

安装前需要先连接云电脑吗？

需要。安装命令在远程 Windows 内执行，先按远程桌面教程进入交付的工作环境。

原生 Windows 与 WSL 要同时安装吗？

不需要。按项目工具链选择一种环境；使用 WSL 前确认虚拟化和系统权限。

安装成功后怎样确认项目目录？

在新终端验证版本，再进入自己的仓库目录；运行和授权前先检查目录中的文件。