如何安装 Claude Code：完整指南 (2026)

快速摘要：Claude Code 可通过 macOS、Windows 和 Linux 的原生安装程序在 Claude Code 官方网站上进行安装。Windows 用户必须先安装 WSL2，然后才能运行 Claude Code。安装完成后，当 Claude Code 打开浏览器窗口让您首次登录时，请使用您的 Claude 账户进行身份验证，即可直接从终端或桌面应用开始使用 AI 辅助进行编码。

Claude Code 代表了 Anthropic 在智能 AI 开发工具领域的一次进军。这款命令行助手可以读取代码库、编辑文件、运行命令，并与开发工作流程集成。

但安装过程并不总是那么直接。不同的平台需要不同的方法。Windows 需要额外的设置。虽然文档内容详尽，但可能让新手不知所措。

本指南将为您理清复杂性。它涵盖了系统要求、平台特定的安装步骤、身份验证和验证——获取 Claude Code 正确运行所需的一切。

安装前的系统要求

根据 Claude Code 官方文档，该工具支持 macOS、Windows 和 Linux。然而，每个平台都有特定的先决条件。

对于 macOS，要求很少。系统需要 macOS 13.0 或更高版本。Intel 和 Apple Silicon 芯片都能正常工作。

Windows 则更复杂。操作系统必须是 Windows 10 Build 19041 或更高版本，或者 Windows 11。但这里有一个关键点——Claude Code 在 Windows 上不是原生运行的。

Windows Subsystem for Linux 2 (WSL2) 是强制性的。这创建了一个 Linux 环境，Claude Code 实际上是在其中运行的。没有 WSL2，安装就会失败。

Linux 用户需要 64 位发行版。官方文档证实支持 Ubuntu、Debian、Fedora 和其他主流发行版。Alpine Linux 和基于 musl 的系统需要额外的配置。

安装过程中，所有平台都需要稳定的互联网连接。下载大小各不相同，但通常在 50MB 到 500MB 之间，具体取决于已安装的内容。

在 macOS 上安装 Claude Code

macOS 的安装过程使用原生安装程序。这是所有平台中最简单的途径。

首先，从 Claude Code 官方网站下载安装程序。下载页面会自动检测 macOS 并提供相应的软件包。

打开下载的 .dmg 文件。将 Claude Code 应用程序拖到“应用程序”文件夹。这是标准的 macOS 安装方式，没什么特别的。

一些用户在首次启动时会遇到安全提示。macOS 默认会阻止来自未知开发者的应用。右键单击 Claude Code 应用程序并选择“打开”即可绕过此一次性警告。

命令行工具会随着桌面应用程序一起自动安装。打开终端并输入 `claude --version` 进行验证。如果显示版本号，则表示安装成功。

验证 macOS 安装

运行以下命令来确认一切正常：

两个命令都应在没有错误的情况下返回输出。`version` 命令显示已安装的 Claude Code 版本。`help` 命令显示可用的选项和命令。

创建一个测试目录有助于验证全部功能。导航到一个项目文件夹并运行 `claude` 以启动交互式会话。如果尚未登录，该工具应初始化并提示进行身份验证。

通过 WSL2 在 Windows 上安装

Windows 安装需要多个步骤。过程比 macOS 耗时，但仍然可以管理。

首先必须安装 WSL2。以管理员身份打开 PowerShell 并运行：

此命令默认安装 WSL2 和 Ubuntu。系统将需要重启。重新启动后，Ubuntu 会自动启动以完成初始设置。

出现提示时，请创建 Unix 用户名和密码。这些凭据与 Windows 登录凭据是分开的。

WSL2 运行后，将适用 Linux 安装过程。打开 Ubuntu 终端（与 WSL2 一起安装）并下载 Linux 版 Claude Code 安装程序。

在 WSL2 中安装 Claude Code

根据官方文档，安装命令会下载并运行原生安装程序：

此脚本会自动处理依赖项。如果需要，它会安装 Node.js，设置 Claude Code 二进制文件，并配置 PATH 变量。

安装需要几分钟时间。进度条和状态消息会显示正在进行的操作。完成后，关闭并重新打开终端以刷新环境变量。

测试安装的过程与 macOS 相同。运行 `claude --version` 进行验证。

Linux 安装流程

Linux 用户拥有最直接的安装途径。原生安装程序无需 WSL2 等额外层即可直接运行。

下载并运行安装脚本：

这将下载 Claude Code 二进制文件，安装依赖项，并配置 Shell 环境。脚本会检测发行版并相应地进行调整。

对于 Ubuntu 和基于 Debian 的系统，脚本会配置安装。官方文档证实支持 Ubuntu 20.04+、Debian 10+ 以及其他发行版。

Alpine Linux注意事项

Alpine Linux 和基于 musl 的发行版需要额外的步骤。官方文档指出，这些系统需要手动配置。

标准安装程序可能在 Alpine 上失败。而是直接从发布页面下载与 musl 兼容的二进制文件。将其提取到系统 PATH 中的一个目录，通常是 `/usr/local/bin`。

设置可执行权限：

Alpine 用户应在继续之前验证兼容性。某些功能可能与基于 glibc 的发行版不完全相同。

身份验证和账户设置

安装 Claude Code 后，在终端中运行 `claude`。首次启动时，Claude Code 会打开一个浏览器窗口让您登录。

这将打开 Claude 身份验证页面。使用现有 Claude 账户登录或创建一个新账户。

浏览器会显示一个授权码。复制此代码并返回终端。在提示时粘贴代码。

成功身份验证后，凭据将存储在本地。将来的会话将不需要登录，除非凭据过期或被手动清除。

团队和企业身份验证

根据官方身份验证文档，使用 Claude for Teams 或 Enterprise 的团队拥有额外的选项。组织可以配置单点登录 (SSO) 或云提供商身份验证。

SSO 设置需要管理员配置。然后，个人开发人员将通过其组织的身份提供者进行身份验证，而不是通过个人 Claude 账户。

云提供商身份验证适用于 AWS、Google Cloud 和 Azure 部署。此方法使用现有的云凭据，而不是单独的 Claude 账户。

桌面应用安装

Claude Code 同时提供命令行和桌面应用程序。桌面应用提供图形界面，同时保持完整的终端功能。

从 Claude 官方网站下载桌面安装程序。该页面提供 macOS、Windows 和 Windows ARM64 版本。选择适合您系统的版本。

macOS 安装遵循前面描述的相同 .dmg 过程。Windows 用户可以下载桌面应用程序以获得图形界面，而无需设置 WSL2。

桌面应用程序包含集成的终端访问。它可以启动 Claude Code 会话，而无需切换到外部终端应用程序。

桌面应用的一个优点是后台可用性。根据官方下载页面，该应用程序“在后台保持就绪状态”，并且可以从任何应用程序启动，而无需切换窗口或失去焦点。

使用 Get AI Perks 为您的 Claude Code 配置查找积分

安装是最简单的部分。真正的成本通常来自于围绕它的所有东西：基础设施、支持工具以及设置和测试期间使用的付费服务。Get AI Perks 可以通过在一个地方列出初创公司积分和折扣，并提供如何申请的指导来提供帮助。

通过 Get AI Perks，您可以：

• 查找云和 AI 相关工具的积分
• 申请前检查福利条件
• 避免浪费时间在您可能不符合条件的优惠上
• 降低设置成本

访问 Get AI Perks，查看可用优惠是否与您计划与 Claude Code 一起使用的工具匹配。

IDE 扩展和集成

除了独立安装，Claude Code 还与流行的开发环境集成。存在适用于 Visual Studio Code 和 JetBrains IDE 的扩展。

VS Code 扩展通过 marketplace 安装。在 Extensions 面板中搜索“Claude Code”并单击“Install”。该扩展要求先安装命令行工具。

一些用户报告了 VS Code 扩展捆绑文件的问题。如果自动安装失败并出现“End of central directory record signature not found”错误，则捆绑的 .vsix 文件可能已损坏。

解决方法是通过从 VS Code marketplace 手动安装扩展，而不是依赖 CLI 的捆绑版本。这会分离这两个组件并防止安装冲突。

JetBrains 集成也类似。在 IntelliJ IDEA、PyCharm、WebStorm 或其他 JetBrains 产品中从 JetBrains marketplace 安装插件。

验证安装成功

在开始实际开发任务之前，正确的验证可确保 Claude Code 工作正常。

基本验证检查命令可用性：

这些命令应在没有错误的情况下执行。`help` 命令列出可用选项。`version` 命令显示已安装的版本。

功能测试需要启动会话。创建一个测试目录：

这将初始化一个交互式 Claude Code 会话。该工具应分析目录（在本例中为空）并显示一个提示。

尝试在会话中使用基本命令。输入 `help` 查看可用操作。请求简单任务，例如“创建 README 文件”或“解释你能做什么”。

成功的响应表明安装正常。如果出现错误，通常与身份验证、网络连接或缺少依赖项有关。

更新和版本管理

Claude Code 默认自动更新。官方文档解释说，该工具会检查新版本并自动安装，无需用户干预。

可以通过 Claude Code 设置配置更新行为。官方文档涵盖了发布渠道配置和手动更新选项。

手动更新需要再次运行安装脚本。用于初始安装的命令与获取最新版本使用的命令相同：

为了进行测试或兼容性原因，可以安装特定版本。高级设置文档涵盖了版本锁定和发布渠道配置。

发布渠道包括稳定版、测试版和每日构建版。稳定版推荐用于生产工作。测试版和每日构建版提供新功能的早期访问，但可能包含错误。

常见的安装问题

在社区讨论中，Claude Code 安装经常出现几个问题。

PATH 配置导致许多问题。如果在安装后找不到 `claude` 命令，则二进制文件目录不在系统 PATH 中。

在 macOS 和 Linux 上，将目录添加到 PATH 通常需要编辑 `~/.bashrc`、`~/.zshrc` 或类似的 Shell 配置文件。安装脚本通常会自动处理此问题，但手动验证有助于解决问题。

Windows 用户在 WSL2 中安装后可能需要关闭并重新打开终端。现有会话中的环境变量不会刷新。

网络限制会阻止某些安装。公司防火墙或代理服务器可能会阻止下载安装程序或连接到身份验证服务器。

代理配置需要环境变量：

安装到受保护的目录时会发生权限错误。安装程序需要写入 `/usr/local/bin` 或等效位置的权限。使用 sudo 运行可以解决此问题，但除非必要，否则应避免。

常见问题解答

安装后的入门

Claude Code 已安装并验证，下一步是了解如何有效使用它。

快速入门文档建议从简单的任务开始。导航到现有项目并运行 `claude` 以开始交互式会话。

要求 Claude 解释项目结构。请求总结代码库的功能。这些探索性查询有助于理解该工具如何解释代码。

尝试进行小的更改。要求 Claude 为函数添加注释，创建简单的测试文件，或重构基本代码块。这些任务演示了编辑功能，而不会带来风险。

如果项目使用版本控制，Git 集成会自动工作。Claude Code 可以创建提交、解释 diff，并根据更改提出改进建议。

官方文档包含常见开发任务的工作流程示例。这些示例涵盖了 bug 修复、功能实现、代码审查和自动化测试。

Claude Code 是一个不断发展的工具。安装只是基础。理解其功能、限制和最佳实践需要实验和练习。

准备好安装 Claude Code 了吗？从官方网站下载适合您平台的安装程序，并遵循本指南中概述的步骤。使用您的 Claude 账户进行身份验证，验证安装是否正常工作，然后开始探索 AI 辅助开发。