安全地管理 API key

为什么这很重要

一个 API key 就像一张信用卡：谁拿到它，谁就能拿着你的账单发请求。公开仓库会被自动扫描，找这类 key——攻击者和防护系统都会这么做。

规则一：绝不能放进代码、仓库或 prompt

key 不应该出现在源代码里，不应该进 git 仓库，也不应该出现在 chat prompt 里。本地的标准做法是：把 key 放进一个 .env 文件——再在 .gitignore 里加一条记录，确保它永远不会被提交。Anthropic 明确推荐的正是这套做法。

规则二：环境变量和 secret manager

在本地，你的程序应该从环境变量里读取 key。在生产环境，Anthropic 建议使用加密的 secret 存储（各云厂商提供的 secret manager），而不是 dotenv 文件。

规则三：定期轮换，限制权限

定期轮换 key（Anthropic 举的例子是每 90 天一次），为开发、测试、生产环境分别使用不同的 key，并且只给每个 key 完成任务所需的最小权限——这就是 OWASP 指南里的最小权限原则。

一旦泄露

立刻吊销并更换。只删除那个 commit 是不够的：GitHub 明确指出，泄露的 secret 必须先被吊销或轮换——因为 git 历史记录可能早就已经被克隆或缓存了。