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
- Initiation:你在 Slack 中 @mention Claude,并提出 coding request
- Detection:Claude 分析消息,识别 coding intent
- Session creation:在 claude.ai/code 上创建新的 Claude Code session
- Progress updates:Claude 在 Slack thread 里持续发送状态更新
- Completion:完成后,Claude @mention 你,并附上 summary 和 action buttons
- 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
- 检查 Claude account 是否已在 Claude App Home 里连接
- 确认你已启用 Claude Code on the web access
- 确认至少有一个 GitHub repository 已连接到 Claude Code
Repository not showing
- 在 Claude Code on the web 的 claude.ai/code 里连接该 repository
- 检查你对该 GitHub repository 的权限是否正确
- 试着断开并重新连接 GitHub account
Wrong repository selected
- 点击 “Change Repo” 选择其他 repository
- 在请求里直接写明 repository name,让 Claude 更容易选对
Authentication errors
- 在 App Home 里断开并重新连接 Claude account
- 确认浏览器里登录的是正确的 Claude account
- 检查你的 Claude plan 是否包含 Claude Code access
Session expiration
- session 会继续保留在 Claude Code 的 web 历史记录中
- 你可以在 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 Code on the web — Web 端使用说明
- Claude for Slack — Claude Slack 通用文档
- Slack App Marketplace — 安装 Claude app
- Claude Help Center — 获取更多支持
常见问题
为什么 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” 打开完整记录并继续处理。