装上 Stroq:给 Claude Code / Cursor 加一层本地防火墙
原创
少年义气
少年义气
少年义气
2026年11月9日 15:26
广东
去阅读
你天天用 Claude Code、Cursor、Codex 这类 AI 编程 Agent(能自己读文件、跑终端、改仓库的自动助手)干活,省事也吓人:它可能把 .env 里的密钥读出来,再通过 curl 发出去;也可能被 Issue、README、MCP 返回里的提示词「带偏」,去跑一条你没仔细看的危险命令。ChatGPT 只能聊,拦不住本机动作;Cursor 本身是干活的,不会在动作执行前替你当门卫。
Stroq 就是干这件事的。它是装在你电脑上的 本地 Agent 防火墙 + 审计工具:先扫近 30 天会话,看有没有密钥被发出去(只打印变量名,不打印值);再给 Agent 装上本地 hooks(钩子:动作真正执行前拦一把),拦住携带已知密钥的外发、可疑的 curl|sh 等。官网 https://stroq.dev/ ,源码 Apache-2.0:https://github.com/AGGIB/Stroq 。需要 Node.js ≥ 22。
一、先白话讲清:Stroq 是什么?
一句话
Stroq 不是又一个写代码的 Agent,也不是要替代 ChatGPT 或 Cursor。它是本机防护层:在动作执行前按策略拦截风险,事后给你审计与控制台;数据不出本机、无遥测。
解决什么
1、担心 Agent 读了 .env / 环境变量后,把密钥带到外网请求里。
2、Agent 会读 Issue、README、网页、MCP 工具结果——里面可能夹着「请执行某某命令」的提示词注入。
3、想事后查清:某次会话里,哪条命令是从哪段内容「带出来」的,为什么被拦。
和 ChatGPT、Cursor 差在哪
· ChatGPT:网页/App 聊天;可以讨论安全,但不会拦截你本机 Agent 的真实动作。
· Cursor / Claude Code / Codex:干活的 Agent;负责读改跑,默认不会在外发密钥或危险 shell 前替你做确定性策略拦截。
· Stroq:补的是「动作执行前的本地防火墙 + 事后审计」——不替代写代码,不上传遥测;策略在本机跑,热路径不联网、不调模型。
读完你能做到什么
会用一行命令审计本机会话;会 init 给常用 Agent 装 hooks;会开本机控制台看决策;会用 doctor / sent / why 自检;并清楚它拦什么、不拦什么。
二、安装启用
先确认本机 Node.js ≥ 22(终端里 node -v 看一下)。建议在项目目录里操作。
步骤 1:先扫一遍近 30 天会话(只读审计)
不改任何配置,先看有没有密钥曾被发出去。输出只打印密钥名称(例如 STRIPE\_SECRET\_KEY),不打印真实值:
npx @stroq/cli
想只看「发出去」相关记录,可再跑:
npx @stroq/cli sent
步骤 2:给 Agent 装本地 hooks
在项目目录执行(默认会按本机已装的 Agent 写入 hooks;--dry-run 可先预览不落盘):
npx @stroq/cli init
装完后重启对应的 Agent(Claude Code / Cursor / Codex 等),hooks 才会生效。
指定某一种 Agent 时,例如:
npx @stroq/cli init --agent cursornpx @stroq/cli init --agent codex
步骤 3:自检是否装对
npx @stroq/cli doctor
步骤 4:打开本机控制台(可选)
npx @stroq/cli console
浏览器会打开仅本机可访问的页面(127.0.0.1),看实时决策与审计;无账号、无遥测。
三、关键命令
审计与溯源
· npx @stroq/cli:扫描近 30 天本机会话,查密钥是否被发出。
· npx @stroq/cli sent:聚焦「外发」相关记录。
· npx @stroq/cli why:解释某次拦截/询问的原因(哪条规则、证据从哪来)。
· npx @stroq/cli replay:按会话回放,便于复盘。
策略自测(本机回放,不是教你攻击别人)
· npx @stroq/cli attack:用内置的已知风险场景回放你的策略,看哪些会 deny、哪些会 ask;用来检验策略是否生效,不要拿去害人。
策略文件
默认策略可复制到 ~/.stroq/policy.yaml 再改。核心思路是:密钥外发直接 deny;部分破坏性命令会 ask(问你一句)而不是静默放行。热路径不做模型判断、不联网。
四、适用边界与常见坑
1、要 Node.js ≥ 22:版本不够时先升级,再跑 npx。
2、init 后要重启 Agent:hooks 写进配置后,旧进程不会自动带上。
3、先 dry-run 再落盘:不熟时用 npx @stroq/cli init --dry-run 预览改了哪些文件。
4、只护本机动作路径:它拦的是 Agent 经 hooks 走的工具调用;你自己在普通终端里手动敲的命令,不在这层防护里。
5、内容扫描有边界:官方也写明,基于规范化文本的规则扫描可被绕过——所以真正卡口在「动作执行前」。别把它当成绝对保险。
6、误杀时看 why:某条命令被拦,先 why 看规则与证据;确认是误报再按文档用显式命令放行,不要一上来关掉 hooks。
7、合规用法:本文只讲本机防护与自检;attack 仅用于回放策略,勿用于未授权测试他人系统。
读完你可以马上做的最小闭环
1、确认 node -v ≥ 22。
2、项目目录跑审计:
npx @stroq/cli
3、装 hooks,然后重启 Claude Code / Cursor / Codex:
npx @stroq/cli init
4、自检,可选再开控制台:
npx @stroq/cli doctornpx @stroq/cli console
跑通这一条,你得到的是「干活的 Agent 外面多了一层本地门卫」——ChatGPT 继续聊想法,Cursor / Claude Code 继续改仓库,Stroq 负责在危险动作真正执行前拦一把,并留下可查的审计。
版权声明
本站仅做备份收录,仅供研究与教学参考之用。
读者将信息用于其他用途的,全部法律及连带责任由读者自行承担,本站不承担任何责任。







评论