---
title: Claude Code × Discord連携 Channelsセットアップと ハマりポイント解決集
tags: 
author: [takish](https://image.docswell.com/user/takish)
site: [Docswell](https://www.docswell.com/)
thumbnail: https://bcdn.docswell.com/page/3EK9DRYPED.jpg?width=480
description: Claude Code × Discord連携 Channelsセットアップと ハマりポイント解決集  スマホからDMを送るだけでローカルのClaude Codeが動く
published: March 23, 26
canonical: https://image.docswell.com/s/takish/KY8W9R-2026-03-23-154618
---
# Page. 1

![Page Image](https://bcdn.docswell.com/page/3EK9DRYPED.jpg)

Claude Code × Discord連携
Channelsセットアップと
ハマりポイント解決集
スマホからDMを送るだけでローカルのClaude Codeが動く
@takish


# Page. 2

![Page Image](https://bcdn.docswell.com/page/L73WR89475.jpg)

やりたいこと
• ターミナルに張り付かず、外出先からClaude Codeを操作したい
• スマホからDMを送るだけでコード生成・ファイル操作
• Claude Code Channels（v2.1.80+、research preview）で実現


# Page. 3

![Page Image](https://bcdn.docswell.com/page/87DKYMG5JG.jpg)

/remote-control vs
Channels


# Page. 4

![Page Image](https://bcdn.docswell.com/page/VJPK6R3DE8.jpg)

従来のリモート操作との違い
• /remote-control: ブラウザ経由でターミナルUIを直接操作
• → スマホの小さい画面ではつらい
• Channels: Discord DMで自然言語の指示を送る
• → ターミナル不要。手軽にタスクを投げられる
• 同じセッションで両方を有効にすることも可能


# Page. 5

![Page Image](https://bcdn.docswell.com/page/2EVV3R4GEQ.jpg)

Channelsのアーキテクチャ
• 内部実装はMCP（Model Context Protocol）サーバー
• claude /channel capabilityを持つMCPサーバーが仲介
• Discordからのメッセージを<channel>タグでコンテキストに注入
• Bunランタイムで動作、Claude Codeがサブプロセスとして管理
• 自分でサーバーを立てる必要なし


# Page. 6

![Page Image](https://bcdn.docswell.com/page/57GL3MKDEL.jpg)

前提条件


# Page. 7

![Page Image](https://bcdn.docswell.com/page/4EQY5RNXJP.jpg)

セットアップ前の確認事項
• Claude Code v2.1.80 以上
• Bun ランタイム（brew install bun）
• claude.ai ログイン必須（API key認証では使えない）
• Team/Enterpriseは管理者によるChannels有効化が必要
• Discordアカウント + Developer Portalへのアクセス


# Page. 8

![Page Image](https://bcdn.docswell.com/page/KJ4W98G271.jpg)

セットアップ手順
全7ステップ


# Page. 9

![Page Image](https://bcdn.docswell.com/page/LE1YK2DK7G.jpg)

Step 1: Discord Botを作成する
• Discord Developer Portalで「New Application」
• 「Bot」セクションでトークンを生成（Reset Token）
• 重要: Message Content Intent を ON にする
• OAuth2 > URL GeneratorでBot招待URLを生成
• Scopes: bot / Permissions: 6つ（View Channels等）


# Page. 10

![Page Image](https://bcdn.docswell.com/page/GEWGDRYPJ2.jpg)

Step 2-3: プラグインのインストールと有効化
# セッション内で実行
/plugin install discord@claude-plugins-official
# マーケットプレイスが古い場合
/plugin marketplace update claude-plugins-official
# プラグインの有効化を確認
/reload-plugins
# → skills > 0 と表示されれば成功
# → 0 skills なら --channels 付きで再起動


# Page. 11

![Page Image](https://bcdn.docswell.com/page/47ZLGRX6J3.jpg)

ハマりポイント 1: プラグインが認識されない
• インストールしてもenabledPluginsに登録されないことがある
• /reload-plugins で「0 skills」→ /discord:configure が失敗
• 「Unknown skill」エラーが出る
• 解決策: セッションを終了し --channels フラグ付きで再起動


# Page. 12

![Page Image](https://bcdn.docswell.com/page/YJ6WYR4LJV.jpg)

Step 4-5: Botトークン設定 → Channels起動
# Step 4: Botトークンを設定
/discord:configure <BOT_TOKEN>
# → ~/.claude/channels/discord/.env に保存される
# Step 5: Channels有効でセッションを起動
claude --channels plugin:discord@claude-plugins-official
# ※ --channels はセッション単位の設定（毎回指定）


# Page. 13

![Page Image](https://bcdn.docswell.com/page/GJ5MG8QMJ4.jpg)

ハマりポイント 2: 「Unknown skill」エラー
• /discord:configure 実行時に発生することがある
• プラグインがenabledPluginsに正しく登録されていない
• 解決策: Step 3と同じ
• --channels フラグ付きでセッションを再起動してから再実行


# Page. 14

![Page Image](https://bcdn.docswell.com/page/9E29YKPR7R.jpg)

Step 6-7: ペアリング → セキュリティ設定
• Discord で Bot に DM を送信（内容は何でもOK）
• Bot がペアリングコードを返信
• /discord:access pair <pairing_code> で接続
• /discord:access policy allowlist で DM を制限
• → ペアリング済みユーザーだけがメッセージ送信可能に


# Page. 15

![Page Image](https://bcdn.docswell.com/page/D7Y4GN55EM.jpg)

セキュリティ上の注意
• Bot起動直後は誰でもDMを送れる状態
• → 起動後すぐにペアリング + allowlist設定を行う
• allowlist未設定 = 全ユーザーがローカルClaude Codeを操作可能
• ファイルの読み書き・コマンド実行が可能になるリスク
• Botの運用はDMベースを推奨（パブリックチャンネルは危険）


# Page. 16

![Page Image](https://bcdn.docswell.com/page/VENYGXN4J8.jpg)

使えるMCPツール


# Page. 17

![Page Image](https://bcdn.docswell.com/page/Y79PW8R4E3.jpg)

Channels で使える MCP ツール
ツール
説明
使いどころ
reply
メッセージ送信
基本の応答
react
リアクション追加
処理中・完了の通知
edit_message
送信済みメッセージ編集
長い出力の段階的更新
fetch_messages
メッセージ取得（最大100件）
過去の会話の参照
download_attachment
ファイルダウンロード
スマホ写真・スクショを渡す


# Page. 18

![Page Image](https://bcdn.docswell.com/page/G78DN8WV7D.jpg)

実践的な運用Tips


# Page. 19

![Page Image](https://bcdn.docswell.com/page/L7LMPRNRJR.jpg)

alias と tmux で常時待機
# .zshrc に追加
alias claude-discord='claude --channels \
plugin:discord@claude-plugins-official'
# tmux でバックグラウンド常時起動
tmux new-session -d -s claude-discord \
'claude --channels plugin:discord@claude-plugins-official'
# 朝PCを開いたら実行 → 外出先からいつでもDMで操作


# Page. 20

![Page Image](https://bcdn.docswell.com/page/4EMY4RXPEW.jpg)

複数リポジトリでの運用
• 1つのBotトークンにつき --channels セッションは1つだけ
• 同じトークンで複数起動 → Gateway二重接続で片方が切断
• リポジトリ切替時は現在のセッションを終了してから再起動
• 他リポジトリは --channels なしの通常起動で併用可能


# Page. 21

![Page Image](https://bcdn.docswell.com/page/PER9WRNYJ9.jpg)

ハマりポイント 3: 「入力中...」が消える
• Bot に DM → 「入力中...」が一瞬表示されて消える
• エラーメッセージも出ない。返信も来ない
• 原因: --channels フラグなしで起動している
• MCPツール（送信側）はプラグインだけで動くが
• チャンネル通知（受信側）は --channels フラグが必須


# Page. 22

![Page Image](https://bcdn.docswell.com/page/P7XQPRN4EX.jpg)

まとめ: 3つのポイント
• ① 困ったら --channels フラグ付きで再起動
•
プラグイン認識も「入力中が消える」もこれで解決
• ② allowlist 設定を忘れずに
•
デフォルトは誰でもDM可能。起動後すぐに設定
• ③ 1 Bot トークンにつき --channels セッションは1つ
•
複数起動するとGatewayが競合する


# Page. 23

![Page Image](https://bcdn.docswell.com/page/37K9DRNP7D.jpg)

Thank you!
Zennでも公開しています
https://zenn.dev/takish/articles/channels-setup
https://zenn.dev/takish/articles/channels-setup