Claude Code や Codex の実行中にスマホからファイルを編集する方法

Claude Code / Codex をマシンで動かしたまま、モバイルから実際のワークスペースのファイルを編集して小さな修正を済ませ、「あとで直す」を防ぐ方法です。

対象バージョン
CLI
0.2.17
プレビュー ref
a2c45c8

小さいけれど繰り返し起きる問題です(そして積み重なります)。

エージェント(Claude Code や Codex)が動いています。あなたはスマホを見ています。実行をすっきりさせる小さな修正に気づきます。

  • 設定値が間違っている
  • ファイル名を変える必要がある
  • 消し忘れのログ行がある
  • エージェントが間違ったディレクトリにファイルを作った

放っておくと、たいてい後でツケを払います(差分が大きくなり、コミットが散らかります)。

スマホから SSH すれば直すことはできますが、モバイルでターミナル作業をすることになります。

そこで目指すのは、マシンでセッションを動かしたまま、スマホからワークスペースを小さく編集するワークフローです。

要点

  1. どんな「スマホからの編集」が必要か決めます:
    • セッションを動かしたままのごく小さな的を絞った編集、または
    • 本格的なリファクタリング(たいていノートPCやターミナルの出番)
  2. Happier を使う場合: セットアップし(またはダイレクトセッション(Direct sessions)で接続し)、スマホでセッションを開きます。
  3. ファイル(Files) で閲覧・検索し、ファイルを編集モードで開きます。
  4. 小さな修正をします。
  5. レビュー(Review) やツールのタイムラインで、何が変わったかを確認します。
  6. スマホからコミットするなら Git 操作を有効にします。そうでなければ後でコミットします。

よくある方法とトレードオフ

  • スマホからの SSH: 使えますが、差分が絡む作業(レビュー、ステージング、間違ったファイルに触れていないかの確認)は急ぎがちです。

  • リモートデスクトップ: 使えますが、ちょっとした編集には重くて扱いにくいです。

  • Happier: コーディングエージェントをクロスデバイスで実行・オーケストレーションするためのオープンソースアプリです。セッション UI にリポジトリを認識するファイル画面とエディターがあるので、セッションのコンテキストを離れずに小さな変更ができます。 トレードオフ: マシン/デーモンに到達できる必要があり、大きなリファクタリングにはフルキーボードのほうが向いています。

Happier を初めて使う場合(概要と入手方法)

Happier を初めて見る方へ。Happier は、Claude Code、Codex、OpenCode などの AI コーディングエージェント向けのオープンソースのコンパニオンアプリ(モバイル/Web/デスクトップ)です。

ここでのワークフローは、セッション(とリポジトリ/Git)はワークスペースのあるマシンに置いたまま、Happier でスマホから実際のワークスペースのファイルを編集する、というものです。

セットアップ:

前提条件

  • セッションを所有するマシン/デーモンがオンラインで到達できること。
  • セッションからリポジトリ/ワークスペースにアクセスできること。

手順: スマホからファイルを編集する

1) ファイルを開く

セッション UI で ファイル(Files) を開きます。

スマホサイズのレイアウトでは、サイドバーと詳細ペインではなく、全画面のフローになります。

2) ファイルを探す

次のどれかを使います:

  • ツリーを閲覧する
  • 名前がわかっていれば検索する
  • 変わったところに集中したいときは、変更済みのみのフィルターを使う

3) ファイルを編集モードで開く

ファイルを開き、編集モードに切り替えます。

変更します。

4) 何が変わったか確認する

スマホから確認する方法は2つあります:

  • レビュー(Review) を開いて、未コミットの差分一式をざっと見る
  • ツールのタイムラインで、どんな編集があったかを見る(エージェントがまだ動いているときに特に便利です)

5) 今コミットするか後でするか決める

  • すでに「スマホからコミットする」モードなら、ステージしてコミットできます。
  • 片付けをしているだけなら、未コミットのままにして、最後のコミットは後でノートPCからしても問題ありません。

添付ファイルとワークスペースのファイル(混同しやすい点)

「これを git に入れたい」なら、編集すべきなのはワークスペースのファイルです。

添付ファイルはログや成果物をモデルと共有するのに便利ですが、リポジトリを編集するのとは別物です。

トラブルシューティング

症状: ファイル(Files)が空、または読み込まれない

考えられる原因:

  • 所有するマシン/デーモンに到達できない

対処:

  • 接続を回復します。ファイル画面はマシンのワークスペース API に依存しています

症状: ファイルは閲覧できるが、編集が保存されない

考えられる原因:

  • 実際のワークスペースのファイルではなく、添付ファイルやプレビュー画面を編集している

対処:

  • ファイル(Files) からファイルを開き、編集モードになっていることを確認する

関連ガイド

mobilefilesgitworkflows
最終更新: 2026-10-26