如何用 AgentPager 在微信中遥控电脑上的 Claude Code、Codex 或 Cursor？

AgentPager 可以让用户在微信小程序中查看并继续电脑上的编程 Agent 会话，支持 Claude Code、Codex、Cursor 等命令行工具。电脑端运行开源守护进程，手机端负责会话展示、文字或语音输入、图片发送和完成通知，两端通过中继交换加密消息。安装并不复杂，但不能只执行配对命令就开始使用：当前默认命令审批档位会自动放行工具调用，配对手机实际上拥有驱动本机 Agent 执行命令和修改文件的能力。

因此，推荐流程是先创建隔离的开发环境并设置审批策略，再运行配对；完成后用一个无敏感数据的测试仓库验证连接、断线恢复和撤销方法。AgentPager 适合远程观察和有限干预，不应把手机变成不受限制的生产运维入口。

AgentPager 的工作方式

电脑上运行 AgentPager daemon，它负责发现本机已经安装的 Agent 命令行程序、启动或恢复会话、读取结构化事件，并把渲染状态发送给微信小程序。小程序发出的新指令也会经过 daemon 交给对应 Agent。代码仓库、工具执行、编译和测试仍发生在电脑上，手机不需要复制项目文件。

传输链路由手机、托管中继、电脑守护进程和 Agent CLI 四部分组成。项目说明称，daemon 使用配对派生的通道密钥密封每条会话消息，中继只转发密文信封，不保存可读对话。配对密钥只位于手机和电脑，电脑端配置目录和含密钥文件也设置了受限权限。

需要区分“会话正文”和“完成通知”。会话消息采用端到端加密，但为了让微信通知可读，任务完成推送会携带一小段经过敏感过滤和截断的请求摘要，这部分不是同样的端到端密文。涉及客户名称、未公开项目、漏洞或凭据时，应关闭敏感通知内容，或在任务首句避免出现机密信息。

电脑端 daemon 仓库使用开放许可证，但维护者托管的中继与微信小程序目前并未全部开放源代码。对一般个人开发，这是一个需要知情接受的信任边界；对受合规要求约束的团队，应评估自建中继、设备管理和日志保留后再部署。

使用前需要满足哪些条件

电脑需要 macOS 或 Linux 环境，并安装 Node.js 18 或更高版本。npx 随 Node.js 提供，可以直接下载并运行当前版本。电脑还需要至少安装一个受支持的 Agent CLI；守护进程会从 PATH 中自动探测，未找到时会给出提示。

Claude Code、Codex、Qwen、CodeBuddy 和 Cursor 当前属于结构化支持范围，工具调用、差异和思考事件可以用更完整的形式展示。Gemini 与 OpenCode 属于基础支持，能够运行，但部分事件只显示文本与工具名。移动端页面的细致程度因此会因 provider 不同而变化。

Codex 可以复用桌面应用或编辑器扩展附带的命令行程序和登录状态。Claude Code 与 Cursor 的桌面应用和 CLI 登录彼此独立；只安装桌面应用时，仍可能需要安装命令行版本并单独登录。部署前应在电脑终端直接运行目标 CLI，确认它本身能够进入会话，而不是把认证问题留到手机端排查。

手机需要能够使用微信小程序，并由用户本人控制。不要把配对码发到群聊、工单或截图中，也不要为同事临时共享自己的已配对手机。配对凭证不是普通的查看链接，它代表对电脑端 Agent 的控制权限。

先隔离再安装

最安全的部署方式是为远程 Agent 使用独立系统账户，或至少使用独立项目目录。该账户不应拥有系统管理权限，不应自动加载生产云凭据，也不应读取个人文档、浏览器数据和其他仓库。Agent 能做什么最终取决于 daemon 进程的操作系统权限，聊天界面上的提示不能替代系统隔离。

在测试仓库中确认版本库状态，并避免把真实密钥写入项目文件。若 Agent 需要访问开发服务，使用权限受限、可撤销的测试凭据。远程会话输出可能同步到手机，因此终端日志中也不能打印访问令牌、Cookie、数据库连接串或用户数据。

还要检查电脑的睡眠策略。daemon 能在后台运行，但电脑关机、合盖深度休眠或网络断开时，手机无法唤醒一个不可达的进程。长任务开始前接通电源，并设置不会在任务中途自动重启的更新窗口。

安装前先设置审批档位

AgentPager 提供 full、auto、ask、allowlist 和 deny 等命令审批档位。项目当前说明中，默认值是 full，也就是工具调用全部自动放行。这对无人值守执行很方便，但也是最危险的起点：一部已配对手机可以发出任务，而 Agent 可以进一步运行 Shell 命令、改文件或调用本地工具。

首次使用应选择 ask 或 allowlist。ask 适合希望逐项确认操作的个人用户；allowlist 适合已知项目，只允许测试、格式化、状态查询等明确命令。deny 可用于只读观察和验证连接。auto 与 full 的具体行为应以当前 CLI 帮助为准，在没有理解差异之前不要启用。

环境变量需要在启动 daemon 的环境中生效。可以先在当前终端设置审批档位，再进行配对：

export AGENTPAGER_EXEC_MODE=ask
npx @agentpager/cli@latest pair

配对成功后服务会转入后台。应立即使用管理命令确认实际运行状态和审批档位，而不是假设临时环境变量一定被后台服务继承：

npx @agentpager/cli@latest status
npx @agentpager/cli@latest exec

如果输出仍显示不符合预期的档位，先停止服务，按工具当前帮助配置持久环境，再重新启动。不要在安全策略尚未确认时发送真实开发任务。

电脑与微信如何配对

在电脑终端执行配对命令后，程序会显示配对码或可供扫描的信息。随后在微信中打开 AgentPager 小程序，扫描或输入该配对信息。完成后，小程序应显示电脑实例以及自动发现的 Agent。

npx @agentpager/cli@latest pair

配对码应像一次性密码一样处理。只在自己控制的屏幕与手机之间传递，不进行远程屏幕直播，也不要长期保存截图。配对完成后检查实例数量；出现未知设备、重复实例或意外会话时先停止 daemon，清理配对信息后重新建立关系。

首次测试不要直接打开重要仓库。创建一个临时目录，放入简单文本文件，让 Agent 完成读取、增加一行内容和显示差异三个动作。手机端应能看到工具调用和修改结果，ask 档位下还应出现清晰的审批流程。验证结束后检查电脑上的真实文件，确保移动界面与执行结果一致。

怎样遥控 Claude Code

先在电脑终端运行 Claude Code CLI 并完成登录，确认命令可以访问测试仓库。AgentPager daemon 通过 PATH 找到可执行文件；如果安装位置不标准，可以使用专门的可执行路径变量指定。路径必须指向可信的真实程序，不能指向可被普通项目文件覆盖的脚本。

Claude Code 支持工具调用和差异的结构化呈现。手机发出任务时，仍要明确工作目录、允许修改的范围、验收命令和禁止事项。例如要求只修改一个测试文件，不安装系统软件，不访问工作目录之外的位置。即使审批档位为 ask，也不能依赖用户在小屏幕上识别所有危险参数。

如果需要更强隔离，项目提供 Claude 沙箱开关。启用操作系统沙箱可以降低自动执行对系统其他目录的影响，但也可能阻止 Agent 写入工作目录外的缓存或工具目录。应先在测试项目验证构建链路，再决定是否用于日常会话。

怎样遥控 Codex

Codex 的便利之处是可以复用电脑上现有应用或编辑器扩展携带的 CLI 与登录状态。配对后若列表中没有 Codex，先运行 doctor 检查 provider 探测结果，再确认可执行文件是否位于 daemon 能读取的 PATH。交互式 Shell 能找到命令，不代表后台服务使用相同环境。

必要时用专门变量设置 Codex 可执行路径，再重启 daemon。设置路径时使用绝对位置，并核对文件所有者和权限。不要把项目根目录加入可执行搜索路径，否则仓库中的同名文件可能被误当作真正的 Agent。

手机适合查看 Codex 的任务进展、回答澄清问题和批准边界明确的操作。涉及 Git 推送、外部发布、删除大量文件和生产访问时，建议让 Codex暂停并输出待办，回到电脑后再执行。远程控制提升的是响应速度，不应扩大自动化权限。

怎样遥控 Cursor

AgentPager 支持的是 cursor-agent 命令行程序，而不是直接操纵桌面编辑器窗口。只安装 Cursor 图形应用并不一定满足条件，需要确认命令行 Agent 已安装且完成认证。可以先在本机终端运行其版本或帮助命令，再让 doctor 执行探测。

Cursor 的会话历史由 daemon 的内置读取方式处理，不要求系统额外安装 SQLite 命令行工具。移动端能够查看会话并继续输入，但具体事件结构取决于当前 provider 适配。若升级 Cursor 后显示异常，应先检查 AgentPager 版本和兼容说明，不要反复重建配对。

常用管理命令

status 用于查看后台服务状态、实例数量和配对情况；start、stop、restart 控制 daemon；doctor 检查中继可达性、provider 是否齐全和实例是否重复；exec 查看或设置审批策略；update 升级；uninstall 删除后台服务。使用 npx 时可保留完整包名和 latest 标签：

npx @agentpager/cli@latest status
npx @agentpager/cli@latest doctor
npx @agentpager/cli@latest restart
npx @agentpager/cli@latest update

频繁使用时可以全局安装，然后直接运行 agentpager 命令。全局安装减少输入长度，但也意味着版本由本机包管理状态决定。团队环境应记录经过验证的版本，不要在重要任务开始前自动升级。

当前包仍处于 1.0 之前，接口和安全实现可能变化。升级前阅读变更说明，备份必要的非敏感配置，升级后重新运行 doctor，并在测试仓库验证一次消息发送、工具审批、断线恢复和完成通知。

中继与自建配置

默认配置连接维护者托管的 WebSocket 与 HTTP 中继。项目声明会话正文以密封信封形式转发，中继无法读取。如果组织政策不允许流量经过第三方基础设施，可以通过 AGENTPAGER_RELAY 和 AGENTPAGER_RELAY_HTTP 指向自建服务。

自建中继并不自动等于安全。仍需部署传输加密、访问控制、限流、日志脱敏、密钥轮换、可用性监控和升级流程。不要为了测试而使用明文协议，也不要让中继管理日志记录完整消息载荷。自建后应从外部网络验证连通性，再确认手机与电脑确实连接到预期地址。

中继负责可达性，端到端加密负责内容保密，两者解决的问题不同。即使信任自建服务器，也不应取消消息加密；即使消息已加密，也要防止攻击者滥用连接次数、猜测配对短码或重放旧请求。

当前安全边界和已知限制

项目明确提示其配对短码威胁模型假定中继诚实，并且完整的重放防护仍有待进一步完善。当前实现会持久化有限数量的重放窗口信息，但这不等于经过独立安全审计。不要把它部署在存放高价值密钥、财务数据或关键生产权限的机器上。

配对手机等价于本地执行入口，是整个系统最重要的边界。手机遗失、微信账号失守或小程序会话被他人使用时，风险不限于聊天泄露，还可能扩展到代码修改和命令执行。手机必须启用设备锁、生物识别、账号保护和远程擦除；发现异常后先停止电脑端 daemon，再撤销配对和轮换相关凭据。

默认 full 审批尤其不适合初次使用。即使用户本人发出的任务无害，Agent 也可能误解范围、执行递归删除、启动昂贵服务或读取不相关文件。优先使用 ask 或 allowlist，并配合独立账户、测试凭据、版本库和系统备份。

完成通知的明文摘要也需要单独管理。任务标题和首句不要包含密码、内部域名、客户身份或漏洞细节。锁屏通知应隐藏内容，只显示有任务完成；需要查看详情时解锁手机进入小程序。

如何设置更可靠的审批规则

允许列表只应包含参数边界清楚、影响可控的命令。例如查看版本库状态、运行固定测试脚本和执行格式检查通常风险较低。不要简单允许 sh、bash、python 或 node，因为这些解释器可以执行任意代码；也不要允许带通配符的删除、网络上传和包安装命令。

审批时检查四个元素：可执行程序、完整参数、工作目录和环境变量。相同的 test 命令在受控仓库与系统目录中意义不同；看似只读的命令若携带令牌环境变量，也可能把秘密发送出去。手机界面若无法完整展示这些信息，应拒绝并要求 Agent 输出摘要，回电脑处理。

把发布、推送、数据库迁移和生产操作放到独立凭据与独立流程中。AgentPager 会话只完成本地修改和测试，最终变更由持续集成或人工审核推进。这样即使手机端权限被误用，也难以直接影响生产环境。

任务怎样写才适合手机遥控

移动端输入应短而明确，但首次任务要包含足够约束。建议依次写出目标、修改范围、禁止范围、验证命令和停止条件。例如：“修复测试仓库中的日期解析，只改解析模块与对应测试，不安装依赖，不提交远端；运行指定测试，失败两次后停止并总结。”

要求 Agent 在关键节点暂停：发现需要改数据库、需要访问外部系统、测试持续失败、修改超出文件数量上限时等待确认。这样手机收到的是少量有意义的决策，而不是持续滚动的工具噪声。

不要从手机同时启动多个 Agent 修改同一工作区。需要并行时，为每个任务建立独立工作树和独立会话，并在名称中包含项目与任务编号。合并冲突应在电脑端处理。

doctor 应该怎样使用

首次配对后运行 doctor，确认中继可达、目标 provider 已发现且只有预期实例。手机能看到电脑但无法启动 Agent 时，通常是后台 PATH 与交互式终端不同；能启动却无法恢复会话，则要检查 provider 版本和会话历史权限。

网络正常但消息延迟时，先比较本机 Agent 直接运行速度，再看中继连接。不要把模型响应慢误判为远程链路故障。若只有图片发送失败，检查文件大小和本机输出权限，不要重置全部配对。

升级后出现问题时，记录 AgentPager 版本、Node.js 版本、操作系统、provider 版本和 doctor 输出。日志分享前删除配对标识、路径中的用户名、项目名和任何会话正文。

如何停止、撤销和卸载

暂时不使用时执行 stop，确认后台进程已经退出。手机丢失或怀疑配对泄露时，应立即停止服务并撤销旧配对，然后检查版本库、Shell 历史和 Agent 会话是否出现未知操作。仅从微信中删除小程序不一定会让电脑端凭据失效。

npx @agentpager/cli@latest stop
npx @agentpager/cli@latest status

不再使用时执行 uninstall 删除后台服务，并检查用户目录下的 AgentPager 配置目录是否仍保留配对信息。删除前可保留非敏感诊断记录，但不应备份私钥。随后撤销专用开发凭据和设备授权。

推荐的上线检查表

正式使用前，应确认 Node.js 与 Agent CLI 版本符合要求，daemon 只使用受限账户，审批档位不是未经评估的 full，测试仓库不含真实秘密，手机启用了设备保护，通知不显示敏感摘要，中继选择符合组织政策，并且已经验证停止服务与撤销配对的流程。

再用一次完整演练收尾：从微信创建测试任务，批准一个只读命令，拒绝一个越界命令，让 Agent 修改测试文件并运行测试；切换手机网络后重新进入会话；最后停止 daemon，确认手机无法继续执行。只有这些行为都符合预期，才把工具用于真实项目。

AgentPager 的价值在于把编程 Agent 的等待时间变成可远程响应的流程，而不是让电脑永久接受来自手机的任意命令。把执行环境隔离、审批档位和撤销能力配置好之后，它可以成为实用的移动会话入口；忽略这些边界，便利性就会迅速转化为本机执行风险。