Claude Code 下载与 Windows 安装：Desktop App、CLI、WSL 怎么选（2026）

搜 Claude Code download 时，最容易踩的坑不是下载失败，而是没先弄清自己要装哪一个：

• 想要图形界面、并排管理多个任务，下载 Claude Desktop，进入其中的 Code 标签；
• 想在 PowerShell、CMD、Git Bash 或 IDE 终端里输入 claude，安装 Claude Code CLI；
• 项目和工具链主要跑在 Linux，或者需要沙箱，安装到 WSL 2；
• Desktop 和 CLI 可以同时装，二者不是互斥选项。

本文按 2026 年 8 月的官方文档整理。官方下载只认以下两个入口：

• Claude 官方下载页
• Claude Code 官方安装文档

不要从网盘、软件下载站或陌生 GitHub Release 下载所谓的“Claude Code 安装包”。

先看结论：Claude Code Desktop、CLI、WSL 怎么选

最简单的判断方式：

• 第一次接触 Claude Code，先装 Desktop；
• 已经习惯终端，直接装 CLI；
• 开发环境本来就在 WSL，别跨文件系统折腾，直接装进 WSL 2。

Claude Code Desktop App 下载与安装

Claude Code 的桌面版不是一个名为“Claude Code.exe”的独立产品。它位于 Claude Desktop 应用中的 Code 标签。

第 1 步：从官方下载页选择版本

打开 claude.com/download，Windows 用户按处理器选择：

• 大多数 Intel / AMD 电脑：下载 Windows x64；
• Windows on ARM 设备：下载 Windows ARM64。

安装后，从开始菜单启动 Claude，登录 Anthropic 账号，再点击顶部的 Code。

第 2 步：选择运行环境

新建 Code 会话时，桌面版通常提供三种环境：

• Local：直接读取并修改这台电脑上的项目；
• Remote：在 Anthropic 的云环境中运行；
• SSH：连接你自己管理的远程 Linux 或 macOS 机器。

如果你只是想让 Claude 修改本机项目，选 Local，再选择项目文件夹即可。Windows 本地会话需要 Git，建议先安装 Git for Windows。

Desktop 版适合哪些人

Desktop 的优势不是“把终端套进窗口”，而是把多会话、文件编辑器、终端、Diff 审查、应用预览和 PR 状态放在同一个界面里。你可以并排运行多个 Agent，又不必反复切终端标签。

但如果你需要脚本化启动、在现有终端里工作、频繁使用 slash command，CLI 通常更直接。

Claude Code Desktop 需要 Pro、Max、Team 或 Enterprise 方案。只装好应用但看不到 Code，先检查登录账号和订阅权限。

Claude Code CLI：Windows 原生安装

官方现在推荐原生安装器，不再要求为了 Claude Code 先全局安装 Node.js。

方法一：PowerShell 安装（推荐）

打开 PowerShell，执行：

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

安装完成后关闭并重新打开终端，再验证：

claude --version
claude

首次运行 claude 会引导你登录。进入项目目录后再启动，它才能从正确的工作目录读取代码：

cd D:\Projects\my-app
claude

方法二：WinGet 安装

如果你习惯用 Windows 包管理器：

winget install Anthropic.ClaudeCode

WinGet 版本不会像原生安装器那样自动后台更新，后续需要手动执行：

winget upgrade Anthropic.ClaudeCode

方法三：CMD 安装

如果你的提示符是 C:\Users\...>，没有前面的 PS，说明你用的是 CMD。执行：

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

PowerShell 和 CMD 的命令不能混用。很多“安装脚本报语法错”，本质上只是把 CMD 命令贴进了 PowerShell，或者反过来。

Claude Code Windows：原生还是 WSL 2

Claude Code 已经支持原生 Windows，不再是“Windows 必须装 WSL”。但两种环境各有取舍。

选原生 Windows，如果你：

• 项目位于 C:\ 或 D:\；
• 依赖 Visual Studio、PowerShell、Windows SDK 等原生工具；
• 希望安装最简单；
• 不需要 Claude Code 沙箱。

原生模式建议安装 Git for Windows。Claude Code 会优先使用 Git Bash 执行 Bash 工具；如果没有 Git Bash，也可以使用 PowerShell 工具。

选 WSL 2，如果你：

• 项目以 Linux、Docker、Node/Python 服务端工具链为主；
• 需要沙箱；
• 部署环境就是 Linux；
• 已经长期在 WSL 终端开发。

进入 WSL 2 后执行 Linux 安装命令：

curl -fsSL https://claude.ai/install.sh | bash

然后在 WSL 内验证：

claude --version
claude

不要一会儿从 Windows PowerShell 启动，一会儿又从 WSL 启动，却期待两边的路径、Git、环境变量完全一致。项目在哪个环境，就在那个环境安装并运行 Claude Code。

Claude Code Desktop App 与 CLI 有什么区别

一个实用组合是：平时用 Desktop 看多个会话和 Diff，需要自动化或终端上下文时再用 CLI。是否安装 CLI，不影响 Desktop 的 Code 标签正常工作。

Windows 安装常见报错

1. `The token '&&' is not a valid statement separator`

你把 CMD 命令贴进了 PowerShell。回到上面的 PowerShell 方案，使用：

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

2. `'irm' is not recognized`

你当前用的是 CMD，不是 PowerShell。打开 Windows PowerShell，或者改用 CMD 安装命令。

3. `claude` 不是内部或外部命令

先关闭并重新打开终端。如果仍然找不到，检查 %USERPROFILE%\.local\bin 是否在 PATH 中，然后运行：

Get-Command claude

也可以执行官方诊断：

claude doctor

4. 找不到 Git Bash

安装 Git for Windows；如果装在自定义目录，可在 Claude Code 设置中指定：

{
  "env": {
    "CLAUDE_CODE_GIT_BASH_PATH": "C:\\Program Files\\Git\\bin\\bash.exe"
  }
}

5. Desktop 里没有 Code 标签，或出现 403

依次检查：

1. 当前登录的是不是购买 Claude 方案的账号；
2. Claude Desktop 是否已更新到最新版；
3. 退出账号、重启应用后重新登录；
4. 团队账号是否被管理员限制了 Claude Code。

装好后，怎样从手机或浏览器继续 Claude Code

安装解决的是“Claude Code 在哪运行”，远程控制解决的是“人不在电脑前时怎么继续”。

Anthropic 已经提供 Desktop、Web、Remote Control 和手机 Dispatch 等官方方式。如果你只使用官方 Claude 账号和官方模型，这些功能通常应当优先尝试。

如果你还需要以下场景，可以再考虑 PandaNpc：

• 同一个界面远程控制 Claude Code、OpenAI Codex 和 PandaCode；
• Agent 继续跑在自己的 Windows / macOS / Linux 开发机上；
• 使用自定义模型或自己的 API endpoint；
• 从 iPhone、任意浏览器、另一台桌面电脑或 Chrome 侧边栏继续同一会话；
• 远程查看流式输出、审批工具调用、回答问题和查看代码变化；
• 不开放公网端口，开发机与控制端都只建立出站连接。

先确认官方 Claude Code 已能正常运行，再在开发机安装 pandapaw：

Windows PowerShell：

iwr -useb https://cos.pandanpc.com/pandapaw/install.ps1 | iex

macOS / Linux：

curl -fsSL https://cos.pandanpc.com/pandapaw/install.sh | sh

安装后打开 PandaNpc Agent，开发机上的连接会出现在列表中。你也可以使用 Windows / macOS / Linux 客户端或 iOS App。

常见问题

Claude Code 是桌面软件还是命令行工具？

两者都是。Claude Desktop 的 Code 标签提供图形界面；Claude Code CLI 则从终端启动。它们服务不同工作流，可以同时安装。

Claude Code Windows 必须使用 WSL 吗？

不必须。原生 Windows 已受支持。Windows 项目优先原生安装；Linux 工具链或需要沙箱时再选 WSL 2。

Claude Code download 需要 Node.js 吗？

Desktop 不需要。官方原生 CLI 安装器也不需要。只有仍使用旧的 npm install -g @anthropic-ai/claude-code 方式时才需要 Node.js。

Claude Code 有 Windows ARM64 版本吗？

Claude Desktop 官方下载页提供 Windows ARM64 安装包。CLI 请以官方安装脚本当前识别到的平台为准。

Claude Code Desktop 支持 Linux 吗？

Claude Code 的桌面 Code 体验目前面向 macOS 和 Windows。Linux 用户使用 CLI，或者通过 Web / 远程客户端操作运行在 Linux 上的会话。

Desktop 和 CLI 哪个更好？

没有绝对答案。想要可视化、多会话、Diff 与预览，选 Desktop；想要终端效率、脚本化和现有开发工具链，选 CLI；Linux 环境与沙箱需求优先 WSL 2。

一句话总结

只想快速开始：从 Claude 官方下载页 安装 Desktop，打开 Code 标签。

想在 Windows 终端使用：PowerShell 执行：

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

项目在 Linux 工具链里：进入 WSL 2，执行：

curl -fsSL https://claude.ai/install.sh | bash

先把官方 Claude Code 安装正确，再决定是否需要 Desktop、CLI 同时使用，以及是否需要用 PandaNpc 从手机、浏览器或另一台电脑远程继续会话。