本文是专为完全不懂编程的新手小白准备的 Claude code 开发助手安装指南。如果你不知道什么是命令行、什么是 npm,没关系!跟着这篇教程一步步操作即可。
写在前面:Claude code是什么?
这是一款由海外公司开发的 AI 辅助编程工具。安装后,你可以:
一句话:把 Claude code装进你的电脑里,随时调用。
第 1 章:安装前的准备工作
Claude Code 需要依赖 Node.js 运行。Node.js 是一个运行 JavaScript 的工具平台。
1.1 检查电脑是否已安装 Node.js
在操作之前,我们先检查一下你的电脑是否已经有 Node.js:
Windows 用户:
Win + R 键打开运行窗口cmd 回车,打开黑色窗口(这就是命令行)node -vv20.11.0 的版本号 → 恭喜,你已安装 Node.jsMac 用户:
node -v1.2 安装 Node.js(LTS 版本)
如果上一步检查发现没安装,请按以下步骤操作:
Windows 安装步骤:
node -v 确认Mac 安装步骤:
方法一:官网下载(推荐新手)
方法二:Homebrew 安装(如果你已安装 Homebrew)
brew install node重要提示:
第 2 章:安装 Claude Code
确认 Node.js 安装成功后,我们就可以安装 Claude Code 了。
2.1 Windows 系统安装
步骤 1:打开命令行
Win + R,输入 cmd,回车步骤 2:输入安装命令
在黑色窗口中输入以下命令,然后按回车:
npm install -g @anthropic-ai/claude-code你会看到什么?
added 1 package in 45s 的消息如果卡住不动?
2.2 Mac 系统安装
步骤 1:打开终端
Command + 空格 打开 Spotlight步骤 2:输入安装命令
npm install -g @anthropic-ai/claude-codeMac 用户如果遇到权限错误?
如果显示 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你会看到:
3.2 登录你的 Claude 账号
步骤1:在浏览器中打开显示的网址(类似 https://console.anthropic.com/...)
步骤 2: 使用你的 Claude 账号登录(如果没有,需要先注册)
步骤 3: 授权完成后,回到命令行窗口,Claude Code 就可以使用了!
3.3 第一个测试对话
登录成功后,光标会变成 >,这时候你可以:
输入你想问 Claude 的话,例如:
> 你好,请介绍一下你自己Claude 会回复你
常用快捷键:
Ctrl + C - 退出 Claude CodeCtrl + L - 清空屏幕Tab 键 - 自动补全文件路径第 4 章:常见问题解答
Q1:安装时显示 "npm 不是内部或外部命令"
原因:Node.js 没有正确安装
解决:
Q2:安装过程太慢或卡住
解决:使用国内镜像加速
# 设置淘宝镜像npm config set registry https://registry.npmmirror.com# 然后再安装npm install -g @anthropic-ai/claude-codeQ3:安装完成后输入 claude 提示 "找不到命令"
Windows 解决:
Mac 解决:
npm config get prefix/usr/local,则添加路径:export PATH="$PATH:/usr/local/bin"~/.zshrc 文件中(如果你用 zsh)或 ~/.bash_profile(如果用 bash)Q4:提示 "Node.js 版本过低"
解决:
Q5:Mac 提示 "无法验证开发者" 或安全警告
解决:
或者使用命令行跳过(不推荐长期用):
# 临时禁用安全检查(安装完成后可以改回去)sudo spctl --master-disable第 5 章:接下来可以做什么
安装完成后,你可以尝试:
1. 进入某个项目文件夹使用
# 进入你的项目文件夹cd 你的项目路径# 启动 Claude Codeclaude# 现在你可以问关于这个项目的问题> 请分析一下这个项目的结构2. 常用命令速查
claude | |
claude -v | |
claude --help |
3. 在 VS Code 中使用
claude 后按 / 查看所有斜杠命令
夜雨聆风