【ITニュース解説】Developing a Web App with Claude from an iPad (4): Switching from Remote Back to Local

Webアプリを開発する際、時には開発環境をリモートからローカルへ切り替える必要がある。この記事では、iPadでのリモート開発からMacでのローカル開発へ戻すための具体的な手順と、その際に注意すべき点について解説する。この切り替え作業を正しく行うことで、開発の整合性を保ち、スムーズに作業を再開できる。

まず、リモート開発中にMac側の環境がどのような状態になっているかを理解することが重要である。Mac上にあるローカルのリポジトリは、リモートで行われた作業によってGitHub上の最新の状態から遅れている。リモートでブランチがマージされた結果、GitHubのメインブランチがMacのメインブランチよりも新しくなっている。また、リモートセッション中に作成されたレポートファイルは、Mac上のレポートフォルダには存在せず、レポート用リポジトリにのみ存在する。これらの二つの要素を、Macでの作業を始める前にGitHub上の最新の状態と一致させる必要がある。

Macでのローカル開発のセットアップでは、主に次の要素が連携して機能する。コードを生成するAIアシスタントであるClaude Codeは、MacのTerminalアプリ内で動作し、リポジトリが格納されているフォルダ内で起動される。開発中に生成される各種レポートは、Mac上の特定のフォルダに保存される。そして、チャット形式で指示を与えるClaudeは、そのレポートフォルダの内容を読み取って、開発状況を把握する。

Terminalアプリ内でClaude Codeを起動する方法は以下の通りである。まずTerminalアプリを開き、cdコマンドを使って現在のフォルダをリポジトリのあるフォルダに変更する。例えば、cd work/<リポジトリ名>のように入力する。<リポジトリ名>の部分は、実際のフォルダ名に置き換える。もしフォルダ名が思い出せない場合は、lsコマンドで現在の場所にあるフォルダの一覧を表示できる。各コマンドの入力後にはReturnキーを押す。現在のフォルダがリポジトリのフォルダ名になっていることをプロンプトで確認したら、claudeと入力してReturnキーを押す。初めてClaude Codeを特定のフォルダで実行する際には、そのフォルダを信頼するかどうかの確認が表示される。ここで表示されるパスが、必ずリポジトリのフォルダで終わっていることを確認する。もしホームフォルダなど、意図しないフォルダのパスが表示された場合は「No」を選択する。ホームフォルダを信頼してしまうと、Claude Codeがその中のすべてのファイルにアクセスできるようになり、またリポジトリを正しく認識できない可能性があるため、この確認は非常に重要である。以前に信頼したことがあるフォルダであれば、この確認は表示されずに直接起動する。

リモートからローカルへの切り替えは、以下の六つのステップで進める。

1. Macの電源を入れる。Macを起動した後、iCloudがファイルの同期を完了するまで数分間待機する。これは、iPadから転送されたファイルが保存されている可能性があるドロップフォルダの状態を最終ステップで確認するためである。
2. チャットでClaudeに「back on the Mac」とメッセージを送信する。これにより、Claudeは待機していたタスクや情報を提示する。
3. ローカル環境の整理を行う。ClaudeからClaude Codeへ向けた短いタスクメッセージが送信される。このメッセージは、特別なブランチの作成やプルリクエストは不要な、シンプルな作業を依頼する。具体的には、Claude Codeに対し、GitHubからローカルリポジトリを最新の状態に更新（メインブランチに切り替え、変更をプル）し、現在のメインブランチの最新コミットを報告するよう指示する。また、リモートのレポート用リポジトリにのみ存在するすべてのレポートファイルを、Mac上のレポートフォルダに、既存のファイルを上書きすることなくコピーし、コピーしたファイルの名前とサイズを報告する。この際、ファイルを削除する作業は指示しない。このメッセージをTerminalで起動したClaude Codeに貼り付けると、Claude Codeは自身のレポートをMac上のレポートフォルダに書き込み、Claudeがそれを読み取る。
4. リモート作業中にMacが必要で延期されていた、本番環境でのライブチェックなどの作業があれば、この時点で実施する。
5. ブランチの確認を行う。以前のリモート開発の最終ステップで完了したブランチがGitHub上で削除されていることを確認する。保存しておきたい作業が含まれているブランチなどは、そのまま残しておく。
6. iPadからのファイルを整理する。iCloud DriveにあるドロップフォルダをMacで開き、リモート作業中にiPadから転送されたファイルをそれぞれの正しい場所へ移動させる。もしフォルダが空であるか、古いファイルのみが残っている場合は、特別な作業は不要である。

この切り替えプロセス中に、絶対に避けるべき重要な行為がいくつかある。まず、ステップ3でローカルリポジトリがGitHubの最新の状態に更新される前に、Mac上でClaude Codeを使った開発作業を開始してはならない。遅れたローカルコピーで作業を進めてしまうと、同じファイルに対して二つの異なるバージョンが存在することになり、後でマージする際に大きな問題を引き起こす可能性がある。次に、レポートファイルのコピーは手動で行ってはならない。Claude Codeが正確にバイト単位でコピーし、その整合性を確認するため、自動化されたプロセスに任せるべきである。最後に、Terminalでホームフォルダを信頼することは絶対に避ける。これはセキュリティ上のリスクを伴い、意図しないファイルアクセスを許してしまうことになるからである。

以上のステップがすべて完了し、以下の条件が満たされていることを確認できれば、安全にMacでのローカル開発作業を開始できる。ローカルリポジトリがGitHub上のメインブランチと全く同じコミットにあること。リモート開発中に作成されたすべてのレポートがMac上のレポートフォルダに存在すること。Claude Codeがリポジトリフォルダ内でTerminalから正しく起動すること。延期されていた必要なチェック作業がすべて完了していること。そして、iCloudのドロップフォルダに移動すべきファイルが何も残っていないこと。これらの条件をクリアすることで、スムーズでエラーのない開発環境が整う。