Slack 中的 Claude Code
在 Slack 里 @Claude 描述编码任务,自动创建 Claude Code 云端会话:用例、前置条件、配置、路由模式、会话流程、访问与权限、最佳实践和排障(较早版本,Team/Enterprise 正迁移到 Claude Tag)。
本页记录较早版本的「Claude Code in Slack」,每个会话在单个用户的账号下运行。Team 和 Enterprise 套餐:Anthropic 正在用 Claude Tag 取代这个版本,Claude Tag 以你组织的共享身份运行 @Claude,访问权限由管理员配置;现有的 Slack 应用和 @Claude 句柄保留,切换日期向你的 Anthropic 客户团队确认;新工作区直接配置 Claude Tag,已经在用这个版本的工作区按官方的迁移指南迁移。Pro 和 Max 套餐:Claude Tag 不适用于个人套餐,本页仍是配置途径。
Claude Code in Slack 把 Claude Code 带进你的 Slack 工作区。你在频道里 @Claude 并描述一个编码任务,Claude 自动识别意图并创建一个 Claude Code 云端会话,让你不离开团队对话就能委派开发工作。它建立在现有的 Claude for Slack 应用之上,只是给编码类请求加了到云端会话的智能路由。每个会话在你自己的 Claude 账号下运行,使用你已连接的仓库和你的套餐额度。
用例
- 缺陷调查与修复:缺陷在 Slack 频道里一被报告,就让 Claude 调查并修复。
- 快速代码评审与修改:让 Claude 根据团队反馈实现小功能或做重构。
- 协作调试:团队讨论提供了关键上下文(如错误复现、用户报告)时,Claude 能用这些信息来指导排查。
- 并行执行任务:在 Slack 里启动编码任务,自己继续做别的事,完成时收到通知。
前提条件
| 要求 | 细节 |
|---|---|
| Claude 套餐 | 有 Claude Code 权限的 Pro、Max、Team 或 Enterprise(高级席位或 Chat + Claude Code 席位) |
| 云端会话 | 你的账号已启用云端会话 |
| GitHub 账号 | 在 claude.ai/code 连接,并至少认证一个仓库 |
| Slack 认证 | 通过 Claude 应用把你的 Slack 账号与 Claude 账号关联 |
设置步骤
- 在 Slack 里安装 Claude 应用。 必须由工作区管理员从 Slack App Marketplace 安装 Claude 应用:打开市场页面,点击「Add to Slack」开始安装。
- 连接你的 Claude 账号。 应用安装后,认证你个人的 Claude 账号:在 Slack 的 Apps 区域点击「Claude」打开应用,进入 App Home 标签页,点击「Connect」把 Slack 账号与 Claude 账号关联,并在浏览器里完成认证流程。
- 配置云端会话。 访问 claude.ai/code,用与连接 Slack 相同的账号登录;如果还没连接 GitHub 账号就连接,并认证至少一个你想让 Claude 处理的仓库。
- 选择路由模式。 账号连接后,在 Slack 的 Claude App Home 里找到 Routing Mode 设置,配置 Claude 如何处理你的消息(见下表)。
- 把 Claude 加进频道。 安装后 Claude 不会自动加入任何频道。要在某个频道里使用,在该频道里输入
/invite @Claude邀请它。Claude 只会响应它所在频道里的 @提及。
路由模式
| 模式 | 行为 |
|---|---|
| Code only | Claude 把所有 @提及路由到 Claude Code 会话。最适合只把 Claude 在 Slack 里用于开发任务的团队 |
| Code + Chat | Claude 分析每条消息,在 Claude Code(编码任务)和 Claude Chat(写作、分析和一般问题)之间智能路由。最适合想用单一 @Claude 入口处理各类工作的团队 |
在 Code + Chat 模式下,如果 Claude 把消息路由到了 Chat 而你想要编码会话,可以点「Retry as Code」改为创建 Claude Code 会话;反过来,如果被路由到 Code 而你想要 Chat,也可以在该线程里选择那个选项。
工作方式
自动识别
在 Code + Chat 路由模式下,你在 Slack 频道或线程里 @Claude 时,Claude 自动判断消息是否是编码任务:编码任务进入 Claude Code 云端会话,其他的得到常规聊天回复。在 Code only 模式下,每个 @提及都去 Claude Code。你也可以明确告诉 Claude 把某个请求当作编码任务处理,即便它没有自动识别出来。
Claude Code in Slack 只在频道(公开或私有)里工作,不能在私信(DM)里使用。
上下文收集
- 来自线程:你在线程里 @Claude 时,它会收集该线程里所有消息的上下文,以理解完整对话。
- 来自频道:在频道里被直接提及时,Claude 查看最近的频道消息获取相关上下文。
这些上下文帮助 Claude 理解问题、选择合适的仓库并确定处理思路。
注意:@Claude 被调用时,Claude 能访问对话上下文以更好地理解请求,并且可能听从上下文里其他消息的指示,所以只应在受信任的 Slack 对话里使用 Claude。
会话流程
- 发起:你 @Claude 并提出编码请求。
- 识别:Claude 分析消息并检测到编码意图。
- 创建会话:在 claude.ai/code 上创建一个新的 Claude Code 会话。
- 进度更新:Claude 随工作推进向你的 Slack 线程发布状态更新。
- 完成:完成时 Claude @你,附上摘要和操作按钮。
- 评审:点「View Session」查看完整记录,或点「Create PR」开一个拉取请求。
界面元素
消息操作
- View Session:在浏览器里打开完整的 Claude Code 会话,可以查看做过的全部工作、继续该会话或提出更多请求。
- Create PR:直接从会话的改动创建拉取请求。
- Retry as Code:Claude 起初以聊天助手回应、而你想要编码会话时,点它把请求作为 Claude Code 任务重试。
- Change Repo:Claude 选错仓库时,让你选另一个仓库。
仓库选择
Claude 根据 Slack 对话的上下文自动选择仓库。如果多个仓库都可能适用,Claude 可能显示下拉框让你选正确的那个。
访问与权限
用户级
| 访问类型 | 要求 |
|---|---|
| Claude Code 会话 | 每个用户在自己的 Claude 账号下运行会话 |
| 用量与速率限制 | 会话计入单个用户的套餐额度 |
| 仓库访问 | 用户只能访问自己连接过的仓库 |
| 会话历史 | 会话出现在 claude.ai/code 上你的 Claude Code 历史里 |
工作区级
Slack 工作区管理员控制 Claude 应用在其工作区里是否可用:
| 控制项 | 说明 |
|---|---|
| 应用安装 | 工作区管理员决定是否从 Slack App Marketplace 安装 Claude 应用 |
| Enterprise Grid 分发 | 对 Enterprise Grid 组织,组织管理员可以控制哪些工作区能用 Claude 应用 |
| 应用移除 | 从工作区移除应用会立即撤销该工作区所有用户的访问 |
基于频道的访问控制
安装应用不会把 Claude 加进任何频道。Claude 只在被加入的频道里响应 @提及,用 /invite @Claude 邀请;公开和私有频道都行。管理员可以通过管理 Claude 被邀请进哪些频道、以及谁能访问这些频道,来控制谁能使用 Claude Code,这在工作区级权限之外又多了一层访问控制。
在哪里能看到什么
- 在 Slack 里:你看到状态更新、完成摘要和操作按钮;完整记录被保留并始终可访问。
- 在 claude.ai/code:完整的 Claude Code 会话,含完整对话历史、所有代码改动和文件操作。会话保留在你的 Claude Code 历史里,可以继续过去的会话、引用它们或创建拉取请求。
对 Enterprise 和 Team 账号,从 Slack 里的 Claude 创建的会话对组织自动可见(见云端会话共享)。
最佳实践
写出有效的请求
- 具体:相关时包含文件名、函数名或错误信息。
- 给上下文:对话里不清楚时,提到仓库或项目。
- 定义成功:说明「完成」是什么样:要写测试吗?要更新文档吗?要创建 PR 吗?
- 用线程:讨论缺陷或功能时在线程里回复,让 Claude 能收集完整上下文。
什么时候用 Slack、什么时候用网页
- 用 Slack:上下文已经存在于某个 Slack 讨论里、你想异步启动任务,或你与需要可见性的队友协作。
- 直接用网页:需要上传文件、希望开发过程中实时交互,或在做更长、更复杂的任务。
排障
「Claude Code is not enabled for your account」
这个错误表示你的 Claude 账号还没有云环境。用与连接 Slack 相同的账号登录一次 claude.ai/code,并完成网页引导(它会创建默认云环境或让你创建),下一次提及时错误就会消失。每个用户都要各自完成。
会话没有启动
- 确认你的 Claude 账号已在 Claude App Home 里连接。
- 检查你的账号已启用云端会话。
- 确保至少有一个 GitHub 仓库连接到了 Claude Code。
来自 Claude Tag 频道的会话启动失败
这一条适用于使用 Claude Tag 的工作区,其中 Claude 以组织的共享身份而非某个成员的账号在频道里工作。如果你在 claude.ai/code 创建了频道的云环境,它属于你的个人账号,而 Claude 无法在个人环境里启动频道会话,Claude Code 会立即让会话失败,重试没有用。
如果你是 Owner 且环境是你自己的,在环境选择器里把它共享给组织;否则由 Owner 在管理设置的 Cloud environments 页面里把它重建为组织共享环境。应用方式有两种:在 claude.ai/admin-settings/claude-code 把它设为组织默认;或在 Claude Tag 管理设置里把它设在频道上。如果你不是 Owner,把这一条转给 Owner。
仓库没有出现
- 在 claude.ai/code 连接该仓库。
- 确认你对该仓库的 GitHub 权限。
- 尝试断开并重新连接你的 GitHub 账号。
选错了仓库
- 点「Change Repo」按钮选另一个仓库。
- 在请求里写上仓库名,让选择更准确。
认证错误
- 在 App Home 里断开并重新连接你的 Claude 账号。
- 确保浏览器里登录的是正确的 Claude 账号。
- 检查你的 Claude 套餐包含 Claude Code 权限。
当前限制
- 仅限 GitHub:仓库必须在 GitHub 上。
- 一次一个 PR:每个会话能创建一个拉取请求。
- 需要云端会话权限:用户需要云端会话的访问权;没有的话,Claude 只回复标准聊天回答。