密钥不要进 agent 的机器:用审批代理把 gh 和 SSH 留在本机
远程跑 Claude Code / Codex 时,把 gh 登录态拷进虚拟机,或用 ssh -A 无询问转发钥匙,都会把本机身份交给 agent 所在的环境。pico.sh 的 Antonio 在 2026-11-13 博文(2026-11-17 仍有更新)里公开了 lend:本机默认拒绝的策略加逐次审批,命令在笔记本上执行,远程只拿输出。本文按博文与 README 转述机制和作者自己写的限制(无沙箱、批了 shell 约等于批了一切、调用方可伪造),未安装或实测;并给出不装 lend 也能做的 5 步自查。

密钥不要进 agent 的机器:用审批代理把 gh 和 SSH 留在本机
远程跑 Claude Code 或 Codex,图的是这台机器可以扔掉。可一到要看 CI、提 PR、SSH 到别的主机,很多人还是把登录态一起拷过去。~/.config/gh/hosts.yml 里的 token,虚拟机上每个进程都能读,agent 和它拉起来的子进程也包括在内,而且在 token 有效期内一直能读。
另一种常见做法是 ssh -A 转发本机的 SSH agent。私钥不出笔记本,但虚拟机可以不经询问、也不留完整记录地使用 agent 里的每一把钥匙;而且它只覆盖 SSH,管不到已经登录的 gh 和云 CLI。
pico.sh 的 Antonio 在 2026-11-13 的博文 Running coding agents without handing them my credentials 里(页面标注 2026-11-17 仍有更新)把这个问题说清楚了,并公开了他写的开源工具 lend:在现有 SSH agent 前面加一层代理,把这个代理的 socket 转发给远程机器。远程的 agent 要跑 gh,请求打回本机,由本机策略决定允不允许,需要时用 Touch ID 批一次,命令在笔记本上执行,远程只拿到标准输出、标准错误和退出码。token 根本不离开本机。
这不是「装上就绝对安全」。作者自己在《What lend doesn't protect against》一节写了限制:已批准的命令不会被沙箱;你如果批准了 shell、解释器,或会从标准输入读指令的程序,约等于批准在本机跑任意代码;调用方信息来自虚拟机,可以伪造。本文根据他的博文和仓库 README 转述机制与限制,我没有在自己的机器上安装或实测 lend,也不提供「已经替你验证过」的截图。把它写成「从此密钥不会再泄露」,是在帮倒忙。
之所以值得写成一篇对照,是因为密钥一旦进了 agent 能读到、能记下来的环境,后面的防护都会变难。2026-11-13,Cursor 官方在 An update on our recent security incident 里写到:与 Fireworks 共享的只读存储里,有一部分非 Privacy Mode、主要用于训练的历史 coding agent traces(多数来自 2025 年)含有未被脱敏的凭据,不到 0.01% 的客户 API 凭据因此暴露。这是官方已披露的既有事故,不是今天的新料,也不是「全量用户密钥被拖走」。它提醒的是:对话和 traces 里可能留下密钥。和「干脆不要把登录态放进 agent 所在的那台机器」,是同一条线上的两步。前文 779《装了 AI 编程助手之后,你的电脑多了哪些「别人的手」》 讲的是本机 agent 配置被改写时该怎么自查;这篇补的是远程跑 agent 时,登录态该放在哪。
一、三种做法对照
按作者博文的划分,远程 agent 要「以你的身份做事」,常见路径就这三条:
| 做法 | 凭据在哪 | 远程实际拿到什么 | 主要风险 |
|---|---|---|---|
把 ~/.config/gh、云 CLI 登录态、甚至私钥拷进虚拟机 |
虚拟机磁盘 | 完整 token / 钥匙 | 机上任何进程都能读,有效期内可反复用,对话和 traces 也有机会记下 |
ssh -A 转发本机 SSH agent |
钥匙仍在本机 | 不经询问的签名能力 | 虚拟机可不经你确认、也不留完整记录地使用 agent 里每把钥匙;只覆盖 SSH |
| lend:本机策略 + 逐次审批,命令在笔记本上跑 | 钥匙和登录态都在本机 | 你批准之后的命令输出 | 批准范围一旦过宽(尤其是批了 shell),约等于把本机打开 |
lend 要解决的,不是「远程完全不能用 gh」,而是:用 gh 的是你的笔记本,远程只申请一次执行、拿走输出。作者自己的工作流是:多个 agent 跑在可扔掉的虚拟机里,笔记本只留 SSH 钥匙、1Password,以及已经登录的 gh 和云 CLI。lend 是补上「远程偶发需要本机能力」这一环,不是让你把整个开发环境搬回本机。
二、lend 实际在做什么
据作者博文和 仓库 README,lend 是现有 SSH agent 前面的一层代理。你转发的是它的 socket,而不是原始 agent 的 socket。SSH 和 Git 仍按原来的方式工作;与此同时,lend 通过 SSH agent 扩展,提供「在本机执行命令」这条路。
请求路径可以写成:
text
Remote: lend exec -- command args
|
forwarded SSH agent socket
|
Laptop: lend agent -> policy + local approval -> local command
-> original SSH agent (signing)
本机策略默认拒绝未列出的命令和钥匙。作者博文里的示例很短,核心是「只允许指定的 gh,审批方式为 biometric:inline」(Touch ID 直接做在请求对话框里,看完请求后按一次即可;单独写 biometric 则是先点 Allow,再弹出第二次 Touch ID):
json
{
"default": "deny",
"commands": [
{"executable": "/opt/homebrew/bin/gh", "approval": "biometric:inline"}
],
"ssh": {
"default": "deny",
"keys": [
{"fingerprint": "SHA256:...", "approval": "biometric:inline"}
]
}
}
规则还可以加 args_prefix,比如 ["pr", "view"],只允许部分子命令。据 README:前缀按完整参数匹配,["pr", "view"] 允许后面再跟参数;最长匹配前缀决定用哪条规则的审批方式;省略前缀等于允许该可执行文件的任意参数。可执行文件路径是绝对路径,加载策略和收到请求时都会按符号链接解析。策略改完要重启 agent 才生效。上面的指纹和路径都是作者示例,不能原样粘贴到你的机器上——本机路径用 command -v gh 查,钥匙指纹用 lend keys 在 SSH_AUTH_SOCK 指向原始 agent 时查看。
从笔记本连过去,作者用的是:
text
lend ssh --config ./policy.json -- agent-vm
它为这一次 SSH 连接启动代理,SSH 退出时代理也停。远程一侧,Claude Code 可以通过 lend mcp 这个 MCP 服务来请求本机执行。这个服务只暴露一个工具 run_local_command,必须同时给出要跑的命令和理由(reason 是必填的):
json
{
"mcpServers": {
"laptop": {"command": "lend", "args": ["mcp"]}
}
}
不想走 MCP,也可以在虚拟机上直接调用:
text
lend exec --reason "Read the repo description" -- gh repo view antoniomika/lend
据作者描述,本机对话框会列出:可执行文件的完整路径、全部参数、将在本机哪个目录运行、理由,以及远程进程自称的身份。你批准之后,gh 在笔记本上跑,标准输出、标准错误和退出码流回 agent。理由和调用方信息来自虚拟机,界面上会标成未验证——它们只是帮你判断的提示,不能扩大策略已经允许的范围。
三、策略里真正有用的几条
1. 默认拒绝,尽量写到子命令
「允许 gh」和「只允许 gh pr view」不是一回事。前者在 gh 还能改仓库、改权限、读更宽的 API 时,等于把登录态的能力几乎全打开了。README 的示例策略把 gh 写成 args_prefix: ["pr", "view"],把 op 写成 args_prefix: ["read"],就是这个意思。从「最小权限」看,宁可多写几条规则,也不要用一条「整个可执行文件都可以」。
README 还提到 --allow-all:启动时允许任意可执行文件、SSH 钥匙和支持的管理操作,但每次请求仍要审批。这只适合你临时排障,不适合当日常策略。规则里的 approval: none 更要小心:匹配到的请求不再弹窗,谁能碰到转发过来的 socket,谁就能发这类请求——README 写明,这和直接转发上游 SSH agent 是同一档信任;lend doctor 会对这类规则报警。
2. 密钥可以注入环境变量,但不要批准会把环境打印出来的命令
gh 之所以能用,常常是因为笔记本上已经登录过。有些工具必须把 token 塞进环境变量。据作者博文,命令规则可以通过 op read 一类的 secret reader,在批准之后把密钥注入给即将执行的那条命令:
json
{
"secret_reader": "/opt/homebrew/bin/op",
"secret_reader_args": ["read", "--no-newline"],
"commands": [
{
"executable": "/opt/homebrew/bin/gh",
"args_prefix": ["pr", "view"],
"approval": "biometric",
"secrets": {"GH_TOKEN": "op://Development/github/token"}
}
]
}
作者写得很清楚:token 留在笔记本;虚拟机不能挑选要设置哪些变量、要读哪一条引用;对话框里只显示变量名和引用,值不会出现在提示或历史里。接下来马上就是限制:如果你批准的是 env、sh,或批准 op 本身,输出会把密钥交回给 agent。换句话说,注入只在「被批准的命令不会把它的环境或 op read 的结果打印回去」时成立。
3. SSH 钥匙要单独写策略
未列入策略的钥匙,对虚拟机是隐藏的。已列入的钥匙,还可以限制允许签名的用途,并用 max_signatures 限制一次会话里最多签几次。这是相对 ssh -A 最关键的差别:不是「agent 里有什么,对面就能用什么」。
4. 租约不是「批一次就一直放行」
规则可以在你批准时给出租约,例如五分钟或三次。据作者博文:租约只存在于一次 lend ssh 会话内部,而且只匹配你批准过的那条精确命令和参数;会话结束或屏幕锁定,租约就失效。它解决的是「连续几次同样的 gh pr view 不要反复按指纹」,不是给你开一个短期的万能通道。
四、用之前要知道的运行约束
这些不是细枝末节,漏掉会误判「已经安全了」或「怎么突然不能用了」。
两边都要装,先跑 doctor。 笔记本和远程主机都要安装 lend。官方提供 Homebrew(brew install antoniomika/tap/lend)和 GitHub Release 的 install.sh。README 写明:安装脚本会按系统和架构取值,校验归档的 SHA256,校验通过后才替换二进制;不使用 sudo,也不改 shell 配置。Release 页面另有归档和 checksums.txt,也可以手工核对后再装。不要把「curl 到 sh」理解成可以跳过校验。装完后,本机用 lend doctor --config ./policy.json 检查策略能否解析、配置的可执行文件是否存在、上游 agent、审批后端等;远程在转发 socket 之后用 lend doctor --remote 确认对面真的是 lend,而不是普通的 SSH agent。据 README:doctor 不会执行你配置的工具、不会取密钥值、不会发起签名或弹出审批框。
平台和交互能力有边界。 作者和 README 都写了:目前是 macOS 与 Linux;macOS 发行版二进制的原生审批要求 macOS 13 或更高。Linux 上的审批是 Zenity 对话框或终端提示,生物识别审批只在 macOS 上可用。lend 不分配 PTY,交互式程序走不通。它仍是早期项目,不要按「已经打磨完的生产网关」来预期。
转发的 socket 跟 SSH 连接走。 作者用固定路径的符号链接,在远程 ~/.ssh/rc 里指向当前连接转发过来的 socket,避免 herdr 这类会在 SSH 断开后继续活着的会话还握着旧路径。更关键的一句是:笔记本到虚拟机的 SSH 连接必须保持;断开期间请求会失败,重连是一次新的 lend 会话,审批和租约都要重来。
lend approve 和 lend exec 不是一回事。 agent 还会问一些与本机凭据无关的问题,例如在虚拟机上跑一条 shell、改一个文件、拉一个 URL。lend approve 只是把这些问题送到本机同一套对话框,并不在笔记本上执行任何东西,回答打回给 agent 自己决定。作者给 Claude Code 配的是远程的 PermissionRequest hook。笔记本连不上时,hook 会让开,agent 仍在自己的界面里询问。不要把「本机点过一次允许」理解成「这条命令已经在本机跑过了」。
另外,lend status --all --watch 可以看到连接、等待中的请求、正在跑的命令和有效租约;lend pause --all 会取消进行中的请求并拒绝新请求,直到你恢复;lend history 默认记录跑过什么、如何批准,但默认去掉参数、输出和密钥,需要的话再打开参数记录。
五、作者写明的限制(请先看完再决定要不要装)
下面这几条直接摘自作者博文的限制节,以及 README 里对信任边界的说明。不是我补充的「谨慎使用」套话。
- 批准等于在本机以你的用户身份执行,lend 不做沙箱。 审批只决定「能不能跑」,不限制跑起来之后能摸哪些文件。
- 批准 shell、解释器,或任何从标准输入读指令的程序,约等于批准在本机跑任意代码。 标准输入是在批准之后才开始流式传入的,对话框里看不到后面要进来的内容。
- 对话框里的调用方信息来自虚拟机,可以伪造。 它只能当提示,不能当身份证明。
- 谁能碰到虚拟机上转发出来的 socket(包括 root),谁就能在会话仍然打开时发起请求。 策略仍然限制他们能申请什么,每次请求也仍要你批;但这意味着 socket 暴露面就是攻击面。会话开着、策略又过宽时,这层面会迅速变薄。
- 密钥注入挡不住「你批准了一条会把秘密打印回去的命令」。 见第三节。
所以,lend 比起「把 token 拷进虚拟机」和「无询问的 ssh -A」,换来的是:凭据不出本机、默认拒绝、逐次可见、钥匙可过滤。它换不来的是:你点了允许之后的执行被关在笼子里,或远程声称「我是谁」一定是真的。作者在 Prior art 里也写了,ssh-rev-exec、op-forward 是相近方向的前作;lend 是另一套实现,加上了逐次策略、本机审批和钥匙过滤。不必把它神化成唯一方案。
六、就算不装 lend,也可以先做的 5 步自查
不是每个人都要在今天引入一个早期工具。下面这份清单不依赖 lend,做完就已经能避开最常见的漏法。
- 清点 agent 所在机器上的登录态。 看
~/.config/gh/、云 CLI 配置目录、~/.ssh/里有没有从笔记本拷过去的 token 或私钥。有就撤掉,改在本机执行需要身份的命令。有效期内的 token,按各平台文档轮换,不要只删文件。 - 不要把
ssh -A当成「钥匙已经留在本机,所以足够安全」。 钥匙不出本机,只说明私钥文件没落地;签名能力仍然在对面。若必须转发 agent,至少要清楚:对面能用哪些钥匙、有没有询问、有没有记录。 - 检查 agent 能否读到、能否写进对话里的密钥。 提示词、
.env文件、调试输出、CI 日志,都是常见来源。Cursor 官方事故里的那批 traces,问题正在「历史会话里有未脱敏凭据」。能不出现在会话里的,就不要贴进去。 - 给本机工具开权限时走最小集。 需要
gh pr view就不要默认给出全部gh;需要读某个仓库目录,就不要把整个家目录或完整登录态交给远程环境。前文 779 的配置自查,和这一条是同一思路:先看它实际拿到了什么,再决定留不留。 - 若你决定试 lend,先写默认拒绝的短策略,再跑 doctor,不要从
--allow-all或approval: none开始。 并且明确一条红线:不批准 shell、解释器、env,以及 secret reader 本身。试的时候以作者文档和lend doctor的输出为准,本文不做安装验收。
小结
- 远程跑可扔掉的 agent 时,把
gh登录态和 SSH 钥匙拷进虚拟机,等于让机上每个进程都能读这些凭据;ssh -A让钥匙不出本机,但对面可不经询问地签名,且只管 SSH。 - 据 Antonio 2026-11-13 的博文(2026-11-17 仍有更新),lend 把命令接回本机:默认拒绝的策略、可选的 Touch ID 审批、远程只拿输出。Claude Code 可通过
lend mcp的run_local_command(必须写理由)或lend exec发起请求。 - 策略要写到子命令和具体钥匙;密钥可用
op read注入且不出现在提示或历史里,但批准env/sh/op本身会把值送回 agent。 - 作者写明的限制必须一起看:无沙箱;批了 shell 约等于批了一切;调用方信息可伪造;能碰到转发 socket 的人都可以发起请求。目前支持 macOS 与 Linux,不分配 PTY,生物识别审批只在 macOS 上可用。
- 本文只转述公开博文和 README,未在本机安装或实测。先看第五节的限制,再做第六节的自查,然后决定要不要引入这个工具。
参考来源
- Antonio,Running coding agents without handing them my credentials(2026-11-13 发布,页面标注 2026-11-17 更新):https://blog.antonio.cx/running-agents-with-lend
- antoniomika/lend 仓库与 README:https://github.com/antoniomika/lend
- Cursor,An update on our recent security incident(2026-11-13):https://cursor.com/blog/security-incident-update
- 本站前文:779 装了 AI 编程助手之后,你的电脑多了哪些「别人的手」