1. 为什么“一句话画 PCB”总在第七步翻车Codex 配合 GPT-6 Astra 画 PCB最吸引人的地方就是那句提示词把需求描述进去等几分钟拿到 Gerber 下单。但真正做过硬件的人都知道从一句需求到可投板文件中间隔着电源预算、封装选型、网络表一致性、DRC 清零、板框安装孔、钻孔坐标 BOM 这一整条证据链。AI 能帮你把这条链跑通但它不会自动帮你把工程约束补齐。我实测下来翻车点几乎都集中在七个环节需求没变成验收表、原理图跳过电气审计、布局顺序乱、布线没有规则驱动、DRC 清零就以为设计正确、投板证据包不完整、版本对应关系丢失。这篇就按这七步拆开每一步给出可复制的配置骨架和逐项验证动作让你在本地能复现也能定位失败点。适合谁看已经会用 KiCad 画简单板子、想让 Codex 接管重复劳动、但不想被 AI 带进沟里的硬件工程师和嵌入式开发者。核心检索词就三个Codex 画 PCB、GPT-6 Astra 生成 Gerber、KiCad DRC 验证。下面所有配置都围绕这三个动作展开。2. TaoToken 统一 Key 接入 Codex 与 KiCad 脚本2.1 为什么需要统一 KeyCodex 在终端里跑KiCad 的 Python 脚本在 PCB Editor 里跑如果两边各自配一套 API Key改一次环境变量就要同步两个地方很容易出现“终端能跑、脚本报 401”的情况。TaoToken 的做法是给一个统一 Key 和统一 API 通道Codex 的 config.toml 和 KiCad 脚本的 settings.json 都指向同一个地址换模型只改一个字段。官网入口在这里https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 注意 API 地址不加 UTM 参数直接写进配置文件即可。2.2 拿 Key 与选通道登录后进控制台在 API Keys 页面创建一个 Key复制出来只显示一次。如果你只是验证模型能不能理解原理图审查任务用模型对话页面先试一轮如果要长期跑 Codex 做编码和 Agent 任务建议开 Coding Plan额度更稳。接入文档在 doc 页面里面有各工具的字段说明。注意Key 不要写进 Git 仓库用环境变量或本地 settings.json 并加 .gitignore。下面配置里的sk-xxx全部替换成你自己的 Key。3. 可复制配置config.toml 与 settings.json 骨架3.1 Codex 的 config.tomlCodex 读取的是用户目录下的 config.toml核心是把 model_provider 指向 TaoToken 的 API 地址并把 Key 通过环境变量注入。骨架如下# ~/.codex/config.toml model gpt-6-astra model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY wire_api chat [profiles.pcb] model gpt-6-astra model_provider taotoken approval_policy on-request环境变量在 shell 里设置export TAOTOKEN_API_KEYsk-xxxwire_api chat对应对话补全接口Codex 的 Agent 模式会在此基础上做多轮工具调用。approval_policy on-request表示涉及文件写入和命令执行时先问你PCB 这种改文件的操作不建议全自动。3.2 KiCad 脚本的 settings.jsonKiCad 9 的 PCB Editor 内置 Python 控制台脚本要调模型时读一个本地 settings.json。放在工程根目录和 .kicad_pcb 同级{ api_base: https://taotoken.net/api, api_key_env: TAOTOKEN_API_KEY, model: gpt-6-astra, timeout_sec: 120, max_retries: 2, project: { board_mm: [50, 35], layers: 2, min_track_mm: 0.15, min_clearance_mm: 0.15, via_drill_mm: 0.3 } }脚本里读 Key 用os.environ.get(TAOTOKEN_API_KEY)不要硬编码。project字段就是第一步要生成的验收表后面所有审查和规则都从这里取值避免模型自己猜板厂参数。3.3 需求验收表 requirements.md在让 Codex 动任何原理图之前先让它把一句话需求展开成可判定的表。以桌面传感器小板为例power: input: USB-C 5V peak_current_ma: 1200 regulator: 3.3V 1.5A mechanical: board_mm: [50, 35] mounting_holes: 4 interfaces: - USB 2.0 - I2C - WS2812 manufacturing: layers: 2 min_track_mm: 0.15 min_clearance_mm: 0.15 via_drill_mm: 0.3这张表的作用是把“看起来像对的”变成“可以逐条判定”。缺失的额定电流、接口电平、机械尺寸会在画板前就暴露出来而不是等 Gerber 导出后才发现装不进外壳。4. 七步翻车点逐项拆解与验证4.1 第一步需求没变成验收表翻车表现直接让 Codex 开始布线结果电源芯片选型对不上峰值电流USB-C 下拉电阻漏了。验证动作检查 requirements.md 是否覆盖输入、输出、峰值电流、接口、机械边界五类字段缺一项就补一项。Codex 提示词可以这样写把下面这段需求展开成 requirements.md字段包括 power、mechanical、interfaces、manufacturing。 缺失的数值标注 TODO不要自己编造。输出后逐条问我确认。4.2 第二步原理图跳过电气审计翻车表现线连上了但去耦电容离电源脚太远、启动脚悬空、传感器地址冲突。正确做法是先审查后修改让 Codex 输出三份产物requirements.md、power-budget.csv、schematic-review.md。审查提示词审查这份原理图不要直接修改。先列出阻断投板的问题、需要数据手册确认的问题、建议优化项。 每条必须给出网络名、器件位号和验证方法。确认后再生成最小补丁。验证动作打开 schematic-review.md逐条核对网络名和位号是否真实存在阻断项清零才进入布局。4.3 第三步布局顺序乱翻车表现先摆主控再挪 USB-C结果机械接口一动前面布的线全废。推荐顺序是先锁定 USB-C、按键、LED、安装孔和天线禁布区再放主控、电源芯片和去耦电容然后按信号流放传感器和连接器最后处理地平面、回流路径和测试点。让 Codex 每完成一个阶段输出变更摘要写明移动了哪些位号、为什么移动。一旦机械接口被后续步骤挪动立即回退该局部变化。4.4 第四步布线没有规则驱动翻车表现只说“帮我把线连完”结果 VBUS 走 0.2 mmUSB 差分没做阻抗。规则要按网络类别写进 KiCad 的 Design Rules网络类别线宽过孔备注VBUS0.8 mm0.5/0.3 mm峰值 1.2 A 留余量3V3 主干0.5 mm0.4/0.3 mmLDO 输出到负载普通数字0.2 mm0.3/0.2 mmI2C、按键USB D/D-按叠层算0.3/0.2 mm差分阻抗待板厂确认天线净空禁布禁布顶层底层铜皮全禁验证动作在 KiCad 里打开 Board Setup 的 Net Classes确认每类网络的线宽和过孔与表格一致。没有板厂叠层参数时USB 阻抗只能标 TODO不能声称已满足。4.5 第五步DRC 清零就以为设计正确DRC 能发现间距、线宽、缺失连接但它不知道器件额定值选没选对也不知道接口位置方不方便装配。至少做四类检查电气看 ERC、DRC、未连接网络、地平面连续性机械看板框闭合、孔位、连接器高度、外壳干涉供应链看封装与实际料号一致、替代料不改引脚制造看 Gerber、钻孔、坐标、BOM、装配图齐全。验证动作在 KiCad 里跑 Inspect 菜单下的 ERC 和 DRC把报告导出到 reports/ 目录和 requirements.md 逐条对照。4.6 第六步投板证据包不完整只拿到一个 .kicad_pcb 不算交付。最终目录至少包含release-v1/ ├── source/ # 原理图与 PCB 源文件 ├── gerber/ # 铜层、阻焊、丝印、板框 ├── drill/ # Excellon 钻孔 ├── assembly/ # BOM、坐标、装配图 ├── mechanical/ # STEP 或 3D 检查文件 ├── reports/ # ERC、DRC、规则与版本记录 └── checksums.txtKiCad 官方文档说明 Gerber 是主要制造输出钻孔文件需要单独生成。验证动作在 PCB Editor 里 File Fabrication Outputs 分别导出 Gerber 和 Drill确认 drill 目录里有 .drl 文件gerber 目录里每层都有对应文件。4.7 第七步版本对应关系丢失翻车表现改了原理图没重新导出 Gerber或者 Gerber 和 PCB 版本对不上。验证动作每次导出后在 checksums.txt 里记录源文件、Gerber、钻孔三者的哈希用一条命令生成find release-v1 -type f -exec sha256sum {} \; release-v1/checksums.txt这样任何一次修改后重新导出哈希都会变能立刻发现版本错位。5. 本篇常见错排查5.1 401 与 404 报错401 通常是 Key 没注入或写错环境变量名。检查echo $TAOTOKEN_API_KEY是否有值config.toml 里的env_key是否和 export 的名字一致。404 多半是 base_url 写成了带路径的地址正确写法是https://taotoken.net/api不要在后面加/v1或/chat具体路径由 wire_api 决定。5.2 模型返回内容被截断PCB 审查任务输出长如果 timeout 设太短会截断。settings.json 里timeout_sec调到 120Codex 侧可以在 config.toml 的 profile 里加request_timeout_ms 120000。另外让模型分阶段输出先出阻断项再出优化项避免一次生成太长。5.3 KiCad 脚本读不到 settings.jsonKiCad 的 Python 控制台工作目录不一定是工程目录。脚本里用绝对路径读配置或者先os.chdir到工程根目录。验证方法在控制台里import os; print(os.getcwd())确认路径后再读文件。5.4 DRC 报错但不知道改哪把 DRC 报告导出成文本让 Codex 逐条解释并给出修改建议提示词里要求它引用具体的网络名和坐标。不要让它直接改文件先出建议清单你确认后再让它生成最小补丁。6. 继续把 Codex 用在工程链路上GPT-6 Astra 让 Codex 更适合承担多步骤、跨工具的工程任务但 PCB 仍然是一项需要证据链的工作。最靠谱的用法是让 AI 管理约束、生成文件、执行检查、整理差异再由工程师对关键电气和制造风险签字。当每个结论都能落到网络名、器件位号、规则报告和制造文件上Codex 画 PCB 才不是演示而是一条可复用的工程流程。如果你要长期跑编码和 Agent 任务建议开 Coding Plan额度更稳只是验证模型对原理图审查的理解用模型对话先试一轮就够。接入配置和字段说明在接入文档里Key 在 API Keys 页面创建。先把这篇里的 config.toml 和 settings.json 骨架复制到本地跑通一次从需求到 Gerber 的完整链路再逐步把七步验证动作加进你的日常流程。