Skip to main content
Role you needOwner in your Claude organization, plus a Slack workspace admin to install the app and generate the pairing code. These can be the same person or two people.
Before this stepThe prerequisites: confirm your role and decide where you’ll pilot
Do I need this?RequiredNothing else in setup works until a workspace is paired.

Install and pair

Pairing has three parts: install the app in Slack, get a code from Slack, and paste it in the Claude console.
1

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.
2

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.
3

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.
The wizard moves straight on to giving Claude access, so there’s nothing to check at this point; continue with Give Claude access. After the wizard finishes, the Slack row under Where Claude Tag works shows your workspace as connected, and a scope for it (the entry where you’ll bind tool access) appears on the Slack tab under Claude Tag’s access.

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:
Please install the Claude app (https://claude.com/claude-for-slack) in [workspace], then run "@Claude connect" in any channel and send me the code it returns. What it can access: https://claude.com/docs/claude-tag/admins/for-slack-admins

If @Claude connect says the installation is out of date

The reply names the missing permission. Depending on your organization’s configuration, it either issues a code with a warning or refuses until the permission is granted. Approve the updated permissions from Slack adminManage appsClaude, then run @Claude connect again. If no warning appears, your install already has everything.

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.