安装 Claude Code:Windows、Mac 和 Linux

要安装 Claude Code,请在终端中运行 Anthropic 的官方命令:在 macOS、Linux 和 WSL 上运行 curl -fsSL https://claude.ai/install.sh | bash,在 Windows 的 PowerShell 中运行 irm https://claude.ai/install.ps1 | iex。然后用 claude --version 进行验证,再输入 claude 登录。需要付费的 Claude 订阅或 Console 账户:免费套餐不包含 Claude Code。
Claude Code 在 Windows、macOS 和 Linux 上只需一条命令即可安装,但各系统的细节有所不同:PowerShell 或 CMD、WSL、Homebrew、Linux 软件源、需要修正的 PATH。本指南提供 2026 年 11 月 18 日核实的官方命令、验证一切正常的方法、最常见的错误,最后介绍如何通过 Ollama 接入本地模型。
#如何安装 Claude Code?前提条件和官方命令
Claude Code 只需一条官方命令即可安装:在 macOS、Linux 和 WSL 上运行 curl -fsSL https://claude.ai/install.sh | bash,或在 Windows 的 PowerShell 中运行 irm https://claude.ai/install.ps1 | iex。该原生脚本是 Anthropic 推荐的安装方式,因为它会在后台自动更新。
Claude Code 是 Anthropic 的编程智能体:一个在终端中使用的程序,可读取项目代码、修改文件,并在你同意后运行命令。程序安装在你的机器上,但 AI 模型运行在 Anthropic 的服务器上:根据 2026 年 11 月 18 日查阅的官方文档,必须连接互联网。
| 系统 | 方法 | Commande | 自动更新 |
|---|---|---|---|
| macOS、Linux、WSL | 原生脚本(推荐) | curl -fsSL https://claude.ai/install.sh | bash | 是,在后台运行 |
| Windows(PowerShell) | 原生脚本(推荐) | irm https://claude.ai/install.ps1 | iex | 是,在后台运行 |
| Windows (CMD) | 原生脚本 | curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd | 是,在后台运行 |
| macOS | Homebrew | brew install --cask claude-code | 默认不会:brew upgrade claude-code |
| Windows | WinGet | winget install Anthropic.ClaudeCode | 默认不会:winget upgrade Anthropic.ClaudeCode |
| Debian、Ubuntu、Fedora、RHEL、Alpine | 已签名的 apt、dnf、apk 软件源 | 查看官方文档 | 否:通过系统更新 |
| 所有系统(Node.js 22 或更高版本) | npm | npm install -g @anthropic-ai/claude-code@latest | 取决于 npm 文件夹的权限 |
#配置要求
借助我们的经验和引导式路径,选择适合你 Mac 的工具,在日常中使用你的 AI。
- 在线空间,终身可用
- PDF + 文件
- 30 天内退款
- 系统
- macOS 13.0 或更高版本、Windows 10 1809 或更高版本(或 Windows Server 2019)、Ubuntu 20.04 或更高版本、Debian 10 或更高版本、Alpine Linux 3.19 或更高版本。
- 硬件
- 至少 4 GB 内存,以及 x64 或 ARM64 处理器。不需要显卡,因为 Claude 模型在远程运行。
- Compte
- Claude Pro、Max、Ultra、Team 或 Enterprise 订阅,或按用量付费的 Claude Console 账户。claude.ai 的免费套餐不包含 Claude Code。
- 国家
- Claude Code 仅限在 Anthropic 支持的国家/地区使用;法国属于其中之一。
价格方面,2026 年 11 月 18 日查阅的 Anthropic 官方页面显示,Pro 方案按月计费为每月 20 美元,并说明所有付费方案均包含 Claude Code,使用限额与订阅的其他部分相同。各方案详情及免费替代方案请参阅 Claude Code 价格专题指南。
#在 Windows 上安装 Claude Code:PowerShell、CMD 或 WSL
在 Windows 上,Claude Code 可在 PowerShell 中通过 irm https://claude.ai/install.ps1 | iex 安装,无需管理员权限。另一种方式是使用 Linux 命令将其安装在 WSL 2(Windows 的 Linux 子系统)中:这是 Windows 上唯一支持命令沙箱的方式。
- 01打开 PowerShell打开“开始”菜单,输入 PowerShell 并正常启动,不要选择“以管理员身份运行”。提示符以 PS C:\Users\VotreNom> 开头,这说明您处于 PowerShell 中,而不是 CMD 命令提示符中。
- 02运行安装脚本粘贴命令 irm https://claude.ai/install.ps1 | iex,然后按回车确认。该脚本下载 Claude Code 时不会显示进度条:请等待提示符重新出现后再进行其他操作。
- 03打开新的终端关闭 PowerShell 窗口并重新打开一个,使安装目录生效。程序位于 %USERPROFILE%\.local\bin\claude.exe。
- 04检查版本输入 claude --version。安装成功时会显示一个版本号,后面跟着 (Claude Code)。如果 Windows 提示无法识别 claude,请按照下文所述修复 PATH。
- 05安装 Git for Windows(建议)Git for Windows 是可选的,但 Anthropic 推荐安装:它提供 Git Bash,Claude Code 会用它来执行命令。没有它时,Claude Code 会改用 PowerShell。在 WSL 中安装则不需要它。
#在 Mac 上安装 Claude Code:原生脚本或 Homebrew
在 Mac 上,打开“终端”应用并运行 curl -fsSL https://claude.ai/install.sh | bash 即可安装 Claude Code。需要 macOS 13.0 或更高版本;Apple Silicon(ARM64)Mac 和 Intel(x64)Mac 均受支持。Homebrew 是另一种选择,但不会自动更新。
Homebrew 提供两个 Claude Code 软件包。claude-code 包跟随稳定渠道,该渠道通常滞后约一周,并会排除存在重大回归问题的版本。claude-code@latest 包则会在每个版本发布后立即获得更新。默认情况下,Homebrew 更新需手动执行 brew upgrade claude-code,第二个包则使用 brew upgrade claude-code@latest。若要让 Claude Code 自行发起此类 Homebrew 或 WinGet 更新,Anthropic 文档指出需将环境变量 CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE 设为 1。
原生脚本会将启动程序放在 ~/.local/bin/claude。如果终端提示“command not found: claude”,说明该目录尚未加入你所用 shell 的 PATH:解决方法见错误排查一节。
#在 Linux 上安装 Claude Code:脚本、apt、dnf 或 Alpine
在 Linux 上,Claude Code 使用与 Mac 相同的脚本安装:curl -fsSL https://claude.ai/install.sh | bash,无需 sudo。对于必须通过包管理器安装软件的机器,Anthropic 还提供了经过签名的 apt(Debian、Ubuntu)、dnf(Fedora、RHEL)和 apk(Alpine)软件源。
Alpine Linux 及其他基于 musl 的发行版默认不包含 bash 和 curl。缺少它们时,安装脚本会报“not found”错误。请先安装这两个软件包,然后重新运行安装命令。
apt、dnf 和 apk 软件源各自提供 stable 和 latest 两个渠道。其配置需要执行多条命令,其中包括校验 Anthropic 签名密钥的指纹:请直接按照官方文档高级安装页面(链接见本指南末尾)中的步骤操作。这些安装方式会随系统一同更新,例如 sudo apt update && sudo apt upgrade claude-code。
#如何确认 Claude Code 已正确安装?
要验证 Claude Code 是否安装成功,请打开一个新终端并输入 claude --version:应会显示一个版本号。截至 2026 年 11 月 18 日,官方版本日志顶部的最新版本为 2.1.327,而根据 npm 注册表,稳定渠道分发的是 2.1.311。因此,版本号较旧并不一定是错误:Homebrew 的 claude-code 包和默认配置的 Linux 仓库都跟随该稳定渠道。之后可使用 claude doctor 命令获取完整诊断。
claude doctor 命令无需打开会话,即可显示安装状态、设置文件中的错误,以及附带修复建议的警告。当 Claude Code 在安装或更新后表现异常时,应首先运行这条命令。
- 01进入项目目录在终端中,使用 cd 命令加上文件夹路径,进入你要用来工作的项目文件夹。Claude Code 会处理其启动所在文件夹中的文件。
- 02启动 Claude Code输入 claude。首次启动时,Claude Code 会打开浏览器,让你使用 Claude 账户(Pro、Max、Ultra、Team、Enterprise)或 Console 账户登录。如果浏览器显示一个代码而没有返回终端,请将该代码粘贴到终端中。
- 03提出第一个问题登录后,Claude Code 的提示界面会显示版本、模型和工作目录。你可以试着问一句“这个项目是做什么的?”。凭据会被保存:之后再启动时不会再要求登录。
- 04准备项目输入 /init,让 Claude Code 分析代码并生成一个初始 CLAUDE.md 文件,其中包含项目的编译命令、测试命令和约定。输入 /help 查看命令列表,输入 /config 进行设置。
#更新或卸载 Claude Code
原生安装的 Claude Code 会在启动时及后台自动更新;claude update 命令可立即应用最新版本。对于 macOS、Linux 或 WSL 上的原生安装,卸载方法是删除启动器和版本文件夹。
#找不到 Claude Code 或安装受阻:常见错误
安装 Claude Code 后最常见的错误是“command not found: claude”或“'claude' n'est pas reconnu”:程序已正确安装,但其所在目录(Mac 和 Linux 上为 ~/.local/bin,Windows 上为 %USERPROFILE%\.local\bin)不在 PATH 中。安装程序会在其“Setup notes”中提示这一点,但不会自行修正 PATH。
| 显示的消息 | 原因 | 修复措施 |
|---|---|---|
| command not found: claude / 'claude' is not recognized | 安装目录不在 PATH 中 | 将 ~/.local/bin(或 %USERPROFILE%\.local\bin)添加到 PATH,然后打开一个新终端 |
| The token '&&' is not a valid statement separator | 将 CMD 命令粘贴到了 PowerShell 中 | 使用 PowerShell 命令 |
| 'irm' is not recognized as an internal or external command | 粘贴到 CMD 中的 PowerShell 命令 | 使用 CMD 命令 |
| curl: (22) The requested URL returned error: 403 | 代理或网络过滤,或所在国家/地区不受支持 | 检查网络或公司代理 |
| App unavailable in region | Anthropic 不支持的国家/地区 | Claude Code 未在该国家/地区提供 |
| Alpine 上出现 not found | bash ou curl absents | apk add bash curl |
针对 zsh 的修正适用于 macOS,zsh 是其默认 shell。在使用 bash 的 Linux 上,同一行 export 应添加到 ~/.bashrc 文件中;在使用 bash 的 Mac 上,则应写入 ~/.bash_profile,因为 macOS 终端会将 bash 作为登录 shell 启动,而登录 shell 会忽略 ~/.bashrc。修正之前打开的终端仍保留旧的 PATH,而集成在 VS Code 等编辑器中的终端会继承编辑器的 PATH:请关闭并重新打开窗口或编辑器,然后再次运行 claude --version 测试。
#如何将 Claude Code 连接到 VS Code?
要在 VS Code 中使用 Claude Code,请安装 Anthropic 官方的 Claude Code 扩展:在 Mac 上按 Cmd+Shift+X,在 Windows 和 Linux 上按 Ctrl+Shift+X 打开扩展视图,搜索“Claude Code”并点击“安装”。需要 VS Code 1.94.0 或更高版本,以及付费 Claude 账户或 Console 账户。
Claude Code 的 VS Code 扩展为其聊天面板内置了一份独立的程序副本,但不会将其添加到 PATH。若要在 VS Code 的集成终端中输入 claude,仍需进行上文所述的独立安装。该扩展也可以通过 Open VSX 注册表安装到 Cursor 及其他基于 VS Code 的编辑器中。
#通过 Ollama 将 Claude Code 连接到本地模型
借助 Ollama,Claude Code 可以使用本地模型运行,因为它提供与 Anthropic 兼容的 API。安装 Claude Code 和 Ollama 后,ollama launch claude 命令会启动连接到 Ollama 的 Claude Code。Ollama 文档建议将本地模型的上下文设置为 64k tokens 或以上。
Ollama 的文档还介绍了通过环境变量进行手动配置的方法,使 Claude Code 指向 Ollama 在 11434 端口上的本地服务器。官方示例使用 qwen3.5 模型,其在 Ollama 模型库中的默认标签对应 9B 版本,大小为 6.6 至 7.6 GB;模型必须支持工具调用,Claude Code 才能读取和修改文件。
Claude Code 免费吗?+
安装 Claude Code 需要 Node.js 吗?+
在 Windows 上安装 Claude Code 需要管理员权限吗?+
如何在 Claude Code 中安装插件?+
安装后如何正确配置 Claude Code?+
Claude Code 可以离线使用吗?+
如何更新 Claude Code?+
#来源及 2026 年 11 月 18 日的核实
本指南中的命令、前提条件、版本和价格均于 2026 年 11 月 18 日采集自 Claude Code 官方文档、Anthropic 价格页面、Anthropic GitHub 仓库的版本日志以及 Ollama 文档;命令和价格经常变化,在企业环境中安装前请先核实。
- 来源:Claude Code 高级安装(Anthropic)
- 来源:Claude Code 快速入门(Anthropic)
- 来源:安装故障排除(Anthropic)
- 来源:VS Code 扩展(Anthropic)
- 来源:Claude 各方案价格(Anthropic)
- 来源:Claude Code 版本更新日志(GitHub,Anthropic)
- 来源:Claude Code 搭配 Ollama(Ollama 文档)
有反馈、发现了错误,或想补充说明?请告诉我们,让这份指南对每个人都更有帮助。