Claude Code Discord Integration

Install discord.js

Adds the core library used to build the bot client, commands, and components.

Store the bot token

Keep the token in .env and add .env to .gitignore so it is never committed.

Register slash commands

Runs the script that pushes your application commands to Discord. Guild commands appear instantly; global commands can take up to an hour.

Slash command registration snippet

The core of deploy-commands.js. Use applicationCommands for global registration instead of applicationGuildCommands.

Start the bot

Launches the bot and opens the gateway connection. Watch the console for missing-intent or login errors.

Run the bot with a process manager

Keeps the bot running in production and restarts it if the process exits.

Scaffold a new discord.js bot for me. Set up the client with the gateway intents needed for slash commands and message events, load the token from a DISCORD_TOKEN environment variable, add a ready event that logs when the bot connects, and give me a clean folder structure for commands and events.

Add a slash command called /ping that replies with the bot's latency. Write the command builder, the handler, and update the deploy-commands script so it registers correctly. Make sure the reply stays inside the three second interaction window.

Generate a deploy-commands.js script that registers all slash commands in my commands folder. Support both guild-scoped registration for testing and global registration for production, reading the application id, guild id, and token from environment variables.

Here is my bot code. Tell me exactly which gateway intents this bot needs based on the events it listens to, flag any privileged intents like MessageContent or GuildMembers that I must enable in the Developer Portal, and update the client to request only those intents.

Set up an interactionCreate handler that routes chat input commands, button presses, and select menu choices to the right handler functions. Add error handling so a failing interaction replies with an ephemeral error message instead of leaving the user with a failed interaction.

Build a rich embed for an announcement message with a title, description, three fields, a color, a thumbnail, and a footer with a timestamp. Keep every field inside Discord's embed limits and show me how to send it from a slash command.

Add two buttons to a message, one primary and one danger style, and write the button interaction handler that responds when each is clicked. Make the response ephemeral and explain how to keep the button custom ids unique.

Create a string select menu that lets a user pick a role from a list, then write the handler that assigns the chosen role. Explain which permissions and intents the bot needs to manage roles.

Write a small Node script that sends a formatted embed to a Discord channel through a webhook URL. It should take a title and message as input and post a deploy notification. Do not include the webhook URL in the code, read it from an environment variable.

Add a guildMemberAdd handler that greets new members with an embed in a welcome channel and assigns them a default role. Tell me which privileged intents I need to enable for this to work.

Build a simple moderation feature that deletes messages containing a configurable list of banned words, warns the user with an ephemeral reply, and logs the action to a moderation channel. Keep the banned-word list in a config file, not hardcoded.

Implement reaction roles: when a user reacts to a specific message with a given emoji, assign a mapped role, and remove it when they remove the reaction. Explain the intents and permissions required and how to store the message-to-role mapping.

Build a button-driven support ticket system. A button in a support channel opens a private thread for the user, pings the moderation role, and posts a close button. Write the handlers and explain the permissions the bot needs to create and manage threads.

This slash command calls an external API that sometimes takes longer than three seconds and the interaction fails. Refactor it to defer the reply immediately and then edit the reply once the API responds, so the interaction never times out.

My slash commands are not showing up in Discord even though the bot is online. Walk me through the likely causes, including guild versus global registration, missing applications.commands scope in the invite, and errors in the deploy-commands run, and help me fix it.

My bot throws an error about a disallowed or missing intent when it starts, or an event never fires. Identify which intent is missing based on my event listeners, explain whether it is privileged, and update both my client options and the Developer Portal settings I need to change.

My bot is hitting 429 rate-limit errors when it sends many messages in a loop. Explain how Discord rate limits work, refactor the code to respect them with proper spacing or batching, and add handling that waits for the retry-after value instead of retrying immediately.

Help me deploy this bot to a host so it runs continuously. Add environment variable handling, a process manager or hosting config, graceful shutdown, and gateway reconnect handling so it recovers from disconnects. Do not put the token anywhere it could be committed.

Add a scheduled task that posts a daily summary embed to a specific channel at a set time. Use a cron-style scheduler, read the channel id from configuration, and make the schedule easy to change without editing the core logic.

Review my Discord bot for security and reliability problems: exposed tokens, over-broad intents or permissions, unhandled interaction errors, missing rate-limit handling, and unsafe user input passed to other systems. For each finding explain the risk and the fix, and do not print any secret values.

What is the Claude Code Discord integration?

It is a workflow that lets you build and maintain Discord bots with Claude Code. Claude Code can scaffold a discord.js bot, register slash commands, wire event handlers, build embeds and buttons, send webhooks, and debug the errors Discord returns. Your Discord application stays the source of truth while Claude Code writes and explains the code around it.

How do I build a Discord bot with Claude Code?

Create an application and bot in the Discord Developer Portal, copy the token, and store it in a .env file. Then ask Claude Code to scaffold a discord.js client with the intents you need, generate your slash commands and a deploy-commands script, and wire the handlers. Run the deploy script, invite the bot with the bot and applications.commands scopes, and test it in your server.

Do I need a Discord MCP server?

No, you can build bots with Claude Code using just discord.js. A Discord MCP server is optional and useful when you want Claude Code to read and act on a live server during development, such as sending messages, managing channels, or inspecting roles from inside your session. Servers like mcp-discord or @pasympa/discord-mcp expose those actions as MCP tools.

Why are my slash commands not appearing?

The most common causes are that the deploy-commands script was never run, the commands were registered globally and have not propagated yet, or the bot was invited without the applications.commands scope. Register to a test guild for instant updates while developing, check the deploy script output for errors, and re-invite the bot with the correct scopes.

How do I fix a missing intents error?

A missing or disallowed intents error means your client is missing a gateway intent that an event needs, or a privileged intent is not enabled in the Developer Portal. Identify which intent each event listener requires, add it to your client options, and enable any privileged intents such as Message Content or Server Members in the portal, then restart the bot.

Why does my interaction fail after three seconds?

Discord requires you to acknowledge an interaction within three seconds. If your handler does slow work before replying, the interaction times out. Call deferReply immediately at the start of a slow handler, do the work, then use editReply to send the final response so the interaction never fails.

Can Claude Code help with webhooks?

Yes. Claude Code can generate a script that posts formatted messages and embeds to a channel through a Discord webhook, which is a lightweight way to send deploy alerts, monitoring notifications, or scheduled summaries without running a full bot. Store the webhook URL in an environment variable rather than in code.

Can Claude Code automate moderation?

Yes. Claude Code can build moderation features such as spam and keyword filters, role gating, welcome flows, and audit logging. Keep configurable lists in a config file, require confirmation for destructive actions like bans or mass deletes, and log moderation actions so a human can review them.