# Introduction
Claude Code Channels is rapidly turning into a sensible various to OpenClaw for individuals who wish to join Claude to speak platforms with out establishing a heavier agent framework. It’s less complicated to get operating, works with a Claude subscription out of the field, and offers you an easy strategy to work together with a neighborhood Claude Code session via Discord.
On this article, you’ll learn to arrange Claude Code Channels regionally and join it to your Discord server. The important thing factor to grasp from the beginning is that this setup relies on a stay native Claude Code session. The bot solely works whereas that session is actively operating in your machine.
# What You Want Earlier than You Begin
Earlier than setting the whole lot up, be sure to have:
You also needs to know that Channels requires a Claude.ai login and doesn’t work with API-key-only authentication.
Notice: This information makes use of Home windows 11 because the working system for the setup steps and instructions, however the identical general course of will also be adopted on Linux and macOS.
# Putting in Claude Code and Signing In
First, set up Claude Code in PowerShell:
irm https://claude.ai/set up.ps1 | iex
Then create a working folder, transfer into it, and begin Claude Code:
mkdir my-channels
cd my-channels
claude
As soon as Claude Code opens, log in together with your Claude.ai account:
This step is required earlier than Channels will work.
# Putting in Bun and Including the Discord Plugin
Claude Code’s official Channels plugins use Bun, so set up it subsequent:
irm bun.sh/set up.ps1 | iex
You may verify the set up with:
After that, inside Claude Code, run the next instructions one after the other in the identical sequence. Every command prepares the following step, so it is vital to not skip the order.
First, add the official plugin market:
/plugin market add anthropics/claude-plugins-official
Subsequent, replace {the marketplace} so Claude Code can fetch the newest obtainable plugins:
/plugin market replace claude-plugins-official
Then set up the official Discord plugin:
/plugin set up discord@claude-plugins-official
Lastly, reload plugins so the newly put in Discord integration turns into obtainable in your present Claude Code session:
At this level, Claude Code is able to use the Discord channel integration.
# Creating and Configuring Your Discord Bot
Now go to the Discord Developer Portal and create a brand new software. Inside that software, open the Bot part, reset the token, and duplicate it someplace secure.
You additionally have to allow Message Content material Intent, as a result of with out it the bot will be unable to learn the textual content folks ship.
Subsequent, generate an invitation hyperlink for the bot utilizing the OAuth2 URL Generator. Give it the permissions it wants, resembling:
- View Channels
- Ship Messages
- Ship Messages in Threads
- Learn Message Historical past
- Connect Information
- Add Reactions
- Ship Voice Messages
Then use the generated hyperlink so as to add the bot to your Discord server.
# Connecting Claude Code to Discord
Return to Claude Code and configure the Discord plugin utilizing your bot token:
/discord:configure YOUR_DISCORD_BOT_TOKEN
Claude Code normally shops this token robotically in its Channels config listing.
After configuring the token, restart Claude Code with Channels enabled:
claude --channels plugin:discord@claude-plugins-official
This begins Claude Code with the Discord Channels plugin turned on.
If you don’t want Claude Code to ask for permission every time it wants to make use of a software or take a brand new motion, you can begin it with the auto-approve flag as an alternative:
claude --dangerously-skip-permissions --channels plugin:discord@claude-plugins-official
This makes the session extra computerized, which may be helpful for a smoother Discord expertise. Nevertheless, you must solely use this in case you belief the atmosphere and perceive that Claude Code shall be allowed to behave with out asking for affirmation every time.
# Pairing Your Discord Account and Beginning to Use It
As soon as Claude Code is operating with Channels enabled, ship your bot a direct message in Discord. It ought to reply with a pairing code.
Take that code and enter it inside Claude Code:
/discord:entry pair YOUR_PAIRING_CODE
Then lock entry to accepted customers solely:
/discord:entry coverage allowlist
After that, you may message the bot in Discord and Claude Code will reply via your native session.
# Ultimate Notes and Troubleshooting
If one thing will not be working as anticipated, the factors under cowl the most typical Claude Code Channels points and the quickest methods to repair them.
- Bot is on-line however says nothing: Allow Message Content material Intent in your Discord bot settings. With out it, the bot receives empty message content material.
- Claude by no means connects to Discord: Restart Claude Code with the
--channels plugin:discord@claude-plugins-officialflag. The Discord plugin won’t work except Channels is enabled at launch. - Bot doesn’t reply after setup: Full the pairing step by sending the bot a DM, copying the pairing code, and operating the pair command inside Claude Code.
- DMs don’t work in any respect: Make sure that your Discord account and the bot are in the identical server, since Discord requires that for direct messages to work.
- Plugin instructions don’t seem: Run
/reload-pluginsafter putting in or updating the plugin so the present session picks it up. - Replies break after resuming a session: Keep away from counting on
--resumefor now, as a result of a current Claude Code subject reviews that channel plugins could not restart appropriately after resume. - Claude says it’s listening, however nothing arrives: Examine
/mcpto substantiate the Discord plugin is definitely linked. Current reviews present instances the place the plugin fails on startup though Claude Code appears to be like prepared. - Messages arrive however Claude stays idle: This can be a present channel notification bug. Restarting the session is the best workaround for now.
- Replies cease after an Permit or Deny immediate: It is a just lately reported Discord permission relay subject. Restart the session if it occurs.
If the bot stops working if you shut the terminal, that’s regular. Claude Code Channels solely works whereas your native Claude Code session remains to be operating.
Abid Ali Awan (@1abidaliawan) is a licensed information scientist skilled who loves constructing machine studying fashions. At present, he’s specializing in content material creation and writing technical blogs on machine studying and information science applied sciences. Abid holds a Grasp’s diploma in know-how administration and a bachelor’s diploma in telecommunication engineering. His imaginative and prescient is to construct an AI product utilizing a graph neural community for college students combating psychological sickness.
