スマホAIエージェント運用

ClaudeCodeを
スマホ操作
Moshiとtmux入門手順

スマホからClaudeCodeを操作するMoshiとtmux環境のヒーロー画像
この記事のゴール

スマホからMoshiでMacに入り、ClaudeCodeやCodex CLIをそのまま動かすための環境構築をまとめました。

Tailscaleで安全な接続経路を作り、Moshiでスマホから入り、tmuxで作業セッションを守り、Mac側はcaffeinateでスリープを止めます。

  • Mac対応
  • iPhone / iPad対応
  • Tailscale対応
  • Moshi対応
  • tmux対応
  • Typeless活用

スマホは操作端末。

ClaudeCodeはMacで動かす。

全体像

この記事で分かること

この記事では、スマホからMac上のClaudeCodeやCodex CLIを動かすための初期設定を、初心者向けに整理します。

この記事の内容
基本理解

なぜMac上のClaudeCodeを
スマホ操作するのか

スマホでAIを使うだけなら、ChatGPTアプリやClaudeアプリで十分です。ただし、ClaudeCodeやCodex CLIの本領は「PC内のファイルを読み、編集し、コマンドを実行し、テストして、差分を残す」ことです。

AIエージェント本体はMacBookで動かし、スマホはそのMacBookに接続する操作端末として使います。この構成なら、PC内のGit、Node.js、Python、画像素材、社内資料、環境変数、ビルドコマンドと連動できます。

この構成のメリット
  • PC内の実ファイルをそのまま扱える
  • ClaudeCodeやCodex CLIのログイン状態を使える
  • スマホの通信が切れてもtmux内の作業を残せる
  • 移動中に進捗確認、追加指示、承認だけできる
構成

Tailscale、Moshi、tmux、caffeinateを組み合わせる

Mosh公式では、MoshはSSHの代わりに使えるモバイル向けリモートシェルで、Wi-FiやLTEなどネットワークを移動しても接続を維持しやすいと説明されています。ただし、Mac本体がスリープすると、そこで動いているClaudeCodeやCodex CLIも止まります。 

スマホ
  ↓ Moshi
Tailscaleのプライベートネットワーク
  ↓ SSH / Mosh
MacBook
  ↓ tmux
ClaudeCode / Codex CLI

なお、SSHやtmuxの設定をせずに、まずもっと手軽なスマホ連携から始めたい人は、Codexデスクトップ版とChatGPTアプリをつなぐ方法もあります。ターミナルなしで似た体験ができるので、こちらもあわせて読んでください。

Codexデスクトップ版スマホ連携｜ChatGPT操作手順のヒーロー画像
あわせて読む Codexデスクトップ版スマホ連携｜ChatGPT操作手順 CodexデスクトップとChatGPTアプリで、ターミナルなしのスマホ連携から始める手順を確認できます。
準備

事前に準備するもの

  • iPhoneまたはiPad
  • MacBook
  • Tailscaleアカウント
  • Moshiアプリ
  • Mac側の管理者権限
  • Homebrew
  • ClaudeCodeまたはCodex CLI

この記事は2026年5月19日時点の情報を元にしています。アプリの画面、料金、対応OS、ログイン方法は変わることがあります。インストール直前に公式ページも確認してください。

手順1

TailscaleでスマホとMacをつなぐ

Tailscaleは、スマホとMacを自分専用のプライベートネットワークに入れるためのツールです。外出先のスマホからMacへ入る場合、いきなりグローバルIPやポート開放でSSHを公開するのはおすすめしません。 

whoami
hostname

Tailscaleアプリ上に表示されるMacの端末名、またはTailscale IPを控えます。接続先は ユーザー名@MacのTailscale名 または ユーザー名@MacのTailscale IP の形になります。

手順2

Mac側でSSH、Mosh、tmuxを準備する

Macの「システム設定 → 一般 → 共有 → リモートログイン」をオンにします。アクセスを許可するユーザーは、普段使っている自分のユーザーに絞るのが安全です。 

brew --version
brew install mosh tmux
mosh --version
tmux -V
手順3

nosleepエイリアスを作る

MacBookがスリープすると、そこで動いているAIエージェントも止まります。移動中にClaudeCodeへ長い作業を任せるなら、Mac側でスリープを止める準備が必要です。 

alias nosleep='caffeinate -dimsu'
alias nosleep-on='caffeinate -dimsu & echo $! > ~/.nosleep.pid && echo "nosleep on: $(cat ~/.nosleep.pid)"'
alias nosleep-off='kill $(cat ~/.nosleep.pid) && rm ~/.nosleep.pid && echo "nosleep off"'
source ~/.zshrc

長時間の nosleep はバッテリーを使います。基本は電源接続中のMac、または据え置きMacで使うのが安全です。

手順4

remoteエイリアスでtmuxセッションを守る

MoshiやMoshはモバイル回線に強いですが、接続が絶対に落ちないわけではありません。接続が落ちてもClaudeCodeの作業場所を残すためにtmuxを使います。 

remote() {
  local name="${1:-agent}"
  tmux new-session -A -s "$name"
}
remote claude
remote codex
remote blog

remote claude でセッションがなければ作成され、すでにあればそこへ接続します。tmuxから抜けるときは Ctrl + b → d です。

手順5

MoshiからMacへ接続する

Moshiで新しい接続を作ります。HostにはMacのTailscale名またはTailscale IP、UserにはMacのユーザー名を入れます。最初はSSHで接続テストし、安定したらMosh接続に切り替えると切り分けしやすいです。

入力する基本情報
  • Host: MacのTailscale名またはTailscale IP
  • User: Macのユーザー名
  • Authentication: SSHキーまたはパスワード
  • Protocol: まずSSH、安定したらMosh
whoami
pwd
手順6

ClaudeCode / Codex CLIを起動する

MoshiからMacへ入れたら、作業フォルダへ移動してtmuxセッションに入ります。 

cd ~/your-project
remote claude
claude
cd ~/your-project
remote codex
codex
最初に送るプロンプト

スマホ操作用に安全条件を先に渡す

スマホからAIエージェントに投げる最初の依頼は、短すぎると迷子になりやすいです。最初だけ、目的、対象フォルダ、安全条件、確認方法をまとめて渡します。 

あなたはこのMac上で動くAIコーディングエージェントです。

目的:
スマホからMoshi経由で作業しているので、短い確認を挟みながら安全に進めてください。

前提:
- 作業場所は現在のディレクトリです
- 既存ファイルを読む前に、まず構成を確認してください
- 秘密情報、APIキー、.envの中身は表示しないでください
- 破壊的なコマンドは実行前に必ず確認してください
- 大きな変更は小さく分けてください

最初にやってほしいこと:
1. 現在のディレクトリ構成を確認する
2. このプロジェクトが何をするものか要約する
3. 変更前に読むべきREADMEやAGENTS.mdがあれば列挙する
4. 次に送るべき指示文を3案出す
音声入力

Typelessで音声入力を強くする

Moshiにも音声入力機能があります。ただ、長く話して、そのままAIへの指示文として整えたい場合は、TypelessのようなAI音声入力ツールを併用するとかなり楽です。 

今からブログ記事を作りたい。
対象読者は初心者。
手順はTailscale、Moshi、tmux、nosleep、Typelessの順番。
専門用語は説明して。
最後にエラー対処とFAQも入れて。
コマンドはコピペできる形で出して。

短いコマンドはMoshi内で直接入力し、長い相談はTypelessで整えて貼る。この使い分けが実務では一番ラクです。

トラブル対応

よくあるエラーと対処法

MoshiからMacに接続できない

Tailscale側でスマホとMacが同じアカウントにログインしているか、Macのリモートログインがオンか確認します。端末名で失敗する場合は、MagicDNS名が解決できていないだけのことがあるので、Tailscale IPで試してください。

SSHでは入れるがMoshで入れない

Mac側にMoshが入っているか確認します。MoshはUDP通信を使うため、環境によってはMoshだけ失敗することがあります。その場合はSSH + tmuxで運用しても大丈夫です。

tmuxに入れない

tmux -V でインストールを確認し、source ~/.zshrc で設定を反映します。急ぐ場合は tmux new-session -A -s agent を直接使ってください。

Macがスリープして作業が止まる

nosleep または nosleep-on を使います。安定運用したい場合は、電源接続中のMacを開いた状態、または据え置きMacで試すのが安全です。

AIプロンプト

AIに聞くための
プロンプト集

接続や設定で止まった時は、エラー文をそのまま検索するより、状況を整理してChatGPT、Claude、Claude Code、Codexに渡す方が早いです。

秘密のキー、パスワード、顧客情報、決済情報は貼らないでください。エラー文と状況だけで十分です。
01

Tailscale接続で迷った時

スマホとMacがつながらない、どの名前で接続すればいいか分からない時に使います。

スマホからMacへTailscaleで接続する設定をしています。
今の状況:
スマホのTailscaleアプリにMacが表示されているか:
MacとスマホのTailscaleは同じアカウントか:
接続に使っている宛先（端末名かIPか）:
今分からないこと:

初心者向けに、次に確認する順番を教えてください。
02

Moshiが繋がらない時

Moshiで接続ボタンを押しても入れない時に使います。

スマホのMoshiアプリからMacに接続できません。
使った接続方式（SSHかMoshか）:
表示されたエラー:
Macのリモートログインはオンか:
TailscaleアプリでMacはオンラインに見えるか:

原因の候補を3つに絞って、確認する順番を教えてください。
03

SSHでは入れるのにMoshで入れない時

SSH接続は成功するのに、Moshに切り替えると失敗する時に使います。

スマホからMacへ、SSHでは入れますがMoshだと失敗します。
表示されたエラー:
Mac側で mosh --version は表示されるか（分かればでOK）:
使っている回線（Wi-Fiかモバイル回線か）:

Moshが失敗する原因の候補と、当面SSHとtmuxで進めてよいかの判断を教えてください。
04

tmuxセッションが見つからない時

作業していたセッションに戻れなくなった時に使います。

tmuxのセッションに戻れなくなりました。
直前に打ったコマンド:
tmux ls の結果（画面に出ている範囲だけでOK）:
remote コマンドは使えるか:

中の作業を消さずにセッションへ戻る手順を、初心者向けに順番で教えてください。
05

セキュリティ設計を相談したい時

外から自分のMacへ入る構成が不安な時に使います。

スマホからMac上のAIエージェントを操作する環境を作りました。
接続経路: Tailscale + Moshi（SSH / Mosh）
Macで扱う内容（個人プロジェクトか仕事のファイルか）:
不安な点:

この構成で最低限やるべきセキュリティ設定を、優先度順に教えてください。
秘密のキーやパスワードは、このチャットにも貼りません。
06

バッテリーとスリープ運用を相談したい時

nosleepをどこまで使っていいか迷った時に使います。

外出中もMacでAIエージェントを動かし続けたいです。
Macの置き場所（自宅かオフィスか持ち歩きか）:
電源（つないだままかバッテリーか）:
任せたい作業時間の目安:

caffeinateでスリープを止める場合の安全な運用と、やめた方がいい使い方を教えてください。
07

スマホとPCの作業分担を設計したい時

移動中にどこまで任せていいか決めたい時に使います。

スマホからAIエージェントに作業を任せる運用を整えたいです。
自分の仕事:
1日の移動時間の目安:
よくやる作業:

移動中にスマホからやってよい作業と、PCの前でやるべき作業に分けて提案してください。
本番反映など、慎重にすべき作業も教えてください。
確認

設定後に確認すること

  • スマホのTailscaleでMacがオンラインに見える
  • MoshiからSSHでMacに入れる
  • MoshiからMoshでMacに入れる
  • remote test でtmuxセッションに入れる
  • Moshiを閉じて再接続しても同じtmuxセッションに戻れる
  • Mac側で nosleep が使える
  • ClaudeCodeまたはCodex CLIがtmux内で起動する
実務

実務での使い方14選

この環境ができると、移動中にできることが増えます。開発者だけでなく、SNS運用者や経営者にも効く使い方を14個挙げます。

外出先からの記事執筆継続 電車の中でClaudeCodeにブログ記事の続きを書かせ、見出しと結論だけスマホで確認する。
SNS予約投稿の下書き確認 予約前の投稿文の下書きをAIに整えさせ、スマホで最終チェックと修正指示だけする。
SNS投稿候補のCSV整理 投稿ネタや候補文をCSVにまとめさせ、帰宅後すぐ使える状態にしておく。
動画レンダリングの進捗確認 Remotionなどの動画書き出しをMacで回し、進捗とエラーだけスマホで見る。
YouTube台本の見出し作成 移動中に台本の骨組みと見出しだけ先に作らせる。
AI画像生成プロンプトの量産 サムネイルや投稿画像用のプロンプト案をまとめて出させる。
小さなバグ修正の依頼 Codex CLIに軽微な修正を任せ、結果の要約だけ読む。
テスト失敗の原因確認 落ちたテストの原因候補だけを3行で報告させる。
管理画面の文言修正 画面文言の修正を依頼し、変更点の要約を確認する。
経営者の移動中承認作業 AIが進めた作業の要約を読み、進めてよいかの判断だけ移動中に返す。
会議前の資料要約 Mac内の資料をAIに要約させ、移動中に論点を把握しておく。
問い合わせ返信文の下書き 返信文の下書きを作らせ、PC前で最終確認してから送る。
月次レポートの下書き 数字の整理とレポート構成をAIに進めさせておく。
競合リサーチの継続実行 リサーチを回しておき、移動中に途中結果へ追加指示を出す。

ただし、スマホから本番反映までやるのは慎重にしてください。スマホ作業は確認や追加指示には強いですが、細かい差分レビューには向きません。SNSの自動投稿もBanリスクの責任を取れないため推奨しません。下書き作成と予約前チェックまでをおすすめ範囲にしてください。

おすすめ運用
  • 移動中: 調査、下書き、構成、軽微な修正、テスト確認
  • PC前: 差分レビュー、本番反映、環境変数、決済、DB作業
まとめ

まとめ ClaudeCodeをスマホ操作するならtmuxまで入れる

スマホからClaudeCodeやCodex CLIを使うなら、ただSSHするだけでは弱いです。Tailscaleで安全な接続経路を作り、MoshiでスマホからMacへ入り、Moshでモバイル回線に強くし、tmuxで接続切れから作業を守り、caffeinateでMacのスリープを防ぎます。 

alias nosleep='caffeinate -dimsu'

remote() {
  local name="${1:-agent}"
  tmux new-session -A -s "$name"
}
FAQ

よくある質問

Moshiだけで十分ですか？

短時間の接続ならMoshiだけでも使えます。ただし、AIエージェントに長い作業を任せるならtmuxを併用してください。接続が切れたときに作業セッションを残すためです。

Tailscaleは必須ですか？

必須ではありませんが、初心者にはかなりおすすめです。SSHをインターネットへ直接公開するより、Tailscale内のプライベート接続で扱う方が始めやすいです。

MacBookを閉じたままでも使えますか？

環境によります。電源接続、外部ディスプレイ、Macの設定によって挙動が変わります。安定させたい場合は、まずMacBookを開いた状態でnosleepを使って試してください。

Moshが失敗したら使えませんか？

使えます。SSH + tmuxでも実用できます。Moshはモバイル回線での復帰に強い選択肢ですが、まずSSHで入れる状態を作ることが先です。

Typelessは必須ですか？

必須ではありません。ただ、スマホから長いプロンプトを打つのは大変です。話した内容を整えて貼れる音声入力を使うと、移動中のAIエージェント操作がかなり楽になります。

セキュリティで一番気をつけることは何ですか？

SSH接続、秘密鍵、.env、APIキー、本番DBです。秘密情報をAIに貼らない、接続先を自分の端末に絞る、作業前にGit差分を確認する。この3つは必ず守ってください。

相談

スマホからClaudeCodeを動かす環境を一緒に整えます

最初のSSH、Tailscale、tmux、スリープ対策で詰まる人は多いです。自分のMacで設定できるか不安な人は、公式LINEから相談してください。

公式LINEで相談する AI診断を受ける
更新履歴

更新履歴

  • 2026-07-02: AIに聞くためのプロンプト集を新設。実務活用事例を14選に拡充。FAQと構造化データを6問に統一。用語集と関連記事（Codexデスクトップ版スマホ連携）を追加。
  • 2026-05-19: 記事公開。
ブログ一覧へ戻る
AIツール

関連記事一覧

Codexデスクトップ版スマホ連携｜ChatGPT操作手順のヒーロー画像
関連記事
Codexデスクトップ版スマホ連携｜ChatGPT操作手順Codexデスクトップ版をMacで動かし、ChatGPTモバイルアプリから進捗確認、承認、差分確認、追加指示を行う連携手順を初心者向けに解説します。QRコードでの接続方法、承認の安全ルール、つながらない時の対処法まで、2026年7月時点の公式情報でまとめました。記事を読む
Claude Codeインストール完全ガイド｜初心者向けのヒーロー画像
関連記事
Claude Codeインストール完全ガイド｜初心者向けClaude Codeのインストール方法を初心者向けに解説。Mac・Windows対応、コピペOK。料金、できること、危険性、エラー対処、よくある質問までまとめました。記事を読む
Codex CLIインストール完全ガイド｜初心者向け手順のヒーロー画像
関連記事
Codex CLIインストール完全ガイド｜初心者向け手順OpenAI Codex CLIのインストール方法を初心者向けに解説。ChatGPT課金ユーザーにおすすめな理由、Mac・Windows対応、Claude Code比較、自動化事例、エラー対処までまとめました。記事を読む