config.toml 八个常见错误清单

配置文件是 AI coding agent 的驾驶舱，配错了轻则别扭，重则翻车：权限全开、密钥进仓库、MCP 挂上不明服务。中文社区里流传一份高频错误清单，八个错误全部有真实案例支撑。这篇先把八条原样列出，供你对号入座，再逐条对照纠正，最后给一份自查路径；分层的底层机制见config.toml 分层一篇，先读它打底更顺。

八个错误的快照：先对号再纠正

先列清单。一，full-access 长期常开，图省事把安全垫抽掉；二，API Token 与密钥直接写进 config.toml，还随仓库提交；三，照抄旧教程的配置，条目早已过时；四，项目没走信任流程，项目层配置静默失效；五，多套安装来源并存，配置互相打架；六，MCP 服务只看连接成功，不看授权了什么；七，把 AGENTS.md 写成愿景文档，agent 无所适从；八，只改审批档位不看沙箱层，被拦了还找不到原因。八条里大部分败在同一个习惯：配完不复核，出错不溯源。

一错权限常开，二错密钥入库

full-access 是权限档位里最宽的一档，文件与网络全放开。当成临时排障手段可以，当默认档位就是自我拆防：agent 误删文件、误装依赖、访问不该访问的地址，都在这一档里畅通无阻。纠正：默认用较低档位，临时需要再切，任务结束切回。第二条更严重：有人图方便把 API Token 直接写进项目层的 config.toml，随仓库提交，公开仓库一推，密钥等于公开。纠正：凭据与配置分离，个人凭据只进不入库的本地文件，团队共享走环境变量或注入机制；已经泄露的按轮换流程处理——作废旧密钥、签发新密钥、检查泄露期间的用量，完整流程见密钥分离与泄露处理一篇。

三错照抄旧教程，四错没走信任

教程的半衰期很短：旧版本里的配置条目、被更名的字段、已经收紧的默认值，照抄轻则无效，重则与新版本行为冲突。纠正：以官方配置文档为准，教程只学思路；凡涉及版本差异的表述，注明截至发稿版本、以官方更新日志为准。第四条：仓库克隆下来直接开干，没走信任确认，项目层配置全部静默不加载，表现为「我配置了怎么没生效」。纠正：新仓库进门先完成信任确认，再用调试命令核对配置来源与生效值。

五错来源打架，六错只看连通

第五条：npm、brew、官方安装器各装了一遍 agent，各读各的配置目录，改了这份那份不认，越调越乱。纠正：确定唯一日常使用的安装，其余卸载或迁移，先收敛来源再谈调优。第六条：MCP 服务配置完，看到连接成功就放心——连通只说明服务在线，不代表授权范围合适。服务能力过大、工具全量放开，agent 手里的权限超出任务所需，风险随之放大。纠正：用工具白名单收窄可用范围，先只读后放开写，用测试账号先跑一轮，机制见MCP 最小授权一篇。

七错愿景文档，八错只看审批

第七条在指令侧：把 AGENTS.md 写成项目愿景书，使命愿景洋洋洒洒，可执行条目一条没有，agent 读完照样犯错。纠正：按命令、边界、验收三要素重写，写法见AGENTS.md 写法一篇。第八条是社区八错里最经典的认知混淆：权限被拦了，只去调审批档位，调到最宽还是被拦——审批与沙箱是两层机制，审批管问不问，沙箱管放不放行，只改审批不动沙箱，拦截照旧。纠正：被拦先判断在哪一层，再对症放开；两层的关系见审批与沙箱两层一篇。八条对照下来有个共同解：配完复核、变更留痕。可以让豆包按这份清单给当前项目做一次逐项体检，再让 DeepSeek 把每条的纠正动作整理成几条可执行的检查命令，下次配置完顺手跑一遍。

八错速查

• 八错：权限常开、密钥入库、抄旧教程、没走信任、来源打架、只看连通、愿景文档、只看审批
• 权限档位按需临时开，任务结束切回低档
• 凭据与配置分离，泄露先轮换再查用量
• MCP 连通只是起点，授权范围要收窄
• 审批与沙箱两层分开看，拦截先定位在哪层

config.toml 错误快问快答

• 这份清单多久过一遍合适？：装新版本、接新服务、换机器这三个节点各过一遍；平时配完新条目，顺手对一眼对应的那条即可。
• 密钥已经提交过公开仓库，还能补救吗？：能，动作要快：立即作废该密钥、签发新密钥、检查泄露窗口期的用量，再清理仓库历史或弃用仓库。
• 八条里哪条最优先处理？：密钥入库排第一，损失直接且难撤回；其余七条影响效率与安全垫，按现场风险排序处理。