乐于分享
好东西不私藏

Claude code 新手安装教程(完全小白版)

Claude code 新手安装教程(完全小白版)

本文是专为完全不懂编程的新手小白准备的 Claude code 开发助手安装指南。如果你不知道什么是命令行、什么是 npm,没关系!跟着这篇教程一步步操作即可。

写在前面:Claude code是什么?

这是一款由海外公司开发的 AI 辅助编程工具。安装后,你可以:

在电脑终端直接和 AI 对话
让 AI 帮你写代码、改代码
让 AI 帮你处理文件、分析项目
直接在 VS Code、JetBrains 等编辑器中使用

一句话:把 Claude code装进你的电脑里,随时调用。


第 1 章:安装前的准备工作

Claude Code 需要依赖 Node.js 运行。Node.js 是一个运行 JavaScript 的工具平台。

1.1 检查电脑是否已安装 Node.js

在操作之前,我们先检查一下你的电脑是否已经有 Node.js:

Windows 用户:

1
按 Win + R 键打开运行窗口
2
输入 cmd 回车,打开黑色窗口(这就是命令行)
3
输入命令:node -v
4
如果显示类似 v20.11.0 的版本号 → 恭喜,你已安装 Node.js
5
如果显示 "不是内部或外部命令" → 你需要安装 Node.js

Mac 用户:

1
打开 "终端"(Terminal)应用
2
输入命令:node -v
3
如果显示版本号 → 已安装
4
如果显示 "command not found" → 需要安装

1.2 安装 Node.js(LTS 版本)

如果上一步检查发现没安装,请按以下步骤操作:

Windows 安装步骤:

1
打开浏览器访问:https://nodejs.org/zh-cn
2
点击绿色的 "LTS"(长期支持版)按钮下载
3
下载完成后双击安装包
4
一路点击 "Next" 直到完成(保持默认设置即可)
5
安装完成后,重启命令行窗口,再次输入 node -v 确认

Mac 安装步骤:

方法一:官网下载(推荐新手)

访问 https://nodejs.org/zh-cn
点击 "LTS" 下载安装包
双击安装,一路点 "Continue"

方法二:Homebrew 安装(如果你已安装 Homebrew)

brew install node

重要提示

安装 Node.js 时,会自动安装 npm(Node Package Manager),这是安装 Claude Code 所需的工具
请确保安装的是 LTS(长期支持版),不是 Current 版
目前 Claude Code 要求 Node.js 版本 >= 18.0

第 2 章:安装 Claude Code

确认 Node.js 安装成功后,我们就可以安装 Claude Code 了。

2.1 Windows 系统安装

步骤 1:打开命令行

按 Win + R,输入 cmd,回车
或者右键点击开始菜单,选择 "终端" 或 "Windows PowerShell"

步骤 2:输入安装命令

在黑色窗口中输入以下命令,然后按回车:

npm install -g @anthropic-ai/claude-code

你会看到什么?

开始显示下载进度(可能显示很多文字滚动)
等待 1-3 分钟(取决于网络速度)
最后显示类似 added 1 package in 45s 的消息

如果卡住不动?

可以尝试按 Ctrl+C 取消,然后重新运行命令
或者使用国内镜像(见下方常见问题)

2.2 Mac 系统安装

步骤 1:打开终端

按 Command + 空格 打开 Spotlight
输入 "Terminal" 回车
或者在 "应用程序 > 实用工具" 中找到终端

步骤 2:输入安装命令

npm install -g @anthropic-ai/claude-code

Mac 用户如果遇到权限错误?

如果显示 EACCES: permission denied,需要加 sudo

sudo npm install -g @anthropic-ai/claude-code

输入后会要求你输入电脑密码(输入时不会显示,直接回车即可)

2.3 验证安装是否成功

安装完成后,输入以下命令检查是否成功:

claude -v

如果显示类似 2.1.119 的版本号,恭喜你!安装成功!


第 3 章:第一次使用 Claude Code

3.1 启动 Claude Code

在命令行输入:

claude

你会看到:

一个欢迎界面
提示你登录 Anthropic 账号
出现一个网址,让你用浏览器打开

3.2 登录你的 Claude 账号

步骤1:在浏览器中打开显示的网址(类似 https://console.anthropic.com/...)

步骤 2: 使用你的 Claude 账号登录(如果没有,需要先注册)

步骤 3: 授权完成后,回到命令行窗口,Claude Code 就可以使用了!

3.3 第一个测试对话

登录成功后,光标会变成 >,这时候你可以:

1

输入你想问 Claude 的话,例如:

> 你好,请介绍一下你自己
2

Claude 会回复你

3

常用快捷键:

Ctrl + C - 退出 Claude Code
Ctrl + L - 清空屏幕
按 Tab 键 - 自动补全文件路径

第 4 章:常见问题解答

Q1:安装时显示 "npm 不是内部或外部命令"

原因:Node.js 没有正确安装

解决

1
卸载已安装的 Node.js
2
重新安装 Node.js,确保勾选 "Add to PATH"
3
重启电脑后再试

Q2:安装过程太慢或卡住

解决:使用国内镜像加速

# 设置淘宝镜像npm config set registry https://registry.npmmirror.com# 然后再安装npm install -g @anthropic-ai/claude-code

Q3:安装完成后输入 claude 提示 "找不到命令"

Windows 解决

1
完全关闭命令行窗口
2
重新打开新的命令行窗口
3
如果还不行,可能是 npm 路径没有配置好

Mac 解决

1
检查 npm 全局安装路径是否在 PATH 中:
npm config get prefix
2
如果显示 /usr/local,则添加路径:
export PATH="$PATH:/usr/local/bin"
3
把上面这行加到 ~/.zshrc 文件中(如果你用 zsh)或 ~/.bash_profile(如果用 bash)

Q4:提示 "Node.js 版本过低"

解决

1
卸载旧版 Node.js
2
重新下载安装最新 LTS 版本(https://nodejs.org/zh-cn)

Q5:Mac 提示 "无法验证开发者" 或安全警告

解决

1
打开 "系统设置 > 隐私与安全性"
2
找到 Claude Code 相关的阻止提示
3
点击 "仍要打开"

或者使用命令行跳过(不推荐长期用):

# 临时禁用安全检查(安装完成后可以改回去)sudo spctl --master-disable

第 5 章:接下来可以做什么

安装完成后,你可以尝试:

1. 进入某个项目文件夹使用

# 进入你的项目文件夹cd 你的项目路径# 启动 Claude Codeclaude# 现在你可以问关于这个项目的问题> 请分析一下这个项目的结构

2. 常用命令速查

命令
作用
claude
在当前目录启动 Claude Code
claude -v
查看版本号
claude --help
查看所有可用命令

3. 在 VS Code 中使用

安装 VS Code 插件市场搜索 "Claude"
或使用 Claude Code 命令 claude 后按 / 查看所有斜杠命令