How to configure Claude code channels locally

Introduction

Channels Claude Code is emerging as a streamlined alternative to Open Claw for those looking to connect Claude to chat platforms without the complexity of a full agent framework. This solution allows users to connect easily through a Claude subscription and engage with a local Claude Code session via Discord. As you read on, you’ll discover how to set up Claude Code channels locally and link them to your Discord server. It’s crucial to note that this setup requires an active local Claude Code session on your machine for the bot to function.

What you need before you start

Before proceeding with the setup, ensure you have a Connection Claude.ai. Note that API key authentication alone is insufficient for Channels. While this guide utilizes Windows 11 for setup instructions, the process is largely applicable to Linux and macOS.

Claude Code installation and connection

Begin by installing Claude Code through PowerShell:

MRI https://claude.ai/install.ps1 | Nothing

Next, you’ll need to create a working folder, access it, and initiate Claude Code:

mkdir my-channels cd my-channels claude

Once Claude Code is operational, log in using your Claude.ai account credentials. This step is essential for enabling the channels.

Installing Bun and adding the Discord plugin

Claude Code’s official channel plugins require Bun, so you’ll need to install it next:

irm bun.sh/install.ps1 | Nothing

After installation, confirm by using the appropriate commands. In Claude Code, execute the following commands sequentially, as each step prepares for the next:

Add the official plugin marketplace:

/Plugins Marketplace add anthropic/claude-plugins-official

Update the marketplace to retrieve the latest plugins:

/Plugins market update claude-plugins-official

Install the official Discord plugin:

/plugin install discord@claude-plugins-official

Finally, reload the plugins to make the Discord integration available:

Claude Code is now prepared for Discord channel integration.

Creating and configuring your Discord bot

Visit the Discord Developer Portal to create a new application. In the Bot section, reset the token and store it securely. Enable the Intent of message content, as this allows the bot to read incoming messages. Use the OAuth2 URL generator to create an invite link for the bot, granting permissions like:

• Show channels
• Send messages
• Send messages in threads
• Read message history
• Attach files
• Add reactions
• Send voice messages

Use the generated link to add the bot to your Discord server.

Connect Claude Code to Discord

Back in Claude Code, configure the Discord plugin using your bot token:

/discord: configure YOUR_DISCORD_BOT_TOKEN

Claude Code should automatically store this token in its configuration directory. Restart Claude Code with channels enabled:

claude --channels plugin:discord@claude-plugins-official

This command launches Claude Code with the Discord Channels plugin enabled. For a more seamless experience without constant permission prompts, use the automatic approval flag:

claude --dangerously-skip-permissions --channels plugin:discord@claude-plugins-official

This approach makes the session more autonomous, suitable for trusted environments where you prefer not to confirm each action.

Link your Discord account and start using it

With Claude Code running and channels enabled, send a direct message to your bot on Discord. You should receive a pairing code. Enter this code into Claude Code:

/discord: access the pair YOUR_PAIRING_CODE

Restrict access to approved users only:

/discord: whitelist of access rules

Now, you can message the bot in Discord, and Claude Code will respond through your local session.

Final Notes and Troubleshooting

If you encounter issues, here are common problems with Claude Code Channels and their solutions:

• The robot is online but says nothing: Ensure Intent of message content is enabled in Discord bot settings.
• Claude never connects to Discord: Restart Claude Code with the –channels plugin:discord@claude-plugins-official flag.
• The robot does not respond after installation: Complete the pairing step by sending a DM to the bot, then execute the pair command in Claude Code.
• DMs don’t work at all: Ensure your Discord account and the bot are on the same server.
• The plugin commands do not appear: Run /reload-plugins after installing or updating the plugin.
• Responses stop after resuming a session: Avoid relying on –resume for now, as there are known issues.
• Claude says he listens, but nothing happens: Check /mcp to verify that the Discord plugin is connected.
• The messages arrive but Claude remains inactive: This could be a notification bug; restart the session.
• Responses stop after an Allow or Deny prompt: Restart the session if this occurs.

If the bot stops working upon closing the terminal, this is expected as Claude Code channels operate only when the local session is active.

Abid Ali Awan (@1abidaliawan) is a certified data scientist passionate about building machine learning models. His work focuses on creating technical content about machine learning and data science technologies. Abid holds a master’s degree in technology management and a bachelor’s degree in telecommunications engineering. His goal is to develop an AI product using graphical neural networks to support students facing mental health challenges.

For more information, visit the source link Here.

“`