开始使用

安装

从 keykeeper.dev 下载 DMG，把 KeyKeeper 拖进「应用程序」打开，它住在菜单栏里。 Apple Silicon，macOS 14 或更新；已签名并公证。在 App 的「设置 → 命令行」里一键装好 keykeeper 命令。

告诉你的 Agent

Codex 和 Claude Code 通过 skill 认识 KeyKeeper：把 skill/keykeeper.md 给它，或者直接说「API key 用 KeyKeeper」。之后任务缺 key 时，Agent 会走 KeyKeeper 的流程，而不是让你把 key 粘进聊天。

第一把 key

说你要做的事——「帮我接 Stripe 退款」。Agent 找到 Stripe 的模板，替你打开创建 key 的页面，告诉你该选什么。 你登录、复制。弹出一个窗口：

• 存为 stripe · stripe-api-key
• 服务商 Stripe——保存后会向 api.stripe.com 发一个只读请求验证
• 声明用途 Agent 说这把 key 是用来做什么的

点保存。KeyKeeper 把 key 存进钥匙串，向 Stripe 验证，Agent 接着干活。整个过程它没见过值。

已经有 .env？

keykeeper import ./.env --id my-app

KeyKeeper 会把找到的变量名列给你看，批准后所有导入值都进入钥匙串，包括普通设置，避免把密钥误判成明文。 之后用 keykeeper run -c my-app -- npm run dev 注入。空值、保留变量和不支持的变量名会跳过；格式不完整或多行值会拒绝导入，不执行变量/命令展开。先核对跳过项并验证项目跑通，再自行删除原文件；明文躺过的 key 建议轮换。

第一次授权

Agent 运行需要这把 key 的命令时，授权窗会显示谁在请求、它说自己在做什么、以及 KeyKeeper 自己的一句话结论。 你回答仅这一次、这次运行期间或以后都不问。见授权。