如何在 Claude Code 或 Codex 运行时用手机编辑文件
在 Claude Code / Codex 继续在你的机器上运行的同时,从手机编辑真实的工作区文件,完成小修小改,避免“以后再改”。
基于版本
- CLI
- 0.2.17
- 预览 ref
- a2c45c8
一个小但反复出现的问题(而且会越积越多):
一个代理(Claude Code 或 Codex)正在运行。你在看手机。你发现一个能让运行更干净的小修改:
- 某个配置值错了,
- 某个文件需要重命名,
- 有一行多余的日志,
- 或者代理把文件建在了错误的目录。
置之不理,通常之后要付出代价(差异更大,提交更乱)。
用手机 SSH 进去,你能修,但这就变成了在手机上做终端工作。
所以目标是一个工作流:在会话继续在你的机器上运行的同时,从手机对工作区做小幅编辑。
简要总结
- 决定你需要哪种“手机编辑”:
- 会话继续运行时的精确小改动,或者
- 真正的重构(通常需要笔记本或终端)
- 如果你在用 Happier:先完成设置(或通过直连会话(Direct sessions)接入),然后在手机上打开会话。
- 用 文件(Files) 浏览或搜索,并以编辑模式打开文件。
- 做出小修改。
- 用 审阅(Review) 或工具时间线检查改了什么。
- 如果你打算在手机上提交,启用 Git 操作,否则以后再提交。
常见做法及其权衡
-
用手机 SSH:可行,但对于任何涉及差异的事(审查、暂存、确认没碰错文件)很容易草率。
-
远程桌面:可行,但对快速编辑来说笨重又麻烦。
-
Happier:一款开源应用,用于跨设备运行和编排编码代理。会话界面中有感知仓库的文件页面和编辑器,你可以在不离开会话上下文的情况下做小改动。 权衡:它仍然依赖机器/守护进程可以访问,更大的重构还是用完整键盘更好。
如果你第一次接触 Happier(它是什么,在哪里获取)
如果你之前没见过 Happier:它是一款面向 Claude Code、Codex 和 OpenCode 等 AI 编码代理的开源配套应用(移动端/网页/桌面)。
这里的工作流是:会话(以及仓库/Git)留在拥有工作区的机器上,你用 Happier 从手机编辑真实的工作区文件。
开始设置:
- 如何在手机上使用 Happier
- GitHub: https://github.com/happier-dev/happier
- 安装/下载: https://github.com/happier-dev/happier#how-it-works
- Discord(社区与支持): https://discord.gg/W6Pb8KuHfg
前提条件
- 拥有该会话的机器/守护进程在线且可访问。
- 你可以从会话访问仓库/工作区。
分步操作:在手机上编辑文件
1) 打开文件
在会话界面中打开 文件(Files)。
在手机尺寸的布局中,这是一个全屏流程,而不是侧边栏加详情面板。
2) 找到文件
使用以下任一方式:
- 浏览文件树
- 知道文件名时使用搜索
- 想专注于改动时,使用仅显示已修改的筛选
3) 以编辑模式打开文件
打开文件,然后切换到编辑模式。
做出修改。
4) 检查改了什么
在手机上检查有两种方式:
- 打开 审阅(Review) 浏览未提交的差异集
- 用工具时间线查看发生了哪些编辑(代理仍在运行时尤其有用)
5) 决定现在提交还是以后提交
- 如果你已经在“用手机提交”模式,可以暂存并提交。
- 如果你只是在清理,不提交也没关系,之后再用笔记本做最终提交。
附件与工作区文件(容易混淆)
如果你的目标是“这个要进 git”,你需要编辑的是工作区文件。
附件很适合与模型分享日志或产物,但这和编辑仓库不是一回事。
故障排查
症状:文件(Files)是空的或加载不出来
可能的原因:
- 无法访问拥有该会话的机器/守护进程
解决方法:
- 恢复连接,文件页面依赖机器的工作区 API
症状:可以浏览文件,但编辑没有保存
可能的原因:
- 你编辑的是附件或预览界面,而不是真实的工作区文件
解决方法:
- 从 文件(Files) 打开文件,并确认处于编辑模式
相关指南
mobilefilesgitworkflows
最后更新: 2026-10-26