Claude Code in Slack 适合在 Slack 频道里直接把编程任务交给 Claude:先完成 Claude App 连接、Claude Code on the web 和 GitHub 仓库授权,再在 App Home 里选 Routing Mode。若会话没启动、仓库没选对或认证失败,通常先检查频道是否已 /invite @Claude、账户是否连到同一个 Claude 账号,以及是否已启用 web 端访问。

Claude Code in Slack 配置与排查

Claude Code in Slack 可以让你在 Slack 工作区里直接委托编程任务。你在频道或线程里 @Claude 提出代码相关请求后,Claude 会自动判断意图,并在 claude.ai/code 上创建一个 Claude Code 会话来处理。

这个集成基于现有的 Claude for Slack app,但会把编程请求智能路由到 Claude Code on the web。

Use cases

  • Bug investigation and fixes: 在 Slack 频道里收到 bug 报告后,直接让 Claude 排查并修复。
  • Quick code reviews and modifications: 基于团队反馈,让 Claude 实现小功能或做重构。
  • Collaborative debugging: 当 Slack 讨论里已经有复现步骤、用户反馈等关键信息时,Claude 可以用这些上下文辅助调试。
  • Parallel task execution: 先在 Slack 里发起编程任务,同时继续做别的工作,完成后再接收通知。

Prerequisites

使用 Claude Code in Slack 前,需要满足下面条件:

Requirement Details
Claude Plan Pro、Max、Team 或 Enterprise,并且有 Claude Code access(premium seats 或 Chat + Claude Code seats)
Claude Code on the web 必须启用 Claude Code on the web
GitHub Account 已连接到 Claude Code on the web,且至少认证了一个仓库
Slack Authentication Slack 账号已通过 Claude app 连接到 Claude 账号

Setting up Claude Code in Slack

工作区管理员必须先从 Slack App Marketplace 安装 Claude app。前往 [Slack App Marketplace](https://slack.com/marketplace/A08SF47R6P4),点击 "Add to Slack" 开始安装。




App 安装完成后,单独为每个用户完成 Claude 账号认证:

1. 在 Slack 的 Apps 区域点击 "Claude" 打开 Claude app
2. 进入 App Home 标签页
3. 点击 "Connect",把 Slack 账号和 Claude 账号绑定
4. 在浏览器里完成认证流程




确认 Claude Code on the web 已正确配置:

* 打开 [claude.ai/code](https://claude.ai/code),使用同一个已连接 Slack 的账号登录
* 如果还没有连接 GitHub 账号,先完成连接
* 至少认证一个希望 Claude 处理的仓库




账号连接完成后,在 Slack 的 Claude App Home 里配置 Claude 处理消息的方式,找到 **Routing Mode** 设置。

| Mode | Behavior |
| :-- | :-- |
| **Code only** | Claude 会把所有 @mentions 路由到 Claude Code 会话。适合团队只用 Slack 处理开发任务的场景。 |
| **Code + Chat** | Claude 会分析每条消息,并在 Claude Code(编程任务)和 Claude Chat(写作、分析、一般问题)之间智能路由。适合希望用一个 @Claude 入口处理多种工作的团队。 |

> 在 Code + Chat 模式下,如果 Claude 把消息路由到了 Chat,但你原本想创建 coding session,可以点 "Retry as Code" 重新创建 Claude Code 会话。反过来,如果它路由到了 Code,但你想要 Chat,也可以在对应 thread 里切换。





Claude 安装后不会自动加入任何频道。要在某个频道里使用它,必须在该频道输入 `/invite @Claude` 把它邀请进来。Claude 只能响应它已加入频道中的 @mentions。

How it works

Automatic detection

当你在 Slack 频道或线程里 @Claude 时,Claude 会自动分析消息,判断是不是 coding task。如果识别到编程意图,它会把请求路由到 Claude Code on the web,而不是作为普通 chat assistant 回复。

你也可以明确告诉 Claude 把某个请求当作 coding task 处理,即使它没有自动识别出来。

Claude Code in Slack 只在频道里工作,包括 public channels 和 private channels,不支持 direct messages(DMs)。

Context gathering

From threads:在 thread 里 @mention Claude 时,它会收集该 thread 中所有消息作为上下文,理解完整对话。

From channels:在频道主对话里直接 @Claude 时,它会查看最近的频道消息,寻找相关上下文。

这些上下文会帮助 Claude 理解问题、选择合适的 repository,并决定任务处理方式。

当 Claude 在 Slack 中被调用时,它会获得对话上下文来更好理解请求。Claude 也可能遵循上下文里其他消息的指令,因此只应在可信的 Slack 对话中使用。

Session flow

  1. Initiation:你在 Slack 中 @mention Claude,并提出 coding request
  2. Detection:Claude 分析消息,识别 coding intent
  3. Session creation:在 claude.ai/code 上创建新的 Claude Code session
  4. Progress updates:Claude 在 Slack thread 里持续发送状态更新
  5. Completion:完成后,Claude @mention 你,并附上 summary 和 action buttons
  6. Review:点击 “View Session” 查看完整 transcript,或点击 “Create PR” 打开 pull request

User interface elements

App Home

App Home 标签页会显示连接状态,并允许你把 Claude 账号与 Slack 连接或断开。

Message actions

  • View Session:在浏览器里打开完整的 Claude Code session,查看所有执行内容、继续 session,或追加请求。
  • Create PR:根据 session 的改动直接创建 pull request。
  • Retry as Code:如果 Claude 一开始按 chat assistant 回复,但你想要 coding session,可以点这个按钮重试。
  • Change Repo:如果 Claude 选错了 repository,可以在这里换成其他仓库。

Repository selection

Claude 会根据 Slack 对话上下文自动选择 repository。若有多个 repository 都可能匹配,它会显示下拉菜单,让你手动选正确的仓库。

Access and permissions

User-level access

Access Type Requirement
Claude Code Sessions 每个用户都在自己的 Claude 账号下运行 session
Usage & Rate Limits session 会计入该用户个人 plan 的限额
Repository Access 用户只能访问自己已经连接的 repositories
Session History session 会显示在 claude.ai/code 的 Claude Code 历史记录里

Workspace-level access

Slack workspace administrators 控制 Claude app 是否可以在工作区使用:

Control Description
App installation 工作区管理员决定是否从 Slack App Marketplace 安装 Claude app
Enterprise Grid distribution 对于 Enterprise Grid 组织,组织管理员可以控制哪些 workspaces 能访问 Claude app
App removal 从工作区移除 app 会立即撤销该工作区所有用户的访问权限

Channel-based access control

Claude 安装后不会自动加入任何频道。用户必须显式把 Claude 邀请到要使用的频道里:

  • Invite required:在任意频道输入 /invite @Claude 把 Claude 加入频道
  • Channel membership controls access:Claude 只能响应它已加入频道里的 @mentions
  • Access gating through channels:管理员可以通过控制 Claude 被邀请到哪些频道,以及谁能访问这些频道,来管理 Claude Code 的使用范围
  • Private channel support:Claude 同时支持 public 和 private channels,便于团队控制可见性

这种基于频道的模型可以把 Claude Code 的使用限制在指定频道里,在工作区权限之外再加一层访问控制。

What’s accessible where

In Slack:你会看到状态更新、完成摘要和操作按钮。完整 transcript 会一直保留,并且始终可访问。

On the web:你可以看到完整的 Claude Code session,包括完整对话历史、所有代码修改、文件操作,以及继续 session 或创建 pull request 的能力。

对于 Enterprise 和 Team 账号,从 Slack 创建的 session 会自动对组织可见。更多内容见 Claude Code on the Web sharing

Best practices

Writing effective requests

  • Be specific:尽量带上文件名、函数名或错误信息。
  • Provide context:如果对话里不够清楚,就说明 repository 或 project。
  • Define success:明确什么算完成,比如要不要写 tests、更新 documentation、创建 PR。
  • Use threads:讨论 bug 或功能时尽量在 thread 里回复,这样 Claude 可以拿到完整上下文。

When to use Slack vs. web

Use Slack when:上下文已经在 Slack 讨论里、你想异步启动任务、或者需要团队成员都看见进展。

Use the web directly when:你需要上传文件、希望开发过程中实时交互,或者任务更长、更复杂。

Troubleshooting

Sessions not starting

  1. 检查 Claude account 是否已在 Claude App Home 里连接
  2. 确认你已启用 Claude Code on the web access
  3. 确认至少有一个 GitHub repository 已连接到 Claude Code

Repository not showing

  1. 在 Claude Code on the web 的 claude.ai/code 里连接该 repository
  2. 检查你对该 GitHub repository 的权限是否正确
  3. 试着断开并重新连接 GitHub account

Wrong repository selected

  1. 点击 “Change Repo” 选择其他 repository
  2. 在请求里直接写明 repository name,让 Claude 更容易选对

Authentication errors

  1. 在 App Home 里断开并重新连接 Claude account
  2. 确认浏览器里登录的是正确的 Claude account
  3. 检查你的 Claude plan 是否包含 Claude Code access

Session expiration

  1. session 会继续保留在 Claude Code 的 web 历史记录中
  2. 你可以在 claude.ai/code 继续或回看历史 session

Current limitations

  • GitHub only:目前只支持 GitHub 上的 repositories。
  • One PR at a time:每个 session 只能创建一个 pull request。
  • Rate limits apply:session 会消耗个人 Claude plan 的 rate limits。
  • Web access required:用户必须拥有 Claude Code on the web access;没有该权限的人只能收到标准 Claude chat 回复。

相关资源

常见问题

为什么 Claude 在 Slack 里没有创建 Claude Code 会话?

先检查 App Home 里的连接状态,再确认你已经启用 Claude Code on the web,并且至少连接了一个 GitHub 仓库。Claude 只会在频道里响应已加入频道中的 @mentions,所以也要确认已经执行过 /invite @Claude

为什么 Claude 选错了仓库?

可以点 “Change Repo” 手动切换仓库。为了让自动选择更准确,直接在请求里写出仓库名通常更有效。

Slack 里的会话和 claude.ai/code 里的内容是一致的吗?

Slack 里会显示状态更新、完成摘要和操作按钮;完整 transcript 始终保留在 web 端的 Claude Code 会话里。你可以从 Slack 点 “View Session” 打开完整记录并继续处理。