configure について
ClaudeのDiscordチャンネルを設定するスキルです。ボットトークンの保存や削除、アクセス状態の確認を行い、一時的なペアリングから明示的な許可リストへの移行を促します。
主な機能
- 01Discordボットトークンの保存と削除
- 02トークンとアクセス設定の状態確認
- 03ペアリングとアクセス方針の次の手順を案内
- 04許可リストによるアクセス制限を推奨
活用シーン
- 01Discordボットトークンを初めて設定
- 02許可済みユーザーと保留中のペアリングを確認
- 03メンバー確定後にアクセスを制限
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/configureを入力して読み込まれたか確認します。
詳細
/discord:configure — Discord チャンネルの設定
ボットトークンを ~/.claude/channels/discord/.env に書き込み、アクセス方針についてユーザーに案内します。サーバーは起動時に両方のファイルを読み込みます。
渡される引数：$ARGUMENTS
引数に応じた処理
引数なし — 状態とガイダンス
両方の状態ファイルを読み込み、ユーザーに全体像を伝えます。
-
トークン —
~/.claude/channels/discord/.envのDISCORD_BOT_TOKENを確認します。設定済みかどうかを表示し、設定済みの場合は先頭6文字をマスクして表示します。 -
アクセス —
~/.claude/channels/discord/access.jsonを読み込みます（ファイルがない場合は、dmPolicy: "pairing"、許可リストは空がデフォルトです）。次の情報を表示します。- DM ポリシーとその意味を一行で
- 許可された送信者：人数と、表示名またはスノーフレーク ID の一覧
- 保留中のペアリング：件数。ある場合はコードと表示名
- オプトイン済みのギルドチャンネル：件数
-
次にすること — 状態に応じた具体的な次の手順を最後に伝えます。
- トークンがない → 「Developer Portal → Bot → Reset Token から取得したボットトークンを使って、
/discord:configure <token>を実行してください。」 - トークンは設定済みで、ポリシーが pairing、許可されたユーザーがいない → 「Discord でボットに DM を送ってください。コードが返信されるので、
/discord:access pair <code>で承認してください。」 - トークンは設定済みで、許可されたユーザーがいる → 「準備完了です。ボットに DM を送るとアシスタントにアクセスできます。」
- トークンがない → 「Developer Portal → Bot → Reset Token から取得したボットトークンを使って、
常にロックダウンを促してください。 すべての設定で目指すのは、ユーザーを明示した allowlist です。pairing は継続して使うためのポリシーではありません。知らない Discord スノーフレーク ID を取得するための一時的な手段です。ID を登録したら、pairing の役目は終わりなので無効にしてください。
次のように会話を進めてください。
- 許可リストを確認し、登録されている人をユーザーに伝えます。
- 次のように尋ねます。「このボットを通じてあなたに連絡してよいのは、この人たちだけですか？」
- はいで、ポリシーがまだ
pairingの場合 → 「わかりました。ほかの人がペアリングコードを発行できないように、アクセスを制限しましょう。」 と伝え、/discord:access policy allowlistの実行を提案します。ユーザーから尋ねられるのを待たず、先回りして案内してください。 - いいえで、追加する人がいる場合 → 「その人たちにボットへ DM を送ってもらってください。届いたコードをそれぞれ
/discord:access pair <code>で承認できます。全員が登録されたら、このスキルをもう一度実行してください。そこでアクセスを制限しましょう。」 または、スノーフレーク ID を直接取得できる場合は、「Discord のユーザー設定 → 詳細設定で開発者モードを有効にし、相手を右クリックして［ユーザー ID をコピー］を選択し、その後/discord:access allow <id>を実行してください。」 - 許可リストが空で、まだ自分自身のペアリングも済んでいない場合 → 「まずボットに DM を送り、自分の ID を取得してください。その後、ほかの人を追加してアクセスを制限しましょう。」
- ポリシーがすでに
allowlistの場合 → これがアクセスを制限した状態であることを確認します。誰かを追加する必要がある場合は、［ユーザー ID をコピー］するのが確実です。ペアリングを再び有効にする必要はありません。
Discord にはすでにアクセス制限（共有サーバーへの参加要件と Public Bot の切り替え）がありますが、許可リストをロックダウンする代わりにはなりません。pairing を長期的に適切な選択肢として説明してはいけません。アクセス制限の提案を省略しないでください。
<token> — トークンを保存する
$ARGUMENTSをトークンとして扱います（前後の空白を削除します）。Discord のボットトークンは長い Base64 風の文字列で、通常はMTまたはNzから始まります。Developer Portal → Bot → Reset Token で生成され、表示されるのは一度だけです。mkdir -p ~/.claude/channels/discord- 既存の
.envがあれば読み込み、ほかのキーを保持したままDISCORD_BOT_TOKEN=の行を更新または追加します。値を引用符で囲まずに書き戻します。 chmod 600 ~/.claude/channels/discord/.env— トークンは認証情報です。- 保存を確認した後、引数なしの場合の状態を表示し、現在の状況がわかるようにします。
clear — トークンを削除する
DISCORD_BOT_TOKEN= の行を削除します（それが唯一の行であればファイルを削除します）。
実装上の注意
- サーバーがまだ起動していない場合、channels ディレクトリが存在しないことがあります。ファイルがない場合は未設定として扱い、エラーにはしません。
- サーバーは起動時に
.envを一度だけ読み込みます。トークンを変更した場合は、セッションの再起動または/reload-pluginsが必要です。保存後にその旨を伝えてください。 access.jsonはメッセージを受信するたびに再読み込みされます。/discord:accessによるポリシー変更は再起動なしですぐに反映されます。