Claude Code 平台集成
Claude Code 平台集成
Slack 中使用 Claude Code
2 分钟阅读
Claude Code in Slack
直接从你的 Slack 工作区委派编码任务
Claude Code in Slack 正在被 Claude Tag 取代，适用于 Team 和 Enterprise 工作区。Claude Tag 以 @Claude 作为组织的共享身份运行，具有管理员配置的访问权限，在同一 Slack 应用下，因此无需重新安装，现有设置在过渡期间继续工作。要切换工作区，请参阅从早期 Claude in Slack 迁移。
Claude Code in Slack 将 Claude Code 的强大功能直接带入你的 Slack 工作区。当你在 Slack 中 @提及 @Claude 并附带编码任务时，Claude 会自动检测意图并在网页上创建 Claude Code 会话，让你无需离开团队对话即可委派开发工作。
该集成建立在现有的 Claude for Slack 应用之上，但增加了智能路由功能，将编码相关请求路由到网页上的 Claude Code。每个会话在你的 Claude 账户下运行，使用你连接的仓库和你的套餐限制。
使用场景
- Bug 调查与修复：在 Slack 频道中报告 bug 时，立即让 Claude 调查和修复。
- 快速代码审查与修改：根据团队反馈让 Claude 实现小功能或重构代码。
- 协作调试：当团队讨论提供关键上下文（如错误复现或用户报告）时，Claude 可以使用这些信息来指导其调试方法。
- 并行任务执行：在 Slack 中启动编码任务，同时继续其他工作，完成后接收通知。
先决条件
使用 Claude Code in Slack 前，请确保你具备以下条件：
| Requirement | Details |
|---|---|
| Claude 套餐 | Pro、Max、Team 或 Enterprise，具有 Claude Code 访问权限（premium seats 或 Chat + Claude Code seats） |
| Claude Code 网页版 | 必须启用 Claude Code 网页版 访问 |
| GitHub 账户 | 连接到 Claude Code 网页版，至少有一个仓库已通过认证 |
| Slack 认证 | 你的 Slack 账户通过 Claude 应用关联到你的 Claude 账户 |
设置 Claude Code in Slack
在 Slack 中安装 Claude 应用
工作区管理员必须从 Slack App Marketplace 安装 Claude 应用。访问 Slack App Marketplace 并点击"Add to Slack"开始安装。
连接你的 Claude 账户
应用安装后，认证你的个人 Claude 账户：
- 在 Slack 中点击 Apps 部分的"Claude"打开 Claude 应用
- 前往 App Home 标签页
- 点击"Connect"将你的 Slack 账户与 Claude 账户关联
- 在浏览器中完成认证流程
配置 Claude Code 网页版
确保你的 Claude Code 网页版已正确配置：
- 访问 claude.ai/code 并使用你连接到 Slack 的相同账户登录
- 如果尚未连接，请连接你的 GitHub 账户
- 认证至少一个你希望 Claude 处理的仓库
选择路由模式
连接账户后，配置 Claude 在 Slack 中处理消息的方式。在 Slack 中前往 Claude App Home 查找 Routing Mode 设置。
| Mode | Behavior |
|---|---|
| Code only | Claude 将所有 @提及路由到 Claude Code 会话。最适合在 Slack 中专门将 Claude 用于开发任务的团队。 |
| Code + Chat | Claude 分析每条消息，并在 Claude Code（编码任务）和 Claude Chat（写作、分析和一般问题）之间智能路由。最适合希望 @Claude 作为所有类型工作的单一入口的团队。 |
在 Code + Chat 模式下，如果 Claude 将消息路由到 Chat 但你希望进行编码会话，可以点击"Retry as Code"来创建 Claude Code 会话。同样，如果路由到 Code 但你希望 Chat 会话，也可以在该线程中选择该选项。
将 Claude 添加到频道
Claude 安装后不会自动添加到任何频道。要在频道中使用 Claude，请在该频道中输入 /invite @Claude 邀请它。Claude 只能在被添加的频道中响应 @提及。
工作原理
自动检测
当你在 Slack 频道或线程中 @提及 @Claude 时，Claude 会自动分析你的消息以确定是否为编码任务。如果 Claude 检测到编码意图，它会将你的请求路由到网页上的 Claude Code，而非作为常规聊天助手响应。
你也可以明确告诉 Claude 将请求作为编码任务处理，即使它没有自动检测到。
Claude Code in Slack 仅在频道（公开或私有）中工作。它在私信（DM）中不起作用。
上下文收集
来自线程：当你在线程中 @提及 Claude 时，它会从线程中的所有消息收集上下文以理解完整对话。
来自频道：当直接在频道中被提及时，Claude 会查看最近的频道消息以获取相关上下文。
这些上下文帮助 Claude 理解问题、选择适当的仓库，并指导其处理任务的方法。
会话流程
- 启动：你 @提及 Claude 并附带编码请求
- 检测：Claude 分析你的消息并检测编码意图
- 会话创建：在 claude.ai/code 上创建新的 Claude Code 会话
- 进度更新：Claude 在工作进展时向你的 Slack 线程发布状态更新
- 完成：完成后，Claude @提及你并提供摘要和操作按钮
- 审查：点击"View Session"查看完整 transcript，或点击"Create PR"打开拉取请求
用户界面元素
App Home
App Home 标签页显示你的连接状态，并允许你连接或断开 Claude 账户与 Slack 的关联。
消息操作
- View Session：在浏览器中打开完整的 Claude Code 会话，你可以查看所有执行的工作、继续会话或提出额外请求。
- Create PR：直接从会话的更改创建拉取请求。
- Retry as Code：如果 Claude 最初作为聊天助手响应但你希望进行编码会话，点击此按钮将请求作为 Claude Code 任务重试。
- Change Repo：如果 Claude 选择错误，允许你选择不同的仓库。
仓库选择
Claude 根据 Slack 对话的上下文自动选择仓库。如果可能适用多个仓库，Claude 可能会显示下拉菜单让你选择正确的仓库。
访问与权限
用户级别访问
| Access Type | Requirement |
|---|---|
| Claude Code 会话 | 每个用户在自己的 Claude 账户下运行会话 |
| 使用量与速率限制 | 会话计入个人用户的套餐限制 |
| 仓库访问权限 | 用户只能访问他们个人已连接的仓库 |
| 会话历史记录 | 会话出现在你在 claude.ai/code 上的 Claude Code 历史记录中 |
工作区级别访问
Slack 工作区管理员控制 Claude 应用是否在其工作区中可用：
| Control | Description |
|---|---|
| 应用安装 | 工作区管理员决定是否从 Slack App Marketplace 安装 Claude 应用 |
| Enterprise Grid 分发 | 对于 Enterprise Grid 组织，组织管理员可以控制哪些工作区可以访问 Claude 应用 |
| 应用移除 | 从工作区移除应用会立即撤销该工作区中所有用户的访问权限 |
基于频道的访问控制
Claude 安装后不会自动添加到任何频道。用户必须明确邀请 Claude 到他们希望使用的频道：
- 需要邀请：在任何频道中输入
/invite @Claude以将该频道添加 Claude - 频道成员控制访问：Claude 只能在被添加的频道中响应 @提及
- 通过频道进行访问控制：管理员可以通过管理邀请 Claude 的频道以及谁可以访问这些频道来控制谁使用 Claude Code
- 私有频道支持：Claude 在公开和私有频道中均可工作，为团队提供控制可见性的灵活性
这种基于频道的模型允许团队将 Claude Code 使用限制在特定频道，提供了工作区级别权限之外的额外访问控制层。
各平台可访问内容
在 Slack 中：你会看到状态更新、完成摘要和操作按钮。完整 transcript 会被保留并始终可访问。
在网页上：完整的 Claude Code 会话，包含完整对话历史、所有代码更改、文件操作，以及继续会话或创建拉取请求的能力。
对于 Enterprise 和 Team 账户，从 Slack 中的 Claude 创建的会话会自动对组织可见。有关更多详情，请参阅 Claude Code 网页版共享。
最佳实践
编写有效的请求
- 具体：在相关时包含文件名、函数名或错误消息。
- 提供上下文：如果对话中没有明确说明，请提及仓库或项目。
- 定义成功：解释"完成"是什么样子——Claude 应该编写测试？更新文档？创建 PR？
- 使用线程：讨论 bug 或功能时在线程中回复，以便 Claude 可以收集完整上下文。
何时使用 Slack vs. 网页
使用 Slack 时：上下文已存在于 Slack 讨论中、你希望异步启动任务，或你正在与需要可见性的队友协作。
直接使用网页时：你需要上传文件、希望在开发过程中实时交互，或正在处理更长、更复杂的任务。
故障排除
"Claude Code is not enabled for your account"
此错误意味着你的 Claude 账户尚未创建云端环境，并非需要管理员启用。使用你连接到 Slack 的相同账户在 claude.ai/code 登录一次。首次访问会创建你的默认云端环境，下次 @提及 时错误就会消除。每个用户必须单独执行此操作。
会话未启动
- 在 Claude App Home 中验证你的 Claude 账户已连接
- 检查你是否已启用 Claude Code 网页版访问
- 确保你至少有一个 GitHub 仓库连接到 Claude Code
仓库未显示
- 在 claude.ai/code 的 Claude Code 网页版中连接仓库
- 验证你对该仓库的 GitHub 权限
- 尝试断开并重新连接你的 GitHub 账户
选择了错误的仓库
- 点击"Change Repo"按钮选择不同的仓库
- 在请求中包含仓库名称以获得更准确的选择
认证错误
- 在 App Home 中断开并重新连接你的 Claude 账户
- 确保你在浏览器中登录了正确的 Claude 账户
- 检查你的 Claude 套餐是否包含 Claude Code 访问权限
会话过期
- 会话在你的 Claude Code 网页版历史记录中保持可访问
- 你可以从 claude.ai/code 继续或引用过往会话
当前限制
- 仅 GitHub：目前支持 GitHub 上的仓库。
- 一次一个 PR：每个会话只能创建一个拉取请求。
- 速率限制适用：会话使用你个人 Claude 套餐的速率限制。
- 需要网页访问：用户必须具有 Claude Code 网页版访问权限；没有它的用户只会收到标准 Claude 聊天响应。