Discord Bot Setup

1. Create a Discord Application

• Go to the Discord Developer Portal
• Click New Application
• Give your application a name (e.g., ClaudeCode)
• Click Create

2. Copy Application ID

• Go to General Information and copy the Application ID

3. Create a Bot User

• Go to the Bot section in the left sidebar
• Click Add Bot
• Under Token, click Copy (keep this secure!)
• Click Save Changes

4. Invite the Bot to Your Server

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.

Next Steps

Once your bot is set up, follow the Installation Guide to run it.