Claude Code Remote Control実践ガイド——リモートマシンでエージェント開発を24時間回す

はじめに

Claude Codeで開発を進めていると、こんな場面に遭遇します。

「Claude Codeが勝手に働いてくれて、スマホで進捗を確認できたら最高なのに」——そう思った方のために、2026年2月に大きく進化した3つのリモート開発機能を解説します。

この記事を読み終わったら、以下ができるようになります。

• Remote Controlでローカルセッションをスマホ・ブラウザから操作する
• Claude Code on the web（--remote）でクラウドにタスクを投げて非同期に開発する
• GitHub ActionsでIssue起票からコード実装までを完全自動化する

3つのリモート開発機能の全体像

まず、Claude Codeが提供する3つのリモート開発機能の違いを整理します。

事前準備

共通の前提

# Claude Codeの最新版にアップデート
claude update

# バージョン確認
claude -v

Remote Controlを使う場合

• ProまたはMaxプランが必要（APIキーでは利用不可）
• claude.aiへのログインが必要

# ログイン（まだの場合）
claude
# セッション内で /login を実行

• プロジェクトディレクトリで一度claudeを実行し、ワークスペース信頼ダイアログを承認しておく

GitHub Actionsを使う場合

• Anthropic APIキーが必要
• Claude GitHubアプリのインストール

# Claude Code内で実行すると対話的にセットアップできる
/install-github-app

ハンズオン 1: Remote Controlでスマホから開発を続ける

架空の業務システム「KanriPro」の開発を例に、Remote Controlを体験します。

Remote Controlセッションを開始する

プロジェクトディレクトリで以下を実行します。

cd ~/projects/kanri-pro
claude remote-control

ターミナルにセッションURLとQRコードの案内が表示されます。

Remote Control session started.
Session URL: https://claude.ai/code/session/...

Press spacebar to show QR code.

スペースキーを押すとQRコードが表示されるので、スマホのClaudeアプリでスキャンします。

スマホからタスクを送信する

スマホ側のClaude UIから、普通に指示を送ります。

KanriProの経理モジュールに、インボイス制度対応の
自動仕訳生成機能を追加してください。

要件:
- src/app/accounting/auto-journal/ に新規ページを作成
- Firestoreのinvoicesコレクションから未処理のインボイスを取得
- 仕訳ルールに基づいて自動で仕訳データを生成
- 生成結果をjournalsコレクションに保存

ローカルマシンのClaude Codeが実際にファイルを読み書きし、その結果がリアルタイムでスマホに表示されます。

既存セッションをRemote Controlに切り替える

すでにClaude Codeで作業中の場合は、セッション内から切り替えることもできます。

# Claude Codeセッション内で
/rename kanri-pro-accounting

# Remote Controlを開始
/remote-control

/renameでセッション名を付けておくと、スマホのセッション一覧で見つけやすくなります。

すべてのセッションでRemote Controlを有効にする

毎回/remote-controlを実行するのが面倒な場合は、デフォルトで有効化できます。

# Claude Codeセッション内で
/config
# 「Enable Remote Control for all sessions」をtrueに設定

Remote Controlの制限事項

ハンズオン 2: Claude Code on the webで非同期タスクを投げる

Remote Controlは「ローカルマシンを使い続ける」方式でした。一方、Claude Code on the webはAnthropicが管理するクラウドVM上でタスクを実行します。ローカルPCを閉じても作業が続きます。

ターミナルからクラウドにタスクを送信する

2つの方法があります。

方法1: & プレフィックス（セッション内から）

Claude Codeセッション内でメッセージの先頭に&を付けると、そのタスクがクラウドに送信されます。

& KanriProのテストカバレッジを80%以上に引き上げてください。
  特にsrc/lib/accounting/配下のユーティリティ関数のユニットテストを追加してください。

方法2: --remote フラグ（コマンドラインから）

claude --remote "KanriProのsrc/components/配下の全コンポーネントにJSDocコメントを追加してください"

どちらの場合も、タスクはクラウドVMで非同期に実行されます。

進捗を確認する

# Claude Codeセッション内で
/tasks

/tasksコマンドで実行中のwebセッション一覧を確認できます。claude.aiやClaudeモバイルアプリからも進捗を確認・操作できます。

複数タスクを並列実行する

&コマンドは独立したwebセッションを作成するため、複数タスクを同時に投げられます。

& src/app/accounting/ のテストを追加
& src/app/inventory/ のテストを追加
& src/app/sales/ のテストを追加

3つのタスクがクラウド上で並列に動きます。

クラウドのセッションをローカルに引き戻す

クラウドで実行した結果をローカルに取り込みたい場合は、teleportを使います。

方法1: セッション内から

# Claude Codeセッション内で
/teleport
# または短縮形
/tp

対話的にセッションを選択できます。

方法2: コマンドラインから

# 対話的に選択
claude --teleport

# セッションIDを指定
claude --teleport <session-id>

teleportを実行すると、リモートセッションのブランチがチェックアウトされ、会話履歴もローカルに読み込まれます。

使い分けフロー

ハンズオン 3: GitHub Actionsで完全自動化する

Remote ControlとClaude Code on the webは「人間が指示を出す」方式でした。GitHub Actions連携を使うと、Issue起票やPRコメントをトリガーに、完全自動でClaude Codeが動きます。

ワークフローファイルを作成する

.github/workflows/claude.ymlを作成します。

name: Claude Code

permissions:
  contents: write
  pull-requests: write
  issues: write

on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
  issues:
    types: [opened, assigned]

jobs:
  claude:
    if: |
      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
      (github.event_name == 'issues' && contains(github.event.issue.body, '@claude'))
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

Issueから自動実装を発動する

GitHubでIssueを作成し、本文に@claudeを含めます。

## 実装内容

KanriProの在庫管理モジュールに、在庫アラート機能を追加してください。

@claude

## 要件
- src/app/inventory/alerts/ に新規ページを作成
- Firestoreのinventoryコレクションから在庫数を取得
- 閾値（threshold）を下回った商品をリスト表示
- アラート閾値はFirestoreのsettingsコレクションから取得

## 技術的注意点
- Next.js App Router（Server Components）で実装
- Tailwind CSSでスタイリング
- TypeScript厳格モード準拠

ワークフローが発動し、Claude Codeがコードを実装してPRを作成します。

PRレビューコメントで修正を依頼する

PRが作成された後、レビューコメントで追加修正を依頼できます。

@claude このコンポーネントにローディング状態の表示を追加してください。
Suspenseではなく、useStateで管理してください。

カスタムワークフロー: 自動コードレビュー

PR作成時に自動でレビューを実行するワークフローも作れます。

name: Auto Review

on:
  pull_request:
    types: [opened, synchronize]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
          prompt: |
            このPRの変更内容をレビューしてください。
            以下の観点でチェックしてください:
            - TypeScriptの型安全性
            - セキュリティ上の問題
            - パフォーマンスへの影響
            - CLAUDE.mdのルールへの準拠
          claude_args: "--max-turns 5 --model claude-sonnet-4-6"

全体戦略: 3つのモードを組み合わせる

実際のプロジェクトでは、3つのモードを組み合わせて使います。KanriProの開発を例にしたワークフローを紹介します。

推奨フロー: 「設計はローカル、実装はクラウド」

# Step 1: ローカルでplan modeを使って設計
claude --permission-mode plan

# Step 2: 計画が固まったらクラウドに実行を投げる
& 先ほどの計画に基づいて、在庫アラート機能を実装してください

--permission-mode planを使うと、Claude Codeはファイルの読み取りとコードベースの探索だけを行います。設計に納得したら、&プレフィックスでクラウドに自律実行を委任するのが最も効率的なパターンです。

Tips・注意点

コスト管理

--max-turnsや--max-budget-usdで上限を設定しておくと安心です。

# 最大ターン数を制限
claude -p --max-turns 10 "タスク内容"

# 最大予算を制限（print modeのみ）
claude -p --max-budget-usd 5.00 "タスク内容"

セキュリティ

• Remote Controlはアウトバウンドのみ（インバウンドポートは開かない）
• すべての通信はTLS経由でAnthropic APIを通過
• Claude Code on the webは隔離されたVM上で実行される
• GitHub Actions連携ではAPIキーを必ずGitHub Secretsに格納する

CLAUDE.mdの重要性

どのモードでもClaude CodeはCLAUDE.mdを読み込みます。プロジェクトのルールをCLAUDE.mdに記載しておけば、ローカルでもクラウドでもGitHub Actionsでも一貫した実装品質が保たれます。

SessionStartフックでクラウド環境をカスタマイズ

Claude Code on the webのクラウド環境で追加の依存関係が必要な場合は、SessionStartフックを使います。

{
  "hooks": {
    "SessionStart": [
      {
        "matcher": "startup",
        "hooks": [
          {
            "type": "command",
            "command": "\"$CLAUDE_PROJECT_DIR\"/scripts/install_pkgs.sh"
          }
        ]
      }
    ]
  }
}

scripts/install_pkgs.sh:

#!/bin/bash

# リモート環境でのみ実行
if [ "$CLAUDE_CODE_REMOTE" != "true" ]; then
  exit 0
fi

yarn install
exit 0

まとめ

**Remote Controlは「手の延長」、Claude Code on the webは「分身」、GitHub Actionsは「自動操縦」**です。この3つを組み合わせることで、開発者がPCの前にいなくてもAIエージェントが24時間コードを書き続ける環境が実現します。

まずはclaude remote-controlを試してみてください。スマホからコードレビューの指示を出す体験は、AI開発の新しいスタイルを感じられるはずです。