手把手教你安装 CLAUDE CODE:MAC 和 WINDOWS 完整指南

本文面向零基础读者,从账号注册到第一次成功启动,全程手把手。

一、开始之前:你需要准备什么

在安装 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立场,如若转载,请联系原作者;如有侵权,请联系编辑删除。

(0)
教程组小编的头像教程组小编
美团入场AI浏览器!Tabbit的真实体验
上一篇 3小时前
CLAUDE CODE 教程丨安装、使用与配置指南
下一篇 1小时前

相关推荐

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注