让 Claude 设计电路板,并逐步校验
Boardwright 通过开源 Claude Code 插件和 KiCad 扩展,辅助完成器件选择、电路绘制、布局及生产文件生成。流程在各阶段执行检查,失败即暂停,并以实际电路板案例展示问题。
AI 深度解读
让 Claude 设计电路板,最难的不是画出线路,而是发现它什么时候画错了。Boardwright 的做法是把设计交给模型,把验收交给 Python 脚本:检查不过就停,修改后重跑,不能靠放宽规则过关。
这套开源工具值得程序员关注,因为它展示了一种具体的 AI 工作流:如何保存验证证据、处理过期结果,以及把尚未确认的问题交还给人。作者公开的 USB 传感器案例,也保留了缺货、符号不一致和审核被拒的过程。
谁来决定 Claude 的设计可以过关
Boardwright 由 Claude Code 插件和 KiCad 插件组成。Claude 负责选器件、画原理图、布局布线及生成制造文件,Python 程序负责检查。
模型可以提出设计,但不能自行宣布设计正确。
规则包括:不能编造料号、引脚和数据手册参数;缺少依据就标记为 unverified,注明文件和页码;不能关闭、过滤或放松检查;申请豁免必须由用户在聊天中批准;没运行的检查不能写成通过;工具不会代为下单、上传或发布。
每个检查脚本都能独立运行,详细结果写入 reports/,退出码也区分清楚:0 表示通过,1 表示检查失败,2 表示运行条件缺失。

流程分为需求、器件、电源、原理图、布局、EMC、BOM、发布八个阶段,底层是 pipeline.json 中的 62 个步骤。plan.py 负责列出可执行工作、等待用户的事项和失败后的回退位置。
通过也不是永久有效。电路板修改后,依赖旧设计的步骤会标记为 reopened,因为先前报告已经不能证明当前设计合格。
Guided 模式逐阶段解释并暂停,Express 模式只在失败或需要用户决定时暂停,两者检查相同。便宜模型处理资料读取等辅助工作,最强模型上的 gate-reviewer 再给一次意见,设计决策不交给辅助代理。
检查程序也可能给出错误的安全感
KiCad 自带 ERC 和 DRC,分别检查电气连接规则、间距及连接完整性。Boardwright 在各阶段运行它们,再补充专项检查。
市电隔离最能说明为什么不能只看「DRC 通过」。危险侧与可触碰侧之间,需要满足空气中的电气间隙和沿板表面的爬电距离。用户在 boardwright.json 填写电压、污染等级、海拔、板材、危险网络和隔离位置,spacing.py 按 IEC 60664-1 方法计算距离。爬电距离取下一档表格值,不做插值。
随后有两条检查路径:
creepage_rules.py --write把距离写入 KiCad 规则,由 DRC 执行。barrier_check.py独立测量各层危险侧与安全侧铜箔间的最短距离。
规则缺失、强度不足、DRC 结果早于电路板、两路结果不一致,都会失败。KiCad 低于 10.0.6 也不能通过这项检查,因为更早版本存在爬电几何计算问题。

原因很具体:规则如果指向根本不存在的网络,DRC 也可能干干净净。另一个规则守卫因此负责确认网络类别确实匹配真实网络。mains_check.py 还检查火线入口保险丝、X/Y 安规电容位置和断电放电速度。
其他专项检查同样有明确边界。emc_rules.py 从走线跨地平面缺口、换层缺少邻近地过孔、接口缺保护及靠近板边等几何特征估计干扰风险,emc_harmonics.py 给出优先测试的时钟频率。它们代替不了实验室测量。
hs_rules.py 除了写长度与偏斜规则,还独立计算含过孔长度的差分线长度、以 mm 和 ps 表示的偏斜及过孔数量。impedance_check.py 估算阻抗,USB 差分目标约为 90 Ω。pdn_check.py 按「电压 × 纹波比例 ÷ 电流阶跃」计算目标阻抗,从 100 kHz 起检查电容,但不模拟安装电感、平面和稳压器自身。
真正有价值的是没有通过的项目
作者展示的是一块约 30 × 40 mm 的 USB-C 温湿度板:3.3 V 稳压器供电,STM32 通过 I2C 读取传感器,再以串口方式向电脑报告。
最直接的问题是库存。阶段 2 的 11 月 14 日到阶段 7 的 11 月 15 日,LCSC 自营库存中,U1 从 16 个降至 3 个,需求却是 5 个;10 kΩ 的 R3 从 8,400 个降至零。BOM 检查失败,流程暂停。候选替代件也缺货,工具没有硬凑一个替代方案。
用户随后选择保留未通过状态继续生成发布文件,报告开头明确要求完成清单前不要下单。
原理图也留下了需人工确认的问题。U2 实际是 AP2112K-3.3,工具无法放置 KiCad 派生符号,于是使用名为 AP2204K-1.5 的基类符号。引脚共享、真实料号字段存在,也仍然需要核对数据手册。sch_check.py 另行提示,部分手册只按系列名匹配,并非精确料号。
gate-reviewer 首次拒绝发布报告,因为清单漏掉两项未验证事项,上电步骤还引用了不存在的测试点。修正后,这些问题才进入交付记录。
EMC 检查得到 16 行结果,没有 CRITICAL,有一项 MEDIUM:连接器某个 D− 焊盘经过两个过孔才到 ESD 器件。USB 两根线各为 10.9 mm;报告同时说明,1.6 mm 双层板配 0.25 mm 线宽无法实现 90 Ω 差分阻抗,但认为 12 Mbit/s 全速 USB 在约 11 mm 距离上不需要满足该目标。这是报告给出的工程判断,原文没有提供实测信号质量数据。
接入方式不复杂,验证范围还很有限
KiCad 聊天窗口是独立进程,通过 stream-json 与用户自己的 Claude Code 长期进程通信。kicad-live 经 IPC API 修改电路板,每次修改保留为正常撤销步骤;DRC、ERC 和导出交给 kicad-cli,原理图由 kicad-schematic 处理。插件不读取或保存密码、API key、token。
作者要求 KiCad 9 或 10、付费 Claude plan 或 Anthropic API 账户,以及 Windows 11 或 Linux。测试环境是 Windows 11、Ubuntu 24.04 和 KiCad 10.0.8,Mac 尚未测试。支持安装不代表所有检查都支持旧版,市电爬电检查仍有前述版本门槛。
Windows PowerShell 安装命令如下,它会下载并执行安装脚本:
irm https://raw.githubusercontent.com/Pratham7767/Boardwright/main/install/install.ps1 | iex
这里需要看清的是最后的 iex:远端脚本会直接执行。
Linux 对应命令为:
curl -fsSL https://raw.githubusercontent.com/Pratham7767/Boardwright/main/install/install.sh | bash
同样要留意末尾的 | bash。随后在 KiCad 的 Plugin and Content Manager 中选择 Install from File... 完成安装。
空目录中先运行 /boardwright:pcb-doctor,再用 /boardwright:pcb-new guided 开始;/boardwright:pcb-run 推进流程。已有项目可运行 /boardwright:pcb-review 或 /boardwright:pcb-gates,两者都不修改设计,后者运行全部检查。
我的判断
我认可它把失败、豁免和决策归属写进交付物。阶段 5 至 8 曾在持续授权下无人值守运行,Claude 决定的板框、接口位置等被明确标记为未经用户审核。这比一句「已完成」更利于接手。
但原文只有两块真实电路板经过流程,尚无测试者从零设计新板的验证,也没有与人工设计或其他工具的对照数据。它的可靠性目前仍需要更多案例支持。
尤其是安全距离来自 IEC 60664-1、IEC 62368-1 的公开二手摘要,尚未对照购买的正式标准。EMC 只是风险估计,内置仿真、器件本体上的三维间隙、涂覆板、内层安全规则和 4 层以上受控阻抗板也未覆盖。自动库存检查仅支持 LCSC。
两种检查一致,只能增强对已建模问题的信心,不能证明未覆盖的问题不存在。
相比只靠提示词要求模型仔细检查,它提供了可重复运行的证据;相比成熟工程验证流程,它还处在需要合格人员复核的辅助工具阶段。
能拿来做什么
- 如果已经有 KiCad 项目,可以先用
/boardwright:pcb-review获取报告,检查未验证项、器件身份和证据来源,再决定是否让模型参与修改。 - 在日常 AI 编程中,可以借用它的验收分工:让模型实现代码,由独立命令检查,并分别记录通过、失败和环境缺失。
- 对多阶段任务,应让设计或代码修改自动使相关旧报告失效,同时保留人工豁免及理由,避免下一轮交接把未解决事项当成已通过。
- 试用硬件生成时,应把发布文件和可生产结论分开处理;库存、数据手册、上电检查及实际测量仍需逐项完成。