开始之前
Claude Code 在你的电脑的 终端 里运行——也就是你输入命令的那个文本窗口。你还需要一个付费的 Claude 账号(Pro 或 Max 版),免费版不包含 Claude Code。
好消息是:使用官方安装器,你 不需要 单独安装 Node.js。操作非常简单,一条命令就搞定。
如果你用的是 Windows,请先做一件事: Claude Code 需要一个叫 Git for Windows 的免费工具才能运行(它在后台使用,你不需要学或者自己用 Git)。如果你用的是 Windows 且还没安装,请先安装再继续:
访问 git-scm.com/downloads/win 下载安装包。
运行安装包。一路点击“下一步”,接受默认设置就好——不用改任何东西,即使有很多个屏幕。
如果问你用哪个编辑器,保持默认,然后点“下一步”。
到了“Adjusting your PATH environment”这个界面,保持当前选中的选项。
不确定有没有装 Git?直接装就行——重新安装没问题。Mac 用户可以跳过这一步,不需要额外的东西。
第一步 — 打开你的终端
在你电脑上打开终端。具体怎么做取决于你的系统:
Windows 10: 按 Win 键 + R,输入
cmd,然后按回车。命令提示符就会打开。Windows 11: 点击任务栏的搜索框(或按 Win 键),输入
Terminal,然后点击搜索结果里的“终端”。或者,右键单击“开始”按钮,选择“终端”。Mac: 按 Cmd + 空格键打开 Spotlight,输入
Terminal,然后按回车。
会出现一个窗口,上面有一行空白,你可以在那里输入。下面所有的命令都要在这里输入。
第二步 — 运行安装器
复制你系统的命令,粘贴到终端里,然后按回车。
Mac:
curl -fsSL https://claude.ai/install.sh | bash
Windows 11(以及使用 Terminal/PowerShell 的 Windows 10):
irm https://claude.ai/install.ps1 | iex
Windows 10(如果你在第一步里用 cmd 打开了命令提示符):
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
你会看到一堆文字滚动,这是它在运行。完成后,你会看到一条消息,告诉你 Claude Code 已成功安装。如果看到错误,请查看底部的“故障排除”部分。
第三步 — 打开一个新的终端窗口
这一步很容易被忽略,但很重要。彻底关闭你的终端窗口,然后重新打开一个(使用和第一步一样的方法)。
安装器把 Claude Code 添加到了你的系统里,但只有在你启动一个新窗口时,终端才会识别这个变化。跳过这一步是导致下一步看起来“没反应”最常见的原因。
第四步 — 启动 Claude Code 并登录
在你新的终端窗口里,输入:
claude
第一次运行时,它会问你如何登录。选择 使用你的 Claude 账号登录(而不是 API 密钥)。会打开一个浏览器窗口,让你登录你的 Claude 账号。登录完成后,你就可以回到终端了——你的 Pro 或 Max 订阅现在可以在 Claude Code 里使用了。
搞定!现在你就可以直接在终端里输入问题或请求了。
故障排除
安装步骤在每个系统上都一样,但如果出了问题,解决办法可能会因你使用的系统而异。以下是一些最常见的问题。
安装后出现“claude 无法识别”或“命令未找到”
这几乎总是意味着你跳过了第三步。彻底关闭终端,打开一个全新的窗口,然后再次输入 claude。终端只有在启动新会话时才能识别新安装的命令。
Windows:“irm 无法识别”(你在命令提示符,而不是 PowerShell)
如果 irm 命令报错“不是内部或外部命令,也不是可运行的程序或批处理文件”,说明你用的是命令提示符 (CMD) 而不是 PowerShell。你可以通过查看行首来判断你用的是哪个:PowerShell 显示 PS C:\...,而命令提示符只显示 C:\...。
请使用命令提示符对应的命令:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Windows 10:“无法创建 SSL/TLS 安全通道”
这在较旧的 Windows 10 系统上可能会发生。在 PowerShell 里,先运行下面的命令,然后再重新运行安装器命令:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 irm https://claude.ai/install.ps1 | iex
Windows:“Claude Code on Windows requires git-bash”
这意味着 Git for Windows 没有安装(或者 Claude Code 找不到它)。回到上面的“开始之前”部分安装 Git for Windows,然后关闭你的终端,打开一个新的,再次运行 claude。
Mac:安全或“权限”提示
由于官方安装器将 Claude Code 放在你自己的文件夹里(在你自己的主目录下),所以以前安装方法容易出现权限错误的情况在这里不会发生。如果你的 Mac 在第一次运行 claude 时显示一个安全弹窗,说无法验证应用程序,请打开 系统设置 → 隐私与安全性,向下滚动找到关于 claude 的消息,然后点击 仍要允许。然后再次在终端运行 claude。
还是卡住了?
安装完成后,你可以运行这条命令让 Claude Code 自检并指出问题所在:
claude doctor
它会检查你的安装和常见设置,通常会告诉你具体该怎么修复。

