本文面向零基础读者,从账号注册到第一次成功启动,全程手把手。
一、开始之前:你需要准备什么
在安装 Claude Code 之前,有两件事必须先搞定。
(一)注册 CLAUDE 账号
前往 claude.ai 注册一个账号,用 Gmail 或其他邮箱均可。
(二)订阅 CLAUDE PRO
Claude Code 需要 Claude Pro(或更高级别)订阅才能使用,免费账号只能用 Claude Chat,无法启动 Claude Code。 订阅入口:登录 claude.ai 后,点击左下角升级按钮,按月订阅即可。
注:没有订阅直接安装也能走完安装步骤,但启动时会提示无权限,所以建议先订阅再安装。
二、MAC 安装全流程
(一)安装 NODE.JS
Claude Code 通过 npm 安装,而 npm 是 Node.js 自带的包管理工具,所以第一步是装 Node.js。 打开终端(Terminal)。不知道怎么打开?按 Command + 空格,搜索终端,回车即可。 先检查一下电脑上有没有装过:
node --version
npm --version
如果看到版本号(比如 v20.x.x),说明已经装好,跳到第二步。 如果显示 command not found,说明还没装,按以下步骤安装: 方法:直接从官网下载安装包(推荐零基础用) 前往 nodejs.org,下载左边那个标着 LTS 的版本,双击 .pkg 文件,一路点继续安装即可。 安装完成后,重新打开终端,再次运行:
node --version
npm --version
两行都显示版本号,说明安装成功。
(二)安装 CLAUDE CODE
在终端中输入以下命令,回车:
npm install -g @anthropic-ai/claude-code
等待安装完成。如果遇到以下报错:
npm error code EACCES
npm error Error: EACCES: permission denied
这是权限问题,在命令前加 sudo 重新运行:
sudo npm install -g @anthropic-ai/claude-code
运行后会提示输入电脑开机密码。输入时屏幕不显示任何字符,这是正常的,输完直接回车。
(三)验证安装成功
输入以下命令:
claude --version
注意:claude 和 — 之间有空格。 如果看到类似 2.1.72 (Claude Code) 的版本号,安装成功。 如果仍然显示 command not found,尝试关闭终端重新打开,再运行一次。
(四)首次启动与登录授权
在终端输入:
claude
回车后,Claude Code 会启动,首先让你选择终端显示风格:
Choose the text style that looks best with your terminal
1. Dark mode
2. Light mode
...
输入 1(深色)或 2(浅色),回车。 接着会让你选择登录方式:
Select login method:
1. Claude account with subscription · Pro, Max, Team, or Enterprise
2. Anthropic Console account · API usage billing
3. 3rd-party platform
我们选第 1 种,即用 Claude 订阅账号登录,输入 1,回车。 此时浏览器会自动弹出一个授权页面,显示:
Claude Code would like to connect to your Claude chat account
点击页面上的 Authorize 按钮,授权完成后浏览器显示Build something great,说明授权成功。 回到终端,按回车继续。Claude Code 会提示是否使用推荐的终端设置,输入 1 接受即可。 最终看到欢迎界面,显示你的账号邮箱,说明安装与登录全部完成。
三、WINDOWS 安装全流程
Windows 有两种安装方式,我个人更推荐方式一(官方一键脚本),更快捷,不需要单独装 Node.js。
方式一:官方一键安装脚本(推荐)
这是官方提供的最快安装方式,一条命令搞定,参考自官方快速入门文档。 按 Win + R,输入 cmd,回车,打开命令提示符。输入以下命令:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
回车等待执行,脚本会自动完成安装。安装完成后,终端会显示 claude 的实际安装路径,类似:
Installed to: C:\Users\Administrator\.local\bin\claude.exe
重要:需要手动切换到该路径才能调用 claude。 在同一个 CMD 窗口中输入(将路径替换为你实际看到的安装路径):
cd "C:\Users\Administrator\.local\bin"
然后验证安装:
claude --version
看到版本号则安装成功,可以跳到第(三)步:首次启动与登录授权。 注:每次新开 CMD 都需要重新 cd 到该路径,或者将该路径添加到系统环境变量 PATH 中,之后就可以在任意位置直接运行 claude。添加方法:搜索编辑系统环境变量 → 环境变量 → 系统变量 → Path → 新建 → 粘贴安装路径 → 确定。
方式二:手动安装(通过 NODE.JS + NPM)
如果一键脚本执行失败,可以用这个方式。 打开命令提示符(CMD)。按 Win + R,输入 cmd,回车。 先检查是否已安装 Node.js:
node --version
npm --version
如果显示版本号,跳到下一步安装 Claude Code。 如果显示 ‘node’ 不是内部或外部命令,说明未安装,按以下步骤操作: 前往 nodejs.org,下载 LTS 版本的 Windows 安装包(.msi 文件),双击运行,一路点Next安装。 注意:安装过程中有一步Automatically install the necessary tools,建议勾选。 安装完成后,关闭并重新打开 CMD,再次运行 node –version 确认安装成功。 然后安装 Claude Code:
npm install -g @anthropic-ai/claude-code
如果遇到权限报错(EACCES 或 access denied),在开始菜单搜索命令提示符,右键选择以管理员身份运行,重新执行安装命令。
(三)验证安装成功
claude --version
看到版本号(如 2.1.72 (Claude Code))即为成功。 如果显示命令找不到,先关闭 CMD,重新打开后再试。若仍不行,检查系统环境变量 PATH 中是否包含安装路径。
(四)首次启动与登录授权
在 CMD 中输入:
claude
后续步骤与 Mac 完全一致: – 选择终端显示风格(输入 1 选深色) – 选择登录方式(输入 1 选 Claude 订阅账号) – 浏览器自动弹出授权页面,点击 Authorize – 回到终端按回车,接受推荐设置 – 看到欢迎界面,登录完成 注:Windows 系统推荐的终端快捷键与 Mac 不同,如不确定,可以选择 2(暂不设置)跳过,不影响正常使用。
四、常见报错与解决方法
| 报错信息 | 原因 | 解决方法 |
|---|---|---|
| command not found: claude | 安装未生效或 PATH 未更新 | 关闭终端重新打开,再运行 claude –version |
| EACCES: permission denied | npm 全局安装权限不足 | Mac 用 sudo npm install;Windows 用管理员身份运行 CMD |
| 浏览器没有弹出授权页面 | 默认浏览器设置问题 | 手动复制终端中显示的授权链接,粘贴到浏览器打开 |
| Authentication fails | 网络问题或账号未订阅 | 检查网络连接;确认已开通 Claude Pro |
| 登录后显示无权限 | 账号未订阅 Claude Pro | 前往 claude.ai 升级订阅 |
装好之后能做什么?下一篇我们讲如何设置工作目录、配置 CLAUDE.md,以及开始第一个实际任务。
如有问题,欢迎在评论区留言。
本文来自转载微信公众号-EconAgent ,不代表发现AI立场,如若转载,请联系原作者;如有侵权,请联系编辑删除。