装上Stroq:给ClaudeCode/Cursor加一层本地防火墙

admin 2026-11-22 02:56:13 网络安全文章 来源:ZONE.CI 全球网 0 阅读模式

装上 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 负责在危险动作真正执行前拦一把,并留下可查的审计。

    评论:0   参与:  0