入门 14 分钟IDE

安装 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 接入本地模型。

作者: Mohamed Meguedmi·更新于 2026-11-20·已在 Windows 11 上测试

#如何安装 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 日查阅的官方文档,必须连接互联网。

Claude Code 各系统安装方式(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是,在后台运行
macOSHomebrewbrew install --cask claude-code默认不会:brew upgrade claude-code
WindowsWinGetwinget install Anthropic.ClaudeCode默认不会:winget upgrade Anthropic.ClaudeCode
Debian、Ubuntu、Fedora、RHEL、Alpine已签名的 apt、dnf、apk 软件源查看官方文档否:通过系统更新
所有系统(Node.js 22 或更高版本)npmnpm install -g @anthropic-ai/claude-code@latest取决于 npm 文件夹的权限

#配置要求

在 Mac 上用好本地 AI 的完整套件。

借助我们的经验和引导式路径,选择适合你 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 上唯一支持命令沙箱的方式。

  1. 01
    打开 PowerShell
    打开“开始”菜单,输入 PowerShell 并正常启动,不要选择“以管理员身份运行”。提示符以 PS C:\Users\VotreNom> 开头,这说明您处于 PowerShell 中,而不是 CMD 命令提示符中。
  2. 02
    运行安装脚本
    粘贴命令 irm https://claude.ai/install.ps1 | iex,然后按回车确认。该脚本下载 Claude Code 时不会显示进度条:请等待提示符重新出现后再进行其他操作。
  3. 03
    打开新的终端
    关闭 PowerShell 窗口并重新打开一个,使安装目录生效。程序位于 %USERPROFILE%\.local\bin\claude.exe。
  4. 04
    检查版本
    输入 claude --version。安装成功时会显示一个版本号,后面跟着 (Claude Code)。如果 Windows 提示无法识别 claude,请按照下文所述修复 PATH。
  5. 05
    安装 Git for Windows(建议)
    Git for Windows 是可选的,但 Anthropic 推荐安装:它提供 Git Bash,Claude Code 会用它来执行命令。没有它时,Claude Code 会改用 PowerShell。在 WSL 中安装则不需要它。
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
Windows(WinGet)
winget install Anthropic.ClaudeCode
→
WSL 2 还是原生 Windows?
如果是 Windows 项目和工具,请选择原生 Windows。如果你的项目使用 Linux 工具,或者你需要命令沙箱,请选择 WSL 2——根据 Anthropic 文档,原生 Windows 和 WSL 1 均不支持该沙箱。在 WSL 中,请从 WSL 终端安装并运行 claude,而不是从 PowerShell。

#在 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 是另一种选择,但不会自动更新。

macOS(终端,原生脚本)
curl -fsSL https://claude.ai/install.sh | bash
macOS(Homebrew)
brew install --cask claude-code

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)软件源。

Linux(Ubuntu、Debian、Fedora…)
curl -fsSL https://claude.ai/install.sh | bash

Alpine Linux 及其他基于 musl 的发行版默认不包含 bash 和 curl。缺少它们时,安装脚本会报“not found”错误。请先安装这两个软件包,然后重新运行安装命令。

Linux(Alpine)
apk add bash curl

apt、dnf 和 apk 软件源各自提供 stable 和 latest 两个渠道。其配置需要执行多条命令,其中包括校验 Anthropic 签名密钥的指纹:请直接按照官方文档高级安装页面(链接见本指南末尾)中的步骤操作。这些安装方式会随系统一同更新,例如 sudo apt update && sudo apt upgrade claude-code。

!
通过 npm 安装:切勿使用 sudo
npm 方式需要 Node.js 22 或更高版本。Anthropic 文档明确不建议使用 sudo npm install -g,因为它会引发权限问题和安全风险,并指出需要 sudo 的安装无法自动更新。原生脚本可以避免这一问题。
macOS、Linux、Windows(npm,Node.js 22+)
npm install -g @anthropic-ai/claude-code@latest

#如何确认 Claude Code 已正确安装?

要验证 Claude Code 是否安装成功,请打开一个新终端并输入 claude --version:应会显示一个版本号。截至 2026 年 11 月 18 日,官方版本日志顶部的最新版本为 2.1.327,而根据 npm 注册表,稳定渠道分发的是 2.1.311。因此,版本号较旧并不一定是错误:Homebrew 的 claude-code 包和默认配置的 Linux 仓库都跟随该稳定渠道。之后可使用 claude doctor 命令获取完整诊断。

macOS、Linux、Windows
claude --version
claude doctor

claude doctor 命令无需打开会话,即可显示安装状态、设置文件中的错误,以及附带修复建议的警告。当 Claude Code 在安装或更新后表现异常时,应首先运行这条命令。

  1. 01
    进入项目目录
    在终端中,使用 cd 命令加上文件夹路径,进入你要用来工作的项目文件夹。Claude Code 会处理其启动所在文件夹中的文件。
  2. 02
    启动 Claude Code
    输入 claude。首次启动时,Claude Code 会打开浏览器,让你使用 Claude 账户(Pro、Max、Ultra、Team、Enterprise)或 Console 账户登录。如果浏览器显示一个代码而没有返回终端,请将该代码粘贴到终端中。
  3. 03
    提出第一个问题
    登录后,Claude Code 的提示界面会显示版本、模型和工作目录。你可以试着问一句“这个项目是做什么的?”。凭据会被保存:之后再启动时不会再要求登录。
  4. 04
    准备项目
    输入 /init,让 Claude Code 分析代码并生成一个初始 CLAUDE.md 文件,其中包含项目的编译命令、测试命令和约定。输入 /help 查看命令列表,输入 /config 进行设置。

#更新或卸载 Claude Code

原生安装的 Claude Code 会在启动时及后台自动更新;claude update 命令可立即应用最新版本。对于 macOS、Linux 或 WSL 上的原生安装,卸载方法是删除启动器和版本文件夹。

macOS、Linux、WSL(原生方式卸载)
rm -f ~/.local/bin/claude
rm -rf ~/.local/share/claude

#找不到 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。

Claude Code 安装错误及修复方法(Anthropic 故障排除指南,2026 年 11 月 18 日)
显示的消息原因修复措施
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 regionAnthropic 不支持的国家/地区Claude Code 未在该国家/地区提供
Alpine 上出现 not foundbash ou curl absentsapk add bash curl
macOS(zsh):将 ~/.local/bin 添加到 PATH
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
Windows(PowerShell):将该文件夹添加到用户 PATH
$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User')
[Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')

针对 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 的编辑器中。

i
无需终端:桌面应用
Anthropic 的文档还提供 Claude 桌面应用,可在 macOS、Windows 和 Linux(Linux 上为测试版)上无需终端即可使用 Claude Code。它同样需要登录付费 Claude 账户。

#通过 Ollama 将 Claude Code 连接到本地模型

借助 Ollama,Claude Code 可以使用本地模型运行,因为它提供与 Anthropic 兼容的 API。安装 Claude Code 和 Ollama 后,ollama launch claude 命令会启动连接到 Ollama 的 Claude Code。Ollama 文档建议将本地模型的上下文设置为 64k tokens 或以上。

macOS、Linux、Windows(已安装 Ollama)
ollama launch claude

Ollama 的文档还介绍了通过环境变量进行手动配置的方法,使 Claude Code 指向 Ollama 在 11434 端口上的本地服务器。官方示例使用 qwen3.5 模型,其在 Ollama 模型库中的默认标签对应 9B 版本,大小为 6.6 至 7.6 GB;模型必须支持工具调用,Claude Code 才能读取和修改文件。

macOS、Linux(Bash 或 Zsh)
export ANTHROPIC_AUTH_TOKEN=ollama
export ANTHROPIC_API_KEY=""
export ANTHROPIC_BASE_URL=http://localhost:11434
claude --model qwen3.5
!
Anthropic 不支持的配置
Claude Code 文档指出,Anthropic 不支持通过网关将 Claude Code 与 Claude 以外的模型配合使用。根据 Ollama 的文档,接入 Ollama 是可行的,但出现问题时应由 Ollama 负责,而不属于 Anthropic 的支持范围。效果在很大程度上取决于本地模型和可用内存。
常见问题
Claude Code 免费吗?+
Claude Code 程序可免费安装,但要配合 Claude 模型使用,需要付费订阅(Pro、Max、Ultra、Team、Enterprise)或按用量付费的 Console 账户。根据 2026 年 11 月 18 日查阅的 Anthropic 文档,claude.ai 的免费方案不包含 Claude Code。通过 Ollama 接入本地模型,会用您本机上的模型取代 Claude 模型,这不在 Anthropic 的支持范围内。
安装 Claude Code 需要 Node.js 吗?+
不需要。使用原生脚本、Homebrew、WinGet 或 Linux 软件源安装 Claude Code 时,已不再需要 Node.js。只有 npm 方式需要 Node.js 22 或更高版本,且文档说明安装的程序是原生二进制文件,运行时不使用 Node.js。原生脚本仍是推荐的安装方式。
在 Windows 上安装 Claude Code 需要管理员权限吗?+
不需要。Anthropic 文档指出,Claude Code 的安装命令可在 PowerShell 或 CMD 中运行,无需以管理员身份运行终端。程序安装在用户目录下的 %USERPROFILE%\.local\bin 中。
如何在 Claude Code 中安装插件?+
在 Claude Code 会话中,/plugin 命令会打开一个面板,列出已配置目录中的插件;/plugin install 后接插件名称和目录(例如 commit-commands@claude-plugins-official)会在安装前打开该插件的详情页。Anthropic 文档提醒,插件可以执行 hooks 和 MCP 服务器:安装前请先阅读其详情页。
安装后如何正确配置 Claude Code?+
安装 Claude Code 后,在项目中运行 /init,即可生成一个 CLAUDE.md 文件,其中描述编译和测试命令以及项目约定。设置可通过 /config 或在 ~/.claude/settings.json 文件中修改。claude doctor 命令会报告无效的设置文件和安装问题。
Claude Code 可以离线使用吗?+
不能。Anthropic 的文档指出,使用 Claude Code 必须联网,因为 Claude 模型运行在 Anthropic 的服务器上。使用 Ollama 和本地模型时,对模型的请求会留在本机,但 Anthropic 的文档并未说明可以完全离线运行:请将这一点视为无法保证。
如何更新 Claude Code?+
原生安装的 Claude Code 会在启动时和后台自动更新,claude update 可强制立即更新。默认情况下,通过 Homebrew、WinGet、apt、dnf 和 apk 安装的版本不会自动更新:请使用 brew upgrade claude-code、winget upgrade Anthropic.ClaudeCode 或 Linux 系统更新。对于 Homebrew 和 WinGet,设置变量 CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 可将此更新交由 Claude Code 处理。

#来源及 2026 年 11 月 18 日的核实

本指南中的命令、前提条件、版本和价格均于 2026 年 11 月 18 日采集自 Claude Code 官方文档、Anthropic 价格页面、Anthropic GitHub 仓库的版本日志以及 Ollama 文档;命令和价格经常变化,在企业环境中安装前请先核实。

这份指南对您有帮助吗?

有反馈、发现了错误,或想补充说明?请告诉我们,让这份指南对每个人都更有帮助。