0%

Claude Code 入门指南 —— 普通人也能拥有的 AI 伙伴

上篇:手把手安装配置

🤔 先判断一下:你是否需要 Claude Code?

Claude Code 和网页版 AI 都是同一种AI 大脑,但使用方式和性能不同。下面这个表格可以帮你判断自己适合哪个:

对比维度 🌐 网页版 AI(DeepSeek、豆包、ChatGPT) 💻 Claude Code
怎么用 打开浏览器或者软件使用 在终端里打字命令
操作文件 需要手动把文件拖进对话框 直接在你文件夹里工作
一次处理 一次传几个文件 一次看几十个文件
记住你 每次新对话要重新介绍 有长期记忆,自动加载
帮你改文件 你复制粘贴它改的内容 直接修改你电脑上的文件
输出报告 只能生成文字 可生成 Markdown / PDF / PPT / Excel等等格式的文件
适合谁 日常聊天、简单问答 需要 AI 帮你操作电脑文件,处理复杂任务的人

简单一句话判断:

如果你只是想问问题、聊聊天,用 网页版 就好,打开浏览器就能用,没有任何门槛。

如果你想让 AI 帮你整理文件、写文档、处理数据、批量改东西,那就装 Claude Code —— 它能直接进到你的文件夹里工作。

本文接下来的内容,都是针对 Claude Code 的安装和使用。


⚠️ 开始前:看看你的电脑能不能用

如果你决定要装 Claude Code,先确认一下你的电脑是否满足系统要求:

最低系统要求:

系统 是否支持
Windows 10 / 11 ✅ 支持
macOS ✅ 支持
Linux ✅ 支持
Windows 7 / 8 ❌ 不支持

为什么 Windows 7 和 8 不行?Claude Code 依赖较新版本的 Node.js(需要 Node.js 18+),而这些版本早已停止支持 Windows 7/8。如果你用的是 Win7/8,建议升级系统到 Windows 10 或 11。

硬件要求:

  • 能正常上网的电脑即可,没有特殊的显卡要求
  • 建议 8GB 以上内存(日常使用 4GB 也能跑,但体验会差一些)
  • 硬盘至少有 500MB 空闲空间

网络要求:

  • 需要能够访问 DeepSeek API(国内网络可以直接访问,无需科学上网)

🎬 配置完成后你将会看到的

按照下面的步骤全部配置好后,在终端里输入 claude 按回车,再信任它查看当前的目录,你会看到这样的界面:

image-20260722191348760

这个界面就是你的 AI 搭档——它已经准备好在你的文件夹里工作了。

具体来说:

  • 🔹 顶部显示 Claude Code 的版本号
  • 🔹 中间 > 提示符后面就是你的对话框,可以直接打字,就像跟一个工作伙伴聊天一样image-20260722191558318
  • 🔹 它会读取你文件夹里的文件,帮你分析、修改、创建
  • 🔹 修改完的文件直接保存在原地,不需要手动下载覆盖

💡 整个界面都在终端里。如果你第一次用终端,记住几个操作就够了:

  • 打字:在 > 后面输入你想说的话
  • 回车:按回车键发送消息
  • 如果看到权限提示(询问”是否允许某个操作”),用 上下箭头键 选择「Yes」或「No」,再按回车确认,下图就是个例子。
  • image-20260722191842282
  • 取消:如果你觉得当前claude code干活的方向不对,你可以在它干活的任何时候按下键盘左上角的Esc键来终止它的任务。

💡 如果你跟着本文一步步配置完成了,回头来看这里,你会觉得”原来就这么简单”。


〇、几个概念

这篇文章里会出现几个容易搞糊涂的词,可以先花两分钟了解一下它们,不需要记住,只要有个大致的印象就行,后面哪里遇到不懂的,再根据左边的目录跳回来。当然如果你已经有过一些相关经验,完全可以跳过。

🖥️ 什么是「终端」「命令行」「cmd」「PowerShell」?

这是最容易搞混的一组概念,这里有一个比喻,可以帮你理清:

电脑系统就像一栋楼。

  • 图形界面(你平时操作的样子) = 楼里的电梯和走廊,点哪里走到哪里,直观
  • 终端 / 命令行 = 楼里的一条密道,你对着它喊一句口令,它直接把你送到指定房间,比走电梯快得多

终端 是一个统称,Windows 上有两个常见终端:

名字 图标 说明
cmd(命令提示符) 黑窗口 + 白文字 老牌终端,Windows 自带,功能基础
PowerShell 蓝窗口或黑窗口 微软新一代终端,功能更强,也是 Windows 自带

Mac 上的终端 就叫「终端」,是一个白底或黑底的窗口。

本文怎么做: 你只需要记住:

  • 终端 = 一个让你打字命令的窗口
  • 文中写 bash xxx 这样的代码块,就表示「把里面的内容复制到终端里,按回车」

🚪 怎么打开终端?

根据你的电脑系统,操作不太一样:

Windows:

方法一(通用,终端默认在用户目录打开):

  1. 按键盘上的 Win + R(左下角 Windows 键 + R 键)
  2. 屏幕左下角会弹出一个小窗口
  3. 输入 powershell,按回车
  4. 一个深色背景的窗口就打开了——这就是终端

方法二(推荐,直接在指定文件夹打开):

  1. 打开文件资源管理器,找到你要操作的文件夹
  2. 在文件夹的空白处右键单击
  3. 在弹出的菜单中,选择「在终端中打开」或「Open in Terminal」
  4. 终端直接在这个文件夹里打开了,省去跳转目录的步骤

💡 方法二的好处是终端打开后就在你想要的文件夹里,不用再输 cd 命令跳转。当然你用方法一也完全没问题,你想让claude code操作哪个目录,你就把那个目录的绝对路径复制粘贴到对话框里就行。

不知道怎么找绝对路径?没关系,很简单,下面两张图解释清楚

首先先进入你想要操作的文件夹,我这里以claude-demo文件夹为例。找到文件夹上方的路径框,左键单击空白部分

image-20260722193410592

然后原来左边的文字就变成了这个,被蓝色框起来的绝对路径,此时再在这个框里右键就可以复制了

image-20260722193506011

Mac:

  1. 按 Cmd + 空格(Command 键 + 空格键)
  2. 屏幕中间会出现一个搜索条
  3. 输入 终端,按回车
  4. 一个白色或深色背景的窗口就打开了——这就是终端

💡 终端小技巧:

  • 粘贴方法:Windows 用户在终端里右键单击即可粘贴(不需要 Ctrl+V)。Mac 用户用 Cmd + V 或右键粘贴

📁 Mac用户要看的:什么是 Finder?

Finder 是 Mac 上的文件管理器——相当于 Windows 上的「此电脑」或「文件资源管理器」。你在 Mac 上打开任意一个文件夹看到的就是 Finder 窗口。

Windows 和 Mac 对照:

操作 Windows Mac
打开文件管理器 Win + E Cmd + N(在 Finder 中)
前往指定路径 在地址栏粘贴路径 Cmd + Shift + G,输入路径
显示隐藏文件 查看 → 勾选「隐藏的项目」 Cmd + Shift + .

🔧 什么是 Git?为什么装它?

Git 是一个版本管理工具。通俗讲:

就像写论文时「另存为」不同版本一样:论文_初稿.md、论文_修改1.md、论文_定稿.md……但 Git 帮你自动做这件事,而且你可以随时回到任何一个历史版本。

Claude Code 需要 Git 来管理它的工作区,所以必须先装上。你不需要学会用 Git,装好就行,Claude Code 自己会调用它。

📦 什么是 Node.js?什么是 npm?

  • Node.js 是一个让 JavaScript 语言可以脱离浏览器运行的环境。Claude Code 是用 JavaScript 写的,所以需要 Node.js 才能跑起来。
  • npm 是 Node.js 自带的「应用商店」,装 Claude Code 的时候就是通过 npm 从网上下载安装的。
  • 这两个概念简单了解即可。

🔑 什么是 API Key?

API Key 是一串身份验证密码,格式像这样:

1
sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

类比一下:API Key 就像你买了一张游泳馆的年卡。到了游泳馆(API 服务商),你出示这张卡(输入 Key),他们才让你进。所以 不要把这个 Key 发给任何人,也不要在截图里露出完整的 Key。

📝 什么是 JSON 文件?

.json 是一种配置文件格式,长得像这样:

1
2
3
4
{
"名字": "小明",
"年龄": 18
}

它用 { } 括起来,里面是 "名称": 值 的配对。特点: 每个 { } 和每一个 " " 都必须成对出现,少一个逗号或多一个逗号都会报错。如果后续遇到「JSON 解析错误」,八成是改配置文件时多删了或少加了逗号。


小总结: 下面文章里你会反复遇到这几个词,记不住没关系,随时翻回来看就行:

概念 一句话记住
终端 / 命令行 一个让你打字命令的窗口
cmd / PowerShell Windows 上的两种终端,随便用哪个都行
Finder Mac 上的文件管理器,相当于 Windows 的「此电脑」
Git 版本管理工具,装好就行不用学
Node.js Claude Code 的运行环境
npm 装 Claude Code 时用的工具
API Key 你的身份凭证,不要泄露
JSON 配置文件格式,注意逗号和引号要成对

一、前置准备:安装 Git

Claude Code 的版本管理、工作区隔离等功能依赖 Git,必须先装好。

Windows 用户:

  1. 访问 https://git-scm.com/downloads/win,下载 64-bit 版本(注意:这个网页加载很慢是正常的,如果可以的话请用魔法上网!)git安装
  2. 双击安装包,一路点 Next(所有选项用默认即可)
  3. 安装完成后,在终端输入以下命令验证:
1
2
git --version
# 应该看到类似 git version 2.47.0 的输出

Mac 用户:

Mac 通常已预装 Git。打开终端输入 git --version 验证。如果没有,按提示安装 Xcode Command Line Tools 即可:

1
xcode-select --install

二、前置准备:安装 Node.js

Claude Code 是基于 Node.js 的命令行工具,所以第一步是安装 Node.js。

1.1 下载 Node.js

访问 Node.js 官方下载地址 https://nodejs.org/,在网站上一般会展示多个版本,如无特殊要求,建议选择最新的 LTS 版本

  • LTS:长期支持版,推荐大多数用户使用的稳定版
  • Current:包含最新功能的开发版,适合想要尝试新功能的用户

image-20260718211203223

如图所示,点击左下角的安装程序安装即可

1.2 安装 Node.js

Windows 用户:

  1. 双击下载好的 node-vxx.x.x-x64.msi 安装包
  2. 勾选「I accept the terms in the License Agreement」,点 Next
  3. 安装路径用默认的就行,一路点 Next
  4. 最后点 Install,等待进度条跑完
  5. 点 Finish 完成

Mac 用户:

  1. 双击下载好的 .pkg 安装包
  2. 一路点「继续」,输入密码确认
  3. 等待安装完成

1.3 验证安装

在终端里输入以下命令,看到版本号就说明安装成功了:

1
2
3
4
5
node -v
# 应该看到类似 v22.11.0 的输出

npm -v
# 应该看到类似 10.9.0 的输出

💡 如果没有显示版本号,试试关闭终端重新打开,或者重启电脑。


三、安装 Claude Code

在刚才的终端里输入下面这行命令:

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

你会看到终端里开始滚动安装日志。这个过程一般 1-3 分钟,取决于网络速度。

⚠️ 如果出现权限错误(Mac/Linux 常见),在命令前面加 sudo:

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

然后输入你的电脑开机密码(输入时不会显示,这是正常的),回车即可。

安装完成后,输入以下命令验证:

1
claude --version

看到版本号(如 v2.x.x)就说明安装成功 ✅


四、获取 DeepSeek API Key

Claude Code 本身是 Anthropic 公司的产品,但原生支持配置第三方 API。对于国内用户来说,使用 DeepSeek API 是最实惠的方案,价格约为官方 API 的十分之一。

3.1 注册 DeepSeek 账号

  1. 打开浏览器,访问 https://platform.deepseek.com/
  2. 点击右上角「登录」→「注册」
  3. 用手机号或邮箱注册,按提示完成验证
  4. 登录后进入控制台

3.2 创建 API Key

  1. 在左侧菜单点击「API Keys」
  2. 点击「创建 API Key」
  3. 给它起个名字(比如 claude-code),点击创建
  4. ⚠️ 关键:创建成功后立刻复制 Key 并保存到安全的地方! 这个 Key 只显示一次,关掉页面就再也看不到了。

Key 的格式类似 sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx。

3.3 充值(少量即可)

DeepSeek API 按量计费,充值 10 元就够用很久。注册时通常有免费额度赠送,可以先试试。在左侧菜单「充值」里按提示操作就行。

注意:在下一步配置settings.json前,一定要确保api里是有钱的,哪怕只有一块钱也可以,否则会报错。


五、配置 settings.json

这是最关键的一步——让 Claude Code 知道要去哪里调用模型。

4.1 找到配置文件位置

Windows:

  • 命令行方式:按 Win + R,输入 %USERPROFILE%\.claude,回车。
  • 手动查找方式:根据C:\Users\<你的实际用户名>\.claude\settings.json 这个路径,从c盘一路进去。注意:Users可能变成中文的用户,**.claude**文件夹可能不存在,那就自己创建。

Mac:

  • 命令行方式:打开 Finder,按 Cmd + Shift + G,输入 ~/.claude,回车。
  • 手动查找方式:在 Finder 中按 Cmd + Shift + . 显示隐藏文件,然后依次进入 用户 -> <你的用户名> -> .claude 文件夹。

⚠️ 如果 .claude 文件夹不存在(第一次使用大概率没有),那就自己创建一个。在 Finder 中按 Cmd + Shift + G,输入 ~/ 回车,然后右键 → 新建文件夹,命名为 .claude(注意前面有个点)。

4.2 创建或编辑配置文件

在该目录下创建或编辑一个名为 settings.json 的文件。

Windows 用户推荐操作:(如果已经有这个文件了,直接跳到第三步)

  1. 在 .claude 文件夹里右键 → 新建 → 文本文档
  2. 改名为 settings.json(注意后缀是 .json 不是 .txt)
  3. 用记事本打开,粘贴下面的内容

Mac 用户推荐操作:

  1. 打开终端,输入:
    1
    nano ~/.claude/settings.json
  2. 粘贴下面的内容

4.3 配置文件内容

把以下内容粘贴进去,如果里面原来有内容的话,替换掉:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
"ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-flash[1m]",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-flash[1m]",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-flash",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
"CLAUDE_CODE_EFFORT_LEVEL": "max"
},
"language": "chinese",
"model": "opus[1m]",
"theme": "dark"
}

关键修改:把 "ANTHROPIC_AUTH_TOKEN" 后面那一长串 sk-xxxxxxxx 替换成你自己的 DeepSeek API Key。

4.4 配置项说明

配置项 作用
ANTHROPIC_BASE_URL 告诉 Claude Code 请求发到 DeepSeek 的服务器
ANTHROPIC_AUTH_TOKEN 你的 DeepSeek API 密钥
ANTHROPIC_DEFAULT_OPUS_MODEL 告诉 Claude:”要调最强模型(Opus 档)时,去调 DeepSeek 的 v4.1-flash,并开启 1M 超长上下文”
ANTHROPIC_DEFAULT_SONNET_MODEL 告诉 Claude:”日常使用(Sonnet 档)时,同样去调 deepseek-flash(1M 上下文)”
ANTHROPIC_DEFAULT_HAIKU_MODEL 告诉 Claude:”要调轻量模型(Haiku 档)时,去调 deepseek-flash”
CLAUDE_CODE_EFFORT_LEVEL 推理深度:max 最强但最贵,可选 high / medium / low 来省钱
language: "chinese" 界面和回复使用中文
model: "opus" 默认就调 Opus 档(多模态最强),需要省钱时可以说”切换到 sonnet”
theme: "dark" 暗色主题,护眼
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: "1" 禁用非必要的网络请求(使用第三方 API 时必须开启)

💡 简单来说: Claude Code 这软件本身是为 Claude 官方模型做的,但我们用的是 DeepSeek 的模型,不是 Claude 的。所以需要告诉它——“当你要最强模型时,实际去调 DeepSeek 的哪个模型。” 上面表格里那三个 DEFAULT_*_MODEL 配置项,干的就是这件事——相当于一张翻译对照表:

Claude 的叫法 实际调用的是(DeepSeek) 什么时候用
Opus(Claude 的最强模型) deepseek-flash[1m] 默认档,最强 + 1M 超长上下文
Sonnet(Claude 的日常模型) deepseek-flash[1m] 同样最强模型,可手动切换
Haiku(Claude 的轻量模型) deepseek-flash 后台轻量任务

2026 年 9 月 10 日起,DeepSeek 发布了 V4.1 Flash,三个档位推荐全部指向它,原因是这个模型全面超越了上一代的 V4 Pro(包括自家的旗舰)。

对比上一代的配置(Opus 档用 DeepSeek-V4-Flash-Vision-Exp、Sonnet 档用 deepseek-v4-pro、Haiku 档用 deepseek-v4-flash),新配置三个档位合并成一个模型,不用再纠结哪个档位该用哪个模型。

⚠️ 旧模型名仍可用:deepseek-v4-flash 和 deepseek-v4-flash-vision-exp 已被官方下线,但出于兼容考虑会自动路由到 V4.1 Flash;deepseek-v4-pro 在 2026 年 9 月 14 日 12:00 之后也会全部路由到 V4.1 Flash 并按新价格计费。所以旧配置不会报错,但没必要再用了。

4.5 保存并退出

  • 记事本:文件 → 保存,关闭
  • nano:Ctrl + O 保存,Ctrl + X 退出

六、验证安装

5.1 启动 Claude Code

在终端中输入:

1
claude

首次启动可能需要初始化,等待几秒钟。看到类似下面这样的界面,就说明成功了:

1
2
Claude Code v2.x.x
输入你的问题...

5.2 测试一下

随便输入一句话,比如:

1
你好,请用中文回复我

如果 Claude Code 用中文回复了你,并且没有报错,恭喜你 🎉 配置全部完成!

5.3 常见启动问题排查

问题 解决方法
claude 不是可识别的命令 关掉终端重新打开,或检查 Node.js 是否正确安装
连接超时 / 网络错误 检查 DeepSeek API Key 是否正确、是否已充值
JSON 解析错误 检查 settings.json 是否有语法错误(逗号、引号是否成对)
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 警告 这个不是错误,是正常提示

下篇:Claude Code 能帮你做什么?

以下案例来自我的真实使用经历。我是计算机专业准大二学生,掌握C语言,正在学数据结构与算法,STM32 嵌入式开发。

不止写代码——日常办公也能用

很多人听到”命令行工具”就以为这是程序员专属。其实 Claude Code 能做的远不止写代码。它能直接操作你电脑上的文件——读取、修改、创建、转换格式,就像一个住在本地的 AI 助手。

和网页版 AI 最大的区别在哪? 用网页版(豆包、DeepSeek、ChatGPT 等),你需要把文件一个个拖进对话框,每次对话结束上下文就丢了,下次要重新传。而 Claude Code 直接在你的文件夹里工作——它能一眼看到整个目录里有什么,你不需要手动上传任何东西。改完的文件直接保存回原位置,没有”下载→覆盖→确认”的来回折腾。

用一个比喻来说:网页版 AI 是你把文件送到它面前,Claude Code 是它直接走进你的书房。

举几个普通人立刻能用的例子:

  • 阅读总结:有好几份几十页的 PDF 合同或论文?让 Claude Code 帮你读,然后根据你的要求总结要点、标注风险条款
  • 撰写文书:要写一份活动策划、工作汇报、社团申请书?告诉它需求和风格,它能直接生成 .md 、.pdf、 .txt等等格式的文件,你稍作修改就能用
  • 处理 Excel / CSV 表格:有一个乱七八糟的数据表?让它帮你整理、筛选、生成统计摘要,几秒钟搞定手工几小时的工作
  • 批量重命名文件:照片、文档、音乐文件命名混乱?让它按规则批量重命名
  • 格式转换:Markdown 转 PDF、JSON 转 CSV、摘取网页内容存为笔记——说一声就行

操作方式很简单,你可以任选一种方式来告诉 Claude Code “我要在这个文件夹里工作”:

方法一:在文件夹里直接打开终端(最推荐)

  1. 打开文件资源管理器,找到你要操作的文件夹
  2. 在文件夹的空白处右键单击
  3. 选择「在终端中打开」或「Open in Terminal」(Windows 11 或 Mac 都有这个选项)
  4. 在弹出来的终端里输入 claude,回车
  5. 搞定——Claude Code 自动就在这个文件夹里工作了

💡 找不到这个选项? 也可以打开终端后,输入 cd (注意 cd 后面有个空格不能少),然后把文件夹从资源管理器拖进终端窗口,文件夹路径会自动填入,然后再按回车就行。cd 的意思是”进入某个文件夹”,是 Change Directory 的缩写。

方法二:把文件夹路径告诉 Claude(不需要记命令)

  1. 打开终端,输入 claude 回车启动
  2. 在对话框里直接输入文件夹的完整路径,比如:
    1
    > 请在这个文件夹里工作:C:\Users\小明\文档\工作总结
    或者 Mac:
    1
    > 请在这个文件夹里工作:/Users/小明/文档/工作总结
  3. Claude Code 会自动跳转到那个路径

💡 怎么看文件夹的完整路径?–如果你忘记了,可以回到上篇–0.几个概念–怎么打开终端–方法二那里查看图文解释,这里我也放了简单的解释。

  • Windows:打开文件夹,点击地址栏(显示 此电脑 > 文档 > ... 的地方),你会看到类似 C:\Users\小明\文档 的文字,这就是绝对路径
  • Mac:在文件夹上右键 → 按住 Option 键 → 选择「将…拷贝为路径名称」,粘贴出来就是类似 /Users/小明/文档/工作总结
  • 简单理解:绝对路径就是**从电脑最顶层一路往下找到这个文件夹的”地图”**,以盘符(Windows)或 /(Mac)开头,中间用 \ 或 / 分隔

方法三:用命令行跳转
如果你已经学会了终端基本操作,也可以手动输入 cd 命令:

1
2
cd 你放文件的文件夹路径
claude

举个例子,不管用哪种方式,进入文件夹后你都可以直接跟 Claude Code 说:

1
2
3
> 帮我读一下这份合同.pdf,找出所有关于违约责任的条款,用大白话总结
> 把这个 CSV 表格里的数据按销售额从高到低排序,加一列排名
> 帮我写一份社团招新策划书,风格活泼,面向大一新生

下面的功能都是我经常使用的


功能一:长期记忆——它记得你是谁

每个用过 豆包、DeepSeek 的人都有这个痛点:每次新建对话,都要重新介绍一遍自己的背景。

我之前也很烦这个,但之前我问过网页版的 DeepSeek,它对此也没有好办法。但 Claude Code 有一个长期记忆系统(Memory),你只需一次告诉它你的信息:

1
2
> 我是大二计算机学生,C语言扎实,正在学数据结构和STM32。
请记住这些信息,以后每次对话自动加载。

Claude Code 会把信息存成结构化的记忆文件。下次新对话自动加载,不需要重复介绍。

这里我想再补充一下,这套记忆机制其实分为三个层次,各管一件事:

1. 全局记忆(Global Memory)

存放在全局路径下的某个固定位置,不依赖任何特定项目。它记录的是关于你这个人本身的信息——专业背景、技术栈、学习计划、开发环境偏好等。无论你在哪个项目下开新对话,这些信息都会被自动载入,再也不用重新介绍自己。

2. 项目说明(Project CLAUDE.md)

项目根目录下的 CLAUDE.md,Claude Code 每次在这个目录启动时自动读取。它记录的是这个项目是什么——技术栈、代码规范、常用命令、目录结构,相当于给项目写的一份说明书。

3. 项目经验(Project Memory)

存放在 .claude/projects/<项目路径>/memory/ 里,用一份 MEMORY.md 做索引。它记录的是这个项目干到哪了——踩过的坑、工作小结、下一步计划。新开对话时说一句「载入记忆」,它就会按索引把相关经验读回来。

三者如何配合? 打个比方:全局记忆像”你是谁、做什么工作”,项目 CLAUDE.md 像”这个办公桌上的文件怎么归档”,项目经验像”这份工作干到第几步了”——不同的信息放在不同的地方,各司其职。换了项目,后两层自动切换,但你的个人背景始终在线。

一句话概括:全局记忆回答”我是谁”,CLAUDE.md 回答”这个项目是什么”,memory 回答”这个项目干到哪了”。

后来我根据自己的使用场景,把三者打通了,形成了自己的配置方案:

全局记忆——我专门整理了一份 Markdown 档案,放在 C:\Users\<用户名>\个人信息档案.md,里面有:

  • 基本情况(学校、专业、年级、职业方向)
  • 技术栈(已掌握的、正在学的、计划学的)
  • 学习计划(暑假学习安排)
  • 项目路径(代码在哪、博客在哪)
  • 性格和学习偏好(代码风格、输出风格)
  • Claude Code 使用约定

项目说明——每个项目根目录放一份 CLAUDE.md,写技术栈、目录结构、构建命令、代码规范这些稳定的事实,启动时自动加载。

项目经验——放在 .claude/projects/ 下,用 MEMORY.md 做索引,记录踩过的坑、工作小结和下一步计划,同时指向全局记忆的位置。这样 Claude Code 既知道项目怎么运行、我干到哪一步,也知道我的个人背景。

之后在任何新项目目录下说一句 **”载入记忆”**,所有上下文就恢复了。

💡 节省了什么:以前每次新对话要花 5 分钟自我介绍,现在一句话搞定。一年下来至少省了几十个小时的重复劳动。


功能二:读代码讲原理——比教材更懂你

我复习数据结构时遇到了一个典型困惑:

教材上讲顺序表和链表,全是伪代码和抽象描述。跟我实际写的 C 代码对不上——我写了 SeqList 结构体,有 data、length、capacity 三个字段;又写了 LinkListHeader 结构体,里面嵌了一个哨兵头节点。这两者到底差在哪?什么时候用哪个?

我把问题丢给 Claude Code:

1
2
> 帮我读一下 01_SeqTable 和 02_LinkList 目录里的代码,
对比顺序表和链表的核心区别。基于我实际写的代码来讲。

Claude Code 做了三件事:

  1. 扫描了两个目录的 .h 和 .c 文件,提取了结构体和函数签名
  2. 画出了对比表格:
顺序表 单链表
存储方式 连续数组 data 链式节点 next 指针
头节点 无 有哨兵头节点
随机访问 О(1) О(n)
插入删除 О(n) 要移动元素 О(1) 改指针即可
  1. 逐行解释了关键代码,包括为什么 LinkListHeader 里要放一个 header 哨兵节点(为了让头插和中间插入逻辑统一)

💡 为什么教材做不到:教材用伪代码,我写的是 C 语言。Claude Code 讲解的对象是我自己写的代码——一样的变量名、一样的函数签名。理解起来自然快了几倍。


功能三:定制学习路线——它能辅助你做决策

我在犹豫暑假要不要学 STM32 嵌入式。之前参加学校智能车社团的培训时学过一阵子,但中途因为很多压力退出了。现在有两份很好的资源摆在面前:

  • B 站博主 keysking 的 STM32 教程(有配套文档站 docs.baud-dance.com,自带例程和 FAQ)
  • 资深学长 Lain 写的《机器人工程师学习计划》(5万字,覆盖 8 个方向 + 考研/就业分析)

两份资料都很长,自己啃完要花几天。我把两份资料的链接喂给 Claude Code 去读,然后开始和它探讨我的学习路线。

Claude Code 给出了详细分析:

  • keysking 的教程配合了 CubeMX + HAL 库的开发方式(比我以前死磕 Keil5 寄存器高效得多),例程覆盖了 GPIO → UART → PWM → ADC → I2C → SPI → FreeRTOS → 智能农场完整项目
  • Lain 的文档明确指出:嵌入式开发是本科生最容易切入的机器人方向,2026 年头部企业给本科嵌入式应届生的薪资已接近部分算法岗
  • 结论:暑假完全可以学完 STM32 核心外设,每个外设跑通后写一篇博客作为产出

💡 关键价值:不是替你决策,而是帮你消化大量信息再呈现给你判断。这就像有个超级助理帮你把两份几万字的资料读完、划好重点、标出跟你相关的内容。


功能四:帮你写博客——让学习有产出、有正反馈

自学者最缺的是正反馈。学了半天,遇到一大堆问题,不知道自己到底掌握了没有,很容易泄气。

Claude Code 能把学到的知识直接转化成博客文章:

1
2
> 我刚复习完顺序表,请根据我的代码,帮我写一篇 Hexo 博客。
风格:图文并茂 + 代码逐行解释,读者是数据结构初学者。

它会:

  1. 读你的 SeqTable.h 和 SeqTable.c,提取核心逻辑
  2. 用大白话解释每个函数做了什么、为什么这么设计
  3. 画示意图、列复杂度表格
  4. 生成带 frontmatter(标题、日期、标签、分类)的 .md 文件,直接放到你博客的 source/_posts/ 目录

我每学完一个新知识就发一篇。一个月下来博客已经有了好几篇有深度的文章。不仅学习更有成就感,博客本身也是未来求职作品集的一部分。

💡 正反馈循环:学一个模块 → 写一篇博客 → 看到网站内容越来越丰富 → 更有动力学下一个模块。Claude Code 帮我把「写博客」这个环节的效率提升了数十倍,我不需要从头到尾一个字一个字地翘,只需要关注文章整体框架、一些可以润色的细节。可以说,在没有使用claude code之前,我绝对没有这个时间和能力去持续产出这么详细的博客文章。


功能五:Debug 排查——有人陪你一起看 bug

学编程最大的痛苦不是写不出代码,而是代码报错了看不懂。尤其是在配环境、编译、链接这些环节。

我的 VS Code 配 C 语言多文件编译时,遇到了经典的 undefined reference to 'xxx' 错误:

1
2
> 我的 main.c include 了 SeqTable.h,但 F5 调试时一直报 undefined reference。
帮我看一下 tasks.json 和 launch.json 哪里有问题。

Claude Code 读了 .vscode/tasks.json,立刻定位到问题:"${file}" 只编译当前打开的单个文件,改成 "${fileDirname}\\*.c" 就好了。还给出了修改前后的对比表格和验证方法。

这个排查过程如果用搜索引擎,要学会描述问题、筛选结果、判断哪个答案适合自己的环境。我以前就经常卡在这一步。现在 Claude Code 直接读我的配置文件,一步到位。


总结

我不太愿意用”工具”来描述claude code,它太智能了。

就像我喜欢看的钢铁侠,唯一一个凭借自己的知识成为英雄的人,有一个ai助手–贾维斯,随时随地帮他分析、计算、兜底。

当然,我不是钢铁侠,Claude Code 也不是贾维斯。

但只要你用过它,你就会懂这种感觉——
在终端里敲几行字,按下回车,
整个屏幕开始滚动,代码一行一行地刷新。

它时不时停下来问你:
“我要读这个文件,可以吗?”
“这里有个 bug,我帮你修了,你看看对不对?”
“这篇博客写好了,你要不要调整一下语气?”

就像一个很靠谱的搭档,坐在你旁边跟你一起干活。
盯着屏幕,那种”旁边有个人”的踏实感,
确实跟以前一个人闷头学的时候,完全不一样了。

如果你也在学什么东西,希望它也能给你这种感觉。😊


📌 Claude Code 官方文档:https://docs.anthropic.com/en/docs/claude-code

💰 DeepSeek API 注册:https://platform.deepseek.com/

🛠 本文示例使用 DeepSeek API 接入。settings.json 模板同样适用于其他兼容 Anthropic 协议的 API 提供商。