コンテンツにスキップ

スマホからClaude Code利用マニュアル

📁 docs/dev-environment/artifact/20260308_スマホからClaude Code利用マニュアル.md

関連issue: #102 作成日: 2026-03-08 更新日: 2026-03-11(複数セッション対応)

日常の使い方

1. スマホから接続する

  1. Tailscale アプリをONにする(VPN接続)
  2. Termius アプリを開く
  3. 登録済みのホストに接続(自動で自宅PCのWSL2に繋がる)

2. Claude Codeを起動する

# これだけでOK
cc

このコマンドで以下が自動で行われる: - 既存のtmuxセッション claude があれば再接続 - なければ ~/MyLab ディレクトリで新規セッション作成

3. 複数セッションを並行で使う

cc にセッション名を指定すると、別々のClaude Codeを同時に動かせる。

cc          # メインセッション(デフォルト名: claude)
cc work2    # 2つ目のセッション
cc work3    # 3つ目のセッション

Termiusでの操作手順:

  1. 1つ目: いつも通りホストに接続 → cc
  2. 2つ目: 画面下の 「+」タブ をタップ → 同じホストにもう1回接続cc work2
  3. タブを切り替えて各セッションを操作
タブ1: ssh → cc        → Claude Code(メインタスク)
タブ2: ssh → cc work2  → Claude Code(別タスク)
タブ3: ssh → cc work3  → Claude Code(さらに別タスク)

セッション一覧は tmux ls で確認できる

4. Claude Codeで作業する

通常通りClaude Codeを使う。スマホでも全機能利用可能。

5. 作業を中断する(セッション維持)

Ctrl+a → d でtmuxからデタッチ。

  • Claude Codeはバックグラウンドで動き続ける
  • Termiusを閉じても、電波が切れてもセッションは維持される
  • 次回接続時に cccc work2 で復帰できる

接続情報

項目
Tailscale IP(自宅PC) 100.87.120.65
SSHポート 2222
ユーザー名 kazuma
WSL2ディストリ Ubuntu
リポジトリパス ~/MyLab

tmux 基本操作

全て Ctrl+a がプレフィックスキー(先に押してから次のキー)。

操作 キー
デタッチ(切断、セッション維持) Ctrl+ad
ペインを縦分割 Ctrl+a|
ペインを横分割 Ctrl+a-
ペイン移動(左/下/上/右) Ctrl+ah/j/k/l
セッション一覧 ターミナルで tmux ls
セッション復帰 cc または cc セッション名

タップ操作も有効(マウスモードON)


トラブルシューティング

接続できない

  1. Tailscaleが有効か確認 → スマホのTailscaleアプリがONになっているか
  2. 自宅PCが起動しているか → スリープしていると接続不可
  3. ポートプロキシの再設定 → 自宅PCの管理者PowerShellで:
    & "C:\Users\kazuma\scripts\start-wsl-services.ps1"
    

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

# セッション一覧を確認
tmux ls

# なければ新規作成(名前を指定も可)
cc
cc work2

Claude Codeの認証が切れた

cd ~/MyLab
claude
# 表示されるURLをブラウザで開いて認証

SSH接続がすぐ切れる

Termius側の設定で「Keep Alive」を有効にする(設定 → SSH → Keep Alive Interval: 30秒)


構成図

┌─────────────────┐     Tailscale VPN      ┌──────────────────────────┐
│  iPhone          │  ──────────────────►  │  自宅PC (Windows 11)      │
│  Termius         │      SSH (port 2222)   │                          │
│                  │                        │  ┌─ WSL2 Ubuntu ───────┐ │
└─────────────────┘                        │  │  sshd (port 2222)    │ │
                                           │  │  ↓                   │ │
                                           │  │  tmux セッション     │ │
                                           │  │  ↓                   │ │
                                           │  │  Claude Code         │ │
                                           │  │  (~/MyLab)           │ │
                                           │  └──────────────────────┘ │
                                           └──────────────────────────┘

自動起動について

PC起動時にタスクスケジューラが以下を自動実行: - WSL2のSSHサーバー起動 - ポートプロキシ設定(WSL2のIP変更に対応)

スクリプト: C:\Users\kazuma\scripts\start-wsl-services.ps1 ログ: C:\Users\kazuma\scripts\wsl-services.log