用手机批准 Claude Code 和 Codex
pushward agent 接入 Claude Code 和 Codex。离开电脑后,代理的权限请求或问题会以卡片形式出现在锁定屏幕上。轻点一下,会话就继续进行。pushward agent 接入 Claude Code 和 Codex。离开电脑后,代理的权限请求或问题会以实时更新的形式出现在通知栏中。轻点一下,会话就继续进行。
手机旁边的终端里运行着 Claude Code:Claude 请求运行 bun run test,卡片到达手机并获得 Allow,测试通过,在同一张卡片上回答三个问题,然后收到完成通知。
brew install mac-lucky/tap/pushward
pushward agent install claude
pushward agent install codex
pushward auth loginscoop bucket add maclucky https://github.com/mac-lucky/scoop-bucket
scoop install maclucky/pushward
pushward agent install claude
pushward agent install codex
pushward auth login在 Windows 上,钩子需要 Claude Code 2.1.295 或更高版本。
工作原理
-
安装钩子
pushward agent install 会把钩子添加到 Claude Code 或 Codex,并保留您已有的钩子。在 Codex 中,用 /hooks 信任一次即可。
-
离开座位
在 macOS 和 Windows 上,您使用电脑时,请求会留在终端中,不会发送任何内容;在 Linux 上以及通过 SSH 连接的 Mac 上,则是您在代理所在的终端中打字时。90 秒没有输入后,钩子会认为您已离开。
-
在手机上回答
您的轻点会传回会话,就像在终端中回答一样。25 分钟内没有回答,请求会回到终端。
手机上会收到什么


您在电脑前时,不会发送任何内容
发送任何内容之前,钩子会检查您在过去 90 秒内是否使用过电脑。如果在请求还在手机上等待时回来,卡片会结束,请求回到终端。
macOS
读取键盘和鼠标闲置了多久。通过 SSH 时,改为读取代理所在的终端,和 Linux 一样。
Windows
同样读取键盘和鼠标的闲置时间。通过 SSH 时没有可读取的内容,因此每个请求都会发到手机。
Linux
读取代理所在的终端:在那里按下的键才算,滚过的输出不算。从 cron 运行的 claude -p 没有终端,因此它的请求会发到手机。
每部手机上的卡片
在 iPhone 上,卡片显示在锁定屏幕和灵动岛中,问题的位置显示为 1/3。PushWard for Mac 显示同样的卡片。在 Android 上,卡片是通知栏中的实时更新,顶部显示问题的位置。Android 最多显示三个按钮,因此第四个选项需要在 iPhone、Mac 或终端中选择。



Claude Code 和 Codex
Codex 的钩子无法记住规则,也无法提问,因此有些功能只适用于 Claude Code。
| Claude Code | Codex | |
|---|---|---|
| 带 Allow 和 Deny 的权限请求 | 是 | 是 |
| Always 或 This session | 是 | 否 |
| 同一张卡片上的问题 | 是 | 否 |
| 完成提醒,以及留在终端中的请求 | 是 | 是 |
| 计划审阅和后台会话 | 是 | 否 |
| 钩子文件 | ~/.claude/settings.json | ~/.codex/hooks.json |
哪些内容会离开您的电脑
命令、文件路径或问题会作为卡片的文字发送到 PushWard,和其他任何活动一样,而活动不是端到端加密的。从 CLI 1.9.0 起,看起来像密钥或密码的值会先被替换为 ***。这能拦住明显的那些,但不是所有机密。
curl -fsSL https://raw.githubusercontent....strap-runner.sh | sh在 CLI 中设置了加密密钥后,备用通知和提醒都会加密。它们的按钮不会加密,Claude 问题的选项会作为按钮标签发送。
钩子需要个人密钥。在卡片送达的任何设备上轻点 Allow 都会运行命令,因此使用组织的密钥时,它们不会发送任何内容。
在锁定的 iPhone 上,卡片上的每个按钮都会先要求面容 ID 或密码,包括 Deny 和 Claude 的问题,因此任何拿着它的人都无法作答。您佩戴的 Apple Watch 只需轻点一下即可回答。
使用 CLI 1.9.0 或更高版本时,权限请求中的 Allow 和 Always,以及编辑文件后的 This session,会先要求解锁手机,因此拿着锁定手机的人只能拒绝。Deny 仍然只需轻点一下,Claude 的问题也是如此。
常见问题
终端需要一直开着吗?
需要。钩子在您电脑上的代理会话中运行,并在那里等待您的回答,默认 25 分钟。
claude -p 和计划运行也能用吗?
可以。只要您被视为离开,它们的请求就会发到手机,运行会等待回答。在 macOS 和 Windows 上,定时运行同样由键盘和鼠标决定:有人在使用电脑时,它的请求不会发出。用 PUSHWARD_AGENT_DESK=away 启动可始终询问手机,用 PUSHWARD_AGENT_DESK=desk 启动则不会等待。
卡片会计入我的实时活动配额吗?
会。每张卡片是一次创建加上每个问题一次更新。卡片结束一分钟后会被删除,因此请求不会在账户中堆积。
在真正的请求到来之前可以试一下吗?
运行 pushward agent test。它会在一张卡片上发送三个示例问题,并打印您的回答。
开始设置
安装 CLI,使用 App 中的个人集成密钥登录,添加钩子,然后运行 pushward agent test。
brew install mac-lucky/tap/pushward
pushward agent install claude
pushward agent install codex
pushward auth loginscoop bucket add maclucky https://github.com/mac-lucky/scoop-bucket
scoop install maclucky/pushward
pushward agent install claude
pushward agent install codex
pushward auth login在 Windows 上,钩子需要 Claude Code 2.1.295 或更高版本。
