1. 这套玩法到底在解决什么问题第一次听到“用 AI 远程控制嘉立创EDA专业版画原理图”这个想法时我脑子里蹦出来的第一个念头是这不是脱裤子放屁吗画原理图本来就是鼠标点几下的事让 AI 去操作中间隔着一层通信效率能高到哪去但真正动手把 STM32F103C8T6 最小系统这个案例跑通之后我的看法变了。这套方案的价值不在于“比人手快”而在于把重复性的、有固定套路的绘图工作自动化。STM32 最小系统这种东西电源部分、晶振部分、复位部分、下载接口部分几乎每一块都是标准电路差别无非是引脚编号和网络标号。人画一遍要十几分钟还容易漏掉去耦电容或者把 BOOT0 的下拉电阻画错。让 AI 按模板生成再通过脚本灌进 EDA 里一次配置好之后后面就是流水线作业。具体来说这套方案适合三类人一是经常要画同类型板子的硬件工程师手里有一堆“换汤不换药”的项目二是想学 EDA 脚本化操作但不知道从哪下手的初学者拿 STM32 最小系统当练手项目刚刚好三是做教学或者批量出图场景的朋友需要快速生成标准原理图作为参考底图。核心思路拆成三块Claude Code 负责“想”也就是根据你的自然语言描述生成结构化的电路网表或者嘉立创EDA能识别的脚本嘉立创EDA专业版的扩展接口负责“做”把 AI 生成的内容转换成实际的原理图元素中间的通信层负责“传”让 Claude Code 能远程调用 EDA 的接口。这三块拼起来就实现了从一句话描述到一张可编辑原理图的完整链路。注意这里说的“远程控制”不是指你在外面用手机控制家里的电脑而是指 Claude Code 作为一个独立的进程通过本地接口或者文件交换的方式驱动嘉立创EDA执行绘图操作。两者可以在同一台机器上也可以在同一局域网内。2. 为什么选这套技术栈而不是别的2.1 Claude Code 在电路生成场景下的独特优势市面上能写代码的 AI 不少但 Claude Code 在这个场景里有几个别人替代不了的特点。第一是长上下文下的结构保持能力。STM32F103C8T6 最小系统涉及几十个元件、上百个网络连接普通对话式 AI 聊到后面就忘了前面定义的网络标号。Claude Code 的工程化交互模式允许你把整个项目结构、引脚定义、连接规则一次性喂进去它在后续生成中能稳定引用这些约束。第二是对脚本语言的生成质量。嘉立创EDA专业版支持 JavaScript 扩展Claude Code 写 JS 的功底在同类工具里属于第一梯队。我实测过让几个不同的 AI 写同样的“创建元件并连线”脚本Claude Code 生成的代码在变量命名、错误处理、API 调用顺序上都更靠谱基本不需要大改就能跑。第三是文件系统操作能力。Claude Code 可以直接读写你本地的工程文件这意味着它可以先生成一份中间格式的网表文件再调用转换脚本导入 EDA。这种“生成-落盘-导入”的流程比纯对话式 AI 只能输出文本要实用得多。2.2 嘉立创EDA专业版的脚本扩展能力选嘉立创EDA专业版而不是其他 EDA 工具主要看中它的扩展接口开放程度。专业版提供了完整的 JavaScript API覆盖了原理图绘制的主要操作创建元件、放置引脚、添加导线、设置网络标号、定义元件属性。这些 API 通过eda全局对象暴露出来在扩展开发模式下可以直接调用。另一个原因是元件库的丰富度。STM32F103C8T6 的符号在嘉立创的系统库里有现成的不需要自己从零画。AI 生成脚本时只需要引用库里的元件 ID然后设置好位号和参数就行。这比让 AI 去画一个 LQFP48 的符号要现实得多。还有一点是本地化程度。嘉立创EDA的服务器在国内元件搜索和库加载的速度很稳定不会出现画到一半库加载不出来的尴尬情况。对于需要批量生成原理图的场景这个稳定性很重要。2.3 整体架构的设计取舍我最终采用的架构是Claude Code 生成 JSON 格式的电路描述文件 → Node.js 脚本读取 JSON 并调用嘉立创EDA扩展 API → EDA 执行绘图操作。没有选择让 Claude Code 直接生成 JavaScript 代码去执行原因有两个。一是调试成本。如果让 AI 直接写 JS 脚本一旦 API 调用出错报错信息是 EDA 内部抛出的Claude Code 看不到完整的调用栈很难定位问题。而 JSON 作为中间层格式错误在解析阶段就能发现排查起来简单得多。二是复用性。JSON 描述文件是平台无关的今天用嘉立创EDA明天想换到别的工具只需要换一个转换脚本就行。AI 生成的那部分逻辑不用动。这个取舍带来的代价是多了一层转换生成速度会慢几秒。但对于画原理图这种分钟级的任务来说几秒的延迟完全可以接受。3. 环境搭建与核心配置细节3.1 Claude Code 的安装与项目初始化Claude Code 的安装方式取决于你的操作系统。Windows 下推荐用 npm 全局安装命令是npm install -g anthropic-ai/claude-code。安装完成后在终端里执行claude命令首次运行会引导你完成认证配置。如果你在 Ubuntu 或者 macOS 下流程基本一致注意 Node.js 版本不要低于 18。安装完成后在你的工作目录下执行claude init它会生成一个项目配置文件。这个文件里需要关注几个关键项model指定使用的模型版本max_tokens建议设大一点因为电路描述文件比较长temperature设成 0.2 左右比较合适太低会死板太高会乱编引脚。提示如果你在 VS Code 里工作可以装 Claude Code 的 VS Code 扩展这样在编辑器里就能直接调用不用来回切终端。扩展的配置和命令行版本是共享的装一次就行。项目初始化之后建议在根目录建一个specs文件夹专门放电路规格描述文件。我习惯把 STM32F103C8T6 的引脚定义、电源要求、外设连接规则写成一个 Markdown 文件放在里面每次让 Claude Code 生成电路时都引用这个文件作为约束。3.2 嘉立创EDA专业版的扩展开发环境嘉立创EDA专业版的扩展开发入口在菜单栏的“设置”里找到“扩展”选项打开“扩展开发模式”。开启之后顶部会多出一个“扩展”菜单里面可以新建扩展项目、加载本地扩展、打开调试控制台。新建一个扩展项目时选择“原理图扩展”类型。生成的模板里会有一个main.js文件和一个extension.json配置文件。extension.json里需要声明扩展的名称、版本、入口文件以及需要的权限。对于我们的场景至少需要schematic:read和schematic:write这两个权限。调试控制台是排查问题的关键工具。在扩展代码里用console.log输出的信息会显示在控制台里API 调用出错时的异常信息也会在这里打印。建议在开发阶段把控制台一直开着方便实时看日志。3.3 通信层的搭建与文件交换机制Claude Code 和嘉立创EDA之间的通信我采用的是文件监听方案。具体来说Claude Code 把生成的电路描述 JSON 写到output/circuit.json嘉立创EDA的扩展里用 Node.js 的fs.watch监听这个文件的变化一旦检测到文件更新就读取内容并执行绘图。这个方案的好处是解耦彻底。Claude Code 不需要知道 EDA 的 API 长什么样EDA 也不需要知道 AI 是怎么生成内容的。两边通过一个约定好格式的文件来交互任何一边出问题都不会影响另一边。文件格式我定义了一个简单的 JSON Schema顶层包含components和nets两个数组。components里每个元素描述一个元件包括libraryId库里的元件标识、designator位号、value参数值、position坐标。nets里每个元素描述一个网络包括name网络名和pins连接的引脚列表每个引脚用位号加引脚号表示。{ components: [ { libraryId: stm32f103c8t6, designator: U1, value: STM32F103C8T6, position: { x: 300, y: 200 } } ], nets: [ { name: VDD, pins: [U1.24, U1.36, U1.48] } ] }这个格式看起来简单但实际用起来很顺手。Claude Code 生成这种结构化数据非常稳定嘉立创EDA那边解析起来也几乎没有歧义。4. 让 Claude Code 生成 STM32 最小系统电路描述4.1 给 AI 喂什么规格信息让 AI 画电路最怕的就是它“自由发挥”。你让它画 STM32 最小系统它可能给你加上一堆用不到的外设或者把某些引脚的连接搞错。所以第一步是把约束条件写清楚。我准备的规格文件里包含这几块内容。引脚定义表把 STM32F103C8T6 的 48 个引脚按功能分组标出哪些是电源、哪些是地、哪些是晶振、哪些是复位、哪些是下载接口、哪些是 BOOT 配置。电源方案明确 VDD 用 3.3VVDDA 通过磁珠或者零欧电阻从 VDD 隔离VBAT 直接接 VDD不用电池的情况下。去耦电容配置每个 VDD 引脚配一个 100nF整体再加一个 10uF 的钽电容。晶振电路8MHz 主晶振配两个 20pF 负载电容32.768kHz 的 RTC 晶振可选。复位电路10k 上拉电阻加 100nF 电容。下载接口SWD 模式SWDIO 和 SWCLK 加上拉电阻。把这些信息写成 Markdown 文件后在 Claude Code 里用specs/stm32f103c8t6.md的方式引用然后给出指令“根据规格文件生成 STM32F103C8T6 最小系统的电路描述 JSON输出到 output/circuit.json”。4.2 生成过程中的参数计算与校验Claude Code 生成完 JSON 之后不要急着导入 EDA。先做一轮逻辑校验。我写了一个简单的 Node.js 校验脚本检查几个关键点所有 VDD 引脚是否都连接到了 VDD 网络、所有 VSS 引脚是否都连接到了 GND 网络、晶振引脚是否连接了正确的负载电容、复位引脚是否有上拉和电容、BOOT0 是否有下拉电阻。这个校验脚本的逻辑不复杂就是遍历nets数组检查特定网络名下的引脚列表是否包含了预期的引脚。比如检查VDD网络时确认U1.24、U1.36、U1.48都在列表里。如果缺少任何一个脚本就报错并指出缺了哪个引脚。参数计算方面主要是去耦电容的数量和晶振负载电容的取值。STM32F103C8T6 有 3 个 VDD 引脚加 1 个 VDDA 引脚所以至少需要 4 个 100nF 去耦电容。晶振负载电容的计算公式是CL (C1 * C2) / (C1 C2) Cstray其中 Cstray 是 PCB 走线的寄生电容一般取 3 到 5pF。8MHz 晶振的 CL 典型值是 20pF反推 C1 和 C2 大约在 20pF 左右。这些计算过程我会在规格文件里写清楚让 Claude Code 直接引用结果而不是让它自己去算。4.3 生成结果的格式转换与导入Claude Code 输出的 JSON 是通用格式嘉立创EDA的扩展需要把它转换成 API 调用序列。这个转换脚本我放在 EDA 扩展的main.js里核心逻辑是遍历components数组对每个元件调用eda.sch.createComponent()然后遍历nets数组对每个网络调用eda.sch.createNet()并添加引脚连接。转换过程中有几个细节要注意。坐标系统嘉立创EDA的坐标原点和单位可能和 JSON 里定义的不一样需要做一个映射。我一般把 JSON 里的坐标当作“格点坐标”每个单位对应 EDA 里的 10 个内部单位。元件库 IDJSON 里写的libraryId需要和嘉立创系统库里的实际 ID 对应这个可以在 EDA 的元件搜索里查到。网络标号的命名规则嘉立创EDA对网络标号有一些保留字限制比如不能以数字开头不能包含特殊字符。转换脚本里加一个清洗函数把不合规的标号自动修正。导入完成后在 EDA 里打开生成的原理图肉眼检查一遍。重点看电源网络是否连通、晶振电路是否完整、复位电路是否正确、下载接口是否接对。确认无误后保存工程文件。5. 实操过程中踩过的坑与排查记录5.1 Claude Code 生成内容不稳定的几种表现引脚号张冠李戴。有一次 Claude Code 把 PA0 的引脚号写成了 10实际应该是 10 没错但它把 PA1 也写成了 10。这种错误在校验脚本里能发现因为同一个引脚号出现在了两个不同的网络里。解决办法是在规格文件里把引脚定义表写得更明确用表格形式列出“引脚号-引脚名-功能”让 AI 直接查表而不是凭记忆。去耦电容漏画。AI 有时候会“偷懒”觉得 3 个 VDD 引脚共用一个 100nF 就够了。这在实际工程中是不行的每个 VDD 引脚都需要独立的去耦电容而且布局时要尽量靠近引脚。我在规格文件里明确写了“每个 VDD 引脚必须配一个独立的 100nF 电容”并且在校验脚本里加了数量检查。网络标号命名不一致。比如电源网络一会儿叫VDD一会儿叫VCC一会儿叫3V3。这会导致导入 EDA 后网络连接断开。解决办法是在规格文件里定义一份“网络命名规范”明确电源用VDD、地用GND、模拟电源用VDDA让 AI 严格按这个来。5.2 嘉立创EDA扩展API的调用陷阱API 调用需要等待上一个操作完成。嘉立创EDA的扩展 API 大部分是异步的如果你连续调用createComponent而不等待返回后面的元件可能会创建失败。正确的做法是用async/await或者 Promise 链确保每个操作完成后再进行下一个。元件创建后需要手动刷新。有时候 API 返回成功了但原理图界面上看不到新元件。这是因为 EDA 的视图没有自动刷新。解决办法是在批量创建完成后调用一次eda.sch.refresh()强制重绘。网络标号的作用域问题。嘉立创EDA里网络标号有“全局”和“局部”两种作用域。如果 AI 生成的网络标号被默认设置为局部跨页面的连接就会断掉。在创建网络时需要显式指定scope: global。5.3 常见问题速查表问题现象可能原因排查方法解决方案导入后元件重叠在一起JSON 里坐标都是默认值检查 JSON 的 position 字段在转换脚本里加自动布局逻辑网络连接断开网络标号命名不一致对比 JSON 和 EDA 里的网络名统一命名规范加清洗函数元件库找不到libraryId 写错在 EDA 里搜索该元件用正确的库 ID 替换脚本执行报错API 权限不足查看调试控制台在 extension.json 里加权限声明生成速度慢JSON 文件太大看文件行数分批生成每批不超过 50 个元件提示调试扩展时把console.log的输出级别调成 verbose这样能看到每个 API 调用的详细参数和返回值。虽然日志会很多但排查问题时非常有用。6. 从最小系统扩展到更复杂的板子STM32F103C8T6 最小系统只是一个起点。这套“AI 生成描述文件 EDA 脚本导入”的流程稍微改改就能用在更复杂的项目上。比如要画一个带 DHT11 温湿度传感器和 OLED 显示屏的板子只需要在规格文件里加上 DHT11 的引脚定义数据脚接 PA0电源接 3.3V地接 GND和 OLED 的 I2C 接口定义SCL 接 PB6SDA 接 PB7然后让 Claude Code 重新生成 JSON。校验脚本里加上“DHT11 数据脚必须有 4.7k 上拉电阻”的检查规则就能保证生成的电路符合实际工程要求。再比如要画一个 TB6612 电机驱动板涉及 PWM 信号、方向控制信号、编码器反馈信号网络连接更复杂。这时候可以在规格文件里定义一个“模块化”的结构把电机驱动部分单独写成一个子规格让 Claude Code 分模块生成最后合并成一个完整的 JSON。这样 AI 的注意力不会被太多细节分散生成质量更稳定。对于 DDR4 这种高速电路这套方案目前还不太适用因为 DDR4 的布线规则、阻抗匹配、时序约束不是简单的网表能描述的。但如果是画 DDR4 的电源部分或者去耦电容阵列用 AI 生成描述文件再导入还是能省不少事。7. 一些实操心得和后续可玩的方向这套方案跑通之后我最大的感受是AI 不是用来替代你的而是用来放大你的效率的。你依然需要懂 STM32 最小系统应该怎么画需要知道去耦电容要放几个需要清楚晶振负载电容怎么算。但你可以把这些知识写成规格文件让 AI 去执行重复性的绘图操作。一次投入后面每次画同类板子都能省下大量时间。另一个心得是校验环节不能省。AI 生成的内容看起来再合理也要用脚本过一遍。我现在的习惯是校验脚本的规则库随着项目积累不断丰富每踩一个坑就加一条检查规则。时间长了这个校验脚本就成了一个“电路设计规范检查器”比单纯依赖 AI 的自觉性靠谱得多。后续可以玩的方向有几个。一是接入本地模型把 Claude Code 换成调用本地部署的模型这样在没网的环境下也能用而且数据不出本地。二是做元件库的自动匹配让脚本根据元件参数自动在嘉立创的库里搜索最合适的符号而不是手动指定 libraryId。三是生成 PCB 布局建议根据原理图的网络连接关系让 AI 给出元件摆放和走线拓扑的建议虽然不能全自动布线但能提供一个不错的起点。最后分享一个小技巧在让 Claude Code 生成电路描述之前先让它“复述”一遍你对电路的要求。比如你告诉它“STM32F103C8T6 最小系统3.3V 供电8MHz 晶振SWD 下载”让它用自己的话把关键点列出来。如果它复述的内容有遗漏或者理解偏差你能在生成之前就发现避免生成一大堆需要返工的内容。这个“先确认再执行”的习惯能省下不少来回调试的时间。