文档索引
在此获取完整文档索引:https://code.claude.com/docs/llms.txt 使用此文件发现所有可用页面,然后再进一步探索。
Slack 中的 Claude Code
直接从你的 Slack 工作区委派编码任务
Slack 中的 Claude Code 将 Claude Code 的强大功能直接带入你的 Slack 工作区。当你使用 @Claude 提及一个编码任务时,Claude 会自动检测意图并在 Web 上创建 Claude Code 会话,让你无需离开团队对话即可委派开发工作。
此集成基于现有的 Claude for Slack 应用构建,但增加了对编码相关请求智能路由到 Web 上 Claude Code 的功能。
使用场景
- Bug 调查和修复:在 Slack 频道中报告 Bug 后立即让 Claude 调查并修复。
- 快速代码审查和修改:让 Claude 根据团队反馈实现小功能或重构代码。
- 协作调试:当团队讨论提供关键上下文(如错误复现或用户报告)时,Claude 可以利用这些信息来指导其调试方法。
- 并行任务执行:在 Slack 中启动编码任务,同时你继续其他工作,完成时接收通知。
前提条件
在 Slack 中使用 Claude Code 之前,请确保你具备以下条件:
| 要求 | 详情 |
|---|---|
| Claude 计划 | Pro、Max、Team 或 Enterprise,具有 Claude Code 访问权限(高级席位或 Chat + Claude Code 席位) |
| Web 上的 Claude Code | 必须启用 Web 上的 Claude Code 访问权限 |
| GitHub 账户 | 已连接到 Web 上的 Claude Code,且至少有一个仓库已认证 |
| Slack 认证 | 你的 Slack 账户已通过 Claude 应用链接到你的 Claude 账户 |
在 Slack 中设置 Claude Code
在 Slack 中安装 Claude 应用
工作区管理员必须从 Slack 应用市场安装 Claude 应用。访问 Slack 应用市场 并点击 "Add to Slack" 开始安装过程。
连接你的 Claude 账户
应用安装后,认证你的个人 Claude 账户:
- 通过点击 Apps 部分中的 "Claude" 打开 Slack 中的 Claude 应用
- 导航到 App Home 标签
- 点击 "Connect" 将你的 Slack 账户与 Claude 账户链接
- 在浏览器中完成认证流程
配置 Web 上的 Claude Code
确保你的 Web 上的 Claude Code 已正确配置:
- 访问 claude.ai/code 并使用与 Slack 相同的账户登录
- 如果尚未连接,请连接你的 GitHub 账户
- 认证至少一个你希望 Claude 使用的仓库
选择路由模式
连接账户后,配置 Claude 在 Slack 中处理消息的方式。导航到 Slack 中的 Claude App Home 找到 Routing Mode 设置。
模式 行为 Code only Claude 将所有 @提及路由到 Claude Code 会话。最适合专门在 Slack 中使用 Claude 进行开发任务的团队。 Code + Chat Claude 分析每条消息并智能地在 Claude Code(用于编码任务)和 Claude Chat(用于写作、分析和一般问题)之间路由。最适合希望使用单一 @Claude 入口点处理所有类型工作的团队。 Note在 Code + Chat 模式下,如果 Claude 将消息路由到 Chat 但你想要编码会话,可以点击 "Retry as Code" 来创建 Claude Code 会话。类似地,如果路由到 Code 但你想要 Chat 会话,可以在该线程中选择该选项。
将 Claude 添加到频道
安装后 Claude 不会自动添加到任何频道。要在频道中使用 Claude,请在该频道中输入
/invite @Claude来邀请它。Claude 只能响应已添加它的频道中的 @提及。
工作原理
自动检测
当你在 Slack 频道或线程中提及 @Claude 时,Claude 会自动分析你的消息以确定是否为编码任务。如果 Claude 检测到编码意图,它会将你的请求路由到 Web 上的 Claude Code,而不是作为普通聊天助手响应。
你也可以明确告诉 Claude 将请求作为编码任务处理,即使它没有自动检测到。
Slack 中的 Claude Code 仅在频道(公开或私密)中有效。在直接消息 (DM) 中无效。
上下文收集
从线程:当你在线程中 @提及 Claude 时,它会收集该线程中所有消息的上下文以理解完整对话。
从频道:当直接在频道中提及时,Claude 会查看最近的频道消息以获取相关上下文。
此上下文帮助 Claude 理解问题、选择合适的仓库并指导其完成任务的方法。
当在 Slack 中调用 @Claude 时,Claude 会被授予访问对话上下文的权限以更好地理解你的请求。Claude 可能会遵循上下文中其他消息的指示,因此用户应确保仅在受信任的 Slack 对话中使用 Claude。
会话流程
- 发起:你 @提及 Claude 并提出编码请求
- 检测:Claude 分析你的消息并检测编码意图
- 会话创建:在 claude.ai/code 上创建新的 Claude Code 会话
- 进度更新:随着工作进展,Claude 向你的 Slack 线程发布状态更新
- 完成:完成后,Claude @提及你并提供摘要和操作按钮
- 审查:点击 "View Session" 查看完整记录,或点击 "Create PR" 打开拉取请求
用户界面元素
App Home
App Home 标签显示你的连接状态,并允许你连接或断开 Slack 中的 Claude 账户。
消息操作
- 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 应用市场安装 Claude 应用 |
| Enterprise Grid 分发 | 对于 Enterprise Grid 组织,组织管理员可以控制哪些工作区可以访问 Claude 应用 |
| 应用移除 | 从工作区移除应用会立即撤销该工作区所有用户的访问权限 |
基于频道的访问控制
安装后 Claude 不会自动添加到任何频道。用户必须明确将 Claude 邀请到他们想要使用的频道:
- 需要邀请:在任何频道中输入
/invite @Claude将 Claude 添加到该频道 - 频道成员资格控制访问:Claude 只能响应已添加它的频道中的 @提及
- 通过频道进行访问控制:管理员可以通过管理 Claude 被邀请到哪些频道以及谁有权访问这些频道来控制谁使用 Claude Code
- 私密频道支持:Claude 在公开和私密频道中均可工作,为团队提供控制可见性的灵活性
这种基于频道的模型允许团队将 Claude Code 使用限制在特定频道中,在工作区级权限之上提供额外的访问控制层。
各处可访问的内容
在 Slack 中:你将看到状态更新、完成摘要和操作按钮。完整记录被保留并始终可访问。
在 Web 上:完整的 Claude Code 会话,包含完整的对话历史、所有代码更改、文件操作,以及继续会话或创建拉取请求的能力。
对于 Enterprise 和 Team 账户,从 Slack 中的 Claude 创建的会话对组织自动可见。更多详情请参阅 Web 上的 Claude Code 共享。
最佳实践
编写有效的请求
- 具体:在相关时包含文件名、函数名或错误消息。
- 提供上下文:如果对话中不明确,请提及仓库或项目。
- 定义成功:解释"完成"是什么样的——Claude 应该编写测试吗?更新文档?创建 PR?
- 使用线程:讨论 Bug 或功能时在线程中回复,以便 Claude 可以收集完整上下文。
何时使用 Slack 与 Web
在以下情况使用 Slack:上下文已存在于 Slack 讨论中,你想要异步启动任务,或你与需要可见性的团队成员协作。
在以下情况直接使用 Web:你需要上传文件、想要开发过程中的实时交互,或正在处理更长、更复杂的任务。
故障排除
会话未启动
- 验证你的 Claude 账户已在 Claude App Home 中连接
- 检查你是否启用了 Web 上的 Claude Code 访问权限
- 确保你至少有一个 GitHub 仓库连接到 Claude Code
仓库未显示
- 在 claude.ai/code 上的 Web Claude Code 中连接仓库
- 验证你对该仓库的 GitHub 权限
- 尝试断开并重新连接你的 GitHub 账户
选择了错误的仓库
- 点击 "Change Repo" 按钮选择不同的仓库
- 在请求中包含仓库名称以获得更准确的选择
认证错误
- 在 App Home 中断开并重新连接你的 Claude 账户
- 确保你在浏览器中登录了正确的 Claude 账户
- 检查你的 Claude 计划是否包含 Claude Code 访问权限
会话过期
- 会话在 Web 上的 Claude Code 历史中保持可访问
- 你可以从 claude.ai/code 继续或引用过去的会话
当前限制
- 仅限 GitHub:目前支持 GitHub 上的仓库。
- 一次一个 PR:每个会话可以创建一个拉取请求。
- 速率限制适用:会话使用你个人 Claude 计划的速率限制。
- 需要 Web 访问:用户必须拥有 Web 上的 Claude Code 访问权限;没有该权限的用户将只获得标准 Claude 聊天响应。