# Claude Code 安装教程：全平台完整设置指南（2026）

> Claude Code 可在 macOS、Windows 和 Linux 上通过原生安装器一条命令完成安装，无需 Node.js。使用时需要付费 Claude 方案（Pro $20/月起）或按用量计费的 Claude Console 账户。本指南涵盖所有安装方式、各平台步骤、假冒安装程序安全警告，以及最常见问题的解决方法。

- URL: https://blog.laozhang.ai/zh/posts/claude-code-install
- Published: 2026-03-13
- Updated: 2026-10-20
- Author: LaoZhang AI Team (https://blog.laozhang.ai/zh/about)
- Topic: Claude 与 Anthropic
- Tags: Claude Code, CLI 工具, AI 编程, 开发者工具

---
Claude Code 是 Anthropic 官方推出的命令行界面工具，可以将 AI 编程辅助直接带入你的终端。与基于浏览器的工具不同，它能读取你的整个代码库、执行命令，并通过自然语言处理复杂的多文件编辑——全程无需离开命令行。截至 2026 年 10 月 20 日，官方仍推荐使用原生安装器进行安装，该方式无需任何依赖且支持自动更新。登录 Claude Code 有两条路：付费 Claude 方案（Pro、Max、Team 或 Enterprise，Pro 起价 $20/月），或按 API 用量计费的 Claude Console 账户；免费版 Claude 不包含 Claude Code。

## 要点速览

以下是关于安装 Claude Code 你需要了解的全部要点。在 macOS 或 Linux 上，打开终端运行 `curl -fsSL https://claude.ai/install.sh | bash`，整个过程不到两分钟即可完成。Windows 用户在 PowerShell 中运行 `irm https://claude.ai/install.ps1 | iex` 即可，不需要管理员权限；Git for Windows 是可选的，装了它 Claude Code 才能用 Git Bash 执行 Bash 命令，没装时改用 PowerShell。原生安装器是官方推荐的安装方式，因为它无需 Node.js、支持自动更新，且能提供最稳定的使用体验。Homebrew（`brew install --cask claude-code`）和 WinGet（`winget install Anthropic.ClaudeCode`）是面向偏好使用包管理器的开发者的替代方案。npm 安装方式（`npm install -g @anthropic-ai/claude-code`）仍写在官方文档的高级安装选项里，没有被弃用：它要求 Node.js 22 或更高版本，装下来的是和原生安装器同一个二进制文件。使用 Claude Code 需要付费 Claude 方案或 Claude Console 账户。按 claude.com/pricing 截至 2026 年 10 月 20 日的网页标价，Pro 月付 $20/月、年付折合 $17/月，Max 5x 为 $100/月、Max 20x 为 $200/月（只能月付），所有付费方案（包括 Team 标准席位）都包含 Claude Code；Console 账户按 token 计费，不需要再买 Pro 或 Max。免费方案不包含 Claude Code 的访问权限。安装完成后，在任意项目目录中运行 `claude` 即可启动交互式编程会话，你可以通过对话让 Claude 读取、编辑和管理你的代码。

## Claude Code 是什么？你真的需要它吗？

Claude Code 并不只是又一个 AI 代码补全工具——它是一个完全在终端中运行的智能体编程环境。由 Anthropic 推出并于 2025 年 5 月正式发布，Claude Code 能够理解你的整个项目结构，可以在文件之间导航、运行测试、提交代码变更，甚至同时调试跨多个代码库的复杂问题。它与 GitHub Copilot 或 Cursor 等工具的根本区别在于，Claude Code 以自主智能体的方式运行：你用自然语言描述你想要的效果，它会自动规划、执行并验证这些变更，无需你手动选择代码或在文件之间切换。它支持任何编程语言、任何框架、任何编辑器——因为它根本不需要编辑器。

你是否真正需要 Claude Code，取决于你的工作流以及你在终端中花费的时间。如果你是一个已经大量使用命令行工具的开发者，Claude Code 会非常自然地融入你现有的工作流程。它在需要同时触及多个文件的任务中表现尤为出色：在整个代码库中重构一个模块、实现一个跨越前端和后端的功能、或者调试一个需要在应用多个层级中追踪的问题。对于正在评估 AI 编程工具的开发者，你可以阅读我们的 [ChatGPT 与 Claude 全面对比](https://blog.laozhang.ai/zh/posts/chatgpt-vs-claude)来了解 Claude 的底层模型与竞品相比有何优势。如果你的工作主要集中在单个文件上，传统的行内代码助手可能就足够了，但对于复杂的多文件工程任务，Claude Code 代表着开发者生产力的一次重大飞跃。这款工具在后端开发者、全栈工程师和 DevOps 专业人员中获得了尤其强劲的采用率，这些人群通常需要在多个服务和配置文件间频繁切换。Reddit 和开发者论坛上的早期使用者一致强调，Claude Code 理解项目上下文的能力——读取 README 文件、分析依赖关系图、理解测试模式——使其比那些只能看到单个文件的 AI 助手有效得多。它在终端中运行这一特点还意味着它能与涉及 git、docker、make 等命令行工具的现有开发工作流无缝集成，无需任何编辑器插件或配置。

## 安装 Claude Code 之前你需要准备什么

![Claude Code 定价方案对比图，展示免费版、Pro、Max 和团队版各档位](https://blog.laozhang.ai/posts/zh/claude-code-install/img/pricing-plans.webp)

在运行安装命令之前，你需要确认两件事：系统要求和 Claude 订阅。提前搞定这两项可以避免你安装完 Claude Code 后才发现无法认证或操作系统不受支持的挫败感。这是大多数安装指南会跳过的步骤，也正是许多开发者在安装后立即碰壁的原因。

**系统要求**非常简单，但因平台而异。在 macOS 上，你需要 13.0（Ventura）或更高版本——旧版 macOS 不受原生安装器支持（code.claude.com/docs/en/setup，截至 2026 年 10 月 16 日）。Windows 用户需要 Windows 10 1809 版本或更高版本，或 Windows Server 2019+。Git for Windows 不再是安装前提：官方文档写明它是可选的，装了它 Claude Code 可以通过 Git Bash 使用 Bash 工具，没装时改用 PowerShell 执行命令。如果你的项目依赖 Bash 脚本，可以从 git-scm.com 顺手装上。Linux 用户需要 Ubuntu 20.04+、Debian 10+ 或 Alpine 3.19+（Alpine 需要额外依赖项）。所有平台都要求至少 4GB 内存，但建议 8GB 或更多以便处理大型代码库。支持的 Shell 包括 Bash、Zsh、PowerShell 和 CMD。

**定价是最容易让人措手不及的部分。** Claude Code 本身是免费安装的——二进制文件不收取任何费用。要实际使用它，有两条计费路线可选。第一条是 Claude 订阅。截至 2026 年 10 月 20 日，claude.com/pricing 网页上的标价（不含税）如下，页面 FAQ 也写明所有付费方案都包含 Claude Code：Pro 月付 $20/月，年付折合 $17/月（一次性付 $200）；Max 5x 为 $100/月、Max 20x 为 $200/月，两档都只能月付；Team 标准席位月付每席 $25/月、年付折合 $20/月，高级（Premium）席位月付 $125/月、年付折合 $100/月，适用于 2 到 150 人的团队。免费的 Claude 方案（$0/月）完全不包含 Claude Code。Pro 是包含 Claude Code 的最便宜方案，也是大多数个人开发者的起点。Max 的倍数指的是用量倍数，不是固定的 token 数：Anthropic 的 Max 方案帮助文章写的是 Max 5x 为 Pro 每个会话用量的 5 倍、Max 20x 为 20 倍，会话每 5 小时重置，另有每周上限；Max 还提供更高的输出上限和高峰期优先访问。本文 2026 年 3 月首发时写的是 Teams Premium $150/用户/月、标准 Team 席位不含 Claude Code；现在的定价页上两种席位都列有 Claude Code。在假设存在免费 Pro 试用前，先核对[当前 Claude Pro 试用边界](https://blog.laozhang.ai/zh/posts/claude-pro-free-trial)，或查看我们的详细 [Claude 订阅定价完全指南](https://blog.laozhang.ai/zh/posts/claude-opus-5-5-pricing-limit-reset)进行全面对比。第二条是 Claude Console 账户按量付费：用 Console 账户登录或提供 Anthropic API 密钥，按实际消耗的 token 计费，不需要另外订阅 Pro 或 Max。通过 Amazon Bedrock、Google Cloud Agent Platform（Vertex AI）或 Microsoft Foundry 使用 Claude 的组织，也可以让 Claude Code 直接连这些平台。

## 如何安装 Claude Code（分步教程）

![Claude Code 在 macOS、Windows 和 Linux 各平台的分步安装指南](https://blog.laozhang.ai/posts/zh/claude-code-install/img/platform-guide.webp)

这是本指南的核心部分——你需要运行的实际命令，按平台分类整理。原生安装器是所有平台的推荐方式，因为它打包了 Claude Code 所需的一切，无需你安装 Node.js 或管理 npm 包。以下命令与 code.claude.com 官方文档一致，截至 2026 年 10 月 16 日。

### macOS 和 Linux（包括 WSL）

在 macOS 或 Linux 上安装 Claude Code 真正只需一条命令，从开始到结束大约两分钟。打开你的终端——在 macOS 上你可以按 Cmd+Space，输入"Terminal"然后按回车，在 Linux 上你可以使用 Ctrl+Alt+T 或你喜欢的终端模拟器。然后运行以下命令：

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

这会下载并运行官方安装脚本，脚本会自动检测你的操作系统和架构，下载对应的二进制文件，并把 `claude` 放到 `~/.local/bin/claude`。下载过程中不显示进度。安装器不会自己修改 PATH：如果 `~/.local/bin` 还不在 PATH 里，它会在输出的 `Setup notes:` 下提示这一点，并打印补 PATH 的命令。打开一个新的终端窗口，运行 `claude --version` 来验证安装，它应该会显示当前版本号（类似 `2.1.301 (Claude Code)` 这样的版本号，数字随更新变化）。如果你使用的是 WSL（Windows 子系统 Linux），过程完全一样——打开 WSL 终端并运行相同的 curl 命令。安装器会将 WSL 视为 Linux 环境，因此不需要任何特殊步骤。验证完成后，只需在任意项目目录中输入 `claude` 即可启动交互式会话，开始使用 AI 驱动的编程辅助。

### Windows 安装

Windows 上不需要先装其他软件，也不需要以管理员身份运行。Git for Windows 是可选的：没装时 Claude Code 用 PowerShell 工具执行命令；装了它，Claude Code 会通过 Git Bash 使用 Bash 工具，项目里有 Bash 脚本时更方便。想装的话从 git-scm.com/downloads/win 下载，安装时勾选 "Add to PATH"，装完重启终端。

你有两种方式在 Windows 上安装 Claude Code。推荐方式是使用 PowerShell——打开 PowerShell（你可以右键点击开始按钮并选择"Windows PowerShell"或"终端"），然后运行：

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

如果你更习惯使用传统的命令提示符（CMD），可以使用这个替代命令：

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

两条命令达到的效果相同：下载官方安装器，把 Claude Code 放到 `%USERPROFILE%\.local\bin\claude.exe`。如果这个目录还不在 PATH 里，安装器会在 `Setup notes:` 下提示并给出修复方法，但不会自己修改 PATH。PowerShell 方式稍微更简洁，因为它不会留下临时文件。安装后，在新的终端窗口中使用 `claude --version` 进行验证。如果新窗口里仍提示命令未被识别，按下文"command not found"一节把这个目录加进用户 PATH；从没写进 PATH 的目录，只重开终端是补不上的。Windows 上一个常见的坑是，一些开发者会尝试使用 Git Bash（Git for Windows 自带的 Bash 模拟器）来运行基于 curl 的 macOS/Linux 安装命令——虽然这有时可行，但并不是推荐的做法。请坚持使用 PowerShell 或 CMD 方式以获得最可靠的 Windows 安装体验。如果你在 Windows 上使用 WSL，你应该在 WSL 环境内使用 Linux 的 curl 命令进行安装，而不是使用 Windows 的 PowerShell 安装器，因为 WSL 维护着自己独立的文件系统和 PATH 配置。

### 包管理器替代方案（Homebrew 和 WinGet）

对于偏好通过包管理器管理所有工具的开发者，Claude Code 可通过 macOS 上的 Homebrew 和 Windows 上的 WinGet 获取。在 macOS 上，只需运行 `brew install --cask claude-code`——这会将 Claude Code 安装为 Homebrew cask，意味着更新通过 `brew upgrade` 管理而非内置自动更新器；`claude-code` 这个 cask 跟随 stable 通道，通常比最新版晚一周左右，想第一时间拿到新版本可以改装 `claude-code@latest`。在 Windows 上，你可以使用 `winget install Anthropic.ClaudeCode` 通过 Windows 包管理器进行安装。两种包管理器方式提供与原生安装器相同的 Claude Code 二进制文件，并自动处理 PATH 配置。代价是你需要通过包管理器来管理更新，而非使用 Claude Code 的内置更新机制。部分开发者更喜欢这种方式以保持工具链的一致性，而另一些人则觉得不如自动更新方便。

## 原生安装器 vs Homebrew vs npm：你应该选择哪个？


三种不同的安装方式（加上 Windows 的 WinGet）可能让选择变得困惑。但实际上比看起来简单得多：对于绝大多数用户，原生安装器是正确的选择，Anthropic 自己的文档也明确推荐它。原生安装器不需要 Node.js 这样的运行时依赖，包含自动更新功能让你始终使用最新版本，并提供最稳定的体验，因为它是 Anthropic 主要测试和支持的方式。它适用于所有平台——macOS、Windows、Linux 和 WSL——每个操作系统只需一条特定的安装命令。

Homebrew 和 WinGet 是不错的替代方案，适合那些强烈偏好通过统一包管理器管理所有开发工具的用户。许多资深开发者通过 `brew` 或 `winget` 命令维护整个工具链，对 Claude Code 使用同样的方式可以保持工作流的一致性。代价是更新不是自动的——你需要显式运行 `brew upgrade` 或 `winget upgrade` 来获取新版本，这意味着你可能会落后于最新的功能和错误修复。对于需要控制更新节奏的企业环境，这反而可以是一个优势，因为你可以选择何时更新，而不是被自动推送更新。

理解为什么原生安装器被如此强烈推荐，有助于你正确看待其他选项。Anthropic 将原生安装器设计为完全自包含的：它不依赖任何系统级包管理器或运行时环境，从而消除了一整类与依赖冲突、版本不匹配和 PATH 污染相关的安装问题。它安装的是针对你的平台和架构编译好的原生二进制文件，运行时不需要 Node.js。自动更新机制会在后台检查并应用新版本，确保你始终能够访问最新的模型改进和错误修复，无需任何手动干预。

npm 方式（`npm install -g @anthropic-ai/claude-code`）仍然可用，截至 2026 年 10 月 16 日，官方安装文档把它列在"高级安装选项"里，没有说它被弃用，只是推荐方式仍是原生安装器。之前流传的"npm 已弃用"说法来自 2026 年 1 月 21 日发布的 2.1.15 版本，它曾给 npm 安装加过一条弃用提示；2.1.301 版本（macOS arm64）的程序里已经没有这条提示。npm 包现在要求 Node.js 22 或更高版本（2.1.197 及之前的下限是 18）；如果你的 Node 版本更旧，npm 只会在安装时打印 `EBADENGINE` 警告，安装照样完成，`claude` 也能正常运行。原因是从 2.1.113 版本起，npm 包会按你的平台通过可选依赖下载和原生安装器同一个二进制文件，`claude` 运行时并不调用 Node，实际跑的是和原生安装同一个程序。npm 全局安装也能自动更新，只有在 npm 全局目录不可写时才更新不了，这时 Claude Code 会在启动时提示一次，`claude doctor` 会列出解决办法。如果你更喜欢原生安装器，迁移过程很简单：先用 `npm uninstall -g @anthropic-ai/claude-code` 卸载 npm 包，然后使用你所在平台对应的 curl 或 PowerShell 命令安装原生版本。你的配置和设置会被保留，因为它们存储在你的主目录中，而不在 npm 包位置中。

用 npm 安装后如果运行 `claude` 提示 `Error: claude native binary not installed.`，说明可选依赖或安装后脚本被跳过了。去掉安装命令里的 `--omit=optional` 或 `--ignore-scripts`（并确认 `.npmrc` 没有设置 `optional=false`）后重新安装即可。

## 安装后的前 5 分钟

安装完成后，从"已安装"到"高效使用"应该是无缝衔接的，而这正是 Claude Code 的设计目标。你第一次在终端中运行 `claude` 时，会被引导完成一个认证流程，将 CLI 连接到你的 Claude 账户。系统会提示你通过浏览器登录，在那里你可以授权 Claude Code 使用你的 Pro、Max 或 API 凭证。这是一次性设置——后续启动会使用已保存的认证信息。

完成认证后，最重要的一点是理解 Claude Code 是基于你当前工作目录感知上下文的。在启动 Claude 之前，先用 `cd /path/to/your/project` 导航到你的项目文件夹，它会自动扫描并理解你的代码库结构。只需输入 `claude`（不带任何参数）即可启动交互式会话。然后你就可以用自然语言与 Claude 对话：请它解释某个函数的工作原理、要求它实现一个新功能、让它查找并修复一个 bug，或指示它重构一个模块。Claude Code 会读取你的文件、进行编辑、创建新文件，甚至可以代你运行终端命令（需要你的许可）。一些特别实用的首次使用命令包括 `claude "explain the architecture of this project"`（用于熟悉一个不了解的代码库），或 `claude "run the tests and fix any failures"`（立即获得实际价值）。你还可以使用单次执行模式，直接将请求作为参数传入——例如 `claude "add input validation to the user registration form"`——它会执行任务后退出而不启动交互式会话，非常适合快速修复或脚本化工作流。

理解 Claude Code 如何管理权限对于信任它处理你的代码库至关重要。默认情况下，Claude Code 在进行任何文件更改或运行 Shell 命令前都会请求你的批准，它会准确显示它打算做什么并等待你的确认。你可以通过权限模式调整这一行为：默认模式要求对每个操作进行批准，"acceptEdits"模式会自动批准文件编辑但仍会询问 Shell 命令，还有更宽松的模式供希望更快执行的资深用户使用。这个权限系统意味着你永远不必担心 Claude Code 做出意外更改——每一项修改在执行前都是可见且经过批准的，让你获得与手动修改相同的控制力，同时享受 AI 辅助带来的速度和准确性优势。

除了交互式会话，Claude Code 还支持多种资深用户日常依赖的工作流模式。你可以通过管道将内容直接传给 Claude，例如用 `git diff | claude "review this code change"` 进行快速代码审查，或用 `cat error.log | claude "diagnose the root cause of these errors"` 进行快速调试。`/init` 命令会在你的项目根目录创建一个 `CLAUDE.md` 文件，为 Claude 提供关于你项目的约定、编码规范和重要架构决策的持久上下文——可以把它看作一份简报文档，让每次后续交互都更加高效。资深用户通常会在这个文件中填入技术栈信息、测试要求和编码风格偏好，这会显著提高 Claude 在各次会话中建议的质量和一致性。

你还可以通过设置来配置 Claude Code 的行为，包括选择关注的发布渠道（`latest` 或 `stable`）、设置 MCP（模型上下文协议）服务器以扩展工具访问能力，以及为你偏好的终端环境自定义键盘快捷键。MCP 集成功能特别强大，因为它允许 Claude Code 与外部工具和服务交互——数据库、问题追踪器、文档系统——赋予它远超简单代码编辑的能力。

## 修复 5 个最常见的安装问题

即使安装过程非常简单，事情也可能出错——而且在安装阶段出错尤其令人沮丧，因为你甚至无法开始使用这个工具。以下是社区讨论和支持渠道中出现频率最高的五个问题及其解决方案。

**安装后提示"command not found"**：这是最常见的问题，原因几乎都是安装目录不在 Shell 的 PATH 里。这里要分清两件事：二进制文件放在哪里，和 Shell 去哪些目录里找命令。原生安装器把 `claude` 放在 macOS/Linux 的 `~/.local/bin/claude`、Windows 的 `%USERPROFILE%\.local\bin\claude.exe`，但不会修改 PATH；目录不在 PATH 里时，它只会在 `Setup notes:` 下打印 `Native installation exists but ~/.local/bin is not in your PATH.` 和修复方法。在 macOS 或 Linux 上，先用 `ls -la ~/.local/bin/claude` 确认文件存在，再用 `echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin"` 检查目录是否在 PATH 中。没有输出就需要自己补上：Zsh 运行 `echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc`，再运行 `source ~/.zshrc`；Linux 上的 Bash 改用 `~/.bashrc`，macOS 上的 Bash 改用 `~/.bash_profile`。在 Windows PowerShell 中，先用 `Test-Path "$env:USERPROFILE\.local\bin\claude.exe"` 确认文件存在，再按官方排错文档把目录加进用户 PATH：

```powershell
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')
```

然后打开一个新的 PowerShell 窗口，不要沿用运行安装器的那个窗口。重开终端只对已经写进配置的 PATH 有效：已经开着的窗口保留旧 PATH，编辑器里的终端沿用编辑器启动时的 PATH，需要退出编辑器再打开；如果目录从没加进 PATH，只重开终端解决不了。补完后运行 `claude --version` 确认。

**Windows 上提示"Git not found"**：这是第二常见的问题。现在的报错文字是 `Claude Code on Windows requires either Git for Windows (for bash) or PowerShell`，意思是 Git Bash 和 PowerShell 两个都没找到——Git for Windows 本身是可选的，有 PowerShell 就能用。解决办法有两个：如果 PowerShell 不在 PATH 里，把它的默认位置 `C:\Windows\System32\WindowsPowerShell\v1.0\` 加回 PATH，或安装 PowerShell 7；或者安装 Git for Windows，安装时勾选 "Add to PATH"，装完重启终端。如果你已经装了 Git 但 Claude Code 仍然找不到它，常见原因是安装时没有加入 PATH，或者装完没有重启终端。你可以在新的终端窗口中运行 `git --version` 来验证 Git 是否正确配置。

**认证失败**通常发生在你登录的账户没有 Claude Code 权限时。免费方案不包含 Claude Code，你需要付费方案（Pro $20/月起，或 Team、Enterprise）或 Claude Console 账户。如果账户本身没问题但仍然无法认证，尝试先运行 `claude auth logout` 然后运行 `claude auth login` 清除缓存凭证并重新发起认证流程（登录和退出是 `claude auth` 下的子命令，不是 `claude logout`、`claude login`；在会话里也可以直接输入 `/logout`）。网络问题，特别是阻止 Anthropic 认证端点的企业防火墙或 VPN，也可能导致认证失败。在这种情况下，检查你是否能在同一网络下通过浏览器访问 claude.ai。

**安装过程中的权限错误**发生在安装器无法写入目标目录或执行下载的二进制文件时。在 macOS 和 Linux 上，安装器会写入 `~/.local/bin/`、`~/.local/share/claude/` 和 `~/.claude/` 等目录，报错信息会指出写不进去的路径。可以用 `test -w ~/.local/bin && echo "writable" || echo "not writable"` 检查（`~/.claude` 同理）。重要的是，不要使用 `sudo` 进行安装，因为以 root 身份运行安装器会在你的主目录中创建 root 拥有的文件，这会在你之后尝试以普通用户身份运行 Claude Code 时导致不同的权限问题。如果目录不可写，或你之前用 sudo 运行过安装器，请用 `sudo mkdir -p ~/.local/bin` 和 `sudo chown -R $(whoami) ~/.local` 修复所有权（`~/.claude` 同样用 `sudo chown -R $(whoami) ~/.claude`），然后不使用 sudo 重新尝试。用 npm 安装时同样不要用 `sudo npm install -g`，碰到权限错误更简单的办法是改用原生安装器。在 Windows 上，安装器写入的是 `%USERPROFILE%` 下的目录，你的用户默认就有写权限，官方文档写明不需要以管理员身份运行 PowerShell。如果你处于写入访问受限、有终端保护软件或应用白名单策略的企业环境中，你可能需要请求 IT 团队将 Claude Code 的安装目录和二进制文件加入白名单。

**旧 npm 安装版本的冲突**可能会导致令人困惑的行为，如果你之前通过 npm 安装了 Claude Code 然后又安装了原生版本。两个版本可能同时存在于你的 PATH 中，你的 Shell 可能会找到错误的那一个。运行 `which -a claude`（macOS/Linux）或 `where.exe claude`（Windows）列出 PATH 里所有的 `claude`，官方的建议是只保留一个。原生安装器把它放在 macOS/Linux 的 `~/.local/bin/claude`、Windows 的 `%USERPROFILE%\.local\bin\claude.exe`；`~/.claude/local/` 是早期版本留下的本地 npm 安装；`npm -g ls @anthropic-ai/claude-code` 能看到 npm 全局安装。要删掉多余的副本，npm 全局安装用 `npm uninstall -g @anthropic-ai/claude-code`，旧的本地安装用 `rm -rf ~/.claude/local`。如果你启动时看到 `Error: Cannot find module './yoga.wasm'`，基本就是这种旧 npm 副本还在 PATH 里抢先运行，处理步骤见 [Claude Code 报错 Cannot find module './yoga.wasm'：是旧版本在跑](https://blog.laozhang.ai/zh/posts/claude-code-cannot-find-module-yoga-wasm)。清理完后，打开一个新终端再运行一次 `which -a claude`，确认只剩一个，再用 `claude --version` 确认版本是新的。

如果你遇到上述未涵盖的问题，code.claude.com 上的官方 Claude Code 故障排除指南提供了更多解决方案，而 `claude doctor` 命令会执行诊断检查，自动识别常见的配置问题。运行 `claude doctor` 会输出关于你的系统配置、认证状态和检测到的问题的详细报告，是安装出问题时最好的起点。

## 保持安全和保持更新

安全性通常不是你安装开发者工具时首先想到的事情，但 Claude Code 呈现了一个值得关注的特殊情况。2026 年，安全研究人员发现了一场通过 Google 广告推广假冒 Claude Code 安装页面、传播名为"InstallFix"攻击的恶意软件的运动（由 BleepingComputer 和 TechRepublic 报道）。这些恶意页面看起来与 Anthropic 的官方下载页面惊人地相似，并以付费广告的形式出现在搜索结果的顶部。结论简单但至关重要：只从官方来源安装 Claude Code。合法的安装 URL 包括 macOS/Linux 的 `claude.ai/install.sh`、Windows PowerShell 的 `claude.ai/install.ps1`、官方 Homebrew cask、WinGet 包 `Anthropic.ClaudeCode`，或官方 npm 注册表中的 npm 包 `@anthropic-ai/claude-code`。如果你是通过 Google 广告或不熟悉的网站到达安装页面的，在运行任何命令之前请仔细验证 URL。

要在安装后验证安装的完整性，请使用 `claude --version` 检查版本输出——合法安装会显示类似 `2.1.301 (Claude Code)` 这样干净的版本号。如果你看到任何异常、意外的品牌信息，或二进制文件位于意外的目录中（在 macOS/Linux 上使用 `which -a claude` 检查，原生安装应在 `~/.local/bin/claude`），请立即删除它并从官方来源重新安装。另外值得注意的是，Claude Code 仅与 Anthropic 的服务器通信进行 AI 处理——它不会将你的代码发送到任何第三方服务，你可以通过工具的透明度功能查看确切传输了什么数据。

使用原生安装器保持 Claude Code 更新非常简单，它会在后台自动检查并应用更新。你可以用 `claude --version` 手动检查当前版本，用 `claude update` 立即升级到新版本，成功时会提示从哪个版本更新到了哪个版本。不同安装方式的升级命令如下：

- 原生安装器：自动更新，手动升级用 `claude update`
- Homebrew：`brew upgrade claude-code`（装的是 `claude-code@latest` 就用 `brew upgrade claude-code@latest`），默认不会自动更新
- WinGet：`winget upgrade Anthropic.ClaudeCode`，默认不会自动更新
- npm：`npm install -g @anthropic-ai/claude-code@latest`。不要用 `npm update -g`，它受最初安装时的版本范围限制，可能升不到最新版；也不要加 `sudo`

保持最新版本不仅是为了新功能，还关系到安全补丁和稳定性改进。Claude Code 团队频繁发布更新，通常每周多次，因此原生安装器的自动更新机制确实很有价值，能确保你始终拥有最新的修复和功能，无需任何手动干预。你还可以通过设置 `autoUpdatesChannel` 在两个发布通道之间选择：默认的 `latest` 一发布就收到新版本；`stable` 用的是大约一周前的版本，会跳过有重大问题的版本，适合求稳的生产工作。

## 常见问题解答

**Claude Code 是免费的吗？**

Claude Code 本身是免费安装的——二进制文件无需付费下载。但是，你需要付费 Claude 方案或 Claude Console 账户来进行认证和实际使用。走订阅路线的话，包含 Claude Code 的最便宜方案是 Claude Pro：截至 2026 年 10 月 20 日，月付 $20/月、年付折合 $17/月。免费的 Claude 方案不包含 Claude Code 访问权限。另外，你也可以用 Claude Console 账户或 Anthropic API 密钥按量付费，不需要订阅，按编程会话中消耗的 token 收费，而非固定的月费。

**Claude Code 可以离线使用吗？**

不可以，Claude Code 需要互联网连接才能工作。它通过云端与 Anthropic 的 Claude 模型通信来处理你的请求，因此使用时需要稳定的互联网连接。你的代码本身会在本地处理以提供上下文，但 AI 推理发生在 Anthropic 的服务器上。工具确实会在本地缓存一些配置，因此启动和基本导航在没有网络的情况下也能工作，但任何实际的 AI 驱动辅助都需要在线。

**Claude Code 可以和 VS Code 或 JetBrains 一起使用吗？**

Claude Code 是一个独立的终端工具，不需要任何 IDE。但是，由于它在终端中运行，可以与任何编辑器或 IDE 并行工作。许多开发者在 VS Code 的集成终端中以分屏布局运行 Claude Code，或在 JetBrains IDE 旁边打开一个单独的终端标签页。如果想要更深的编辑器集成，Anthropic 官方提供了 VS Code 扩展和 JetBrains 插件。注意 VS Code 扩展自带一份只供它的聊天面板使用的 CLI，不会把 `claude` 加入 PATH；想在终端里运行 `claude`，仍要按上文单独安装命令行版本。

**如何卸载 Claude Code？**

按你当初的安装方式删除，Claude Code 没有 `claude uninstall` 这个命令。原生安装器在 macOS、Linux 和 WSL 上运行 `rm -f ~/.local/bin/claude` 和 `rm -rf ~/.local/share/claude`；在 Windows PowerShell 中运行 `Remove-Item -Path "$env:USERPROFILE\.local\bin\claude.exe" -Force` 和 `Remove-Item -Path "$env:USERPROFILE\.local\share\claude" -Recurse -Force`。如果你通过 Homebrew 安装的，使用 `brew uninstall --cask claude-code`（装的是 latest 版就用 `brew uninstall --cask claude-code@latest`）。对于 WinGet，使用 `winget uninstall Anthropic.ClaudeCode`。如果通过 npm 安装的，使用 `npm uninstall -g @anthropic-ai/claude-code`。`~/.claude/` 中的配置文件不会随卸载删除，只有你手动删掉它才会消失，因此你可以在之后重新安装而不会丢失设置。卸载后如果 `claude` 还能运行，说明还有第二份安装，用 `which -a claude` 找出来再删。

**Claude Code 和 Claude 桌面应用有什么区别？**

Claude 桌面应用提供类似 claude.ai 的图形化聊天界面，但作为你电脑上的原生应用运行。另一方面，Claude Code 是专为软件开发设计的命令行工具。Claude Code 可以读取和修改你项目中的文件、运行终端命令、与 git 交互，以及执行多文件编辑——这些是桌面应用所不具备的能力。你可以把桌面应用看作通用型 AI 助手，而 Claude Code 是一个专业的编程伙伴，驻留在你的终端中。

**Claude Code 的使用量如何计入我的订阅限额？**

Claude Code 的使用量确实会计入你的订阅使用限额，claude.com/pricing 写明终端里的使用和聊天共用同一个额度池。额度按滚动的 5 小时会话窗口重置，付费方案另有每周上限，所以繁重的 Claude Code 会话（特别是涉及大型代码库或大量连续操作的会话）可能很快用完 Pro 的额度。截至 2026 年 10 月 20 日，Max 5x（$100/月）提供 Pro 每个会话用量的 5 倍，Max 20x（$200/月）提供 20 倍；Anthropic 没有公布任何方案的固定 token 数或消息数。如果你达到使用限额，Claude Code 会通知你，你可以等待限额重置、升级到更高档位，或在付费方案里开启按标准 API 价格计费的使用额度（usage credits）继续工作。使用 Console 账户或 API 密钥代替订阅可以获得按量付费的定价模式，不受订阅的会话额度限制，但仍有 API 速率限制，密集使用时成本可能会累积。

**Claude Code 可以在 CI/CD 流水线或自动化脚本中使用吗？**

可以，Claude Code 支持非交互式使用，能在自动化环境中良好运行。你可以直接将命令作为参数传入，例如 `claude -p "generate unit tests for src/utils.ts"`，它会执行任务并输出结果，无需任何交互提示。对于 CI/CD 集成，你通常会使用存储为环境变量的 API 密钥进行认证，而非交互式浏览器登录。这使得在构建流水线中使用 Claude Code 进行自动化代码审查、测试生成或文档更新成为可能。`--output-format json` 标志在脚本场景中特别有用，因为它返回结构化输出，其他工具可以通过编程方式解析。

## 立即开始使用 Claude Code

在任何平台上安装 Claude Code 都不到五分钟，而原生安装器使这个过程简单到只需运行一条命令。首先确认你的系统满足要求（macOS 13+、Windows 10 1809+ 或 Linux Ubuntu 20.04+），确保你有付费 Claude 方案（Pro $20/月起）或 Claude Console 账户，然后运行适合你平台的安装命令。原生安装器是大多数用户的推荐选择——它自动处理依赖项、无需手动干预即可保持更新，并提供 Anthropic 积极测试和支持的最可靠体验。

请记住只从官方来源下载（claude.ai、code.claude.com 或 GitHub anthropics/claude-code），以保护自己免受通过假冒 Google 广告针对 Claude Code 用户的恶意软件攻击。如果在安装过程中遇到问题，上面的故障排除部分涵盖了五个最常见的问题及其解决方案，`claude doctor` 命令始终可以作为诊断的起点。安装完成后，导航到你的项目目录，输入 `claude`，然后开始构建——无论是实现新功能、重构旧代码，还是调试跨越整个代码库的棘手问题。你的终端刚刚成为了你最强大的编程工具，而你现在已经掌握了在任何平台上安全有效地安装、配置和维护 Claude Code 所需的一切知识。