文章摘要
hush是专为AI代理打造的密钥安全存储工具，杜绝代理接触密钥明文。其特点是密钥不从标准输出，无直接获取接口。介绍了快速上手、本地安装、使用示例等信息，还提示它无法抵御本地恶意进程攻击，需做好本地备份。采用MIT开源许可证。

一款专为AI代理打造的密钥安全存储工具，核心设计原则是彻底杜绝代理接触到密钥明文。

该工具的核心特点是：密钥明文永远不会输出到标准输出流，不会出现在工具返回结果、对话转录或者任何云端存储中。密钥只会从本地安全存储直接传递给使用它的程序，工具本身完全没有提供直接获取密钥的接口——因为直接的获取接口恰恰是最容易导致密钥泄露的隐患。

使用场景非常清晰：当AI代理以用户身份运行时，本身已经拥有调用服务、设置服务器密钥的权限，但却无法直接查看密钥明文，否则会导致密钥泄露到对话中。这款工具可以帮助用户将密钥一次性存入系统本地的安全密钥链，之后AI代理可以直接将密钥注入到需要的命令中，全程无需手动粘贴密钥、不会产生临时文件，也不用担心不小心提交配置文件到代码仓库。

AI代理快速上手

如果你是首次接触这款工具，首先需要完成基础安装并按照指引完成配置。将工具脚本部署到运行环境后，可以参考官方文档完成全套入门流程，文档涵盖了密钥存储、生成、注入以及如何在项目中集成该工具的全部内容。

这款工具的核心脚本是一个独立的bash文件，你可以将它放置在代理加载工具的目录中，或者直接添加到系统PATH环境变量中，基础部署命令如下：

git clone 仓库地址
chmod +x hush/hush
# 将hush脚本添加到PATH，或者移动到代理的工具目录

如果你使用的是Mac或Linux系统，也可以直接通过包管理工具快速运行，无需克隆仓库。Windows用户建议通过克隆仓库的方式部署，因为当前的脚本依赖bash环境运行。

如果你使用Claude Code，可以直接将仓库克隆到技能目录中，实现自动加载：全局会话可以克隆到系统技能目录，单项目则可以克隆到项目专属的技能目录。其他AI代理工具可以参考对应的集成文档完成配置。

整个流程非常简单：当人类用户需要提供密钥时，只需要运行hush set <密钥名称>，此时会弹出一个隐藏的输入对话框，只有人类用户能看到并输入密钥，AI代理完全不会接触到密钥明文。

本地安装说明

安装方式和AI代理的部署流程基本一致，可以直接克隆仓库，也可以直接下载单个脚本文件并添加到系统PATH中。

工具内置了多平台的密钥存储后端：MacOS系统使用自带的钥匙串服务，Linux系统使用libsecret工具，Windows系统则通过PowerShell使用DPAPI加密服务。其他平台可以参考文档，按照系统标准的密钥存储协议完成适配。该工具已经在主流操作系统的持续集成环境中完成了跨平台测试，覆盖了Mac、Linux和Windows三大平台。

快速使用示例

以下是常用的操作命令示例：

# 通过隐藏对话框输入密钥并存储
hush set my-vendor-token
# 通过管道传输密钥，适合脚本和CI场景，密钥不会出现在命令行参数中
printf '%s' "$TOK" | hush set my-vendor-token
# 生成并存储一个随机的密钥
hush mint app-operator-key
# 将密钥注入到命令中执行，密钥明文不会输出到任何地方
hush run TOKEN=my-vendor-token -- 你的业务命令
# 列出当前存储的所有密钥名称，不会泄露任何密钥明文
hush list

关于密钥命名：建议使用默认的命名空间，并按照项目前缀来命名密钥，比如blame-cf-token、lifescored-gemini-key，这样可以通过密钥链的hush前缀快速检索到所有相关密钥。专用的环境变量仅用于创建完全独立的密钥存储，不建议用于项目隔离。如果需要修改已有的密钥名称，可以使用重命名命令，该操作会在内部完成密钥迁移，不会重新要求输入密钥，也不会泄露任何明文信息。完整的文档和可移植的使用协议可以参考官方文档。

重要安全提示

需要明确的是，这款工具并不是一个绝对安全的保险箱：任何拥有该机器shell访问权限的代理都可以读取和修改存储的密钥，因此它无法抵御针对本地机器的恶意进程攻击。它的核心价值是防止密钥明文泄露到对话转录、工具返回结果或者云端存储，让“一次存储、多处注入”成为安全便捷的操作流程。

另外，该工具的安全性依赖于本地机器的密钥存储服务，因此请务必做好本地机器的备份，或者将密钥同步到专业的密钥管理服务中，不要将这款工具作为不可重建密钥的唯一存储介质。本工具采用MIT开源许可证。

塔猴是一个专注于为用户提供系统学习、内容创作与商业连接的AIGC综合服务平台，致力于为每一位AI探索者打造理想的创作、成长家园。在塔猴，你不仅可以学习众多AIGC类实战课程，获得与时俱进的AIGC技能和视野，还有机会获得长期商业合作和接单机会！点击进入：https://www.tahou.com/

AI生成内容提示：本文由人工智能辅助创作，内容仅供参考，不代表平台观点。请注意核实信息的准确性，并理性判断。

以上内容不代表本平台立场，仅供读者参考