1. 嵌入式AI编程的上下文管理策略1.1 为什么上下文管理在嵌入式开发中格外重要用过Claude Code做嵌入式开发的朋友应该都有体会它跟纯软件项目最大的区别在于嵌入式项目的代码文件往往分散在多个目录里HAL库、外设驱动、中间件、应用层逻辑各占一块而且很多关键信息藏在头文件的宏定义和寄存器配置里。如果你一股脑把整个工程目录丢给AI它很容易在几百个文件里迷失方向给出的代码要么引脚定义对不上要么时钟配置跟你的实际板子不匹配。我在STM32项目里踩过最典型的一个坑让Claude Code帮我写一个SPI驱动它默认用了SPI1但我板子上SPI1的引脚已经被以太网占用了实际能用的是SPI2。问题出在哪就是上下文里没有把引脚分配表告诉它。后来我养成了一个习惯在项目根目录放一个hardware_config.md把芯片型号、时钟树、引脚分配、外设占用情况全部写清楚每次开新会话先让Claude Code读这个文件。这个做法看起来笨但实测下来能减少80%以上的“答非所问”。上下文管理的核心逻辑其实就一句话给AI的信息要精准不要贪多。Claude Code的上下文窗口虽然大但嵌入式项目里大量代码是重复的HAL库文件这些内容塞进去只会稀释真正重要的信息。我的做法是只把当前任务相关的源文件、对应的头文件、以及硬件配置文件加入上下文其他一概不管。1.2 用CLAUDE.md建立项目级记忆Claude Code有一个非常实用的功能叫CLAUDE.md放在项目根目录下每次启动时会自动读取。这个文件相当于给AI的一份“项目说明书”我一般会写这几块内容芯片与开发板信息具体型号、主频、Flash和RAM大小开发环境用的是STM32CubeIDE还是Keil MDK编译器版本HAL库版本代码规范命名习惯、注释语言、是否允许使用动态内存分配外设分配表每个外设用在什么地方引脚怎么分配的已知限制比如“本项目不使用RTOS”、“中断优先级分组为NVIC_PRIORITYGROUP_4”举个例子我在CLAUDE.md里写了这么一段## 硬件配置 - MCU: STM32F407VGT6, 168MHz, 1MB Flash, 192KB RAM - 系统时钟: HSE 8MHz PLL, 168MHz - 调试接口: SWD (PA13/PA14) - USART1: PA9/PA10, 115200-8-N-1, 用于日志输出 - SPI2: PB13/PB14/PB15, 连接W25Q128 Flash - 不使用动态内存分配所有缓冲区静态分配有了这个文件之后Claude Code生成的代码质量明显提升。它知道该用SPI2而不是SPI1知道日志走USART1知道不能用malloc。这比每次在对话里重复交代要高效得多。注意CLAUDE.md不要写得太长控制在200行以内。太长了会占用宝贵的上下文空间而且AI对超长文件的注意力会下降。把最关键的约束放前面。1.3 会话隔离与任务拆分Claude Code的会话是有状态的同一个会话里前面的对话会影响后面的输出。这在做复杂任务时是好事但在切换任务时就是灾难。比如你先让它优化了一段PID控制代码然后接着让它写一个OTA升级的流程它可能会把PID那套思路带进来生成一些莫名其妙的代码。我的做法是一个任务一个会话。具体来说写外设驱动开一个新会话只加载相关的HAL库文件和硬件配置调试问题开一个新会话把错误现象、相关代码片段、调试输出贴进去代码审查开一个新会话只加载要审查的文件重构开一个新会话明确重构目标和约束这样做的好处是每次对话的上下文都是干净的AI不会被之前的对话带偏。缺点是每次都要重新交代背景但有了CLAUDE.md之后这个问题基本解决了。另外一个小技巧如果一个任务特别复杂可以在同一个会话里分阶段完成但每个阶段结束时用/clear命令清空对话历史只保留CLAUDE.md的上下文。这样既能保持任务的连续性又能避免上下文污染。2. 嵌入式场景下的提示词工程实战2.1 嵌入式提示词与通用提示词的区别网上关于AI编程提示词的教程很多但大部分是针对Web开发或者Python脚本的。嵌入式开发的提示词有它自己的特点核心区别在于硬件约束必须显式表达。举个具体的例子。如果你让Claude Code“写一个LED闪烁的程序”在Python里它可能给你一个while True: GPIO.toggle(); sleep(1)就完事了。但在STM32上这个需求背后隐藏着大量信息用哪个GPIO推挽输出还是开漏输出上拉还是下拉时钟使能了吗用了哪个定时器做延时所以嵌入式提示词的第一原则是把隐含的硬件前提全部写出来。我常用的提示词模板是这样的【硬件环境】 MCU: STM32F103C8T6, 72MHz LED: PC13, 低电平点亮, 推挽输出, 无上拉 延时: 使用SysTick, 1ms中断 【需求】 实现LED以500ms间隔闪烁不使用阻塞延时用状态机实现 【约束】 - 不使用HAL_Delay - 代码放在main.c的while(1)循环中 - 变量命名用snake_case - 注释用中文这个模板看起来啰嗦但实测下来AI一次就能给出可用的代码省去了反复修改的时间。你可以把这个模板存成代码片段每次改改参数就能用。2.2 分步骤引导从框架到细节嵌入式项目往往涉及多个模块的协同一次性让AI生成完整代码很容易出问题。我习惯用分步骤引导的方式先让AI搭框架再逐步填充细节。以STM32的OTA升级功能为例我会这样分步第一步让AI设计整体架构我要在STM32F407上实现OTA升级功能通过USART1接收固件数据 写入外部SPI FlashW25Q128然后跳转到Bootloader进行升级。 请先给出整体架构设计包括 1. 内存分区方案Bootloader区、App区、升级标志区 2. 数据流走向 3. 关键状态机设计 不要写具体代码先讨论方案。这一步的目的是让AI理解你的意图同时你也能检查它的方案是否合理。如果方案有问题这时候纠正成本最低。第二步逐个模块实现方案确认后再让AI逐个实现模块。比如先实现Flash读写驱动再实现USART接收状态机最后实现跳转逻辑。每个模块单独测试通过后再集成。第三步集成与联调所有模块完成后让AI帮你写集成代码和测试用例。这时候可以把之前各个模块的代码一起加载进来让AI检查接口是否匹配、有没有资源冲突。这种分步方式的好处是每一步都可控出了问题容易定位。坏处是耗时更长但对于嵌入式项目来说调试时间远比编码时间长前期多花点时间在方案上绝对是值得的。2.3 用示例驱动输出格式Claude Code有一个很强的能力你给它一个示例它会模仿这个示例的风格和格式。这在嵌入式开发里特别有用因为嵌入式代码往往有固定的模式。比如你要写一组外设初始化函数可以先给它一个你之前写好的例子/** * brief 初始化USART1用于日志输出 * param baudrate: 波特率 * retval None */ void bsp_uart1_init(uint32_t baudrate) { huart1.Instance USART1; huart1.Init.BaudRate baudrate; huart1.Init.WordLength UART_WORDLENGTH_8B; huart1.Init.StopBits UART_STOPBITS_1; huart1.Init.Parity UART_PARITY_NONE; huart1.Init.Mode UART_MODE_TX_RX; huart1.Init.HwFlowCtl UART_HWCONTROL_NONE; huart1.Init.OverSampling UART_OVERSAMPLING_16; HAL_UART_Init(huart1); }然后说“按照这个风格帮我写一个SPI2的初始化函数用于驱动W25Q128”。AI就会按照你的命名规范、注释格式、初始化顺序来生成代码风格高度一致。这个技巧在团队协作中特别有价值。你可以把团队里写得最好的那个人的代码作为示例让AI模仿这样生成的代码风格统一代码审查时省心很多。实操心得示例不要给太多一个就够了。给太多示例反而会让AI困惑不知道该模仿哪个。选一个最能代表你项目风格的函数作为模板即可。3. 代码生成与调试的完整工作流3.1 从需求到可运行代码的实操流程我拿一个真实的例子来演示整个流程。需求是在STM32F407上通过SPI2读取W25Q128的ID并通过USART1打印出来。第一步准备上下文在CLAUDE.md里确认硬件配置已经写好了。然后开一个新会话把w25q128.h、w25q128.c如果已有的话、bsp_spi.h、bsp_spi.c、main.c加载进上下文。第二步描述需求基于当前项目上下文实现以下功能 1. 在bsp_spi.c中添加SPI2初始化函数用于驱动W25Q128 2. 在w25q128.c中实现读取JEDEC ID的函数 3. 在main.c的while(1)之前调用通过USART1打印ID W25Q128的JEDEC ID命令是0x9F预期返回0xEF4018。 SPI2引脚PB13(SCK), PB14(MISO), PB15(MOSI), PB12(CS) CS使用软件控制低电平有效。第三步审查生成的代码Claude Code会生成完整的代码。这时候不要直接复制粘贴先审查几个关键点SPI的时钟极性(CPOL)和相位(CPHA)设置是否正确W25Q128支持Mode 0和Mode 3通常用Mode 0CS引脚的控制时序是否正确片选拉低到发送命令之间需要延时吗波特率分频系数是否合理W25Q128最高支持104MHz但STM32F407的SPI2在APB1上最高42MHz分频后要确保不超过Flash的限制第四步编译与调试把代码复制到工程里编译。如果报错把错误信息贴回给Claude Code它会帮你修正。如果编译通过但运行不对把串口打印的实际ID值告诉它它会帮你分析原因。我实测下来用这种方式开发一个外设驱动从描述需求到调通大概15-20分钟。如果纯手写查数据手册、写代码、调试至少一个小时。3.2 用Claude Code做代码审查Claude Code不仅能写代码还能审查代码。我经常用它来检查自己写的嵌入式代码有没有潜在问题。具体做法是把要审查的源文件加载进上下文然后说请审查这段代码重点关注 1. 是否有数组越界风险 2. 中断服务函数里是否有阻塞操作 3. 是否有未初始化的变量 4. 寄存器操作是否有竞态条件 5. 是否有内存泄漏虽然我们不用动态内存但检查一下它会逐条分析并给出修改建议。我印象最深的一次是它发现我在一个中断服务函数里调用了HAL_UART_Transmit这是个阻塞函数在中断里调用会导致系统卡死。这个问题我自己review了好几遍都没注意到。不过要注意Claude Code的审查不是万能的。它对硬件时序的理解有限比如它可能看不出某个操作需要插入NOP延时。所以审查结果要结合自己的经验判断不能全信。3.3 调试辅助从错误现象反推原因嵌入式调试最头疼的就是“程序跑飞了”或者“数据不对”现象很模糊原因可能有很多。Claude Code在这方面能帮上不少忙前提是你要把现象描述清楚。我一般会提供这些信息具体的错误现象比如“串口打印乱码”而不是“串口有问题”相关代码片段调试器里看到的关键变量值时钟配置和波特率设置已经尝试过的排查步骤举个例子有一次我的STM32通过SPI读取Flash数据读出来的全是0xFF。我把现象和代码贴给Claude Code它给出了几个可能的原因CS引脚没有正确拉低SPI模式设置错误Flash芯片没有正确供电MISO引脚配置错误然后它建议我用示波器或者逻辑分析仪抓一下SPI波形。我按照它的建议抓了波形发现CS确实拉低了但SCK没有输出。顺着这个线索查下去发现是SPI2的时钟没有使能。问题解决。这个例子里Claude Code并没有直接给出答案但它提供了一个系统性的排查思路这比盲目试错高效得多。4. 常见问题与避坑指南4.1 Claude Code在嵌入式开发中的典型问题用了几个月下来我总结了Claude Code在嵌入式场景下最容易出的几类问题以及对应的解决方法问题类型典型表现解决方法引脚冲突生成的代码用了已被占用的引脚在CLAUDE.md里写清楚引脚分配表时钟配置错误外设不工作但代码看起来没问题明确告诉AI系统时钟频率和总线频率HAL库版本不匹配编译报错函数签名对不上在CLAUDE.md里注明HAL库版本中断优先级错误系统卡死或响应异常明确中断优先级分组和各个中断的优先级数据类型错误变量溢出或精度丢失在提示词里注明关键变量的数据类型要求阻塞操作中断里调用了阻塞函数让AI审查代码时特别关注这一点这些问题里引脚冲突是最常见的。因为AI不知道你的板子是怎么设计的它只能根据芯片的默认复用功能来分配引脚。解决这个问题的唯一办法就是把硬件信息显式地告诉它。时钟配置错误也很常见。STM32的时钟树比较复杂不同外设挂在不同总线上频率不一样。如果AI不知道这些信息它计算出来的波特率、定时器周期都可能是错的。我的做法是在CLAUDE.md里写一个简单的时钟树说明SYSCLK: 168MHz AHB: 168MHz APB1: 42MHz (定时器时钟84MHz) APB2: 84MHz (定时器时钟168MHz)有了这个AI在计算分频系数时就不会出错了。4.2 提示词写不好的三个典型症状症状一AI答非所问你问的是SPI驱动它给你讲了一堆I2C的东西。这通常是因为提示词里没有明确限定范围。解决方法是在提示词开头就写清楚“只讨论SPI相关的内容不要涉及其他外设”。症状二代码风格不一致生成的代码一会儿用驼峰命名一会儿用下划线命名。这是因为提示词里没有给出风格示例。解决方法是在CLAUDE.md里写明命名规范或者在提示词里附上一个示例函数。症状三代码能编译但跑不通这是最隐蔽的问题。代码语法没问题但逻辑上有硬件相关的错误。比如SPI的CPOL/CPHA设置反了或者CS的时序不对。这类问题很难通过提示词完全避免需要你在审查代码时特别关注硬件相关的配置。我的经验是凡是涉及硬件时序、寄存器配置、中断优先级的代码都要逐行审查。AI在这些地方出错概率最高而且出错后很难通过调试发现。4.3 嵌入式AI编程的边界与局限说了这么多Claude Code的好处也得说说它的局限。嵌入式开发有几个领域是AI目前很难替代的硬件调试AI看不到示波器波形读不懂逻辑分析仪的时序图。当问题出在硬件层面时AI能提供的帮助有限。时序敏感的代码比如软件模拟的通信协议、精确的延时控制AI生成的代码往往需要手动调整。资源极度受限的场景当RAM只有几KB、Flash只有几十KB时每一字节都要精打细算。AI生成的代码通常不会考虑这种极致的优化。安全关键系统涉及功能安全的代码必须经过严格的审查和测试不能依赖AI生成。所以我的定位是Claude Code是一个高效的代码生成和审查助手但不是替代品。它能帮你省去大量重复性的编码工作让你把精力集中在架构设计和硬件调试上。但最终的代码质量还是要靠你自己的专业判断。实操心得我一般用Claude Code生成初版代码然后自己逐行审查重点看硬件配置和边界条件。审查完之后再让它帮我写单元测试。这样一套流程下来代码质量比纯手写还高因为AI不会犯“忘记初始化变量”这种低级错误。4.4 从零开始搭建嵌入式AI编程环境如果你还没开始用Claude Code做嵌入式开发这里给一个从零开始的步骤第一步安装VS Code和Claude Code插件VS Code的安装没什么好说的官网下载安装包一路下一步就行。Claude Code的插件在VS Code的扩展市场里搜索安装然后用你的账号登录。第二步配置嵌入式开发环境如果你用的是STM32需要安装ARM GCC工具链和OpenOCD。如果用的是Keil MDK确保Keil的安装路径已经加到系统PATH里。这些是编译和调试的基础跟Claude Code没关系但必须先配好。第三步创建CLAUDE.md在项目根目录创建CLAUDE.md把硬件配置、代码规范、已知限制写进去。这是最重要的一步直接决定了后续AI生成代码的质量。第四步从一个简单的任务开始不要一上来就让AI写复杂的代码。先从一个LED闪烁或者串口打印开始熟悉一下Claude Code的工作方式。等摸清了它的脾气再逐步增加任务复杂度。第五步建立自己的提示词模板库把常用的提示词存成代码片段比如“外设初始化”、“中断服务函数”、“状态机实现”等。下次用的时候直接调用改改参数就行效率会高很多。这套流程走下来大概需要半天时间。但一旦搭好了后续的开发效率提升是立竿见影的。我在实际项目里用这套流程编码时间大概缩短了40%左右而且代码质量更稳定因为AI不会因为疲劳而犯低级错误。最后分享一个我最近发现的小技巧Claude Code可以读取你项目里的.gitignore文件自动忽略不需要的文件。所以确保你的.gitignore写对了把编译产物、临时文件都排除掉这样AI加载上下文时就不会被无关文件干扰。这个细节看起来不起眼但实测下来对生成质量有明显影响。