Claude Code Discord Bridge
Control Claude Code from your phone.
Every running Claude Code instance on your PC automatically appears in Discord.
See everything Claude does. Send prompts. Approve permissions. All from your phone.
Install
Prerequisites: Bun and Claude Code v2.1.80+
claude plugin marketplace add chrismdemian/claude-code-discord-bridge
claude plugin install discord-bridge@claude-code-discord-bridge
Then run the setup wizard inside Claude Code:
/discord-bridge:setup
Paste your Discord bot token when prompted. The wizard walks you through creating a server, configures channels, installs the bridge service, and sets up a claude-dc alias. Takes about 2 minutes.
What You Get
Full output mirroring, not just a chat bridge. Every tool call, diff, terminal output, and file read appears in Discord, formatted for mobile.
| Feature | Description |
|---|
| Auto-discovery | Bridge finds all running Claude Code instances automatically |
| Forum post per session | Each session gets its own post, auto-named, auto-tagged by status |
| Rich diffs | File edits shown with syntax-highlighted diff formatting |
| Terminal output | Bash commands and output, long results attached as files |
| Permission buttons | Approve or deny tool calls from your phone with one tap |
| Reaction shortcuts | React with ✅ to approve, ❌ to deny, ⏸️ to interrupt |
| Cost tracking | Token usage, cost, model, and duration on every response |
| Smart notifications | Only pings you when Claude actually needs input |
| Plan mode | See plans as structured text, reply to approve |
| File drops | Drop an image or file in Discord and Claude receives it |
| Dashboard | Pinned embed showing all active sessions at a glance |
| Multi-instance | Multiple simultaneous sessions, each in its own post |
How It Works
Your PC Your Phone
┌──────────────────────────────────┐ ┌──────────────┐
│ Claude Code 1 ── transcript ─┐ │ │ │
│ Claude Code 2 ── transcript ─┤ │ │ Discord │
│ Claude Code 3 ── transcript ─┤ │ │ │
│ │ │ │ #sessions │
│ Bridge Service ◄─────────────┘ │ │ ├── fix-bug │
│ ├─ Discord bot ◄── internet ──────►│ ├── api-v2 │
│ ├─ Transcript tailer │ │ └── tests │
│ └─ Hook receiver │ │ │
│ │ │ #dashboard │
└──────────────────────────────────┘ └──────────────┘
Two components:
- Plugin: lightweight MCP server running inside Claude Code. Handles input (Discord to Claude) via the Channels system.
- Bridge Service: persistent process on your PC. Watches for sessions, tails transcripts, formats output for Discord. Stays alive when Claude Code exits.
Setup
1. Create a Discord Bot
Go to discord.com/developers, create a New Application, go to Bot, and copy the token.
Enable these intents under Bot settings:
2. Install and Configure
# Install the plugin
claude plugin marketplace add chrismdemian/claude-code-discord-bridge
claude plugin install discord-bridge@claude-code-discord-bridge
Then run the setup wizard inside Claude Code:
/discord-bridge:setup
Paste your bot token when prompted. The wizard walks you through adding the bot to a Discord server, then:
- Sets up forum channel, dashboard, and alerts channels
- Creates webhooks and configures the bridge
- Installs the bridge service via pm2
- Sets up the
claude-dc shell alias
3. Start
Open a new terminal and start Claude Code with the channel plugin enabled:
claude-dc
The setup wizard creates this alias for you. Every session you start with claude-dc will automatically appear as a forum post in Discord. All Claude Code flags work normally (e.g. claude-dc --dangerously-skip-permissions).
