# Introduction
Claude Code Channels is shortly turning into a sensible various to OpenClaw for individuals who wish to join Claude to talk platforms with out organising a heavier agent framework. It’s less complicated to get working, works with a Claude subscription out of the field, and offers you an easy option to work together with an area Claude Code session via Discord.
On this article, you’ll learn to arrange Claude Code Channels domestically and join it to your Discord server. The important thing factor to grasp from the beginning is that this setup relies on a dwell native Claude Code session. The bot solely works whereas that session is actively working in your machine.
# What You Want Earlier than You Begin
Earlier than setting every thing up, ensure you 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 total course of may 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 along 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 possibly can affirm 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 subsequent step, so it can be crucial 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 utility. Inside that utility, 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 individuals ship.
Subsequent, generate an invitation hyperlink for the bot utilizing the OAuth2 URL Generator. Give it the permissions it wants, akin to:
- 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 instrument or take a brand new motion, you can begin it with the auto-approve flag as a substitute:
claude –dangerously-skip-permissions –channels plugin:discord@claude-plugins-official
This makes the session extra automated, which will be helpful for a smoother Discord expertise. Nevertheless, you need to solely use this in the event you belief the atmosphere and perceive that Claude Code can 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 working 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 authorised customers solely:
/discord:entry coverage allowlist
After that, you may message the bot in Discord and Claude Code will reply via your native session.
# Remaining Notes and Troubleshooting
If one thing just isn’t working as anticipated, the factors under cowl the commonest 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-official flag. The Discord plugin won’t work until 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 working the pair command inside Claude Code.
- DMs don’t work in any respect: Ensure 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-plugins after putting in or updating the plugin so the present session picks it up.
- Replies break after resuming a session: Keep away from counting on –resume for now, as a result of a current Claude Code situation studies that channel plugins might not restart appropriately after resume.
- Claude says it’s listening, however nothing arrives: Verify /mcp to substantiate the Discord plugin is definitely related. Current studies present circumstances the place the plugin fails on startup although 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 not too long ago reported Discord permission relay situation. Restart the session if it occurs.
If the bot stops working once you shut the terminal, that’s regular. Claude Code Channels solely works whereas your native Claude Code session remains to be working.
Abid Ali Awan (@1abidaliawan) is an authorized information scientist skilled who loves constructing machine studying fashions. Presently, 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 expertise 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.
