Skip to main content
If your organization already used the earlier Claude in Slack, including Claude Code in Slack, Claude Tag replaces it. Your existing Slack app and @Claude handle stay, and no data migrates. What changes is who Claude acts as and who sets it up.
On the Team plan, a single Enable Claude Tag switch replaces the Claude Tag version controls described on this page, and there is nothing to migrate; the switch appears only while no scope routes to the earlier app.

​
Switch your workspace to Claude Tag

1

Connect the workspace in the Claude console

Open claude.ai/admin-settings/claude-tag. If your workspace isn’t paired, run setup; otherwise you’re already on Claude Tag. Once paired, channels and linked-user DMs answer with the New version by default; no per-channel action is needed.
2

Check for channels still on Legacy

Under Claude Tag’s access → Slack, open each scope’s Advanced section. Pairing defaults every scope’s Claude Tag version to New, so this is usually quick. Set any showing Legacy to New.
3

Give Claude its connections

The New version starts with no access of its own. GitHub repositories and other connections do not carry over from individual users’ linked accounts, so code requests in a switched channel have nothing to clone until you configure them. Follow the setup overview to add connections, and GitHub access for code work specifically.If your teams keep custom skills in a repository’s .claude/skills/ folder, those skills apply only in threads that have the repository. Grant the repository in an Access bundle and have users name it in the first message. To give skills to every channel under a scope, add them through a skills repository.
4

Tell your users

Send them Get started. The visible change is that work now belongs to the channel; see What existing users notice after the switch below.
You’ll see: the workspace appears under Where Claude Tag works, and the Claude Tag version on each scope shows New.

​
If @Claude doesn’t respond at all

On Enterprise Grid, an earlier install can lose its connection and stop responding in every workspace. See Claude is silent everywhere on Enterprise Grid for the reinstall that refreshes it without uninstalling, then send @Claude connect again in a channel of that workspace and pair the workspace with the new code.
The earlier Claude in Slack app, shown as Legacy in admin settings, is being deprecated; check with your account team for the cutover date. After that date, channels still set to Legacy stop responding until the scope’s Claude Tag version is set to New.

​
What stays the same

  • The Slack app and the @Claude handle. Your existing Claude in Slack settings (allowed users, verified-domain restriction) carry over. If your earlier install predates a permission Claude now uses, @Claude connect says so when you pair; a Slack admin clicks the install link in that reply and approves the consent screen, which installs over the existing app. Otherwise no app-side action is needed.
  • Direct messages still run on the user’s own claude.ai account, the same way they did before. The shift to a shared identity applies to channels.
  • Users who already linked their claude.ai account keep that connection. It is what powers their DMs.

​
How Claude Tag differs from the earlier app

The earlier app linked each user’s own claude.ai account, so it answered as that person and used their connectors. Claude Tag has one identity for the team, provisioned by an admin who also sets what it can reach in each channel. The Claude Tag version setting on each scope chooses whether the New or Legacy version answers there, or neither. Access bundles only apply where the New version answers. See Set the version for a scope for the four values and where to set them.

​
Two versions of the same Slack app

The earlier Claude in Slack and Claude Tag are two versions of the same @Claude Slack app, not two apps, so there is nothing to uninstall. You choose which version answers per scope with the Claude Tag version setting (Off, Legacy, New, or Inherit), so one workspace can run both during a phased switch. Setting a scope to Off turns off both versions there; to keep the earlier behavior in a scope, set it to Legacy. To tell which version answered in a channel, look at who authored the work. The New version authors code as the Claude GitHub App and keeps work in the channel’s thread; if @Claude still opens pull requests under the asker’s name, that channel is answering with the Legacy version.

​
What existing users notice after the switch

In channels, the visible difference is that work belongs to the channel, not to whoever asked. Anyone can reply in a thread to steer it, and the result stays where the team can see and pick it up. Code work is authored by the Claude GitHub App rather than as the requesting user. A user who never linked a claude.ai account can now hand Claude work in channels, by default. Whether that stays open or narrows to organization members is the admin’s access restriction setting.