给 AI agent 一把代客钥匙，而不是你的万能钥匙。

agent 需要钥匙时，发生了什么

四步完成，秘密始终留在只有 root 能读的凭证库里。

1. agent 发出请求

   通过 MCP 说明要用哪个凭证、为了什么。

2. 你来批准

   Touch ID 弹窗显示凭证和这次授权放开的能力。逐次模式下显示真实请求——方法、域名、路径，以及已知 API 的关键业务字段——按一次，只授权这一笔。

3. KeyValet 代为调用

   root 进程注入 key，只发往你允许的域名，并抹掉响应里回显的秘密。

4. agent 拿到结果

   返回响应，记录会话、目的和结果。会话结束，授权随之失效。

万能钥匙与代客钥匙

把 key 写进 .env 或贴进对话，等于交出了万能钥匙。

认证的事交给它，agent 不用操心

agent 拿到的是短期 token 或代理后的响应。refresh token、私钥和种子都留在凭证库里。

• API key 与 token约 50 个现成模板（OpenAI、Anthropic、Gemini、GitHub、Stripe、Notion、Slack 等），以及通用的 bearer、header、query、basic 认证。
• OAuth 2.0浏览器登录（PKCE）、设备码、客户端凭证，自动刷新。支持 Google、GitHub、Microsoft 和任意 OIDC 服务。
• 给 SDK 用的本地网关把 SDK 的 base URL 指向 KeyValet（OPENAI_BASE_URL 风格），支持流式输出，程序拿不到真实 key。
• Google service account 与 GitHub App在凭证库内签名换取 token，agent 只拿到一小时有效的 token。
• AWSSTS 临时凭证、AssumeRole，并可用保存的 TOTP 种子完成 MFA。
• TOTP 与签名 JWT当前的两步验证码；按模板签发 App Store Connect 这类 JWT。

能找到的密钥，帮你收进凭证库

钥匙不会自己走进凭证库，所以 KeyValet 帮你把它们找出来。

• keyvalet scan在 .env*、~/.claude.json、.cursor/mcp.json、~/.codex/config.toml 和 shell 启动文件里找可能的密钥；勾选后按匹配模板导入为「仅代理」，并从原文件移除（留备份）。
• 编辑器 hookClaude Code、Codex、Cursor、Grok、Devin 的原生 hook 适配器：粘贴或硬编码进文件、命令行的 key 会被识别并引导进 KeyValet。
• 审计日志每次解锁、授权、读取、取 token、代理调用和配置修改都记录在只有 root 能读的日志里——秘密本身从不写入。

能保证什么，不能保证什么

凭证工具应该讲清楚自己的边界。完整的安全模型见 SECURITY.md，或本站的安全摘要。

安装

curl -fsSL https://keyvalet.dev/install.sh | sh

“用 KeyValet 的 openai 模板保存我的 OpenAI key。”
“用 KeyValet 列出我的 OpenAI 模型。”