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

関連issue: #102 作成日: 2026-03-08

日常の使い方¶

1. スマホから接続する¶

Tailscale アプリをONにする（VPN接続）
Termius アプリを開く
登録済みのホストに接続（自動で自宅PCのWSL2に繋がる）

2. Claude Codeを起動する¶

# これだけでOK（エイリアス設定済み）
cc

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

3. Claude Codeで作業する¶

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

4. 作業を中断する（セッション維持）¶

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

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

接続情報¶

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

tmux 基本操作¶

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

操作	キー
デタッチ（切断、セッション維持）	`Ctrl+a` → `d`
ペインを縦分割	`Ctrl+a` → `\|`
ペインを横分割	`Ctrl+a` → `-`
ペイン移動（左/下/上/右）	`Ctrl+a` → `h/j/k/l`
セッション一覧	ターミナルで `tmux ls`
セッション復帰	ターミナルで `tmux attach -t claude`

タップ操作も有効（マウスモードON）

トラブルシューティング¶

接続できない¶

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

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

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

# なければ新規作成
cc

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