Claude Codeを外部から操作する方法まとめ【2026年版】Remote Control・SDK・Channelsなど全手段を解説
目次
関連記事: スマホからClaude Codeを使う方法【完全ガイド】 / TailscaleでClaude CodeにSSH接続する方法
はじめに
Claude Codeはターミナル上で動くAIコーディングエージェントですが、「ターミナルの前に座って手動で操作する」だけのツールではなくなりました。
2026年に入り、外部からClaude Codeを操作・自動化する手段が急速に増えています。スマホからの遠隔操作、CI/CDパイプラインへの組み込み、TelegramやDiscordからのメッセージ送信、定期スケジュール実行など——Claude Codeは「呼び出される側」のエージェントとして進化しています。
本記事では、2026年4月時点で利用可能なすべての外部操作手段を整理し、それぞれの特徴と使い分けを解説します。
外部操作手段の全体像
Claude Codeの外部操作手段は、大きく4つのカテゴリに分類できます。
| カテゴリ | 手段 | 概要 |
|---|---|---|
| リモートUI | Remote Control, Dispatch | 別デバイスからセッションを操作 |
| プログラマティック | Agent SDK, Headlessモード | コードやスクリプトから呼び出し |
| イベント駆動 | Channels, Hooks, GitHub Actions | 外部イベントをトリガーに実行 |
| インフラ連携 | MCP, SSH, Scheduled Tasks | 外部ツール・環境との接続 |
以下、それぞれの手段を詳しく見ていきます。
1. Remote Control — スマホからの遠隔操作
登場時期: 2026年2月(リサーチプレビュー) 対応プラン: Pro, Max
ローカルのClaude Codeセッションを、スマホやタブレットのブラウザ・公式アプリから操作できる機能です。
仕組み
# ローカルで実行
claude remote-control
QRコードとURLが表示され、それをスマホで開くだけで接続完了です。通信はAnthropicのAPI経由でTLS暗号化され、ローカルマシンへのインバウンド接続は不要。VPN設定もポート開放もいりません。
特徴
- PCがスリープから復帰しても自動再接続
- claude.ai/code、iOSアプリ、Androidアプリに対応
- 複数デバイスから同時に同じセッションを閲覧可能
SSHで自宅サーバーに接続する従来の方法と比べると、セットアップの手軽さが圧倒的です。ただし、ローカルでClaude Codeのプロセスが起動している必要があります。
2. Agent SDK — プログラムからの呼び出し
登場時期: 2025年後半(SDK → Agent SDKにリブランド) 対応プラン: 全プラン(APIキー課金)
Claude Codeのエージェントループ(ツール実行、コンテキスト管理、オーケストレーション)をライブラリとして利用できます。
3つの形態
CLI(Headlessモード)
# 基本的な使い方
claude -p "このプロジェクトのREADMEを要約して" --output-format json
# CI/CD向け(プラグインやMCPを読み込まない高速モード)
claude -p "テストを実行して結果を報告" --bare --allowedTools "Bash,Read"
# 構造化出力
claude -p "型エラーを一覧化して" --json-schema '{"type":"array","items":{"type":"object","properties":{"file":{"type":"string"},"line":{"type":"number"},"message":{"type":"string"}}}}'
Python SDK
from claude_agent_sdk import ClaudeAgent
agent = ClaudeAgent(api_key="sk-ant-...")
result = agent.run("src/配下のTODOコメントを一覧化して")
print(result.output)
TypeScript SDK
import { ClaudeAgent } from '@anthropic-ai/claude-agent-sdk';
const agent = new ClaudeAgent({ apiKey: 'sk-ant-...' });
const result = await agent.run('テストカバレッジを計測して');
console.log(result.output);
主なオプション
| フラグ | 用途 |
|---|---|
--bare | hooks/skills/MCP/CLAUDE.mdをスキップ(高速・決定的) |
--allowedTools | 自動承認するツールを指定 |
--permission-mode | セッション全体の権限ベースライン |
--output-format | json / stream-json / text |
--continue / --resume | 既存セッションの続行 |
--mcp-config | bareモードでもMCPサーバーを読み込み |
Agent SDKはClaude Codeの「中核エンジン」を直接利用するため、最も柔軟性が高い方法です。
3. Channels — 外部メッセージの受信
登場時期: 2026年3月(リサーチプレビュー) 対応プラン: 全プラン(Enterpriseは管理者の有効化が必要)
Telegram、Discord、iMessageなどの外部プラットフォームから、稼働中のClaude Codeセッションにメッセージを送り込む仕組みです。
Remote Controlとの違い
- Remote Control = 自分が別デバイスからセッションを「操作」する
- Channels = 外部イベントがセッションに「プッシュ」される
セットアップ例(Telegram)
# プラグインインストール
/plugin install telegram@claude-plugins-official
# Channels有効でClaude Codeを起動
claude --channels plugin:telegram@claude-plugins-official
送信者のアローリストで、ペアリング済みアカウントのみがメッセージを送れるようになっています。ツール実行の承認もリモートから可能です。
使いどころ
- Discordのチャンネルで「@claude このバグ調べて」と投げる
- Telegramから作業指示を送り、結果をそのまま受け取る
- 外部Webhookの受信先としてClaude Codeを使う
4. Hooks — ライフサイクルへの介入
対応プラン: 全プラン
Claude Codeの特定のライフサイクルイベントにシェルコマンドをフックする仕組みです。LLMに依存しない決定的な制御が可能です。
主なイベント
| イベント | タイミング |
|---|---|
PreToolUse | ツール実行前 |
PostToolUse | ツール実行後 |
UserPromptSubmit | ユーザーがプロンプトを送信した時 |
SessionStart | セッション開始時 |
Notification | Claude Codeが通知を送る時 |
Stop | セッション終了時 |
設定例
{
"hooks": {
"PostToolUse": [
{
"matcher": "Edit",
"command": "npx prettier --write $CLAUDE_FILE_PATH"
}
],
"PreToolUse": [
{
"matcher": "Bash",
"command": "/path/to/security-check.sh"
}
]
}
}
ファイル編集後に自動フォーマット、Bash実行前にセキュリティチェック、といったガードレールを設定できます。JSON形式でstdinからコンテキストを受け取り、終了コードで制御フローを決定します。
5. GitHub Actions — PRとIssueの自動化
対応プラン: 全プラン(APIキー課金)
公式のGitHub Action(anthropics/claude-code-action)を使って、PRやIssueをトリガーにClaude Codeを実行します。
できること
- PRの自動レビュー: PR作成時にコードを分析し、コメントでフィードバック
- Issueからの自動実装:
@claudeメンションで、ブランチ作成→実装→テスト→PR作成を自動化 - セキュリティスキャン: PRごとに脆弱性チェック
セットアップ
# Claude Code内で実行するだけ
/install-github-app
ガイドに沿って設定すれば、リポジトリにClaude Codeが常駐する形になります。Agent SDKベースで動作するため、カスタマイズも柔軟です。
6. GitLab CI/CD
対応プラン: 全プラン(APIキー課金)、ベータ
GitLabパイプラインへの統合も進んでいます。MR(マージリクエスト)やIssueでの@claudeメンションをトリガーに、Claude Codeが実装やレビューを行います。
Claude API直接、AWS Bedrock、Google Vertex AIなど複数のプロバイダーに対応し、OIDCによるセキュア認証もサポートしています。
7. Slack連携
対応プラン: Team, Enterprise
Slackチャンネルで@Claudeにコーディングタスクを依頼すると、Claude Code on the web(クラウドサンドボックス)が自動起動。関連するGitHubリポジトリをクローンし、作業完了後にスレッドで結果を報告します。
チームでの非同期開発フローに組み込みやすい方法です。
8. MCP(Model Context Protocol)サーバー
対応プラン: 全プラン
MCPはAI-ツール間の統合を標準化するオープンプロトコルです。Claude Codeは200以上のMCPサーバー実装(GitHub、Slack、Google Drive、PostgreSQL、Notion、Jira等)に接続できます。
2026年の主なアップデート
- Tool Search / 遅延読み込み: セッション開始時はツール名のみ読み込み、コンテキスト消費を85%削減
- OAuth 2.0認証: セキュアなリモート接続
- MCP Apps: UI機能の提供
設定
プロジェクトルートの.mcp.jsonまたはグローバル設定(~/.claude/)に記述します。--mcp-configフラグでHeadlessモードからも読み込み可能です。
MCPを活用することで、Claude Codeの操作対象をコードベース外に広げられます。データベース操作、チケット管理、ドキュメント更新など、開発ワークフロー全体をClaude Codeから一元管理できます。
9. Scheduled Tasks — 定期実行
対応プラン: 全プラン(クラウド実行はPro以上)
ローカルループ(/loop)
# 5分ごとにデプロイ状況をチェック
/loop 5m デプロイの状況を確認してSlackに報告して
セッション内で繰り返し実行。最大3日間稼働します。
クラウドスケジュール(/schedule)
# 毎朝9時に実行(ローカルタイムゾーン)
/schedule "0 9 * * *" 昨日のPRをレビューしてサマリーを作成
Anthropicのインフラ上で実行されるため、PCがオフでも動作します。Cron式で柔軟にスケジュール設定が可能です。
定期的なコードレビュー、デプロイ監視、日次レポート作成などに活用できます。自動失効は作成から7日後です。
10. SSH接続
対応プラン: 全プラン
Claude Codeをリモートサーバー上で動かし、SSHで接続する「古典的だが確実な」方法です。
構成パターン
- Tailscale + SSH: ポート開放不要、ゼロコンフィグVPN(詳細記事)
- tmux + SSH: セッション永続化で接続断に対応(詳細記事)
- VS Code Remote SSH: IDEからの透過的な接続
- mosh: ネットワーク不安定な環境でのレジリエンス
Remote Controlが登場した今でも、SSHには「ローカル環境のフルコントロール」「他のCLIツールとの組み合わせ」という強みがあります。
11. Dispatch — リモートデスクトップエージェント
登場時期: 2026年3月 対応プラン: Max
スマホからタスクを送ると、デスクトップPCのClaude Codeが作業を実行し、完了したら通知する仕組みです。
Remote Controlとの違いは、Dispatchがデスクトップのローカルリソース(ファイル、ツール、MCP設定)をフル活用できる点です。クラウドサンドボックスではなく、実際の作業環境で動作します。
12. Sub-agents / Agent Teams
対応プラン: 全プラン
Claude Code内部で複数のエージェントを並行実行するマルチエージェント機構です。
Sub-agents
単一セッション内で専門エージェントを起動します。組み込みのExplore(読み取り専用検索)、Plan(調査→計画)に加え、Markdownで定義したカスタムサブエージェントを利用できます。
Agent Teams(実験的)
複数セッションを「チームリード」が共有タスクリスト・P2Pメッセージング・ファイルロックで協調制御します。
外部からの操作とは少し毛色が異なりますが、Claude Code自身が複数のエージェントを「外部操作」するという意味で、自動化の重要な要素です。
13. その他の手段
Computer Use(リサーチプレビュー)
Claude CodeがGUIを操作する機能。スクリーンショット→推論→アクションのループで、デスクトップアプリのボタンクリックやフォーム入力が可能です(Pro, Max)。
Voice Mode
/voiceコマンドで音声入力モードに切り替え。20言語対応。スペースキー長押しのPush-to-Talk方式です。
Auto Mode
AIが各ツール呼び出しのリスクを自動評価し、安全なものは自動承認、危険なものはブロックする仕組み。claude --enable-auto-modeで有効化できます。
Claude Code Analytics API
組織レベルのClaude Code使用状況をREST APIで取得。管理者向けのモニタリング用途です(Team, Enterprise)。
手段の比較と使い分け
| 手段 | 方向性 | セットアップ | 主な用途 | プラン |
|---|---|---|---|---|
| Remote Control | 双方向UI | 極めて簡単 | 外出先からの操作 | Pro+ |
| Agent SDK | プログラマティック | 中程度 | CI/CD、バッチ処理 | 全プラン |
| Channels | 外部→Claude | 中程度 | チャットbot連携 | 全プラン |
| Hooks | イベント駆動 | 簡単 | ガードレール、自動化 | 全プラン |
| GitHub Actions | イベント駆動 | 簡単 | PRレビュー、自動実装 | 全プラン |
| Slack | 双方向 | 簡単 | チーム非同期開発 | Team+ |
| MCP | 拡張 | 中程度 | 外部ツール統合 | 全プラン |
| Scheduled Tasks | 定期実行 | 簡単 | 監視、レポート | 全プラン |
| SSH | 双方向 | やや複雑 | フルコントロール | 全プラン |
| Dispatch | 非同期委任 | 簡単 | リモート作業委託 | Max |
選び方の目安
- 手軽にスマホから使いたい → Remote Control
- CI/CDに組み込みたい → Agent SDK(Headless)+ GitHub Actions
- チャットツールから使いたい → Channels(個人)/ Slack(チーム)
- 定期的に自動実行したい → Scheduled Tasks
- ローカル環境をフル活用したい → SSH + tmux
- 開発ワークフロー全体を統合したい → MCP + Hooks
まとめ
2026年のClaude Codeは、ターミナルの前に座っていなくても、あらゆる場所・タイミングから操作できるエージェントになりました。
特に注目すべきは以下の3つの変化です。
- Remote Control / Channels: 2026年2〜3月に登場し、スマホ操作とチャットボット連携を実現
- Agent SDK: CLIだけでなくPython/TypeScriptライブラリとして成熟し、プログラマティックな利用が容易に
- Scheduled Tasks / Dispatch: PCがオフでも自律的にタスクを実行する仕組みが整備
これらを組み合わせることで、「人間が指示を出す→Claude Codeが実行する」という従来のフローから、「イベント駆動で自律的に動くエージェント」へとワークフローを進化させられます。
自分の開発スタイルや課金プランに合った方法を選んで、Claude Codeを最大限活用してみてください。