Setup
Set up the Discord bridge — connect your bot, create server structure, start the bridge serviceFrom its SKILL.md
npx -y skills add chrismdemian/claude-code-discord-bridge --skill setupAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
3.2 KB, as published. Nobody here has run it
Discord Bridge Setup
Walk the user through setting up the Discord bridge.
Steps
-
Open the Discord Developer Portal in the user's browser automatically. Detect the platform and run the appropriate command:
- macOS:
open https://discord.com/developers/applications - Windows:
start https://discord.com/developers/applications - Linux:
xdg-open https://discord.com/developers/applications
Then print this concise guide:
1. Click "New Application" → name it anything (e.g. "CC Bridge") 2. Go to Bot → Reset Token → copy it 3. Under Bot → Privileged Gateway Intents → enable Message Content Intent 4. Paste your token below: - macOS:
-
Ask the user to paste the bot token.
-
Save the token to
${CLAUDE_PLUGIN_DATA}/.env:DISCORD_TOKEN=<the token> BRIDGE_PORT=7676 -
Add bot to a Discord server. Tell the user:
- Create a new Discord server (click the + in Discord's sidebar), or use an existing one
- In the Developer Portal, go to OAuth2 (left sidebar)
- Under OAuth2 URL Generator: check
botandapplications.commandsscopes - Under Bot Permissions: check
Administrator - Copy the Generated URL at the bottom and open it in your browser
- Select your server and authorize
- Wait for the user to confirm the bot has been added to their server.
-
If the user has their Server ID, add
DISCORD_GUILD_ID=<id>to the .env file. If not, that's fine — the setup script will auto-detect it if the bot is in exactly one server. -
Install dependencies and run the setup script:
cd ${CLAUDE_PLUGIN_ROOT} && bun install && PLUGIN_DATA=${CLAUDE_PLUGIN_DATA} bun run bridge/setup.ts --yesThis will:
- Check that pm2 is installed
- Login the bot and auto-brand it
- Auto-detect the Discord server (or ask for DISCORD_GUILD_ID if in multiple)
- Set up the CLAUDE CODE category with #sessions, #dashboard, and #alerts channels
- Create webhooks and save config
- Post a welcome message and generate an invite link
- Add a shell alias (
claude-dc) - Start the bridge service via pm2 and verify health
-
Show the user the Discord server invite link (printed by the setup script output) and suggest they join on their phone.
-
Remind the user:
- JOIN ON PHONE: Open the invite link on your phone
- START SESSIONS: Use
claude-dcto start Claude Code with Discord bridging - BOT AVATAR: If the auto-set avatar failed, set it manually in the Developer Portal
Troubleshooting
- If the bot can't connect: verify the token is correct and MESSAGE CONTENT intent is enabled
- If channels already exist: setup will reuse them (idempotent)
- If pm2 is not installed:
npm install -g pm2then re-run setup - If bot is not in any server: create a server in Discord, then open the OAuth2 invite URL to add the bot
- Check bridge logs:
npx pm2 logs discord-bridge - If
setUsernamefails: Discord limits bot username changes to 2 per hour. Wait and retry, or change it manually in the Developer Portal. - If the bridge fails to start: check
npx pm2 logs discord-bridgefor errors