Claude Code や Codex の実行中にスマホからファイルを編集する方法
Claude Code / Codex をマシンで動かしたまま、モバイルから実際のワークスペースのファイルを編集して小さな修正を済ませ、「あとで直す」を防ぐ方法です。
- CLI
- 0.2.17
- プレビュー ref
- a2c45c8
小さいけれど繰り返し起きる問題です(そして積み重なります)。
エージェント(Claude Code や Codex)が動いています。あなたはスマホを見ています。実行をすっきりさせる小さな修正に気づきます。
- 設定値が間違っている
- ファイル名を変える必要がある
- 消し忘れのログ行がある
- エージェントが間違ったディレクトリにファイルを作った
放っておくと、たいてい後でツケを払います(差分が大きくなり、コミットが散らかります)。
スマホから SSH すれば直すことはできますが、モバイルでターミナル作業をすることになります。
そこで目指すのは、マシンでセッションを動かしたまま、スマホからワークスペースを小さく編集するワークフローです。
要点
- どんな「スマホからの編集」が必要か決めます:
- セッションを動かしたままのごく小さな的を絞った編集、または
- 本格的なリファクタリング(たいていノートPCやターミナルの出番)
- Happier を使う場合: セットアップし(またはダイレクトセッション(Direct sessions)で接続し)、スマホでセッションを開きます。
- ファイル(Files) で閲覧・検索し、ファイルを編集モードで開きます。
- 小さな修正をします。
- レビュー(Review) やツールのタイムラインで、何が変わったかを確認します。
- スマホからコミットするなら Git 操作を有効にします。そうでなければ後でコミットします。
よくある方法とトレードオフ
-
スマホからの SSH: 使えますが、差分が絡む作業(レビュー、ステージング、間違ったファイルに触れていないかの確認)は急ぎがちです。
-
リモートデスクトップ: 使えますが、ちょっとした編集には重くて扱いにくいです。
-
Happier: コーディングエージェントをクロスデバイスで実行・オーケストレーションするためのオープンソースアプリです。セッション UI にリポジトリを認識するファイル画面とエディターがあるので、セッションのコンテキストを離れずに小さな変更ができます。 トレードオフ: マシン/デーモンに到達できる必要があり、大きなリファクタリングにはフルキーボードのほうが向いています。
Happier を初めて使う場合(概要と入手方法)
Happier を初めて見る方へ。Happier は、Claude Code、Codex、OpenCode などの AI コーディングエージェント向けのオープンソースのコンパニオンアプリ(モバイル/Web/デスクトップ)です。
ここでのワークフローは、セッション(とリポジトリ/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) ファイルを開く
セッション UI で ファイル(Files) を開きます。
スマホサイズのレイアウトでは、サイドバーと詳細ペインではなく、全画面のフローになります。
2) ファイルを探す
次のどれかを使います:
- ツリーを閲覧する
- 名前がわかっていれば検索する
- 変わったところに集中したいときは、変更済みのみのフィルターを使う
3) ファイルを編集モードで開く
ファイルを開き、編集モードに切り替えます。
変更します。
4) 何が変わったか確認する
スマホから確認する方法は2つあります:
- レビュー(Review) を開いて、未コミットの差分一式をざっと見る
- ツールのタイムラインで、どんな編集があったかを見る(エージェントがまだ動いているときに特に便利です)
5) 今コミットするか後でするか決める
- すでに「スマホからコミットする」モードなら、ステージしてコミットできます。
- 片付けをしているだけなら、未コミットのままにして、最後のコミットは後でノートPCからしても問題ありません。
添付ファイルとワークスペースのファイル(混同しやすい点)
「これを git に入れたい」なら、編集すべきなのはワークスペースのファイルです。
添付ファイルはログや成果物をモデルと共有するのに便利ですが、リポジトリを編集するのとは別物です。
トラブルシューティング
症状: ファイル(Files)が空、または読み込まれない
考えられる原因:
- 所有するマシン/デーモンに到達できない
対処:
- 接続を回復します。ファイル画面はマシンのワークスペース API に依存しています
症状: ファイルは閲覧できるが、編集が保存されない
考えられる原因:
- 実際のワークスペースのファイルではなく、添付ファイルやプレビュー画面を編集している
対処:
- ファイル(Files) からファイルを開き、編集モードになっていることを確認する