如何在 Claude Code 或 Codex 运行时用手机编辑文件

在 Claude Code / Codex 继续在你的机器上运行的同时,从手机编辑真实的工作区文件,完成小修小改,避免“以后再改”。

基于版本
CLI
0.2.17
预览 ref
a2c45c8

一个小但反复出现的问题(而且会越积越多):

一个代理(Claude Code 或 Codex)正在运行。你在看手机。你发现一个能让运行更干净的小修改:

  • 某个配置值错了,
  • 某个文件需要重命名,
  • 有一行多余的日志,
  • 或者代理把文件建在了错误的目录。

置之不理,通常之后要付出代价(差异更大,提交更乱)。

用手机 SSH 进去,你能修,但这就变成了在手机上做终端工作。

所以目标是一个工作流:在会话继续在你的机器上运行的同时,从手机对工作区做小幅编辑。

简要总结

  1. 决定你需要哪种“手机编辑”:
    • 会话继续运行时的精确小改动,或者
    • 真正的重构(通常需要笔记本或终端)
  2. 如果你在用 Happier:先完成设置(或通过直连会话(Direct sessions)接入),然后在手机上打开会话。
  3. 用 文件(Files) 浏览或搜索,并以编辑模式打开文件。
  4. 做出小修改。
  5. 用 审阅(Review) 或工具时间线检查改了什么。
  6. 如果你打算在手机上提交,启用 Git 操作,否则以后再提交。

常见做法及其权衡

  • 用手机 SSH:可行,但对于任何涉及差异的事(审查、暂存、确认没碰错文件)很容易草率。

  • 远程桌面:可行,但对快速编辑来说笨重又麻烦。

  • Happier:一款开源应用,用于跨设备运行和编排编码代理。会话界面中有感知仓库的文件页面和编辑器,你可以在不离开会话上下文的情况下做小改动。 权衡:它仍然依赖机器/守护进程可以访问,更大的重构还是用完整键盘更好。

如果你第一次接触 Happier(它是什么,在哪里获取)

如果你之前没见过 Happier:它是一款面向 Claude Code、Codex 和 OpenCode 等 AI 编码代理的开源配套应用(移动端/网页/桌面)。

这里的工作流是:会话(以及仓库/Git)留在拥有工作区的机器上,你用 Happier 从手机编辑真实的工作区文件。

开始设置:

前提条件

  • 拥有该会话的机器/守护进程在线且可访问。
  • 你可以从会话访问仓库/工作区。

分步操作:在手机上编辑文件

1) 打开文件

在会话界面中打开 文件(Files)。

在手机尺寸的布局中,这是一个全屏流程,而不是侧边栏加详情面板。

2) 找到文件

使用以下任一方式:

  • 浏览文件树
  • 知道文件名时使用搜索
  • 想专注于改动时,使用仅显示已修改的筛选

3) 以编辑模式打开文件

打开文件,然后切换到编辑模式。

做出修改。

4) 检查改了什么

在手机上检查有两种方式:

  • 打开 审阅(Review) 浏览未提交的差异集
  • 用工具时间线查看发生了哪些编辑(代理仍在运行时尤其有用)

5) 决定现在提交还是以后提交

  • 如果你已经在“用手机提交”模式,可以暂存并提交。
  • 如果你只是在清理,不提交也没关系,之后再用笔记本做最终提交。

附件与工作区文件(容易混淆)

如果你的目标是“这个要进 git”,你需要编辑的是工作区文件。

附件很适合与模型分享日志或产物,但这和编辑仓库不是一回事。

故障排查

症状:文件(Files)是空的或加载不出来

可能的原因:

  • 无法访问拥有该会话的机器/守护进程

解决方法:

  • 恢复连接,文件页面依赖机器的工作区 API

症状:可以浏览文件,但编辑没有保存

可能的原因:

  • 你编辑的是附件或预览界面,而不是真实的工作区文件

解决方法:

  • 从 文件(Files) 打开文件,并确认处于编辑模式

相关指南

mobilefilesgitworkflows
最后更新: 2026-10-26