Complete Guide — 2025

Claude Code
Remote Control ガイド

ターミナル上のClaude Codeを、スマホ・ブラウザ・スクリプトから
自在に操作する3つの方法を完全解説

Terminal — zsh
$ claude remote-control
✓ Remote Control session started
✓ Session URL: https://claude.ai/code/session/abc123
✓ QR code ready — press Space to display
# スマホ、別のPC、どこからでもアクセス可能
01 — Overview

3つのリモート操作方法

Claude Code は、ローカルマシン上で動作するAIエージェントです。 リモートからの操作方法として3つのアプローチが用意されています。

📱

Remote Control

ローカルのClaude Codeセッションをブラウザやスマホから操作。 ファイルシステムやMCPサーバーにフルアクセスしたまま、 外出先からも作業を継続できます。

Headless Mode

-p フラグによる非対話モード。 CI/CDパイプラインやシェルスクリプトから Claude Codeをプログラム的に呼び出せます。

🛠

Agent SDK

Python / TypeScript ライブラリとして Claude Codeのエージェント機能をアプリに組み込み。 本格的な自動化エージェントを構築できます。

あなたのPC
Claude Code
ファイル / ツール / MCP
Point

すべての方法において、Claude Code はローカルマシン上で実行されます。 コードやファイルがクラウドに送信されることはなく、 安全にローカル環境のリソースにアクセスできます。

02 — Remote Control

Remote Control の使い方

ローカルのターミナルセッションを、ブラウザやスマホからリアルタイムに操作します。 Pro または Max プランが必要です。

1

セッションを開始する

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

# 新しいRemote Controlセッションを開始
$ cd /path/to/project
$ claude remote-control

# 既存セッションを変換する場合
$ claude
> /remote-control
2

別のデバイスから接続する

3つの接続方法があります。

🔗 URLをコピー

ターミナルに表示されるURLをブラウザで開く

📸 QRコード

Spaceキーを押してQRを表示 → スマホで読み取り

📄 セッション一覧

claude.ai/code からセッションを選択

3

デフォルトで有効にする

毎回コマンドを打たなくても、設定で常時有効にできます。

# Claude Codeの設定画面を開く
$ claude
> /config
# → "Enable Remote Control for all sessions" を ON にする
注意事項

ターミナルを閉じるとセッションが終了します。 また、ネットワーク切断が10分以上続くとタイムアウトになります。 1つのClaude Codeインスタンスにつき、同時に1つのリモートセッションのみ有効です。

03 — Headless Mode

ヘッドレスモード(-p フラグ)

スクリプトやCI/CDからClaude Codeを非対話的に実行します。 自動化ワークフローの基盤となるモードです。

基本的な使い方

-p フラグにプロンプトを渡すだけで、 非対話的にClaude Codeを実行できます。

# 単純な質問
$ claude -p "authモジュールの概要を説明して"

# ツールの事前許可を指定
$ claude -p "テストを実行して失敗を修正して" \
  --allowedTools "Bash,Read,Edit"
セッションの継続・再開

--continue で直前のセッションを継続、 --resume で特定のセッションIDを指定して再開できます。

# 直前のセッションを継続
$ claude -p "先ほどの続きをお願い" --continue

# 特定のセッションを再開
$ claude -p "作業を続けて" --resume <session-id>
出力フォーマットの制御

出力形式をJSON、ストリーミングJSON、テキストから選択できます。 構造化データの取得には JSON Schema も指定可能です。

# JSON形式で出力
$ claude -p "要約して" --output-format json

# JSON Schemaを指定して構造化出力
$ claude -p "コードの問題を列挙" \
  --output-format json \
  --json-schema '{"type":"object","properties":{"issues":{"type":"array"}}}'

# リアルタイムストリーミング
$ claude -p "コードを書いて" --output-format stream-json
CI/CDでの活用例

GitHub ActionsなどのCI環境で、コードレビューやテスト修正を自動化できます。

# GitHub Actions でのセキュリティレビュー
$ claude -p "このPRにセキュリティ上の問題がないかレビューして" \
  --allowedTools "Read,Glob,Grep" \
  --output-format json
04 — Agent SDK

Agent SDK でプログラム的に制御

Python / TypeScript のライブラリとして、Claude Codeのエージェント機能を アプリケーションに組み込めます。

1

インストール

# Python
$ pip install claude-agent-sdk

# TypeScript
$ npm install @anthropic-ai/claude-agent-sdk
2

Python での使用例

agent.py
import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions

async def main():
    async for message in query(
        prompt="auth.pyのバグを見つけて修正して",
        options=ClaudeAgentOptions(
            allowed_tools=["Read", "Edit", "Bash"],
            permission_mode="bypassPermissions",
            working_directory="/path/to/project",
        )
    ):
        if hasattr(message, "result"):
            print(message.result)

asyncio.run(main())
3

TypeScript での使用例

agent.ts
import { query } from "@anthropic-ai/claude-agent-sdk";

for await (const message of query({
  prompt: "テストを実行して失敗を修正して",
  options: {
    allowedTools: ["Read", "Edit", "Bash"],
    permissionMode: "bypassPermissions",
    workingDirectory: "/path/to/project",
  }
})) {
  if ("result" in message) console.log(message.result);
}
認証について

環境変数 ANTHROPIC_API_KEY にAPIキーを設定してください。 AWS Bedrock(CLAUDE_CODE_USE_BEDROCK=1)、 Google Vertex AI(CLAUDE_CODE_USE_VERTEX=1)にも対応しています。

05 — Comparison

3つの方法を比較する

用途やプランに応じて最適な方法を選択してください。

機能 Remote Control Headless (-p) Agent SDK
ローカル実行
インタラクティブUI ブラウザ
モバイル対応
プログラム的利用
必要な認証 Pro / Max プラン APIキー APIキー
MCP サーバー
セッション継続 自動 --continue / --resume resume パラメータ
主な用途 外出先からの開発 CI/CD 自動化 本格的なエージェント構築
06 — Use Cases

実践的な活用シナリオ

各リモート操作方法を活かした、実際のワークフロー例を紹介します。

Remote Control

移動中のコードレビュー

PCでRemote Controlセッションを立ち上げておき、 通勤中にスマホからPRのレビューやフィードバック対応を行う。

Headless

PR 自動レビュー

GitHub Actionsで新しいPRごとにClaude Codeを実行し、 セキュリティやコード品質の自動レビューコメントを生成。

SDK

カスタム開発ツール

Agent SDKを使い、チーム固有のコーディング規約チェックや ドキュメント自動生成ツールを構築。

Headless

定期バッチ分析

cronジョブでリポジトリのTODOコメントやデッドコードを 定期的に検出し、レポートを自動生成。

SDK

マルチステップ自動化

テスト実行 → 失敗分析 → コード修正 → 再テストの 一連のフローをSDKで構築し、完全自動化。

Remote Control

ペアプログラミング

Remote Controlのセッションを共有し、 リモートのチームメンバーとClaude Codeを活用した 共同作業を実施。

07 — Security

セキュリティと権限管理

安全に運用するための仕組みが複数用意されています。

🔒

通信の暗号化

すべての通信はHTTPS/TLS経由。 インバウンドポートは不要で、 アウトバウンド通信のみで動作します。

🛡

権限モード

bypassPermissionsacceptEditsrequireApproval の 3段階で制御可能。

📑

監査フック

Hooksでツール実行前後にカスタムロジックを挿入。 コンプライアンスや操作ログの記録に活用できます。

Permission Mode 一覧

requireApproval — すべてのツール使用に承認が必要(最も安全)
acceptEdits — ファイル編集は自動許可、破壊的操作は承認が必要
bypassPermissions — すべて自動許可(CI/CD向け、信頼できる環境のみ)

08 — Available Tools

利用可能な組み込みツール

すべてのリモート操作方法で、以下のツールが利用できます。

ツール名 用途
Readファイルの読み込み
Writeファイルの新規作成
Edit既存ファイルの編集
Bashターミナルコマンドの実行
Globファイルパターン検索 (例: **/*.ts)
Grep正規表現によるファイル内容検索
WebSearchWeb検索による情報取得
WebFetchWebページの取得と解析
Taskサブエージェントの起動・委譲