乐于分享
好东西不私藏

AI基础教程系列2: Claude Code的安装

AI基础教程系列2: Claude Code的安装

title: AI基础教程系列2: Claude Code的安装
description: 零基础安装指南,教你如何把 AI 助手装到电脑上
tags:

  • AI基础教程
  • Claude Code
  • 安装教程
  • Windows

AI基础教程系列2: Claude Code的安装

前置知识
:建议先阅读 [[Markdown从入门到精通]],学完 Markdown 再来装工具,事半功倍。

课前热身:你有没有遇到过这些情况?

周一早上,部门要开会,领导让你整理一下上个月的销售数据。你打开 Excel,看着密密麻麻的数字,开始发愁:这些数据要怎么分析?图表怎么画?PPT 怎么写?

周三下午,要写季度报告,你对着空白文档发呆了大半天,憋出一段干巴巴的文字,回头一看自己都觉得不够专业。

周五下班前,老板突然发来一堆客户反馈,让你分类整理、归纳要点。你复制粘贴了半天,眼睛都花了。

如果你有过这些经历,Claude Code 就是为你准备的


等等,这是给程序员用的吧?

不是。

Claude Code 是 Anthropic 公司推出的一款 AI 助手,它确实能帮程序员写代码,但它的能力远不止于此。

你可以把它理解为:一个超级能干的办公室助手

它能帮你:

你的需求
Claude Code 能做什么
不会写 Excel 公式
告诉它你想要什么,它帮你写公式
报告写不出来
告诉它你要写什么,它帮你起草
数据太多看不过来
把数据扔给它,让它帮你分析要点
邮件不知道怎么写得体
告诉它背景,它帮你写专业邮件
要整理会议记录
把录音/文字丢给它,让它帮你归纳
代码看不懂
丢给它,让它用人话解释给你听

核心是:你不用学编程,直接说人话就行。


这节课学什么?

今天这节课,解决最基础的问题:

怎么把这玩意儿装到你的电脑上?

考虑到大部分读者是 Windows 用户,我会从最基础的部分讲起。

特别说明
:如果你是 Mac 用户,安装过程更简单,我会专门标注 Windows 用户需要额外注意的地方。

一、先搞清楚几个概念

在开始安装之前,我们先来搞清楚几个名词。

什么是命令行?

命令行(也叫终端)就是一个纯文字的界面,你输入文字命令,电脑执行。

听起来很 old school,但别担心,今天的教程会手把手带你敲命令,其实比点按钮还简单。

打开方式:

  • Windows:按 Win + R,输入 wt,回车(wt = Windows Terminal)
  • Mac:按 Command + 空格,搜索"终端",回车
⚠️ Windows 用户注意:Claude Code 需要 Windows Terminal,不能用 CMD!CMD 是旧版命令行,很多功能不支持。

你会看到一个黑窗口(Mac 上是白窗口),别怕,这就是命令行。

什么是 Node.js?

Node.js 是 Claude Code 的运行环境。

你可以把它理解为:Claude Code 是一辆车,Node.js 就是发动机。车要跑,必须先有发动机。

不过你不用深入了解它是什么,只需要知道必须装它才能运行 Claude Code


二、Windows 用户:安装前的准备工作

⬇️ 这是 Windows 用户专属内容,Mac 用户请跳到下一节。

Windows 用户需要安装两个东西:

  1. Node.js(运行环境,Claude Code 依赖它)
  2. Git for Windows(让命令行更好用)

2.1 安装 Node.js

Step 1:下载安装包

打开浏览器,访问 Node.js 官网:

https://nodejs.org/

你会看到两个按钮:

  • LTS(长期支持版)—— 稳定,推荐我们用这个
  • Current(当前版)—— 最新功能

我们选 LTS 版本,点击下载。

Step 2:安装 Node.js

双击下载的安装包,一路点"Next"就行。

注意
:安装过程中会有一个选项"Add to PATH",一定要勾选!否则命令行找不到 Node.js。

安装完成后,关掉命令行窗口,重新打开一个

Step 3:验证安装

打开 Windows Terminal(按 Win + R,输入 wt),输入:

node -v

如果看到类似 v20.11.0 这样的输出,说明安装成功!

数字可能不一样,没关系,看到版本号就对了。

2.2 安装 Git for Windows

Step 1:下载安装包

访问 Git 官网:

https://git-scm.com/download/win

页面会自动检测你的系统,下载对应的安装包。

Step 2:安装 Git

双击安装包,会进入安装向导。

这里有个小坑:找到 Adding Git to PATH 这个选项,一定要选择第二个
"Git from the command line and also from 3rd-party software"

这样 Git 才能被命令行识别。

剩下的选项一路"Next"就行。

Step 3:验证安装

打开一个新的命令行窗口,输入:

git --version

看到版本号就说明装好了。


三、Mac 用户:快速安装 Node.js

Mac 用户简单很多。

Step 1:安装 Homebrew(如果没装过)

Homebrew 是 Mac 的包管理器,装软件特别方便。打开终端,输入:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
如果提示"Already installed",跳过这步。

Step 2:安装 Node.js

终端里输入:

brew install node

Step 3:验证

node -v

看到版本号就搞定了。


四、终于轮到 Claude Code 了

好了,准备工作做完,现在开始装主角。

4.1 安装命令

打开你的命令行(Windows 用 Windows Terminal,Mac 用终端),输入:

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

然后回车,等待安装完成。

小提示
:安装过程可能需要几分钟,显示一堆进度条是正常的,别关掉窗口。

看到类似这样的输出就说明装好了:

added 1 package in 5s

4.2 验证安装

输入:

claude --version

如果看到版本号,比如:

0.1.2

恭喜你!Claude Code 装好了!


五、第一次启动 Claude Code

在命令行里输入:

claude

如果看到类似这样的界面,说明 Claude Code 启动成功了!

这时候你可能会看到登录提示。按照屏幕上的指示,用浏览器登录 Anthropic 账号即可。

新手常见问题
:关于账号登录和费用问题,我们下节课会专门讲如何用国产模型(比如 DeepSeek)来替代,这样就不需要额外付费了。

六、跳过登录提示(可选)

如果你暂时不想登录,可以用一个小技巧跳过登录提示。

在用户目录下创建配置文件 .claude.json

系统
路径
Windows
C:\Users\你的用户名\.claude.json
Mac
/Users/你的用户名/.claude.json

在这个文件里写入:

{
  "hasCompletedOnboarding": true
}

保存后重启 Claude Code,就可以跳过登录了。


七、常见问题 Q&A

Q:输入 claude 提示"不是内部命令"怎么办?

Windows 用户请检查:

  1. 命令行有没有完全关掉重新打开
  2. Node.js 安装时有没有勾选 Add to PATH

解决方法:打开一个新的 Windows Terminal(Win + R,输入 wt),输入 claude --version 试试。

Q:安装过程很慢怎么办?

npm 安装有时候卡住,可以试试切换国内镜像:

npm config set registry https://registry.npmmirror.com

然后重新安装:

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

Q:Mac 上装了但找不到命令?

重新打开终端试试。如果还是不行,运行:

source ~/.zshrc

或者直接重启终端。


八、一图总结:Windows 安装流程

┌─────────────────────────────────────────────────────────┐
│                   安装流程 (Windows)                     │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  1. 下载 Node.js (LTS版本)     → nodejs.org            │
│                                                         │
│  2. 下载 Git for Windows        → git-scm.com          │
│                                                         │
│  3. 打开 Windows Terminal (Win+R → wt)                │
│                                                         │
│  4. 输入: npm install -g @anthropic-ai/claude-code     │
│                                                         │
│  5. 验证: claude --version                            │
│                                                         │
│  6. 启动: claude                                       │
│                                                         │
└─────────────────────────────────────────────────────────┘

本章小结

  1. Claude Code 不仅仅能写代码,还能帮你处理各种办公室任务
  2. Node.js 是它的运行环境,必须装
  3. Git 让 Windows 用户的命令行更好用
  4. 安装命令只有一条npm install -g @anthropic-ai/claude-code
  5. 验证是否成功:看 claude --version 能不能返回版本号

下节课预告

装好了 Claude Code,下一步就是用起来

下节课我们会讲:

  • 如何用 Claude Code 帮你写报告、整数据
  • 如何用国产模型(DeepSeek)替代昂贵的 Claude 账号
  • 几个实用的办公室场景示例

敬请期待!


本文属于《AI 基础教程》系列