Claude Code Download：官方下载、安装与连接验证步骤
简答：Claude Code 可以通过官方桌面应用或终端 CLI 使用。最短路径是：打开官方 Claude 下载页选择桌面版，或根据系统运行官方安装命令；安装后执行 claude --version 和 claude doctor 验证，再运行 claude 完成登录。需要注意，官方文档显示免费 Claude 账号不包含 Claude Code，终端登录前应确认账号或 API 计费方式。
定义：Claude Code 是面向终端、IDE 和桌面环境的代码协作工具，可在项目目录中读取文件，并在执行修改或命令前请求确认。
先选对下载方式：桌面版、终端版还是 WSL
如果你只想尽快开始，优先选择官方桌面应用：官方下载页提供 macOS、Windows 和 Windows ARM64 桌面下载，并将 Linux 引导至 Claude Code 文档。桌面应用登录后可直接进入 Code 标签，不需要另行安装终端版。具体入口和平台列表以官方 Claude 下载页为准。
| 使用场景 | 建议路径 | 注意事项 |
|---|---|---|
| 不熟悉终端，想快速开始 | 桌面应用 → Code 标签 | 登录桌面应用后直接选择项目文件夹 |
| 日常在终端运行项目 | 原生安装脚本 | macOS、Linux、WSL 使用 shell 安装命令，Windows 使用 PowerShell 或 CMD 命令 |
| Windows 原生开发 | Windows 原生安装 | 可选安装 Git for Windows；没有 Git 时使用 PowerShell 工具 |
| Linux 工具链或需要 WSL 环境 | WSL 2 或 Linux 原生安装 | WSL 中要在 Linux 终端安装和启动，不要在 PowerShell 中运行 Linux 命令 |
| Debian、Ubuntu、Fedora、RHEL、Alpine | apt、dnf 或 apk 仓库 | 仓库安装默认通过系统升级更新，不是 Claude Code 后台自动更新 |
硬件与系统要求以官方文档为准：当前文档列出 macOS 13.0 及以上、Windows 10 1809 及以上或 Windows Server 2019 及以上、Ubuntu 20.04 及以上、Debian 10 及以上和 Alpine Linux 3.19 及以上，并要求 4 GB 以上内存及 x64 或 ARM64 处理器。详见Claude Code 官方安装文档。
按系统安装 Claude Code
macOS、Linux 或 WSL
打开对应终端，运行官方原生安装命令：
curl -fsSL https://claude.ai/install.sh | bash
macOS 用户如果需要确认架构，可运行 uname -m：显示 arm64 通常对应 Apple Silicon，显示 x86_64 则是 Intel。官方当前文档将两类处理器统一列为支持的 x64 或 ARM64，具体下载包不要从第三方页面补充。
Windows 原生安装
PowerShell 的提示符通常以 PS C:\ 开头，运行：
irm https://claude.ai/install.ps1 | iex
如果使用 CMD，运行：
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Windows 原生安装不要求以管理员身份运行。Git for Windows 是可选项；安装后可以让 Claude Code 使用 Git Bash。官方文档还区分 Windows x64 与 ARM64 桌面下载，下载页出现架构选择时，应根据系统实际架构选择，不要混用第三方安装包。
Windows WSL
在已经打开的 WSL 发行版终端中运行 Linux 安装命令：
curl -fsSL https://claude.ai/install.sh | bash
之后仍然在 WSL 终端中执行 claude。官方文档建议根据项目位置和工具链选择 Windows 原生、WSL 2 或 WSL 1：Windows 原生适合 Windows 工具链，WSL 2 适合 Linux 工具链和沙箱场景，WSL 1 适用于无法使用 WSL 2 的情况。
Linux 包管理器
Debian 和 Ubuntu 可以使用官方签名 apt 仓库；Fedora、RHEL 可使用 dnf；Alpine 可使用 apk。仓库配置涉及签名密钥、发行版版本和 stable/latest 通道，建议直接按官方 Linux 包管理器章节逐行执行，不要把不同发行版命令混用。官方文档明确说明 apt、dnf、apk 仓库提供签名校验，安装前应核对密钥指纹。
安装后首次登录与项目验证
- 打开新的终端窗口，让 PATH 重新加载。
- 执行
claude --version。能输出版本号，说明命令已被系统找到。 - 执行
claude doctor，检查安装健康状态、配置文件错误和更新提示。 - 进入项目目录，例如
cd path/to/your/project，再运行claude。 - 首次启动按浏览器提示登录；使用付费 Claude 计划时，应使用与 Claude 相同的账号。
- 确认项目目录后，再提交第一个只读或低风险任务。Claude Code 会在修改文件或运行命令前请求确认，并显示变更差异。
官方文档显示，Claude Code 需要 Pro、Max、Ultra、Team、Enterprise 或 Console 账号；免费 claude.ai 计划不包含 Claude Code。若同时设置了 ANTHROPIC_API_KEY，登录方式可能转为 API 密钥，相关用量可能按 API 方式计费。不要在不清楚计费归属时随意复制 API 密钥。账号与订阅绑定步骤可参考官方账号使用说明。
更新、版本通道与卸载前检查
原生安装通常会在后台自动更新；Homebrew、WinGet 和 Linux 包管理器安装则需要使用各自的升级命令。原生安装可以手动执行：
claude update
验证当前版本：
claude --version
检查最近一次更新、PATH 和配置状态：
claude doctor
官方文档区分 latest 与 stable 通道。Homebrew 中，claude-code 对应 stable，claude-code@latest 对应 latest；两者不会由 Claude Code 自动更新，需要分别运行 Homebrew 升级命令。Linux 仓库也按渠道区分，企业或团队环境不要在未确认兼容性的情况下随意切换。
如果只是想恢复安装，先记录当前版本和安装方式，再按照官方文档对应的 native、Homebrew、WinGet、apt、dnf、apk 或 npm 卸载章节处理，避免直接删除 PATH 文件导致残留配置。
下载或登录失败时的最短排查清单
| 现象 | 优先检查 | 处理方法 |
|---|---|---|
claude: command not found | 终端没有重新加载 PATH | 关闭并重新打开终端；macOS/Linux 可按官方说明重新加载 shell 配置 |
| Windows 提示命令不识别 | PowerShell 与 CMD 命令混用 | PowerShell 使用 irm，CMD 使用 curl ... install.cmd |
| npm 出现 EACCES 或 permission denied | 曾经使用 sudo 安装 | 不要继续用 sudo；优先改用原生安装器或修复 npm 全局目录权限 |
| 安装返回 403 或下载 HTML | 网络、代理或下载主机访问异常 | 检查代理和企业网络策略，再按官方故障排查页选择替代安装方式 |
/login 一直等待 | 浏览器回调被远程 SSH、容器或防火墙阻断 | 使用终端显示的手动登录流程，或先在桌面应用中登录 |
| 账号登录后仍显示未授权 | API 密钥环境变量覆盖了订阅登录 | 检查 ANTHROPIC_API_KEY，必要时执行 /logout、claude update 后重新登录 |
这些现象和处理方向来自官方安装与认证故障排查说明。如果故障只发生在某个企业网络，先记录系统、终端类型、命令输出和代理环境，再交给管理员处理；不要在公开工单中粘贴 API 密钥。
本站是第三方使用指南站，不是 Claude 官方站点；下载地址、账号政策和支持范围变化时，以官方页面为准。
相关指南
如果你已经完成 Claude Code 安装，但仍然遇到登录或网络连接问题，可以继续查看：
常见问题
Claude Code Download 应该下载桌面版还是终端版？
不熟悉终端时选官方桌面应用并进入 Code 标签；需要在项目目录、脚本或 IDE 中工作时选终端 CLI。两者的账号和权限要求仍应以官方文档为准。
免费 Claude 账号可以使用 Claude Code 吗？
官方当前文档明确写明，免费 claude.ai 计划不包含 Claude Code。可用账号类型包括 Pro、Max、Ultra、Team、Enterprise 或 Console，实际权限以账号页面和官方政策为准。
Windows 应该选原生安装还是 WSL？
Windows 原生适合 Windows 项目和工具链；WSL 2 更适合 Linux 工具链或需要 WSL 环境的项目。原生 Windows 从 PowerShell 或 CMD 安装，WSL 则必须在 WSL 终端内运行 Linux 安装命令。
安装后为什么提示 claude 找不到？
最常见原因是当前终端还没有重新加载 PATH。关闭并重新打开终端后再运行 claude --version；如果仍失败，再使用 claude doctor 或查看官方故障排查说明。
设置 ANTHROPIC_API_KEY 会不会影响登录？
会有影响。官方说明显示，环境变量可能让 Claude Code 优先使用 API 密钥，而不是 Claude 订阅登录。若不清楚计费方式，先检查并临时移除该变量，再使用 /login 完成账号认证。
相关阅读
参考资料
- Download Claude｜Claude 官方下载页（claude.com）
- Advanced setup｜Claude Code 官方文档（code.claude.com）
- Use Claude Code with your Pro, Max, or Ultra plan｜官方帮助中心（support.claude.com）
- Your first day in Claude Code｜官方帮助中心（support.claude.com）
- Troubleshoot Claude Code installation and authentication｜官方帮助中心（support.claude.com）
- Claude Code 产品说明｜Claude 官方产品页（claude.com）