Claude Code Channels

Claude Code Channels Setup

Claude Code Channels pushes messages from external platforms (Telegram, Discord) into a running Claude Code session via MCP server plugins.

Prerequisites

• Claude Code v2.1.80+
• Bun runtime
• A claude.ai account (not API key mode)

Platform Selection

Ask which platform(s) the user wants, then follow the relevant reference:

• Telegram: See [references/telegram.md](references/telegram.md)
• Discord: See [references/discord.md](references/discord.md)

Both can run simultaneously:

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

Universal Workflow

Regardless of platform, setup follows 6 steps:

1. Create bot on the platform's developer portal
2. Install plugin: /plugin install @claude-plugins-official
3. Configure token: /:configure
4. Launch session: claude --channels plugin:@claude-plugins-official
5. Pair account: DM the bot, get a code, run /:access pair
6. Lock down: /:access policy allowlist

Troubleshooting

MCP Server Shows "failed" on Startup

Known race condition — server may fail on cold start but reconnect fine.

Fix: Run /mcp, navigate to the failed server, select Reconnect.

Persistent failures — verify the bot token:

# Telegram
TOKEN=$(grep TELEGRAM_BOT_TOKEN ~/.claude/channels/telegram/.env | cut -d= -f2)
curl -s "https://api.telegram.org/bot$TOKEN/getMe"

# Discord
TOKEN=$(grep DISCORD_BOT_TOKEN ~/.claude/channels/discord/.env | cut -d= -f2)
curl -s -H "Authorization: Bot $TOKEN" https://discord.com/api/v10/users/@me

If unauthorized/401, regenerate the token and update ~/.claude/channels//.env.

Plugin Not Found

Add the official marketplace first:

/plugin marketplace add anthropics/claude-plugins-official

Bot Not Responding

1. Session must be running with --channels flag
2. /mcp must show the server as "connected"
3. Telegram: verify token with BotFather
4. Discord: enable Message Content Intent in Developer Portal → Bot → Privileged Gateway Intents

Dependency Issues

Pre-install manually:

cd ~/.claude/plugins/cache/claude-plugins-official//
bun install --no-summary

Running as Background Service (tmux)

# Start
tmux new-session -d -s claude- \
  'claude --dangerously-skip-permissions --channels plugin:@claude-plugins-official'

# Attach / Detach
tmux attach -t claude-   # Ctrl+b then d to detach

# After startup, if MCP failed: /mcp → select server → Reconnect

Access Control

Both platforms share the same model. Replace ` with telegram or discord`.

| Command | Effect | |---|---| | /:access | Show current state | | /:access pair | Approve pairing | | /:access deny | Reject pairing | | /:access allow | Add user by ID | | /:access remove | Remove user | | /:access policy | pairing / allowlist / disabled | | /:access group add | Enable group/channel | | /:access group add --no-mention | Enable without requiring @mention | | /:access group rm | Disable group/channel | | /:access set | Configure delivery settings |

State Files

~/.claude/channels//
├── .env          # Bot token (mode 0o600)
├── access.json   # Policy, allowlist, groups, pending
├── approved/     # Approved user ID → chat ID mapping
└── inbox/        # Downloaded attachments

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: broomva
• Source: broomva/skills
• License: MIT
• Homepage: https://skills.sh/broomva/skills

Install and usage instructions live in the source repository linked above.