手机上的 Claude Code：OpenMinis 实战

先说结论：OpenMinis 的意义，是在 iOS 和 Android 上给了你一套完整的 Claude Code / Codex 体验。

不是「又一个能聊天的 AI app」。是你在电脑上习惯的那一整套 —— 一个真的 shell、一个真的文件系统、能跑命令看报错再自己改、skill 按需加载、规矩写进说明文件它自己会看 —— 原样搬到了手机上。

手机上的 AI 应用大多卡在同一个地方：模型很聪明，但是没有手。能调的无非几个写死的接口，稍微超出一点就只能告诉你「建议您……」。Minis 的解法很直接：给它一台完整的电脑。它在你手机里跑了一个真的 Alpine Linux，agent 能装包、跑脚本、读写文件。

我用了挺久，主要干三件事：写文章、写小说、做图。这篇讲这三件活具体怎么干。

先交代最低限度的背景：Minis 自己不做模型，你填自己的 Claude / GPT / Gemini key，app 免费，花的是模型的钱。装完第一件事是给权限 —— 需要用到哪个给哪个，别一次全开。

一、写文章

这是我用得最多的。手机上写东西的麻烦从来不是打字，是查资料、翻旧稿、改结构这三件事在手机上做起来太笨，得在浏览器、备忘录、文件管理器之间来回倒腾。

Minis 的好处是这三样它自己就能干。典型的一轮是这样：

先查一下 X 最近的说法，要带来源链接，冲突的地方单独列出来。然后读一下 drafts/ 里我上个月那篇，看看有没有重复的观点。最后按「结论先行 + 三个论据」的结构列个提纲给我，先别写正文。

它会自己联网搜、点开、发现不够再接着搜；然后读工作区里的旧稿；最后给提纲。我确认提纲之后再让它写正文。

几个实际有用的习惯：

让它先给提纲，别一上来就写全文。 手机上读长文很累，改起来更累。提纲阶段调整一次，比正文推翻重来省太多。

要求它标来源、报冲突。 加一句「不同来源说法不一致的话单独列出来告诉我」，比什么都管用 —— 它一旦发现矛盾就必须说，而不是挑一个顺嘴的讲。

成品直接写回文件。 说「写进 posts/2026-07-26-xxx.md，frontmatter 按现有格式来」，它会照着工作区里已有的文件格式写。比复制粘贴靠谱，格式也不会串。

二、写小说

这件事最能说明前面那句「完整的 Claude Code 体验」到底是什么意思。

因为我写小说不是靠对话，是靠一套自己写的 skill。它原本是在电脑上写的、给 Claude Code 和 Codex 用的，现在原样跑在手机上。

那套东西不是单个 skill，是个带路由的工具箱。入口叫 /story，它根据我说的话分发到具体的子 skill：

所以在手机上我不用背命令，说人话就行 —— 「这段太 AI 了」它就去走去味流程，「我写到哪了」它就去翻项目文件。

书是文件，不是对话记录。 每本书一个目录，里面有 设定/ 和 追踪/；一个项目可以同时放好几本，用一个 .active-book 文件标记当前在写哪本，切书就是改这个标记。这套结构在电脑上什么样，手机上就什么样，同一份文件两边都能接着改。

这也带出我踩过才明白的一条：改设定要改文件，不要只在对话里说。 你说「这个角色改姓王」，这一轮它记得，设定/ 里没变，下次开新会话就又回去了。

一个细节：skill 得自己写好降级

这是我觉得最值得说的地方。

工具箱里有些活是要派子代理去干的 —— 比如「查角色状态」「查伏笔进度」会 spawn 一个专门的检索 agent。但不是所有环境都有子代理。

所以我在 skill 里写了可用性检查和降级路径：先看当前是不是已经在子代理上下文里、Agent 工具在不在、agent 定义文件存不存在，任一条不满足就降级到主线程直接用 Read / Grep 从项目文件里翻，并在回答前标一行 Fallback: agent unavailable -> direct lookup。不硬失败，只是换个方式把活干完。

当初写这个降级是为了兼容不同的桌面环境，没想到它真正的价值在换平台的时候才体现出来：skill 能不能搬到手机上，取决于你写的时候有没有假设「环境一定有 XX」。 假设越少，搬家越顺。

碎片时间能推进一章，靠的不是「手机上也能聊天」，是这一整套文件和流程原封不动地跟过来了。

三、做图

这件事能顺起来，靠的是 Minis 那套 minis:// 寻址。

流程是：skill 调图像接口 → 产物以 minis:// 的形式回传给模型 → 聊天界面直接把这个 URL 渲染成图片。不用导出、不用切到相册再切回来。生成、看、接着改，全在同一个对话里完成。

对于要反复调的活儿，这个闭环省的时间比想象中多。一句「上一张色调太冷，暖一点，字再大些」，它改完直接出图，你当场就能判断。

要注意的是画面里带精确文字和数字的图，AI 生图靠不住。它会把占位数字画得很像真的。我自己的分工是：氛围图、插画交给生图；带表格、数据、代码的图老老实实用别的方式做。这不是 Minis 的问题，是所有生图模型的通病，但因为 Minis 让出图变得很快，反而更容易一不小心就用错地方。

电脑上的 skill 能直接搬过来

这是「完整的 Claude Code 体验」这句话最实的一处，也是我愿意在手机上认真用它的主要原因。

Minis 的 skill 就是一个文件夹加一个 SKILL.md，里面写指令，可以再带脚本和参考资料。元数据常驻上下文用来触发，正文只在真正用到时才加载。

眼熟吧 —— 这就是 Claude Code 那套结构，一模一样。官方明确写了：为 Claude、Codex、OpenClaw 或 Hermes Agent 写的 skill，一般不用改就能在 Minis 里跑。适配过的只是跑得更好，因为能直接够到 Linux shell 和设备集成。

所以我在电脑上攒的那些 skill，搬到手机上基本是零成本。前面那套写小说的工具箱就是现成例子：十几个子 skill 加一个路由入口，是照着 Claude Code 的规矩写的，搬过来不用改。写作规范、发布流程、检查清单，电脑上怎么用手机上还怎么用，不用维护两套。

同理，AGENTS.md 那一套把项目规矩写进文件的做法在这儿照样成立 —— 规矩写进去，它自己会读。

唯一要留心的还是上面那条：别在 skill 里假设环境一定有什么。 留好降级路径，它才能真的跨平台。

官方还开了 MinisSkills 收适配过的版本，AwesomeMinis 收社区用例。

几条通用的经验

这三件活干下来，有些东西是共通的：

一个正经任务一个工作区。 别都堆在一个会话里。会话之间是硬隔离的，A 会话的文件 B 会话看不到 —— 这个设计一开始觉得麻烦，用久了发现是对的，上下文不会互相污染。

危险操作先让它说方案。 「先把你打算做什么列出来，等我确认再动手」。删除、覆盖、批量改，都值得多这一步。

它说完成了不等于真的完成了。 让它自己验证一遍（「数一下条数」「打开看看格式对不对」），你再抽查两条。

长任务中途看一眼。 跑十分钟以上的活儿，早点发现跑偏比返工划算。

顺便说，它现在开源了

2026 年 7 月 25 日，官方把整个 app 的源码放了出来，iOS 和 Android 两端都在 GitHub 上，GPLv3。

对日常使用没影响，该怎么装还怎么装。想自己编译要有心理准备，沙箱是从源码构建的，官方说第一次得留 30 到 60 分钟。仓库是私有开发树的镜像，不收 PR，参与只能提 issue。

倒是有一条跟使用直接相关：App Store 版本会落后。 每次更新要过审，稳定性不够时官方还会压着不发，修复和新功能先进 TestFlight。想要新功能就去 TestFlight，Android 直接在 releases 页面拿 APK。

---

回到开头那句。

市面上手机端的 AI 应用不少，但绝大多数是「聊天框 + 几个固定功能」。Claude Code 和 Codex 之所以好用，从来不是因为模型更聪明，而是因为它们能碰到你的真实文件、能跑命令、能一步接一步做到完。 这套体验此前只在电脑上有。

Minis 把它整个搬到了手机上：Linux 沙箱、设备权限、skill 系统、会话隔离，拼在一起还能天天用。技术上不算新鲜（iSH 存在很多年了），难的是拼齐了还顺手。

对我来说这件事的实际意义很朴素：排队、坐车、等人的十分钟，能真的推进一章小说、改完一篇稿子，而不只是跟 AI 聊两句。

具体的 skill 怎么写、我踩过哪些坑，另开一篇细说。