Claude Code 使用指南

最近 AI 编程工具界最火的莫过于 Anthropic 官方推出的 Claude Code。但国内因为网络和高昂的 API 费用，很多开发者望而却步。

今天这篇文章，我将带你用一杯奶茶钱（7.9 元）搞定原本遥不可及的顶级 AI 编程体验，并扒一扒 Claude Code 内部隐藏的子代理机制——很多人因为不懂这个机制，白白浪费了大量 Token 和上下文！

一、什么是 Claude Code？

与网页版的聊天对话框不同，Claude Code 是一个运行在终端（CLI）的具备工程上下文、权限控制和执行能力的开发协作系统。

它的核心特点是：

直接在终端可用：无需来回切换窗口。
能动手的工程师：可以自主读取代码、编写文件、执行 Git 提交，甚至运行测试命令。
按量计费（API 模式）：本地不吃算力，全部通过 API 调用云端模型。

简单来说，它不是一个“聊天机器人”，而是一个直接坐在你终端里的“高级外包程序员”。

官方文档参考：Claude Code Overview

二、算力平台选择：先搞定 API 密钥

官方的 Claude 4.7 接口价格非常昂贵（百万 Token 动辄几十美元），且国内无法直连。我们的核心原则是：API 提供商本质只是一个算力中转，既然功能一样，哪家便宜稳定就买哪家！

在下载任何工具之前，我们需要先去云厂商那里注册并获取 API Key。

首选方案：阿里云（限时优惠）

阿里云百炼平台最近推出了专为 AI 编程打造的订阅套餐，目前活动价只要 7.9 元/月！（日常价 40 元/月），国内网络直连，速度快且稳定。

支持调用顶尖模型来驱动你的 Claude Code，网络国内直连，速度快且稳定。

购买套餐：前往阿里云 AI 编程套餐活动页完成购买。

找到下面的购买入口进行购买
获取密钥：购买后进入百炼 API Key 控制台

在左侧找到订阅套餐的选项，将API Key **复制保存好**。
记录接口地址：根据官方文档，阿里的专属后端调用地址为 https://coding.dashscope.aliyuncs.com/apps/anthropic。

备选方案：

如果阿里云活动结束或你想多一个备选，可以考虑其他家的套餐，同样是国内直连的稳定服务。

火山引擎（字节）：日常价 40 元/月开通通道
百度千帆：日常价 40 元/月开通通道
智谱 AI：日常价 49 元/月专属 9 折优惠开通通道
Kimi：日常价 99 元/月开通通道
MINIMAX：日常价 30 元/月开通通道

三、安装 Claude Code

虽然各家云厂商都提供了复杂的官方配置文档，但作为开发者，我们有更优雅的通用解法：使用开源工具 cc-switch。

无论你买的是阿里云、智谱还是其他家，配置流程只有简单的三步：复制、粘贴、启用。

1. 安装环境和程序本体

1.1 安装运行环境(Node.js):

因为 Claude Code 是由 JavaScript 编写的程序，所以需要先安装 Node.js。

Node.js 是一个开源、跨平台的 JavaScript 运行环境，它让电脑能够运行像 Claude Code 这样的命令行工具。

下载地址：https://nodejs.org/zh-cn/download

下载 Node.js的**Windows 安装程序 (.msi)**。下载后就像安装微信一样，双击运行并一路点击 ‘Next’（下一步）直到 ‘Finish’（完成）即可。

Node.js下载指示

1.2 安装运行依赖（Git）

Claude Code 的底层运行依赖 Bash 环境，这是 Windows不支持的。

因此必须安装 Git，利用其附带的 Git Bash 工具来模拟类 Linux 环境，Claude Code 才能正常工作。

下载地址：https://git-scm.com/install/windows

下载Git for Windows/x64 Setup。下载后就像安装微信一样，双击运行，保持默认安装选项一路点击 ‘Next’（下一步）直到 ‘Finish’（完成）即可。

Git for Windows下载页面

1.3 安装 Claude Code

安装好前面的两个环境后，按下键盘上的win+r，在里面输入cmd，点击确定以打开cmd命令行窗口

在你的cmd终端执行以下命令即可实现安装：

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

通过npm安装Claude Code

2. 下载并安装 cc-switch

这是一个专为 Claude Code 等工具设计的可视化配置切换器。

前往 cc-switch GitHub Releases 下载对应操作系统的安装包。

往下翻，找到CC-Switch-v3.11.0-Windows.msi，下载安装，安装时一路下一步即可

cc-switch GitHub Releases下载页面

3. 配置 API

复制你的KEY

如果之前没有保存key，在这里进入百炼 API Key 控制台

在左侧找到订阅套餐的选项，将 API Key **复制保存好**。
打开 cc-switch 桌面端，点击右上角的加号 -> 选择”自定义”（或对应的厂商预设）。

我们这里是阿里的API,就选择阿里的配置
往下翻，将 API Key 和后端地址粘贴进去

根据官网描述，后端地址已经发生了改变，所以也需要修改预设的请求地址：
1
https://coding.dashscope.aliyuncs.com/apps/anthropic
点击”保存”（或添加）

4.开始使用

大功告成！

现在你在之前的终端里输入 claude，就可以直接起飞了。

可以在对话框里随便输入一些文字来测试是否配置成功

Claude Code启动成功界面

四、用“文件整理”搞懂三大子代理模式

这是新手最容易踩坑的地方！

很多新手打开 Claude Code 后，无论干什么都在主对话里直接输入。这会导致一个致命问题：主对话的上下文越来越长，反应越来越慢，Token 消耗极快！

其实，Claude Code 内部有一套极其精密的交互模式和子代理（Subagent）机制。你可以把“子代理”理解为运行在独立上下文窗口中的专用 AI 工具人。把特定任务交给它们，就不会污染你的主对话上下文。

一般情况下，它在终端会自动切换，如果你用 VS Code 插件，也可以手动切换：

Claude Code交互模式切换界面

为了让你秒懂这三大模式的作用（Ask、Plan、Edit），我们直接结合一个非程序员也极其需要的日常痛点来实战：让 Claude Code 帮我们整理一个乱七八糟的文件夹。

⚠️ 注意：让 AI 整理文件前，请确保不要在包含超多文件或核心系统盘的目录执行，避免误删重要数据。

0. 先进入需要整理的文件夹

在文件管理器里找到你需要整理文件的位置，例如我这里要整理我的博客，就打开博客文件夹

点击我箭头指向的这个位置

317d8969d47c300256a56a44fa0e9489

往里面输出cmd，然后回车确认

在新开的终端窗口中，输入claude即可启动ClaudeCode

1. Ask 模式，先看不动手

打开此工具默认以Ask（询问）模式启动

此模式做只读分析。它会调用速度快、成本低的模型，分出多个人来同时读取文件

只拥有读取权限，绝对不改文件。

面对一堆不知道装了什么的乱七八糟的文件，我们先用探索模式去摸底。

触发关键词：“探索”、“帮我看看”、“分析一下”
实战：
在终端中输入：
1
帮我探索一下当前文件夹，告诉我里面都有哪些类型的文件？
此时它会派出几个小兵快速翻阅目录，并向你汇报他的分析结果：

2. Plan 模式，规划后再行动

Plan（计划）模式依然不改文件，只负责在独立上下文中收集信息，并给你一份详细的实施步骤。

摸清文件夹底细后，我们需要制定分类规则，防止 AI 瞎整理。

触发关键词：“帮我做个规划”、“出个整理方案”

实战：
继续在终端输入：

1	进入计划模式。基于刚才看到的文件，帮我制定一个文件夹分类整理方案，按文件类型和日期列出具体的新建文件夹名称，并给出你的移动规则。

此时，AI 会给你输出一份 Markdown 列表。

你可以看看ai给出的整理方案合不合理，你可以反复和ai沟通来确认实施方案，只有你自己和ai磨合好了之后，AI才能做出对你有帮助的动作

界面会给你这四个选项，你可以根据你的需要来选择他执行此计划还是重新计划：

翻译后的内容：

c827c75549d13db5059419e180a7a28e

例如我这里说：

我觉得不太合理 
			1.你不能动我的git，应该由我自己判断是否提交记录
      2.我这里image文件夹下压根就没有多少图片，不需要整理
      3.你只能修改_posts文件夹，按照你说的用年份分类，还有各种脚本放到同一个文件夹内

输入后，ai就会按照你的指导重新给出方案，直到你满意为止

看，ai重新给了我一个方案，这次就比较合理，我们选择第一个选项，让他开始进入编辑模式干活

3. Edit 模式，开始干活

这是 ClaudeCode 真正动手的全能模式。会定位文件、执行命令（如新建文件夹、移动文件）、生成差异，并直接自动编写文件。

最好是在方案确认无误后，下达最终执行指令来使用此模式。

触发关键词：“修改”、“执行”

刚刚确认方案，它就会自动调用系统命令，新建文件夹并唰唰唰地把文件全部归类整齐！

五、对非编程人员推荐的基础用法

很多人认为 Claude Code 只能写代码，这其实极大地低估了它的潜力。由于它具备 文件读写权限、终端执行能力以及多模态视觉，它本质上是一个接管了你操作系统的 AI Agent。

查找和生成本地文档

首先是 Claude Code 本身支持搜索，你可以让他搜索指定内容给你写成 MarkDown 文档，也可以对你本身的 MarkDown 文档进行编辑。

注意因为我们用的是阿里的ClaudeCode套餐，无法调用Claude官方搜索工具，所以我们需要配置阿里的搜索MCP

根据阿里云官方文档的教程，我们需要进入阿里的MCP广场，找到联网搜索MCP服务并开通

我下面画框的这两个开通

除开推荐的MCP服务外，也可以自行安装其他服务来尝试其他功能，例如接入支付MCP让AI在淘宝帮你下单，接入高德地图MCP让AI帮你规划行程

阿里云MCP广场界面

然后，此服务需要单独创建APIKEY
进入此网址：https://bailian.console.aliyun.com/cn-beijing/?spm=a2c4g.11186623.0.0.5de85ec6kTTcXJ&tab=model#/api-key

点击创建APIKEY

创建MCP服务APIKEY界面

创建成功后，将下列命令中的 YOUR_API_KEY 替换为开通联网搜索MCP时使用的阿里云百炼 API Key，并放在终端里执行：

1	claude mcp add WebSearch https://dashscope.aliyuncs.com/api/v1/mcps/WebSearch/mcp -t http -H "Authorization: Bearer YOUR_API_KEY"

终端返回 Added HTTP MCP server xx 即表示添加成功。

可以再添加下面这个MCP服务方便claudecode解析网页：

1	claude mcp add WebParser https://dashscope.aliyuncs.com/api/v1/mcps/WebParser/sse -t sse -H "Authorization: Bearer YOUR_API_KEY"

接着，执行以下命令进入 Claude Code。

claude

在对话框执行/mcp命令，确认websearch的状态为 connected。首次添加可能需要等待状态从 connecting 变成 connected。

Claude Code MCP服务状态界面

按 Esc 退出 MCP 列表后，发送提问用websearch MCP搜索鸿蒙最新的新闻即可看到搜索结果。

为了避免和其他工具混淆，建议提问时明确提及 websearch MCP。

使用websearch MCP搜索结果示例

返回搜索结果即大功告成，接下来就可以让他搜索归藏的信息并且整理一个介绍文档。

请使用搜索功能，查找关于‘Openharmony 3863’的资料，阅读我本地 D:\OpenHarmony 目录下的相关文档，然后为我生成一份 Markdown 格式的综合报告，并存为 星闪概念介绍及3863开发板星闪使用方法.md。

Claude Code生成技术文档示例

你也可以让他分析你保存在本地的文章之后进行改写，生成新的文章。

比如我这里就让他把星闪的软件相关文章改写成适合发布的博客文章，同时生成对应的微信发布版本，也可以对于会议总结之类的文档进行分析和处理。

读取我刚才录音转写的会议纪要 meeting_notes.txt，总结出关键决策点，并识别出分配给我的所有待办事项，将它们以任务列表的形式添加到我的 todo.md 文件中。

根据你刚刚生成的 hi3863芯片星闪使用方法，将其改写成一篇约 800字的博客文章，风格要轻松有趣。然后，为这篇文章生成 3 个适合在 小红书 上发布的内容版本，并附上 #AI #Tech 标签

图片分析和处理

由于我们给 Claude Code 接入的是多模态的大模型，所以你的图片也可以让他帮忙处理。

比如我打开了一个全是图片的文件夹，里面的图片名字乱七八糟的，这时候就可以让他分析图片内容之后根据图片内容给图片重新命名。

1	分析我当前文件夹下的所有图片内容，基于图片内容批量对图片进行重新命名。

这个东西的应用场景很多，例如财务人员可以用ClaudeCode整理发票

Claude Code批量重命名图片功能演示

辅助做数据标注

在重新命名之后我们也不能浪费他分析的图片内容。

我们都知道在训练图像模型或者 Lora 的时候需要对图像进行标注，大部分训练工具都是把标注放在一个跟图片命名一样的文本文件里，现在我们就可以让 Claude Code来做这件事了。

可以看到他执行的非常完美，以往这些你还得找对应的工具，而且不好自定义要求，现在直接提问就行。

1	分析图像内容，生成对图像的详细描述，除了内容还有风格，然后将这些描述放在跟图像名称一样的文本文件中。

我们最近在做一些AI训练，可以用这个方法让ai做数据标注，方便我们训练一些针对性的小模型用于嵌入式设备

Claude Code图像内容分析和标注功能

修改系统设置

Claude Code除了可以读取文件和修改文件外，也是可以控制系统设置的。

比如我们就可以写好自己日常对于软件和系统设置在不同工作时间的喜好，需要的时候一键完成所有操作的更改。

这里我就让他给我关掉浏览器，然后打开 VScode，开启 Windows 的专注助手（勿扰模式），直接进入工作模式。

更进一步让他把操作写成 PowerShell 脚本，之后你就可以直接右键运行脚本完成系统设置了。

Claude，帮我创建一个名为 deep_work.ps1 的 PowerShell 脚本。这个脚本需要：
1. 启动 VScode。
2. 强制关闭 Edge/Chrome 浏览器和微信等通讯软件。
3. 开启 Windows 的‘专注助手（勿扰模式）’。
4. 播放我本地 D:\music\ 文件夹里的音乐。

Claude Code 的高级使用方法

上面都是些基本用法，你最近可能也看到了一些。

但是我发现结合一些本地软件，Claude Code能实现对各种文件更加高级的处理，比如视频转 gif、youtube 视频下载、加水印、文档格式转换等。

这些就非常牛皮了，而且我们日常内容创作大部分都非常需要。

为本地文档生成PPT

前面我们有了文档了，但是很多时候演示的时候总不能真给人看 Markdown 文档吧，能不能生成 PPT 呢？

可以的，朋友，必须可以，比如我这里就把前面我那个 MCP 索引文档的内容直接转换为 PPT 了。

这个依赖一个叫 Slidev 的项目，它可以用类似 Markdown 文档的格式将内容变成带有丰富样式的 PPT。

你不需要知道这个项目的细节，直接用我下面的提示词生成文件之后，复制文件到这个页面（https://stackblitz.com/github/slidevjs/new?file=slides.md）预览就行。

帮我基于刚才总结的那个 hi3863芯片星闪使用方法 文章用 Slidev 这个专门用来用 Markdown 格式生成幻灯片的工具语法写一个对应的 PPT，用 Slidev 的语法美化一下

上面的 Slidev 不需要本地安装直接预览就行，接下来我们介绍一些需要本地安装的项目。这些本地的软件非常强大，但是由于本身他们是没有界面的（纯命令行），阻碍了大量 Windows 用户使用。

但是有了 Claude Code 之后一切都解决了，提示词可以直接转换为驱动他们的命令行，也可以用提示词直接安装他们，你直接用就行。

生成效果还不错对吧，关键是这样生成支持二次编辑

PPT生成效果

用 ffmpeg 帮助处理视频

首先先介绍一下 ffmpeg 这个项目，基于它你可以实现非常强的视频编辑能力，理论上剪映之类的视频编辑软件底层都是基于类似技术完成的。

你可以对本地的视频进行拼接、剪辑、增加文字、转换格式、转换分辨率、增加音乐，基本上你能想到的视频编辑能力他都能做到。

首先我们需要打开你需要处理视频的的文件夹，然后启动 Claude Code。

我们直接让ClaudeCode来帮我们安装和配置软件

1	帮我在电脑上安装 ffmpeg，并确认已配置好环境变量

看到没，跟其它教程里那些乱七八糟的下载和配置路径要求都没关系，你只需要说两句话，就全部安装了。

然后我们就可以爽用了，先给我们指定的视频加个水印试试。

可以看到新的视频右上角果然有了一个水印，这种言出法随的感觉谁不喜欢，你不需要了解原理，你就只需要知道所有的视频编辑他都能帮你搞定。

1	帮我将此目录下视频用 ffmpeg 打上一个 10% 透明度的水印在右上角，水印内容为此目录下的png图片，然后存储为新视频。

用ffmpeg添加视频水印效果

然后我想要给视频配乐也可以，你只需要告诉他视频文件和音乐文件的名字就行，我甚至让他给音乐加上了淡入和淡出。

他先是获取了一下视频的时长，然后就开始操作了，然后搞定了，非常完美，严丝合缝，淡入淡出也加上了，可以看剪映界面预览的频谱。

1	帮我将 XXX 这个视频用 ffmpeg 将它和 XXX 音频合并为一个新的视频，音频的长度需要跟视频一样长并且加上淡入淡出。

我们很多时候需要把视频转换为序列帧，然后拿其中一帧进行处理，或者处理所有的帧，以前你是不是还得到处找这种工具，而且转换效果不一定好。

Claude Code一句话就能搞定，处理的又快又好，而且节省了用网页工具上传下载的时间。

1	帮我将 XXXX 这个视频用 ffmpeg 转换为 png 序列帧放在一个新的文件夹里面。

用ffmpeg转换视频为序列帧

另一个常见的任务就是视频转 gif，尤其公众号有视频大小限制，很多时候迫不得已得转成 gif 发布。

Claude Code 捕捉到了高品质这个关键词还制作了调色板保证颜色还原度，最后处理的非常完美。

1	帮我将当前文件夹中的第一个视频用 ffmpeg 转换为一个高品质 gif

用ffmpeg转换视频为高品质GIF

利用 yt-dlp 下载视频

像 ffmpeg 这种宝藏项目还有很多，比如 yt-dlp 这个项目跟 ffmpeg 配合几乎可以下载你能想到的所有视频平台的视频。

我们还是可以让 Claude Code帮我们安装 yt-dlp。

1	帮我在电脑上安装 yt-dlp 并配置环境变量

然后直接提供视频链接他就会帮你下载，甚至可以批量下载多个视频或者一起连封面和视频一起下载，再也不需要忍受那些满是广告的下载工具了。

1	帮我用 yt-dlp 和 ffmpeg 下载这个平台的视频和它的封面：XXX 链接

用yt-dlp下载视频和封面

利用 ImageMagick 处理图片

处理视频我们有 ffmpeg 这种项目，当然图片也有。

ImageMagick 是一个极其强大的工具集，你可以用它来转换格式、缩放、裁剪、旋转、添加滤镜、组合图片等等。

依然是老一套，先让 Claude Code 帮我们安装：

1	帮我在我电脑上安装 ImageMagick，并确保配置好环境变量，命令行可用

用winget安装ImageMagick

先来一个常见任务，我们设计师做外包经常用，在没结款之前给甲方低分辨率和带水印的图片，现在就可以直接批量完成。

这里我让他把所有图片宽边调整为 800 PX，然后统一加上带“内部资料”文字的水印。

帮我用ImageMagick把文件夹下的所有图片的宽边尺寸统一调整为宽度 800 像素，并给它们加上一个10%透明度的灰色水印，水印文字是‘内部资料’，放在新的文件夹里面

由于 Windows 字体编码原因，中文的水印有时会显示方块，可以让他改成英文（或者让 Claude 自己去调取系统里的中文字体如微软雅黑），而且出错之后他自己开始用多模态能力检查修改后的图像了，发现 10% 不透明度的文字不明显，又自己重新改了一下，太聪明了。

用ImageMagick批量处理图片

然后再来一个常见的图像拼接需求，这种在媒体上发消息的时候经常需要，尤其是发推文或者小红书。

1	将加过水印的图片用ImageMagick拼合成一张四宫格图片，中间有白色分隔

搞得不错，这几张图比例不同，所以没有对齐，可以在命令上加上统一比例这种要求就行。

用ImageMagick拼接图片为四宫格

利用 Pandoc 进行文档转换

文档格式转换也是常见的需求，相当多的公司工作文档还是 Word (.docx)，很多时候我发过去 .md 文件那边都不知道怎么办。

首先还是让 Claude Code 帮我们在 Windows 上安装。

1	帮我在我电脑上安装 Pandoc

这个时候我们就可以利用 Pandoc 这个项目进行各种文档格式之间的互相转换，当然批量转换也是可以的。

1	将 hi3863芯片星闪使用方法这个 Markdown 文档用Pandoc转换为 word (.docx) 文档

可以看到转的很好，Markdown 几乎所有格式也都迁移了，不管是加粗还是无序列表有序列表。

用Pandoc转换文档格式

六、我的日常开发方法论与 AI 避坑指南

我用过几款主流的 AI 编程工具（如 Cursor、Trae 等），但在日常的嵌入式和底层开发中，我主要使用的还是 Claude Code。整体感觉是：它现在已经是一个可以深度协作的工程助手。

结合 Claude Code 的特性，我总结了一套自己的方法论与避坑原则：

6.1 深度协作方法论（结合子代理）

拒绝上来就写：接手复杂模块时，先用 Explore 探索代码库，生成核心架构文档；再用 Plan 制定实现流程。只有当你和ai理解一致后，产出才会高质量。
控制上下文污染：每个独立的开发任务务必开启新对话（/reset），并提供清晰的需求背景和硬件约束。
勤删废弃代码：旧代码和冗余注释会严重误导 AI，增加上下文噪音，长期不清理会直接影响协作效率。
坚守人工底线：
- AI 生成的代码之后必须人工 Review。
- 关键的底层逻辑（如中断处理、时序控制）必要时自己重写。
- 核心路径必须做真机压测和边界测试。

6.2 警惕过度依赖带来的三大风险

技术能力退化：习惯让 AI 看 Log，自身对硬件底层原理、指针异常的理解变浅，甚至失去对“优雅代码”的判断力。
架构失控：AI 往往急于实现功能，容易导致硬件驱动与业务逻辑严重耦合，引入技术债务。
一致性被破坏：不同对话生成的代码风格、命名规范可能完全割裂。

6.3 未来 3 年工程师的核心竞争力

AI 时代，竞争的关键不再是“产出速度”。结合系统开发领域，我认为未来工程师的核心竞争力将转向以下维度：

系统架构与设计能力：单模块交给 AI，但系统级设计（HAL 与业务层解耦、RTOS 权衡、内存防碎片化）仍需人类主导。
复杂业务与状态建模能力：将规则转化为可执行的设计。例如复杂的状态机设计，以及软硬件交互边界划分。
性能与稳定性治理能力：嵌入式设备资源极其受限，精细化内存管理、中断延迟优化、Watchdog 策略，必须通过真机抓包、示波器验证，AI 暂时还没有具生智能的能力，无法替代工程师。
驾驭 AI 的协作能力：精通 Prompt 工程，懂得拆解问题，敏锐判断 AI 产出代码的潜在漏洞。

七、实战演练：让 Claude Code 融入工程化

理论与方法论讲完了，接下来我们进入真刀真枪的代码实战阶段。

1.对鸿蒙北向开发赋能

对于前后端项目（北向项目）开发，我建议可以开两到三个ClaudeCode窗口，一个开发前端，一个开发后端，让后让后端输出api文档给前端，让前端做api适配。具体的前后端AI使用教程可以查看鱼皮的AI知识库，他的VibeCoding教程相对来说比较完整，且文档在Github上开源（开源地址）。

2.对鸿蒙南向开发赋能

很多开发者觉得 AI 写前端还行，遇到嵌入式（C/C++、硬件时序、RTOS）就歇菜了。核心原因在于：嵌入式开发需要极强的架构思维，并且硬件环境 AI 是“看”不到的。

在我的日常开发中，面对复杂的嵌入式需求，我总结了一套“Ask 摸底 -> Plan 架构 -> 软硬分离执行”的闭环开发范式。

我们以一个典型且前沿的实战需求为例：为 Hi3863 平台（LiteOS 环境）编写 W25Q128FV 外部 Flash 驱动。看看顶级开发者是如何驱使 Claude Code 把复杂的芯片底层变得井井有条的。

阶段一：用 Ask 模式“摸清底细”（Explore）

在引入新驱动前，面对 Hi3863 庞大的 SDK 目录，我绝不会直接让 AI 写代码，而是先派 Explore 子代理去摸清当前工程的底牌。

在终端中启动 Claude Code，明确要求它只探索，不修改：

提示词：进入探索模式（Ask）。请帮我阅读当前项目下 Hi3863 的工程目录，重点分析现有的 SPI/QSPI 外设底层的 HAL 层接口是如何封装的，以及当前 LiteOS 的临界区保护、互斥锁和中断管理的接口规范是什么，看完后给我一个简单的总结。

这一步是为了让 AI 建立起本地工程上下文，确保它后面生成的代码风格能完美融入 Hi3863 的原生框架，而不是瞎编一套不通用的底层 API。

阶段二：用 Plan 模式“运筹帷幄”（架构设计）

探索完毕后，进入最核心的规划环节。在这个环节，我们要把 AI 当作资深架构师，和它反复磨合，直到 Plan 子代理输出的设计文档与你的构想完全一致。

我会下达一段非常详细的架构设计需求。你可以参考我日常使用的这段高阶 Prompt：

进入规划模式（Plan）。我想为 Hi3863 平台编写一个 W25Q128FV 的驱动程序。请帮我输出一份详细的架构设计和分步实施计划，不要直接写代码。

【架构设计要点】：
1. 抽象分层：需要设计一个 Flash 抽象层，在 Per 接口层对接 W25Q128 的驱动。
2. 多设备管理：考虑到系统未来可能挂载多个外部 Flash 芯片，需要使用 Builder（生成器）模式实现多个设备的统一管理，通过 Handler 层进行统一调度。
3. 接口适配（配置模式）：不同 Flash 芯片可能使用不同通信接口（SPI/QSPI），采用配置模式对不同接口进行选配，实现灵活性。
4. 依赖注入与可移植：驱动需具备良好的跨芯片移植能力（哪怕以后换成其他星闪芯片）。必须通过依赖注入方式，注入 Handler 所需的依赖（如 Hi3863 的 SPI 通信接口函数指针、中断处理、OS 临界区保护等）。
5. 工厂模式封装：为了简化应用层的调用，采用工厂模式实现 Flash 对象的自动构建，向用户屏蔽 W25Q 系列的详细构建过程。
6. 存储管理切换（策略模式）：Flash 管理策略未来会变化（如接入 LittleFS 文件系统或特定 Flash 均衡算法），采用策略模式设计内存管理层的动态切换机制。
7. 测试闭环：需要在 Hi3863 平台上设计单元测试和电仿真测试用例，确保 Driver、Handler、依赖注入等模块对上提供的 API 能够快速验证。

请根据以上要求，给我一份模块划分图（用文本表示）和 TODO 列表。

注意！

AI 给出的第一版 Plan 可能在某些细节（比如依赖注入的函数指针定义方式）上不符合你的要求。不要将就！ 继续在 Plan 模式下指出它的问题（例如：_“工厂模式那一块的设计太重了，在 IoT 芯片上浪费内存，改成轻量级的静态预分配”_），直到它的 TODO List 完美契合你的心意。

阶段三：步步为营，软硬分离（Edit 执行）

Plan 敲定后，终于到了让 Edit 子代理（通用模型）写代码的阶段。

在嵌入式开发中，我坚守一个原则：先写硬件逻辑，再写软件逻辑；软件逻辑分控制线和存储线。 千万不要让 AI 一次性把从底层 SPI 到上层文件系统全写完，那样一旦出错，在 Hi3863 这种高频复杂芯片上连去哪抓 Bug 都不知道。

按照之前定好的 TODO 列表，我们一步步下达指令：

先调通硬件层（Driver）：

“现在开始执行计划的第一步，只写最底层的 SPI 读写和时序依赖注入部分。写完后生成一个基础的寄存器读取测试函数（用来读取 W25Q128 的 Device ID）。”
（人工介入：把代码编译烧入 Hi3863 开发板，接上逻辑分析仪或看串口打印，确保读到了正确的 ID 0xEF4018。硬件调通，心里才有底。）
再写核心逻辑（Handler & 控制线）：

“硬件层 ID 验证通过。现在执行第二步，利用工厂模式实现 Flash Handler 的对象构建，把前面的底层接口注入进去，实现基本的擦除、页写、连读功能。”
最后写策略层（存储线）：

“执行第三步，利用策略模式接入之前说的 LittleFS 接口适配，向 OpenHarmony 框架侧提供标准的 VFS 挂载点。保持高内聚低耦合。”

阶段四：测试用例覆盖（闭环验证）

最后，别忘了利用 Claude Code 的代码生成能力，为你构建坚固的测试护城河。

“基于我们刚刚完成的驱动，在 test 目录下生成对应的单元测试。通过 Mock 调用 Hi3863 的底层 SPI 接口，在纯软环境下验证工厂模式构建的对象是否正确，以及多设备管理 Handler 在越界读写时的保护逻辑。”

你看，通过上面这四个阶段，我们并没有亲手敲击几行 C 代码，但整个工程的灵魂（架构模式、软硬分离、依赖注入）依然是我们赋予的。

Claude Code 充当了不知疲倦的高级打字员、UML 转换器和测试工程师。我们把主要精力从“查阅 W25Q128 手册的指令集对应关系”转移到了“把控系统复杂度与接口设计”上。

在这个时代，AI 写出的代码或许能跑，但只有融合了人类工程思维、设计模式和物理世界硬件认知的系统，才是真正健壮的工业级产品。而 Claude Code，正是连接这两种力量的最强桥梁。

八、从哪里获取最新的AI信息

正在爆肝编写中

九、总结

好了教程到这里就结束了。

你可以用 Claude Code控制这些已经非常成熟的命令行项目，基本上你所有的需求都能找到对应的项目。

不是只有 MCP 才能做 Agent，这些传统工具在有了 LLM 加持之后会更加强大。

看到这里，你可能会突然意识到：原来那些让我们望而却步的专业工具，其实一直都在那里等着我们。

史蒂夫·乔布斯说过的一句话：”技术应该是隐形的。” 今天的 Claude Code，正是让那些强大的命令行工具变得”隐形”——你不需要理解它们在 Windows 下复杂的配置原理，不需要去配环境变量，只需要说出你的需求。

更重要的是，这种改变不仅仅是效率的提升，而是创作门槛的彻底消失。

所以，如果你还在犹豫要不要试试 Claude Code，我想说：别让”我不会编程”成为你探索新世界的借口。因为在这个新世界里，你需要的不是编程能力，而是想象力。

那些曾经高高在上的专业工具，现在都在静静等待着你的一句话。而你要做的，就是勇敢地说出你的需求。

因为最好的工具，是让你忘记它是工具的工具。