用电脑上的编码 Agent#

你的电脑上装了 Codex、Cursor 这类编码 Agent 的话，可以在对话里把写代码的活交给它。比如在对话里说「让 Codex 在 ~/code/site 里把登录页改成支持邮箱登录，改完跑一遍测试」，Waper 会在你的电脑上拉起 Codex，在你说的文件夹里干活；它做到哪一步显示在对话里，做完 Agent 告诉你结果：改了哪些文件、测试过没过。

它用的是你自己在这台电脑上登录的账号或 API Key，模型费用不花 Waper 积分。

支持哪几个#

编码 Agent	怎么登录
Codex	在终端里运行 codex login；或者只给 Waper 用一个 API Key：桌面端在菜单里选「Codex 的 API Key…」，服务器上运行 waper-node agents codex-key
Cursor CLI	在终端里运行 agent login
GitHub Copilot CLI	在终端里运行 copilot login
OpenCode	不用登录也能用它的免费模型；要用自己的账号，在终端里运行 opencode auth login
Gemini CLI	只能用 API Key：在 shell 配置里设 GEMINI_API_KEY，再在 Gemini CLI 里选用 API Key 登录

Claude Code 暂不支持。

登录都在你的电脑上、用各家自己的方式完成，Waper 不代你登录。Codex 的 API Key 只存在你的电脑上，不经过 Waper 的服务器。

Waper 通过 Agent Client Protocol（ACP）和它们对话：拉起、交代任务、看它做到哪、转达它要的权限、停下。

要什么#

• 这台电脑上开着 Waper 桌面端，或在运行 waper-node，并且在线。
• 告诉 Agent 在哪个文件夹（代码仓库）里做，比如「在 ~/code/app 里用 Codex 修这个 bug」。没说的话，Agent 会先问你。
• 编码 Agent 装好、登录好。设置 → 连接 → 电脑 里点开一台电脑，列着检测到的编码 Agent、版本和能不能用；没登录、要 API Key、版本太旧时，那一行写着怎么办。刚装好或刚登录完就可以直接用：交出去时那台电脑会当场再查一次，设置里的状态随后跟着更新。

怎么用#

• 点名就行：「让 Codex……」「用 Cursor 在 ~/code/app 里……」。没点名时，遇到在代码仓库里改代码的大活，Agent 也可能自己交给电脑上的编码 Agent；小改动它自己用文件工具做。
• Agent 会把任务写成一份完整的交代（目标、涉及的文件、限制、怎么检查结果）交过去：编码 Agent 看不到这个对话里的其他内容。
• 一次交出去默认最多做 30 分钟，需要时最长 1 小时。做完之后你可以接着说「再让它把测试补上」，Agent 会在同一个会话里接着交代，编码 Agent 记得刚才做过什么。
• 随时可以停：在对话里停止这一轮回答，编码 Agent 也会停下。

审批怎么对应#

交出去这一步按什么时候先问你的规矩判断，和在电脑上执行命令是同一类。交出去之后，编码 Agent 按它自己的权限档位干活，Waper 按你这个对话的审批模式替它选一档：

• 自动审批：用各家自己的自动档。它自己判断能做的不再问你；越出它那一档的（比如工作文件夹外的改动、联网、它规则之外的命令）它会来问 Waper：读文件、查找、联网读取和工作文件夹里的改动 Waper 直接答允许，其余的在对话里给你一张卡。
• 完全访问：用各家最宽的一档，几乎不再问。它自己的安全检查还来问的，照样在对话里问你。

编码 Agent	自动审批	完全访问
Codex	Auto review	Full access
Cursor CLI	默认	--force
GitHub Copilot CLI	默认	Allow all
OpenCode	默认	全部允许
Gemini CLI	auto_edit	yolo

问你的卡写着谁在哪台电脑上要做什么（例如「Codex 想在「MacBook」上运行命令」），点 详情 能看到命令或改动、涉及的文件。只有「允许」和「拒绝」两个按钮，答的都是这一次：不给「始终允许」，免得在它那边留下 Waper 看不到、撤不掉的放行。这一次交出去结束了（做完、停下、超时）还没答的卡，会变成「已失效」。

交出去之前要你批准的，批准之后它来问的权限卡显示在那张审批卡下面，照样能答。权限卡目前要在网页或桌面端回答，iOS 上还看不到。

费用#

• 编码 Agent 用的是你自己的账号或 API Key，它的模型费用记在那一家，不花 Waper 积分。
• 交出去、读结果的那几步是你的 Agent 在做，照常算积分。

风险#

编码 Agent 在这台电脑上用的是你的全部环境，和你自己在终端里运行它一样：

• 已登录的浏览器：有的编码 Agent 会用你的浏览器资料打开网页，带着你的登录状态。
• 全局的技能与设置：它会读你给它配的全局技能、MCP、放行规则，以及这个文件夹（仓库）里的配置。一个不可信的仓库可以预先放行一些命令。
• 工作区外的文件：它的档位允许的话，可以读写工作文件夹以外的文件；有的默认档在工作区外写文件也不问。

这和 Agent 自己用电脑一样（见Agent 能用什么）：你说的文件夹是告诉它从哪开始，不限制它。Waper 管得住的是：交不交、交给谁、在哪个文件夹、它主动来问的那些，以及随时能停；它做到哪一步也都显示在对话里。只把你信得过的文件夹交给它。

电脑断线时#

• 电脑离线时 Agent 不会偷偷换到云端去做，它会告诉你打开那台电脑上的 Waper 之后再说一声。
• 做到一半电脑断了网，编码 Agent 在那台电脑上照样接着做；重新连上之后，做完的结果会补发回来，还在等你答的权限请求也会重新出现在对话里。到这一次的时限（默认 30 分钟）还没连回来，按超时结束。
• 只有那台电脑上的 Waper 自己退出或重启了，这一次才算中断：编码 Agent 会被停下，Agent 会告诉你，你可以让它接着做。