返回资讯中心
外部精选
软件工程
#开发者实时流

开源工具 Cloak 在 AI 编程助手与模型 API 间做本地代理,脱敏密钥和 PII

来源标题:AI Privacy Cloak

Cloak 是一个运行在本地的代理,位于 Claude Code、Cursor、aider、Codex CLI 等 AI 编程助手与模型服务商 API 之间,在数据离开本机前对密钥和个人信息(PII)做脱敏,并在返回结果中透明还原。项目目前处于早期 MVP 阶段,尚未发布,需 Go 1.23+ 从源码构建。安装只需几条终端命令,无需配置文件,也不涉及自有 API 密钥或账号。

Hacker News 最新miloshke2026/11/22 · 今天30 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

一个本地代理,位于 AI 编程代理(Claude Code、Cursor、aider、Codex CLI 等)与模型提供商的 API 之间,在数据离开你的机器之前对密钥和 PII 进行脱敏——并在响应中透明地将其还原。 状态:早期脚手架 / MVP 开发中。尚未达到生产可用。名称暂定。 这是开箱即用,还是需要配置?只需在终端执行几条一次性命令,之后它就隐形了。无需编写配置文件,cloak 本身也没有 API key 或账户——cloak install 会检测你的 shell,并写入一个你的代理已经知道如何读取的环境变量(ANTHROPIC_BASE_URL,或你所使用提供商对应的等效变量),cloak serve(或 cloak service install,用于在重启后依然存活的服务)将其启动,此后你就像以前一样正常使用 Claude Code / Cursor / aider。唯一持续的交互是 cloak toggle/enable/disable,用于在你想要关闭脱敏但又不想让代理失去连接时使用。完整步骤见下文。 目前尚未发布任何内容——请从源码构建。需要 Go 1.23+。 go build -o cloak ./cmd/cloak 从第 3 步开始的所有操作,请使用真正的构建产物,不要用 go run——go run 会编译到一个临时的临时二进制文件,而 cloak service install 需要一个稳定的路径以便在登录时重新启动。 cloak 一次代理一个提供商的 API:anthropic(默认)、openai 或 gemini。这会将正确的环境变量写入你的 shell 配置文件: ./cloak install # 仅预览——试运行,不写入任何内容 ./cloak install -yes # 将 ANTHROPIC_BASE_URL=http://127.0.0.1:8787 写入例如 ~/.zshrc 如需使用其他提供商: ./cloak install -provider openai -yes # 写入 OPENAI_BASE_URL ./cloak install -provider gemini -yes # 写入 GOOGLE_GEMINI_BASE_URL——请确认你的代理确实支持该变量,它不如另外两个通用 然后重启你的 shell(或 source ~/.zshrc),以便新的终端会话读取到该变量。 选择前台运行(最简单,终端关闭即停止)或后台运行(重启后依然存活): ./cloak serve # 前台运行,anthropic,监听 127.0.0.1:8787 ./cloak serve -provider openai ./cloak service install -provider anthropic # 后台:launchd(macOS)/ systemd --user(Linux)/ 登录 Run 键(Windows) ./cloak service status ./cloak service uninstall 无论哪种方式,一旦它运行起来,就像平常一样使用 Claude Code / Cursor / aider——请求在发出时被脱敏,在返回时被还原,你的工作流程无需任何改变。 ./cloak protection-status # 当前是否正在脱敏? ./cloak disable # 流量仍然通行,只是不脱敏——代理永远不会失去连接 ./cloak enable ./cloak toggle # 切换当前状态 5. 可选:菜单栏 / 系统托盘开关 go build -o cloak-tray ./cmd/cloak-tray ./cloak-tray # 显示托盘图标,每 3 秒轮询状态,点击即可切换 cloak-tray 不会启动或停止 cloak serve——它是与第 4 步相同的控制 API 上的一个轻量 GUI 客户端,因此只有在 cloak 已经运行时它才有实际作用。 ./scripts/package-macos.sh # -> dist/macos/cloak-tray.app, dist/macos/cloak-VERSION.dmg brew install makensis # 一次性安装,用于 Windows 安装程序 ./scripts/package-windows.sh # -> dist/windows/cloak-setup-VERSION.exe macOS:默认不签名,但如果设置了 CLOAK_SIGN_IDENTITY 和 CLOAK_NOTARY_PROFILE(一次性 Keychain 设置,脚本顶部有文档说明),package-macos.sh 现在会对真实构建进行签名 + 公证——配置完成后打开时完全不会有 Gatekeeper 警告。 Windows:仍未签名,尚未拥有代码签名证书——SmartScreen 会在首次运行时发出警告。传统证书每年约 200-500 美元,通常需要企业验证;微软较新的 Trusted Signing(基于 Azure,按使用量付费)值得作为更便宜的选项加以考察,但请直接核实当前定价/资格,因为它之前有过变化。尚未接入 package-windows.sh,因为还没有证书可用于签名。 ./cloak bench # 泄漏语料基准测试:捕获率 + 延迟 ./cloak protection-status # 确认脱敏已开启 最直接的检查:将 -upstream 指向一个只会回显所收到内容的东西(一个裸的 nc -l <port> 监听器即可快速查看,无需任何设置),并通过 cloak 发送真实流量——你读到的是实际离开进程的字节,而不是信任日志。 默认关闭——除非你要求,cloak 不会向磁盘写入任何内容。向 serve 或 service install 传入 -audit-log <path>,即可获得本地、仅追加的 JSON-lines 格式的每次脱敏记录: ./cloak serve -audit-log ~/.cloak/audit.jsonl tail -f ~/.cloak/audit.jsonl 每一行是 {"time", "session_id", "kind", "placeholder"}——何时、哪个对话、以及什么类型(AWS_ACCESS_KEY、EMAIL 等)。它绝不包含触发脱敏的真实值,也不包含占位符到该值的映射——这一点由一项测试验证,该测试断言植入的密钥绝不会出现在日志文件的任何位置。在 macOS/Linux 上,该文件以 0600(仅所有者)权限创建——在 Windows 上,chmod 风格的权限位不会映射到真实的 ACL(已通过 Windows CI 任务确认:无论请求什么,文件都会以 0666 返回),因此那里的隐私目前依赖于用户配置文件目录自身的默认 ACL 继承,而非显式的仅所有者锁定。实践中范围有限(标准的单用户 Windows 机器已经将配置文件目录限制为该用户),但在共享 Windows 机器上依赖此功能之前值得了解。 ./cloak service uninstall # 如果你将其作为后台服务运行过 然后从你的 shell 配置文件中删除 cloak install 添加的 export ANTHROPIC_BASE_URL=...(或 OPENAI_BASE_URL/GOOGLE_GEMINI_BASE_URL)行——它上方有清晰的 # added by cloak install 注释标记。

(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →