Install and pair
Pairing has three parts: install the app in Slack, get a code from Slack, and paste it in the Claude console.Install the Claude app in Slack
Open claude.com/claude-for-slack, click Add to Slack, and approve the permissions Slack shows. Skip if the app is already installed.
Run @Claude connect in Slack
Send
@Claude connect in any channel or in a DM with @Claude. Claude replies with a pairing code. Only a Slack workspace admin (or Grid org admin) can run this command; if that’s not you, send them the install request and have them return the code.If your install is missing a permission, the reply names it (and may still issue a code with a warning); see the section below.In the console: run the setup wizard
At
claude.ai/admin-settings/claude-tag, select Set up (or + Connect next to Where Claude Tag works if a workspace is already paired) to open the Set up Claude Tag for your workspace wizard. Paste the code, choose whether to enable Claude for the whole workspace or specific channels, and click Next.Send the install request to your Slack admin
Steps 1–2 above need a Slack workspace admin; step 3 needs an Owner in your Claude organization. If those are two people, send the Slack admin this and have them return the code:If @Claude doesn’t respond at all
On Enterprise Grid, an earlier install can lose its connection and stop responding in every workspace. Don’t uninstall the app. Have a Slack Org Owner or Org Admin, while signed in to one of the workspaces (not the org-level admin page), open claude.com/claude-for-slack, select Add to Slack, and choose Install to entire organization. This refreshes the connection in place. Then run @Claude connect again.
If @Claude connect says the installation is out of date
Your Slack install predates a permission the app now requests. The reply names the missing scope and includes a reinstalls the Claude app link. A Slack workspace admin clicks that link (or opens claude.com/claude-for-slack and clicks Add to Slack again), approves the consent screen Slack shows, then runs @Claude connect again. This installs over the existing app; do not uninstall first.
Slack’s Manage apps page lists the scopes the app requests, not the scopes your workspace has granted, so seeing a permission listed there does not mean it is approved. The grant happens on the consent screen.
If the console says “already connected to a different organization”
A Slack workspace can pair with only one Claude organization at a time, and this one is already paired elsewhere. An Owner in the Claude organization that currently holds the pairing must disconnect it from their Connected workspaces list before your code can be redeemed here. If your company has more than one Claude organization, check the others; the existing pairing is often in a test or trial org.If the console says “claim code is invalid, expired, or already used”
Pairing codes are single-use and expire after a short window. Ask the Slack admin to send@Claude connect again and paste the fresh code; reinstalling the app is not required. On Enterprise Grid, a Grid org admin’s reply includes a Grid-wide code alongside the workspace code.
After pairing: where Claude is enabled
Once a workspace is paired, where Claude responds depends on what you chose in the wizard (whole workspace or specific channels), the Turn on Claude Tag toggle, and your Members setting.- What Claude can reach in each channel depends on which Access bundles you bind; see Configure per-channel access.
- Nothing runs until usage is funded on Team plans; see Set a spend limit.
- DMs work separately from channels and run on each user’s own claude.ai account; pairing isn’t what enables DMs.
Related resources
- Give Claude access: create an Access bundle and add connections
- What the Claude Slack app can access: the page to send a Slack admin who’s approving the install