- Go to the Discord Developer Portal
- Click New Application
- Give your application a name (e.g.,
ClaudeCode) - Click Create
- Go to General Information and copy the Application ID
- Go to the Bot section in the left sidebar
- Click Add Bot
- Under Token, click Copy (keep this secure!)
- Click Save Changes
Go to OAuth2 > URL Generator and select these scopes:
bot
applications.commands
Then select all of the following bot permissions:
| Permission | Why It's Needed |
|---|---|
| Manage Channels | Creates categories and text channels on startup (one per branch) |
| View Channels | Finds existing categories/channels to avoid duplicates |
| Send Messages | Sends embeds, streaming output, completion messages, startup notification |
| Embed Links | All bot output uses rich embeds (code, status, completions, errors) |
| Attach Files | File attachment support in message payloads |
| Read Message History | Reads channel to find its own messages |
| Use External Emojis | Emoji formatting in status and completion embeds |
| Use Application Commands | All 45+ slash commands |
Quick invite URL (replace YOUR_APP_ID):
https://discord.com/oauth2/authorize?client_id=YOUR_APP_ID&scope=bot+applications.commands&permissions=412317248576
Gateway Intents: Only the Guilds intent is used. No privileged intents (Message Content, Members, Presence) required. No toggles needed in the Developer Portal.
Copy the generated URL, open it in your browser, select your Discord server, and authorize the bot.
Once your bot is set up, follow the Installation Guide to run it.