AI Agent密钥管理避坑指南:Autopilot如何防止你的API Key泄漏进代码和提交
AI Agent密钥管理避坑指南:Autopilot如何防止你的API Key泄漏进代码和提交
让 AI Agent 帮你写代码很方便,但新手最容易踩的安全坑只有一个:API Key 泄漏。你在聊天里随手贴出的 Stripe 密钥、GitHub Token、数据库连接串,可能被 Agent 原样写进代码、文档甚至提交记录里。本文以 Autopilot 为例,讲清楚 AI Agent 密钥管理该怎么防、Autopilot 又是如何做到"密钥进不了代码和提交"的。
Autopilot 是一个面向 Claude Code、Cursor、Codex 的 agent skill:你描述想做什么,它写规格、拆任务、写代码、验收交付,并自动打开一个实时进度面板。它的秘密处理规则写在 skills/autopilot/SKILL.md 的 Secrets 一节,约束所有阶段。
先看清坑:API Key 是怎么泄漏的 🔍
用 AI Agent 搭建项目时,密钥泄漏通常走这三条路:
| 泄漏路径 | 发生了什么 |
|---|---|
| 聊天粘贴 | 你把 Key 贴进对话,Agent 把它当"需求描述"写进了 .md 文件或代码注释 |
| 落盘入库 | 密钥进了项目文件,.env 又没加进 .gitignore,一次 commit 就进了仓库历史 |
| 提交留痕 | 即便后来删掉文件,git 历史里仍可随时翻出明文密钥 |
对非程序员用户来说,这三步往往毫无感知——所以防御必须内建在流程里,而不是靠人记住"别贴密钥"。Autopilot 的做法是:把密钥当成横切规则,贯穿整个构建流程的四个环节。
Autopilot 的四层密钥防护机制
第一层:从源头起就不向你要密钥
Autopilot 的规则写得很直白:"Never request one."(SKILL.md)。
它会问"收款用 Stripe 还是 PayPal?你在那里有账号吗?",但永远不问"把你的 Key 发给我"。这条原则同样约束提问环节(phases/2-briefing.md 中的 "Decisions, never secrets"):问的是决策,不是秘密。
代码里出现的只有变量名——比如 STRIPE_SECRET_KEY、TELEGRAM_BOT_TOKEN,值由你自己填进 .env。
第二层:入口脱敏(Redaction Gate)——密钥落盘前被拦截
这是 Autopilot 最关键的机制:任何你的文本——需求描述、问答回复、粘贴的片段——在写进文件、提示词或面板之前,先过一道脱敏门,规则见 phases/1-manifest.md。
它识别的密钥形态包括:
- Stripe / OpenAI 风格:
sk-…、sk_live_…、pk_live_… - GitHub:
ghp_…、github_pat_… - AWS:
AKIA…、ASIA… - Google:
AIza…、ya29.… - Slack:
xoxb-…、xoxp-…;Telegram Bot Token;JWT(eyJ…) - 数据库连接串、
-----BEGIN … PRIVATE KEY-----私钥 - 兜底规则:紧跟
key/token/secret/password等词的 32 位以上十六进制或 base64 串
命中之后会发生四件事:
- 值被替换为
[REDACTED:STRIPE_SECRET_KEY]这类占位标记; - 变量名自动写入
.env.example(空值); - 用一句人话提醒你:这个 Key 已经进了聊天记录,建议吊销并重新签发;
- 绝不回显原值——连"我检测到的是不是这个"都不会打印出来。
首次 commit 之前,脱敏门还会对整个 .autopilot/ 目录再扫一遍,做双保险。
第三层:.env 存值 + .gitignore 阻断,密钥进不了提交
Preflight 阶段在创建任何其他文件之前就写好 .gitignore,至少包含 .env、.env.*(!.env.example 除外),见 phases/0-preflight.md。
也就是说分工非常明确:
.env:真实值,只存在你的本地,永远不进 git;.env.example:只有变量名和空值,随仓库提交,方便你和下一个接手的人知道要填什么;- 构建全程只按名字引用密钥,包括进度面板——面板的
emptyEnv只存名字,等待说明只写"在等什么",不写值(phases/0-instruments.md)。
交付报告里的"还需要你做什么"一节同样只列名字:「在 .env 里填 TELEGRAM_BOT_TOKEN、GOOGLE_SHEETS_ID」,见 phases/8-final.md——报告规则明确要求 Secrets — 只按名字(8-final.md#L131)。
第四层:代码审查把"密钥泄漏"列为必查项
审查提示词里有一条硬指标:代码、日志、错误响应、客户端 bundle 中不允许出现任何密钥值,只允许出现变量名,见 prompts/review.md。
涉及"密钥与秘密"的任务会被标记为风险任务,在并行构建的同时单独接受一次安全审查;最后整条分支还会再过一遍包含安全项的全量审查。安全类发现要么立即修复、要么写入报告,永远不允许被降级或丢弃。
万一你已经把 Key 贴进聊天了怎么办?
Autopilot 把"密钥已泄漏"定义为停止条件(stop condition):
- Agent 立即停下当前动作,用大白话告诉你哪类密钥出现在对话里;
- 通过
ap.py ask stop让进度面板同步显示"已暂停、在等你处理"; - 给你明确的建议:吊销这个 Key、重新签发——因为它已经"进过聊天记录",无论有没有落盘,都应视为已暴露。
这一步值得记进你的 AI 编程习惯里:密钥进过对话 ≠ 安全,轮换才是唯一解。Autopilot 只是把"停下来 + 提醒你轮换"变成了自动行为,而不是指望你事后自查。
在进度面板上确认密钥被正确处理 ✅
构建结束时,面板的 "Before you run it" 区域会列出还差哪些 .env 键(如 TELEGRAM_BOT_TOKEN、ANTHROPIC_API_KEY)——只有名字,没有值。你照单填进 .env 就能真实运行,这也是验证密钥流程是否闭环的最快方式。
构建进行中的状态(蓝色 = 构建中、橙色 = 等待你的回答)同样在面板上一目了然:
AI Agent 密钥管理清单:照着做就不踩坑
| # | 检查项 | Autopilot 的对应做法 |
|---|---|---|
| 1 | 不把 Key 贴进对话 | 从不索要密钥,只问用哪家服务 |
| 2 | 粘贴的文本先脱敏再落盘 | Redaction Gate 识别 10 类密钥形态 |
| 3 | .env 在首次 commit 前就进 .gitignore |
Preflight 最先写 .gitignore |
| 4 | 代码/日志/报告只出现变量名 | 按名引用 + 审查硬指标 |
| 5 | 密钥一旦进过对话就轮换 | 停止条件 + 面板同步暂停 |
动手前 1 分钟:安装与启动
在终端执行一行即可安装(需要 Node.js):
npx skills add nick-vels/skills --skill autopilot -a claude-code -g -y
然后在 AI Agent 中输入 /autopilot + 你的需求描述,构建开始时它会自动打开进度面板。更多用法见 README.md 的 "Keys, passwords and access" 一节。
相关规则都在哪看?
- 总规则(五条例外条款 + Secrets 一节):skills/autopilot/SKILL.md
- 脱敏门与密钥识别表:skills/autopilot/phases/1-manifest.md
- "只问决策,不问秘密":skills/autopilot/phases/2-briefing.md
.gitignore先行的仓库初始化:skills/autopilot/phases/0-preflight.md- 审查安全轴(密钥值零容忍):skills/autopilot/prompts/review.md
- 报告"只按名字":skills/autopilot/phases/8-final.md
一句话总结:API Key 泄漏不是"用户不小心",而是流程默认不挡。把"不问密钥、入口脱敏、.env 隔离、审查兜底"四步内建进 AI Agent 的工作流,才能让"描述一下想法、拿到一个能跑的项目"这件事真正安全。


