2026年、Telegram経由でスマートフォンからClaude Codeを操作する方法

ツールの設定に関する資料は、Ailootのドキュメントでご覧いただけます。

Claude Code Channelsとは何か、なぜ必要なのか#

2026年3月20日、AnthropicはClaudeセッションをメッセージングアプリに接続する公式プラグイン、Claude Code Channelsを公開しました。Telegram、Discord、iMessageに対応しています。この機能はリサーチプレビュー段階です。code.claude.com/docs/en/channelsにドキュメントがあり、プラグインのソースコードは公開リポジトリanthropics/claude-plugins-officialにあります。

簡単に言うと、スマートフォンとClaude Codeセッションをつなぐ「チャットブリッジ」です。ボットに「料金表の書き換えを続けてください。business/products/practicum/README.md の次のコホートの日付を更新してください。」と送ると、ボットがVPS上のセッションに転送します。Claudeが文脈を取得してファイルを編集し、変更をコミットして、Telegramで「わかりました。コミットを確認してください。」と返信します。自宅のノートパソコンは閉じたままです。

⚠️ リサーチプレビューの主な制限： ChannelsはMCPブリッジです。セッションは自分のマシンまたはVPSで実行されている必要があります。セッションを終了すると、メッセージを受信する相手がいなくなります。そのため、24時間365日稼働させるには別途設定が必要です（下記のVPSのセクションを参照）。

Channelsと他のリモート作業方法との違い

Anthropicは公式ドキュメントで直接比較する表を掲載しています。以下はその内容をもとにしたものです。

ChannelsとRemote Controlの主な違いは、Remote Controlが「スマートフォンをターミナルをのぞく窓にする」機能であることです。カーソルが見え、ボタンを押せます。Channelsは、頭脳としてローカルのClaudeセッションを使うチャットボットです。Remote Controlではターミナルを見ます。Channelsでは、ファイルを読める相手にメッセージを送ります。

画面からすべてを操作したいならRemote Controlを使ってください。「質問を送って、そのまま一日を過ごし、返信を受け取る」ならChannelsを使います。私は両方を使っています。重要な変更を承認する必要があるときはRemote Control、タスクに自信があり、自分の夜の時間を取り戻したいときはChannelsです。

始める前に必要なもの#

コマンドに進む前に、次の項目を確認してください。

1. Anthropicアカウント。 対応するclaude.ai契約認証かConsole APIキーを使います。無料claude.aiはこの契約経路の対象ではありません。Console APIキーも使えます。Console組織が管理設定を配布している場合、その設定でチャンネルが有効か確認します。
2. Claude Code v2.1.80以降。 claude --versionで確認します。古い場合は、claude updateまたはnpm install -g @anthropic-ai/claude-code@latestで更新してください。
3. Bun。 ChannelsプラグインはNodeスクリプトではなく、Bunスクリプトです。bun --versionで確認します。インストールされていない場合は、curl -fsSL https://bun.sh/install | bashを実行し、その後source ~/.bashrcを実行してください。
4. Telegramアカウント。 どのアカウントでもかまいません。スマートフォンでログインしていることが大切です。
5. Team/Enterpriseプランを利用している場合、 管理者に、管理対象の設定またはadmin-settings/claude-codeでchannelsEnabledを有効にしてもらってください。組織ではデフォルトで無効になっています。

Bunを初めて聞いたとしても、心配はいりません。BunはNodeのような別のJavaScriptランタイムです。起動が速く、単一のバイナリにまとめやすいため、AnthropicはChannelsプラグインに採用しました。一度インストールすれば、あとは気にする必要はありません。

⚠️ Channelsは、企業向けのBedrock / Google Vertex / Azure Foundryではまだ動作しません。 claude.ai認証またはAnthropic Consoleでのみ動作します。

ステップ1. BotFatherでTelegramボットを作成する#

BotFatherがすべて処理してくれるので、5つの操作をするだけです。手順は次のとおりです。

1. Telegramで@BotFatherを開きます（スマートフォンを使えます。残りの設定もスマートフォンで行えます）。
2. 初めて使う場合は「Start」を押します。
3. /newbotコマンドを送ります。
4. BotFatherから「よし、新しいボットですね。何と呼びましょうか？」と聞かれるので、表示名を入力します。たとえば、マイアシスタント - Claude Codeです。
5. 次にユーザー名を聞かれます。Telegram全体で一意で、botで終わる必要があります。たとえば、my_claude_botやmy_dev_botです。
6. BotFatherは次のようなメッセージを返します。

Done! Congratulations on your new bot. You will find it at
'<OFFICIAL_URL>'.

Use this token to access the HTTP API:
1234567890:AAHzlAU...

Keep your token secure and store it safely, it can be used by anyone to control your bot.

トークンをコピーします。2分後に必要です。

⚠️ トークンの安全性。 ボットトークンがあれば、ボットを完全に操作できます。漏えいすると、誰でもボットとして書き込めるうえ、Claudeに送るメッセージを傍受する可能性があります。リポジトリで公開したり、コードに貼り付けたり、チャットで送ったりしないでください。私はトークンを~/.claude/channels/telegram/.envに保存しています。次のステップでプラグインがここに保存します。

ステップ2. Claude CodeにTelegramプラグインをインストールする#

普段Claudeを使うフォルダーでターミナルを開き、次を実行します。

claude

セッション内でスラッシュコマンドを入力します。

/plugin install telegram@claude-plugins-official

Claudeが「どのマーケットプレイスにもプラグインが見つかりません」と返す場合、クライアントが公式マーケットプレイスを認識していません。次を追加してください。

/plugin marketplace add anthropics/claude-plugins-official

以前に追加している場合は、次のコマンドで更新してください。

/plugin marketplace update claude-plugins-official

インストールに成功したら、プラグインを再読み込みしてコマンドを有効にします。

/reload-plugins

これで、/telegram:configureや/telegram:accessなどのスラッシュコマンドが使えるはずです。確認するには/helpを入力します。リストにtelegramのセクションがあれば準備完了です。

ステップ3. トークンをプラグインに登録する#

Claudeセッションで次を入力します。

/telegram:configure 1234567890:AAHzlAU...

このコマンドはトークンを~/.claude/channels/telegram/.envに保存します。このファイルには自分のユーザーだけがアクセスできる（chmod 600）ため、心配はいりません。

または、環境変数でトークンを設定します。systemdやDockerでClaudeをデプロイし、対話型コマンドを使いたくない場合に便利です。

export TELEGRAM_BOT_TOKEN="1234567890:AAHzlAU..."
claude --channels plugin:telegram@claude-plugins-official

⚠️ 本番環境では、ホームディレクトリ~/の.envファイルではなく、常に環境変数を使っています。これならsystemdのEnvironment=TELEGRAM_BOT_TOKEN=...でシークレットを管理しやすく、~/.claude/を誤ってリポジトリに取り込むことも避けられます。

ステップ4. --channelsフラグを付けてClaudeを再起動する#

ここが最も重要で、初回に多くの人がつまずくポイントです。プラグインをインストールしただけでは不十分です。 ボットが実際にメッセージを受信し始めるには、明示的なフラグを付けてClaudeを起動する必要があります。

claude --channels plugin:telegram@claude-plugins-official

フラグがなくてもセッションは通常どおり動作しますが、Telegramプラグインは休止状態です。フラグを付けると、ClaudeはプラグインのMCPサーバーを起動し、Telegram APIのポーリングを開始して、ボットに送られたメッセージに応答します。

起動後、ターミナルに次のような表示が出るはずです。

✻ Welcome to Claude Code 2.1.80
  Channels: telegram@claude-plugins-official (active)
  Polling for messages...

channelsに関する行がなければ、フラグが認識されていません。Claude Codeがバージョン2.1.80以降であること、プラグインが実際にインストールされていること（セッション内で/plugin list）を確認してください。

⚠️ 便利なヒント。 私は~/.zshrcにエイリアスを設定しています。

alias claude-tg="claude --channels plugin:telegram@claude-plugins-official"

これでclaude-tgを実行するだけです。スペースで区切れば複数のプラグインを渡せます。--channels plugin:telegram@... plugin:discord@...のようにします。

ステップ5. アカウントをペアリングし、他の全員をブロックする#

承認済みの送信者は、そのセッションのファイルやツールへの操作を依頼できます。 意図したアカウントだけをペアリングし、ボットを頼る前に送信者方針を固めてください。

手順：

1. Telegramでボットを開きます。 ユーザー名@my_claude_botで検索するか、BotFatherの返信にあるリンクを開きます。「Start」を押します。
2. ボットに何かメッセージを送ります。 たとえば、hiと送ります。
3. ボットからペアリングコードが返ってきます。 次のような形式です。

こんにちは！このアカウントをペアリングするには、Claude Code セッションで次を実行してください：
/telegram:access pair 847291

このコードの有効期限は5分です。

4. ターミナルに戻ります。 Claudeセッションで、返信に記載されたコマンドを入力します。

/telegram:access pair 847291

Claudeは「アカウントをペアリングしました」と返信します。これでTelegramアカウントからコマンドを送れます。

5. 許可リストのポリシーを有効にします。 これにより、すでにペアリングされているアカウント以外はすべてブロックされます。

/telegram:access policy allowlist

これ以降、他のアカウントからのメッセージは何も通知せず無視されます。ターミナルにも表示されず、ボットも返信しません。まるでメッセージがなかったかのようです。

⚠️ 許可リストは必ずペアリング直後に有効にしてください。後回しにしないでください。設定中に見知らぬペアリングを承認せず、返信成功だけで送信者方針が正しいとも考えないでください。初めてボットを使ったとき、許可リストなしで10分間動作させてしまい、その間に無関係のTelegramユーザー2人から「hi」と送られました。幸い、その時点ではコマンドによるファイル書き込みを許可していませんでした。

他の人（たとえばプロジェクトの共同作業者）を追加する場合：

/telegram:access pair <その人のアカウントのコード>

その人が先にボットにメッセージを送ってコードを取得し、それをあなたに伝える必要があります。追加方法はこれだけです。

その他のガイドはAilootのドキュメントでご覧いただけます。

自分のVPSでClaudeを24時間365日稼働させる方法#

ボットを「ノートパソコンを1時間開いて操作する」状態ではなく、「24時間いつでも動いている」状態にしたいなら、セッションを実行したままにする必要があります。ローカルならtmuxでもできますが、VPSのほうが簡単で安定しています。

構成例の一つでは、ウェブサイトもホストしているCoolify VPSを使っています（Coolify経由で公開するガイドを参照）。同じサーバーを使えます。Claudeのメモリ使用量はわずかです。VPSを持っていなければ、月額4～5ユーロ程度の最安プランを利用できます。たとえばHetzner CX11 / Yandex Cloud / Selectelです。

ステップ1：VPSにシステムをインストールする

管理者として専用Unixアカウントと作業場を先に作ります。既存アカウントはホームと所有者を確認した場合だけ再利用します。

sudo useradd --create-home --shell /bin/bash claude
sudo install -d -o claude -g claude /home/claude/workspace
sudo -iu claude

以後はrootのホームでなく、このclaudeのログインシェルで、Bun公式導入とClaude Codeのネイティブ導入を行います。

curl -fsSL https://bun.sh/install | bash
curl -fsSL https://claude.ai/install.sh | bash

同じユーザーの新しいログインシェルを開き、PATH変更を反映して確認します。

whoami
printf '%s\n' "$HOME"
command -v bun
command -v claude
bun --version
claude --version
cd /home/claude/workspace
claude

whoamiはclaude、HOMEは/home/claudeである必要があります。command -vの絶対パスを記録し、実ClaudeパスをExecStart、BunのディレクトリをサービスPATHへ使います。見つからなければ止めてください。

ステップ2：サービスユーザーで認証・導入・ペアリングする

同じ対話セッションでサインインし、上の手順2〜5をこのUnixユーザーで繰り返します。Telegramプラグインをuser scopeへ入れ、トークンを設定し、--channelsで再起動し、アカウントをペアリングしてpolicy allowlistを有効にします。実際の返信を確認してからサービス化します。rootの設定や認証をコピーしません。

claude.ai契約認証とConsole APIキーの両方に対応します。Team/Enterpriseは組織で有効化し、管理Console組織もチャンネル設定を満たす必要があります。Consoleは契約に含まれずAPI課金です。対話からサービスへ移すときも選んだアカウントと方式を保ちます。

ステップ3：systemdでセッションを実行する

サービスユーザーのシェルを抜け、管理者としてunitを作ります。以下は確認結果が/home/claude/.local/bin/claudeと/home/claude/.bun/bin/bunの場合で、違えば実際の値へ置き換えます。同じ認証環境とボットトークンを渡し、unitは管理者だけが読めるようにして、秘密をコミットしません。自動起動・障害再起動用のファイルは次です。

cat > /etc/systemd/system/claude-code.service <<'EOF'
[Unit]
Description=Claude Code with Telegram channel
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=claude
WorkingDirectory=/home/claude/workspace
Environment="HOME=/home/claude"
Environment="TELEGRAM_BOT_TOKEN=1234567890:AAH..."
Environment="PATH=/home/claude/.local/bin:/home/claude/.bun/bin:/usr/local/bin:/usr/bin:/bin"
ExecStart=/home/claude/.local/bin/claude --channels plugin:telegram@claude-plugins-official --dangerously-skip-permissions
Restart=on-failure
RestartSec=10

[Install]
WantedBy=multi-user.target
EOF

systemctl daemon-reload
systemctl enable claude-code
systemctl start claude-code

設定した項目は次のとおりです。

• Type=simple — シンプルなモードです。プロセスの起動と同時に、systemdは起動完了と判断します。
• User=claude — rootではなく、専用ユーザーで実行します。こちらのほうが安全です。
• WorkingDirectory=/home/claude/workspace — 事前に作ったサービスユーザー所有の作業場です。起動前に対象リポジトリを置き、root所有のクローンやrootのホームを使わないでください。
• Environment=TELEGRAM_BOT_TOKEN=... — トークンをプロセスに直接渡します。.envファイルは不要です。
• --dangerously-skip-permissions — 権限確認を迂回するモードです。無人運用に常に必須と考えず、確認方針と強制隔離を明示的に選んでください。送信者リストは本人を認可するだけで、依頼コマンドを安全にはしません。バイパスは、ファイル、認証、通信を意図的に制限した隔離環境だけで使います。
• Restart=on-failure — Claudeのクラッシュやネットワーク切断などでプロセスが終了すると、systemdは10秒後に再起動します。

ログを表示するには、次を実行します。

journalctl -u claude-code -f

問題が起きた場合、journalctl -u claude-code -n 100で直近100行を確認できます。

ステップ4：ボットが動作していることを確認する

対話設定で実際の返信が出てからサービスを開始し、同じペアリング済みアカウントから無害なメッセージを送り、応答とログを確認します。対話で動いてサービスで失敗するなら、ユーザー、HOME、作業場、実行パス、PATH、認証を先に比べてください。

後のペアリング変更はサービスを止め、sudo -iu claudeで同じユーザーとなり、/home/claude/workspaceへ入り、同じチャンネルを対話起動して行います。ペアリングと許可設定後に終了し、サービスを戻します。同じボットのポーラーを同時に2つ動かしません。journalctlはログ閲覧で、対話プロンプトを提供しません。

本番サーバーでの5つの落とし穴と対処法#

1. systemdのPATHにBunがない

systemdは最小限の環境でプロセスを起動するため、~/.bashrcの変数を認識しません。rootのホームだけにBunを入れ、サービスがUser=claudeなら、その導入やrootのシェルPATHは引き継ぎません。

解決策。 Bunをシステム全体にインストールする（/usr/local/bin/bun）か、PATHを明示的に渡します。

Environment="PATH=/home/claude/.bun/bin:/usr/local/bin:/usr/bin:/bin"

2. 長時間アイドル状態が続くと、Telegram APIへのTCP接続が失われる

6～12時間アイドル状態が続くと、ボットが「沈黙」することがあります。メッセージはTelegramに送信されますが、プラグインに届きません。ロングポーリングの仕様上の問題です。

解決策。 systemdに定期再起動を追加します（24時間ごと）。

Restart=always
RuntimeMaxSec=86400

またはcronジョブを設定します。0 5 * * * systemctl restart claude-code（午前5時に再起動）です。

3. 日中にClaude Maxの上限に達する

Telegram経由でClaudeを頻繁に使うと、Max 5xプラン（月額約$100）では4～6時間で上限に達することがあります。Telegramからのリクエストも通常のターミナルからのリクエストと同じで、同じ利用枠を消費します。

解決策。「ボットが応答しない—/statsを確認」というリマインダーを設定します。上限に達したら、リセットを待つか、Max 20x（月額$200）にアップグレードします。トークン節約ガイドとSonnetとOpusモデルのガイドも参考になります。

4. 許可リストがあっても--dangerously-skip-permissionsは危険

このフラグはすべての確認を無効にします。Telegramから送ったコマンドは何でも、質問なしで実行されます。ファイル削除、外部へのリクエストなど、何でもです。以前、Claudeに「不要な console.log 文を削除してください」と頼んだところ、整理しようと熱心になるあまり、本番スクリプトのデバッグログを半分消してしまいました。gitで復元しましたが、被害はすでに起きていました。

解決策。 重要なプロジェクトで作業する場合は、--dangerously-skip-permissionsを有効にしないでください。代わりにRemote Controlでセッションを実行します。権限の確認がスマートフォンに届き、手動で承認できます。--dangerously-skip-permissionsを付けたChannelsは、ラフな下書き、リファクタリング、テスト用です。

5. 再インストール後に許可リストが「壊れる」

許可リストは~/.claude/channels/telegram/に保存されています。新しいVPSに移行したり、Claudeを再インストールしたり、ユーザーを変更したりすると、以前のペアリング情報が引き継がれません。元の送信者リストはないため、新しい実体が以前のアクセス方針を持つとは考えないでください。

解決策。 移行前に~/.claude/channels/telegram/をバックアップします。移行後に元の場所へ戻してください。または再インストール後すぐに再ペアリングし、ボット起動からpolicy allowlist設定まで1分も空けないでください。

ChannelsとRemote Control、どちらを選ぶべきか#

Anthropicはほぼ同じ時期に両方の機能を公開しました。Remote Controlは2026年2月25日、Channelsは2026年3月20日です。両者は機能が重複しているのではなく、それぞれ異なる問題を解決します。

私は次のように使い分けています。ノートパソコンから離れている間の非同期作業、CIの通知、連携にはChannelsを使います。Claudeの動作を確認したり、リスクのある手順を承認したりする必要がある場合は、Remote Controlを使います。

両方を同時に使えます。Telegramボットは「質問して答えを受け取る」ための手軽な経路、Remote Controlは「重要なことを操作する」ための経路です。どちらも同じClaudeの利用枠を使います。

よくある質問#

複数のボットを同時に接続できますか？

はい。--channelsフラグには、スペース区切りで複数の項目を指定できます。--channels plugin:telegram@claude-plugins-official plugin:discord@claude-plugins-officialのようにします。1つのClaudeセッションが両方のチャットに返信します。

ターミナルを閉じるとどうなりますか？

セッションが終了し、プラグインが停止して、ボットは沈黙します。VPSではsystemdがセッションを実行し続けます。ローカルマシンではノートパソコンを閉じると、数秒後にclaudeがSIGHUPで切断されます。

CIやSentryから通知を受け取れますか？

はい。Channelsは双方向チャネルです。Channels Referenceを使って、Webhookをセッションに転送する独自のプラグインを作成できます。Claudeはイベントをリアルタイムで確認して応答します。

TelegramはDiscordより機能が制限されていますか？

基本機能は同じです。Discordでは、ボットの設定でMessage Content Intentが必要です。iMessageはmacOSでのみ動作し、~/Library/Messages/chat.dbデータベースを直接読み取ります。Telegramはどの環境でも使えます。

Teamプランの場合、何をする必要がありますか？

組織の管理者が、管理対象の設定またはadmin-settings/claude-codeでchannelsEnabled: trueを有効にする必要があります。これをしないとプラグインは接続しても、メッセージは届きません。起動時に警告がターミナルに表示されます。

スマートフォンからClaudeに見えるのは何ですか？Telegramのチャット自体も見えますか？

いいえ。Claudeに見えるのはボットに送ったメッセージだけです。Telegramの会話履歴、チャット一覧、連絡先にはアクセスできません。MCPプラグインはTelegram Bot API経由でボット宛てのメッセージのみを読み取ります。

Pro/MaxのサブスクリプションなしでChannels経由でClaudeを使えますか？

はい。Console APIキーにも対応し、Console組織にAPI課金されます。無料claude.aiはここで説明する契約経路ではありません。Team/Enterpriseと管理Console組織はチャンネルの有効化条件を満たします。

次にすること#

ボットが安定して動作するようになったら、Channelsを最大限に活用するために次のことを試せます。

1. CIからWebhookを接続する。 GitHub Actions / GitLab CIを使っている場合、Channelsプラグインでビルド結果を直接セッションに転送できます。push直後にClaudeが「テスト失敗」を確認し、修正案を提案します。channels-referenceのドキュメントを参照してください。
2. Routinesと組み合わせる。 同じセッションでRoutinesを実行し、定期タスクを行えます。朝になるとボットが自動で「おはようございます。プロジェクトの概要です」と送り、スマートフォンから「売上レポートを作って」と返信できます。
3. ボットの監視を設定する。 ボットが沈黙したら、すぐに気づきたいものです。VPS上の簡単なcronスクリプトで、1時間ごとにTelegramボットへpingを送ります。ボットが返信しない場合、別のチャネルにアラートを送ります。これがないと、ボットが午前4時に停止しても、正午まで気づかない可能性があります。
4. hooksを検討する。 HooksはClaudeのイベント（ツールの開始、メッセージの完了）に応答します。HooksとChannelsを組み合わせると、「ClaudeがタスクNを完了しました」のようなTelegram通知を自動送信できます。

Channelsを何にでも追加する必要はありません。外出先やカフェにいる間にタスクの様子を確認するのに便利です。じっくり考える必要があるときは、ノートパソコンを開いて座りましょう。外出中や移動中に「これも聞かないと。ノートパソコンを開かないと」と考え続けずに済むのがChannelsの利点です。

ツール活用に関する資料は、Ailootのドキュメントをご覧ください。