Patapim

Patapim 快速入门

Patapim（patapim.ai）把 Claude Code、Codex、Gemini CLI、Antigravity（或任意自定义 CLI）包进一个按项目组织的桌面应用——不夺走终端，只是给终端装上「驾驶舱」：项目即文件夹、本地语音听写、手机远程接管、Telegram/WhatsApp 通知机器人、内嵌浏览器（保留登录态）、可选的全自动电脑控制（带急停开关）。用你自己的 Claude/OpenAI/Google 订阅跑，不收 API 差价。2026-09-28 核验：官网 patapim.ai 在线，BetaList 收录（dev-tools/development-platforms 分类），Windows 10+ / macOS 12+，免费档 + Pro $6.99/月或 $59.99 买断。

这是什么？适合谁？

多 Agent 开发的日常痛点不是「没有好 Agent」，而是「Agent 散落在 N 个终端窗口里」：Claude Code 在一个 tmux 里、Codex 在另一个、Gemini 又是一个，项目上下文靠脑记，离开电脑就失联。Patapim 的解法是把它们统一进一个按项目组织的桌面壳：每个项目是一个文件夹（不是一场聊天），带色彩标记的任务与实时通知，可以同时跑多个真实终端互不跟丢；已经用 Claude Code 的用户可以一键导入全部项目（含完整会话历史）。

核心卖点：

• 真终端：包的是真 CLI（Claude Code 还是 Claude Code），不是阉割版 Web 代理——你的订阅、你的配置文件、你的 CLI 版本。
• 手机远程控制：patapim.ai/go 扫码连接后，手机上直接对电脑里的 Claude Code 下指令、看输出、点恢复（tap to resume），出门也能盯任务。
• 本地语音听写：按住说话，完全本地语音转文字，对着任意终端口述需求。
• 通知机器人：Telegram / WhatsApp 接收任务完成/需要输入的事件。
• 内嵌浏览器：带登录态的浏览器会话，Agent 查文档、看部署预览不用切窗口。
• 全自动电脑控制（可选开启）：Claude 直接操作真实鼠标键盘应用，端到端驱动整台机器；配紧急停止开关（emergency kill switch）。官网明示用订阅额度干活、无 per-token 计费。

适合人群：

• 同时跑 2 个以上编码 Agent CLI 的独立开发者/小团队（官网作者自述「整个公司都跑在它上面，已有 10+ 合作伙伴落地该技术」）
• 经常离开桌面、需要手机继续指挥 Agent 跑长任务的人
• 想给 Claude Code 加语音输入和通知、又不想自己拼 whisper+telegram 脚本的懒人（褒义）

不适合谁：只用一个 Agent 且从不离开电脑的人（收益有限）；需要 Linux 桌面版的用户（2026-09-28 官网只列 Windows/macOS）；对「Agent 控制整台电脑」有安全红线、又不想研究权限收敛的团队——全自动电脑控制默认关闭，但开启前请先读本文「权限与安全」一节。

准备工作

• 运行环境：Windows 10+ 或 macOS 12+；已安装至少一个目标 CLI（Claude Code / Codex / Gemini CLI / Antigravity，或任意自定义 CLI）
• 账号要求：免费档可直接开始；Pro（$6.99/月 或 $59.99 终身）解锁高级功能（以官网定价页为准）。已有 Claude/OpenAI/Google 订阅即可跑 Agent，Patapim 不加收 API 费
• 时间预算：安装 + 导入第一个项目约 10 分钟；配置远程控制/通知再花 10-15 分钟
• 前置知识：会用命令行装 CLI；知道自己的订阅账号（Patapim 不替你付 token 钱）
• 替代方案：AgentGUI（开源，npx agentgui，多 Agent 并排对比，无手机远程）；Cockpit（getcockp.it，iPhone/iPad 远程控制 Claude Code，无桌面壳）；Ptah（ptah.live，持久记忆+子 Agent 编排的桌面 Agent，定位不同）；或干脆 tmux + tail 日志（免费但没远程/语音/通知）

快速上手（第一个项目跑通）

第一步：安装 Patapim

Windows（PowerShell）：

irm patapim.ai/install.ps1 | iex

macOS：

curl -fsSL https://patapim.ai/install-mac.sh | bash

或在官网 patapim.ai 进入 download page 下载安装包。装完命令行里会有 patapim 命令。

第二步：确认你的 CLI 已登录

Patapim 不管理凭据，它包的是你本机已登录的 CLI。先确保 claude（或 codex / gemini）在终端里能用：

claude --version

第三步：导入或创建第一个项目

打开 Patapim，点导入（面向 Claude Code 用户）——它会扫描本机 Claude Code 的项目与会话历史，一键全部导入；或手动新建项目文件夹（例如 ~/projects/convoy），在项目里选你要用的 Agent（同一项目不同任务可以用不同 Agent，官网示例即「api 用 claude、ui 用 codex」）。

第四步：跑第一个任务

在项目终端里输入（或按住语音键说）：

fix the auth flow

观察右侧任务列表出现带颜色的任务条目、终端流式输出。任务完成或需要输入时，通知机器人（若已配置）会推 Telegram/WhatsApp。

预期结果：一个项目文件夹里跑着真实 CLI 会话，任务状态可视化，关掉 Patapim 窗口会话仍在（回来 tap to resume）。

第五步（可选）：配置手机远程

手机浏览器打开 patapim.ai/go → Google 登录 → 桌面端确认连接。之后手机上可以直接打字指挥电脑里的 Agent、看流式输出。远程会话走官网中转，手机端操作等于你本人在电脑上操作，别在不可信网络下开着全自动电脑控制。

常见踩坑

1. 症状：装完 patapim 命令不存在。 原因：PowerShell 执行策略拦截了 irm | iex，或 PATH 未刷新。解决：Set-ExecutionPolicy -Scope CurrentUser RemoteSigned 后重装；或新开一个终端窗口让 PATH 生效；实在不行用官网下载页的图形安装包。
2. 症状：导入 Claude Code 项目后会话历史是空的。 原因：Claude Code 会话存在 ~/.claude/projects/ 下，Patapim 按项目路径映射；如果项目目录曾被移动/改名，映射断链。解决：在原路径重新打开一次该项目的 Claude Code 会话让元数据刷新，再导入。
3. 症状：手机远程连上但指令没反应。 原因：桌面端在休眠/锁屏时后台挂起，CLI 会话冻结。解决：电源设置里关闭休眠，或保持 Patapim 窗口激活；官网的 tap to resume 就是为这种断点设计的。
4. 症状：语音听写出字很慢或没反应。 原因：本地语音模型首次冷启动需要加载；或麦克风权限未授予。解决：第一次多等几秒；系统设置里给 Patapim 授麦克风权限。
5. 症状：自动电脑控制开启后鼠标乱飞。 原因：该模式让 Claude 直接驱动真实鼠标键盘，任何提示词歧义都会被「物理执行」。解决：先用测试项目试，保持急停开关（emergency kill switch）触手可及；生产机上建议只在做明确边界的任务时开启。
6. 症状：内嵌浏览器登录态丢失。 原因：清缓存或更新后 profile 重置。解决：重新登录一次；敏感账号别在内嵌浏览器长持登录态。

常见问题 FAQ

Q1：Patapim 会不会替换或魔改我的 Claude Code？

A：不会。它包的是你本机的真实 CLI（官网口径「It’s still Claude Code. Still your terminal.」），CLI 版本、配置、订阅都是你自己的；Patapim 提供的是外壳（工作区/通知/远程/语音）。

Q2：和 AgentGUI、Cockpit 这类开源方案比呢？

A：AgentGUI（开源，14 个 Agent 并排对比、会话持久化）胜在免费可改，但没有手机远程、语音、通知机器人；Cockpit 专注 iOS 远程控制 Claude Code；Patapim 是商业产品，把这些（远程+语音+通知+浏览器+电脑控制）打包成一个按项目组织的桌面体验，代价是核心功能收费。预算敏感、只要单一功能，选开源；要整套驾驶舱，Patapim 省事。

Q3：我的订阅会被封吗？

A：Patapim 官网口径是「designed for developers running AI coding agents on their own Claude/OpenAI/Google subscriptions」，即用你自己的订阅跑官方 CLI。但全自动电脑控制等重度自动化用法是否触发各厂商的使用政策，以厂商条款为准——本文未做长期挂机实测，无法保证。

Q4：免费档和 Pro 差在哪？

A：官网标 Pro $6.99/月 或 $59.99 终身。具体功能分界（如远程控制是否免费档可用）以官网定价页实时信息为准，本文 2026-09-28 核验时未逐项实测付费墙。

Q5：支持哪些 Agent？

A：官网明示 Claude Code、Codex、Antigravity，以及「any custom CLI」——本质是终端包装器，任何命令行 Agent 都能塞进去；Gemini CLI 在 BetaList 收录描述中被列为支持对象。

Q6：数据走哪？

A：桌面端本地跑 CLI；远程控制与通知经由其云端中转（patapim.ai/go、Telegram/WhatsApp bot）。语音听写是本地处理。代码与凭据不经过 Patapim 服务器（CLI 在你机器上登录），但远程指令流会过它的中转——介意的话关闭远程功能。详细隐私条款以官网为准，本文未审计其网络流量。

权限、安全、成本与限制

• 权限：全自动电脑控制 = Agent 拿到真实鼠标键盘。开启前：关闭无关应用、准备好急停开关、不要在有生产凭据填表的浏览器里跑。远程控制意味着任何能登录你 patapim.ai 账号的会话都能指挥你的电脑——账号开 2FA。
• 安全：内嵌浏览器保留登录态，等于把 cookie 常驻在一个可被 Agent 访问的浏览器里；敏感账号（银行、生产控制台）不要登录在内嵌浏览器。
• 成本：软件免费档起步，Pro $6.99/月或 $59.99 终身（2026-09-28 官网价）。Agent 用量走你自己的 Claude/OpenAI/Google 订阅，Patapim 不加价。
• 平台限制：仅 Windows 10+ / macOS 12+，无 Linux 桌面版；Linux 用户看 AgentGUI。
• 核验声明：本文基于 2026-09-28 的官网（patapim.ai）与 BetaList 收录页公开信息撰写；未做付费购买与长周期挂机实测；「整个公司都跑在它上面」「10+ 合作伙伴」为官网作者自述，未独立核实。

小技巧

1. 同一项目里用不同 Agent 分工（api 任务给 claude、ui 任务给 codex），Patapim 的项目视图天然支持这种混合编队。
2. 把 Telegram 通知 bot 拉进一个只属于自己的频道，Agent 深夜跑完任务手机只响一声，不用守着电脑。
3. 远程控制配「tap to resume」：出门前让 Agent 跑长任务，路上手机看进度，回家点一下接回终端现场。
4. 语音听写适合写长需求：口述三分钟比打字三百字快，且本地转写不出网。
5. 新项目先在内嵌浏览器里打开它的预览地址，让 Agent 自己看渲染结果改 UI，省去截图往返。

进阶学习方向

• 多 Agent 混合编队：官网首页示例（convoy 项目里 api-claude / tests / db-codex 分任务挂 Agent）就是按目录结构组织 Agent 分工的样板，照抄到自己的 monorepo。
• 远程控制安全加固：给 patapim.ai 账号开 2FA、手机仅用受信网络、生产机不开电脑控制——三条线守住再玩远程。
• 与 MCP 工具链组合：CLI 原生支持 MCP，Patapim 不拦；把文件系统、浏览器、数据库 MCP server 配在 CLI 层，Patapim 里直接受益。
• 竞品横向：要开源自托管去读 AgentGUI（github.com/AnEntrypoint/agentgui）的 README；要纯移动端远程看 Cockpit（getcockp.it）；要持久记忆型桌面 Agent 看 Ptah（ptah.live）——三家定位与 Patapim 互补或重叠，选型时对照本文 FAQ Q2。

参考链接

• Patapim 官网
• BetaList 收录页