52  频道和私信中的 Claude Tag 故障排除

Claude Tag 在 Slack 中的常见问题修复。涵盖无回复后反应、排队或失败的会话、丢失的工作、缺失的连接、被阻止的链接和网站,以及私信或账户错误。

export const BetaNote = () => Claude Tag 目前处于公开测试阶段。此处描述的功能和行为在正式发布前可能会发生变化。;

对话中途出问题时,原因通常是少数几种之一。以下每个条目都有相同的三个部分:你看到的现象、含义和解决方法。对于设置和凭证错误,参见管理员故障排除页面

许多修复的最终步骤是向管理员发送某些内容。在此页面上,“管理员”指在 claude.ai 管理你组织 Claude 账户的人,通常与你的 Slack 管理员不是同一个人。如果你不知道是谁,询问在你的工作区设置 Claude 的人。

52.1 无回复或沉默

52.1.1 @Claude 完全没有反应

你看到的现象

@Claude 没有反应也没有回复。

含义

完全沉默有几种可能原因,从应用未安装到频道被关闭,以下检查可以将它们区分开。

解决方法

按以下顺序排查。每个步骤都说明了成功是什么样的以及失败时去哪里。

  1. 此工作区是否安装了 Claude 应用? 在任意频道中开始输入 @Claude成功:Slack 自动补全为带应用标识的 Claude 应用;如果出现多个 Claude 应用,与管理员确认使用哪个。失败:没有自动补全,或只出现一个叫 Claude 的人。应用未安装;需要你的管理员(发送设置概览给他们)。
  2. Claude 在此频道中吗? 在频道的消息输入框(而非线程回复)中输入 /invite @Claude。Slack 不允许在线程内使用 /invite(“/invite is not supported in threads. Sorry!”)。成功:Slack 发布”Claude was added to #channel”(或”is already in this channel”)。再次提及它。失败:Slack 说我不能向此频道添加应用(Slack Connect 或访客限制频道);改为尝试内部频道。
  3. 此频道是否已开启 Claude Tag? 邀请后再次提及。成功:它反应并回复。失败:它回复”Claude is disabled in this channel”(频道设置为 Off),或它回复但行为像早期的 Claude in Slack——没有频道记忆,Pull Request 以你的名字而非 Claude 的名字打开(频道设置为 Legacy)。无论哪种,都需要管理员(发送从早期 Claude in Slack 迁移)。

如果三步之后 @Claude 仍然没有反应和回复,向管理员发送沉默工作区的管理员条目。如果沉默覆盖 Enterprise Grid 上的每个频道,修复需要 Slack 组织管理员而非你的 Claude 管理员,因此发送链接给他们。

52.1.2 Claude 回复我但不回复队友

你看到的现象

Claude 在频道中回答你的提及,但同一频道中队友的提及得到沉默或拒绝。

含义

在频道中提及 Claude 不需要发送者拥有 Claude 账户或席位,因此默认情况下工作区中的任何人都可以使用它。你的组织可以通过成员访问设置进行限制,此时限制外的成员会被拒绝。

解决方法

让队友自行提及 @Claude 并报告任何回复的确切文本;回复就是诊断。

  • 完全没有反应和回复:在同一频道对你有效时很不寻常;向管理员发送确切的频道和人。
  • 关于访客的消息:参见下面的访客条目
  • 关于权限或访问的消息:你的组织限制了谁可以使用 Claude;向管理员发送成员访问设置

52.1.3 Claude 反应了或开始思考,但从未回复

你看到的现象

Claude 对你的消息添加了反应,或出现了”is thinking…“提示,但没有回复到达。

含义

有反应或”is thinking…“但没有回复通常意味着 Claude 仍在工作,而非你的消息被丢弃。

解决方法

  1. 在同一线程中 @ 提及 Claude 进行状态检查。
  2. 如果它之前在线程中回复过,从其最后消息中的链接打开会话观看实时进度。长任务通常在那里显示稳定进展,而 Slack 线程看起来空闲。
  3. 如果沉默已远超任务应有时间,在线程中发送 @Claude !restart;它归档会话并启动一个仍读取该线程的新会话。开始新线程并重述请求也有效。

重启会放弃会话正在进行的工作,无法恢复。沉默的会话可能仍在处理长任务,因此将 !restart 视为最后手段。

52.1.4 Claude 说我的会话在排队或启动失败

你看到的现象

Claude 在线程中发布:

Still waiting for available capacity — your request is queued and will start automatically. Replies in this thread are picked up automatically.

或者,如果会话从未启动:

Session failed to start: the session container never connected — please try again

含义

第一条消息意味着计算资源暂时繁忙;一旦资源释放,会话自动启动。第二条意味着会话根本没有启动,这是暂时性的。

解决方法

  • 对于资源消息,等待几分钟;无需操作。要在等待时添加上下文,在同一线程中 @ 提及 Claude 而非开启新线程。新线程只会在第一个后面排队第二个会话。
  • 对于启动失败消息,在同一线程中提及 Claude 重试。如果重试成功,会话启动,Claude 开始任务。

52.1.5 Claude 对我编辑的消息没有反应

你看到的现象

你编辑已发送的消息添加了 @Claude,但没有反应。

含义

编辑已发送的消息添加提及不会触发回复;Claude 仅从新消息中拾取提及。

解决方法

发送一条包含提及的新消息。

52.1.6 Claude 在与另一家公司共享的频道中从不回复

你看到的现象

在与另一家公司共享的频道中提及 Claude 没有反应和回复,完全不回复。

含义

Claude 不在 Slack Connect 频道(与另一家公司共享的频道)中运行。无论管理员设置如何都如此;那里的提及被静默丢弃。参见外部共享频道

Enterprise Grid 内跨工作区共享的频道不是静默的;那里发生什么取决于这些工作区如何连接到 Claude。当频道中的每个工作区属于你的一个 Claude 组织时,Claude 会回复,但仅使用你组织的默认访问权限和设置,因此为该频道设置的仓库或指令不适用。线程中的通知会不时指出这一点。当工作区连接到不同的 Claude 组织时,你看到”This channel is shared among several Claude workspaces, so Claude cannot respond here”而非回复。

在访客访问受限的地方,你可能首先看到”This channel is shared across multiple workspaces, and Claude can’t verify whether it includes guests, so Claude can’t respond here.” 如果你在其他对话中要求 Claude 对这些频道之一操作(如在那里发布消息),你看到以”Claude isn’t available in channels shared across your Enterprise Grid”结尾的回复。

这些消息中的每条都意味着频道跨越多个工作区。关于这些消息的管理员条目解释了每条的原因以及管理员可以做什么。

解决方法

将对话移到属于单个工作区的内部频道或私信中,在那里提及 Claude。

52.1.7 无法立即检查此频道

你看到的现象

Claude 在频道中回复:

Couldn’t check this channel just now. Please try again in a moment.

含义

当你的组织在包含访客的频道中限制 Claude(默认行为)时,Claude 在回复前检查每个频道是否有访客。该检查暂时失败,因此 Claude 退出了此次回复而非猜测。

解决方法

再次提及 Claude;重试通常通过。如果同一频道反复出现此问题,向管理员发送关于此消息的管理员条目

52.1.8 Claude 在包含访客的频道中不回复

你看到的现象

Claude 在频道中回复:

Claude doesn’t respond in channels that include guests. You can remove the guests from this channel (Channel details -> Members -> filter by “guests”), or a claude.ai organization owner can allow it here.

含义

频道包含至少一个 Slack 访客账户,且你的组织在包含访客的频道中限制 Claude(默认行为)。

解决方法

以下任一修复有效:

  • 从频道中移除访客。在 Slack 中,打开 Channel detailsMembers 并按”guests”筛选;访客在 Slack 资料上有 guest 标识。
  • 将对话移到没有访客的频道。
  • 请 claude.ai 组织 Owner 允许 Claude 在包含访客的频道中回复,并发送访客访问设置给他们。如果你不知道组织的 Owner 是谁,询问在工作区设置 Claude 的人。

访客访问设置恢复回复,但不恢复工作区搜索。即使 Claude 被允许在包含访客的频道中回复,它也无法从该频道搜索工作区。移除访客或移到没有访客的频道可同时恢复搜索。

如果修复有效,在频道中提及 Claude 可获得回复。

52.2 回复过多或错误

52.2.1 Claude 给了我自信但错误的答案

你看到的现象

Claude 确定地回答,但答案是错误或不完整的。

含义

Claude 可能出错,包括当它听起来很确定时。Slack 中最常见的错误答案是不完整的——Claude 查询了一个来源或一个日期范围,然后像报告全貌一样报告结果。

解决方法

在你分享或根据结果行动之前,检查它发布的来源链接,并要求它展示工作过程(“which channels did you search?”或”show me the query you ran”)。如果答案错误,在同一线程中用正确答案说明;在那里纠正它也是引导下一次尝试的方式。

对于重要的数字和事实,完成定义习惯有帮助。将”include the source for every figure”或”show me the query”作为要求的一部分。

52.2.2 Claude 回复线程中的每条消息

你看到的现象

Claude 回答线程中不是对它说的消息。

含义

一旦 Claude 在线程中被提及,它会跟踪那里的整个对话,并可能回复不是对它说的消息。

解决方法

在线程中回复指令如”only respond when I @-mention you”;Claude 在该线程的剩余部分遵循该指令。

52.2.3 我想撤回我发送的内容

你看到的现象

你编辑或删除了一条消息,但 Claude 仍在按原始消息行动。

含义

Claude 已经读取了原始消息。编辑作为线程中的新更新到达它,因此它可能会也可能不会根据更改行动,且它永远不会撤销已经在进行中的工作。删除的回复完全不会到达 Claude。

解决方法

在新回复中说明(“ignore that, do X instead”),或开始新线程获得干净的会话。

52.2.4 此对话太长,我无法处理

你看到的现象

Claude 在线程中发布:

This conversation is too long for me to process and I couldn’t finish this turn — please start a new thread to continue.

在私信中结尾改为”Click New Chat in the top right to start a fresh session”。

含义

线程已超出单个会话能容纳的范围,并且永远会太长;在那里重试无法工作。

解决方法

开始新线程。你可以粘贴前一线程停止处的摘要。

52.3 Claude 在任务中途停止

本节中的消息意味着会话已启动然后在中途停止。大多数情况下工作不会丢失,同一线程会从中断处继续。每个条目说明是否需要重做什么。

52.3.1 遇到重复的 API 服务器错误并在重试后停止

你看到的现象

Claude 在线程中发布:

I hit repeated API server errors and stopped after retrying. Mention me to continue.

相关消息”I hit repeated 529 Overloaded errors (the API is at capacity) and stopped after retrying. Mention me to continue.”和”The API request timed out and I stopped after retrying. Mention me to continue.”行为相同。

含义

服务会话的 API 返回了重复错误,因此 Claude 停止而非继续重试。工作未丢失。

解决方法

在同一线程中提及 Claude;它从中断处继续。

52.3.2 遇到 API 速率限制并在重试后停止

你看到的现象

Claude 在线程中发布:

I hit API rate limits and stopped after retrying. Wait a moment, then mention me to continue.

含义

Claude API 在回合中途对你的组织流量进行了速率限制。工作未丢失。速率限制关于瞬时请求速率,不是累积使用量:单个任务在短突发中发出许多 API 请求,因此这可能在组织的首次请求上就出现。它不是频道支出限额,也不意味着配置有误。

解决方法

等待片刻,然后在同一线程中提及 Claude;它从中断处继续。如果在各频道中持续出现,组织的持续流量超过其速率限制;管理员可以错峰使用或联系客户团队关于限额的事。

如果你的消息提到的是支出限额,那是不同的问题;参见已达 Claude Tag 支出限额

52.3.3 此请求需要不可用的使用额度

你看到的现象

Claude 在线程中发布:

This request needs usage credits that aren’t available and I couldn’t finish this turn. Enable or purchase usage credits in claude.ai, then mention me to retry.

含义

你的组织使用额度余额无法覆盖此请求,因此回合停止。会话仍然存在。

解决方法

管理员在 claude.ai 为你的组织启用或购买使用额度。完成后,在同一线程中提及 Claude 重试(添加额度不会自动重启工作)。重试继续使用线程的对话和上下文。回复之间保留了什么涵盖了还有什么会延续。

52.3.4 Claude 无法为此会话克隆仓库

你看到的现象

Claude 在线程中发布:

Claude couldn’t clone a repository for this session. Mention Claude in this thread to retry.

含义

会话启动时克隆失败。一次性失败是暂时性的;同一仓库每次都失败通常意味着它未在此频道授权。

解决方法

在同一线程中提及 Claude 重试。如果同一仓库每次都失败,向管理员发送GitHub 访问条目

52.3.5 回合中途丢失了与此会话容器的连接

你看到的现象

Claude 在线程中发布:

I lost the connection to this session’s container mid-turn — the work I was doing may not have finished. Mention me to resume.

你可以在与 Claude 工作的线程中(包括私信线程)看到此消息;Claude 不会在它仅监控的频道或例行任务中发布此消息。

含义

运行此线程会话的沙箱在回合中途停止,因此 Claude 正在进行的步骤可能未完成。线程的对话完好无损。

解决方法

在同一线程中提及 Claude。Claude 在那里恢复并从对话继续;要求它检查正在进行的步骤并重做未完成的部分。如果同样的通知再次出现,底层问题尚未清除。等待几分钟再提及 Claude。

52.3.6 出了点问题,我无法完成此回合

你看到的现象

Claude 在线程中发布:

Something went wrong and I couldn’t finish this turn. Mention me to retry.

相关消息”The API rejected the request as invalid, so I couldn’t finish this turn. Mention me to retry.”行为相同。

含义

这是回合中途停止的兜底消息。错误不匹配本节中更具体的消息,因此原因各不相同。如果消息说”Something went wrong starting a session. Try again in a moment.”,会话从未启动;无论哪种,重试方式相同。

解决方法

在同一线程中提及 Claude 重试;它从中断处继续。如果每次重试都重复出现该消息,从发生的线程提交反馈

52.4 丢失或过时的工作

52.4.1 Claude 丢失了之前创建的工作

你看到的现象

Claude 找不到它之前在线程中制作的文件或草稿。

含义

Claude 在线程上工作的隔离工作区在不活动一段时间后被回收。推送到分支、作为 Pull Request 开启或发布到线程中的工作仍然存在。仅存在于该工作区内的文件不会,Claude 需要重新创建它们。

解决方法

要求 Claude 重新创建文件,对于长时间运行的工作,要求它尽早提交和推送,或随进度将草稿发布到线程中,使任何东西不会仅存在于那个工作区中。完成定义习惯在此有帮助。将”push the branch”或”post the file”作为任务的一部分。

52.4.2 我的旧线程停止工作,但新线程正常

你看到的现象

之前创建的线程每次重试都以相同方式失败,而新线程正常。

含义

线程保留其启动时的 Skill、插件和自定义指令,因此几周前创建的线程可能与组织当前配置脱节,即使新线程正常。在同一线程中重试通常会继续以同样方式失败。

解决方法

在线程中发送 @Claude !restart。它归档卡住的会话并启动一个使用组织当前配置的新会话,新会话仍然读取该线程。

开始新线程并重述请求也有效;粘贴旧线程的链接以便 Claude 拾取上下文。

52.4.3 Claude 选错了仓库

你看到的现象

Claude 开始在你不是指的仓库中工作。

含义

请求没有指定仓库,因此 Claude 从频道的授权中选了一个。

解决方法

开始新线程,在第一条消息中指定正确的仓库,例如”in acme/data-pipeline, fix the failing import。“预先指定仓库也是防止此问题的方法。如果你在线程中途需要另一个仓库,要求 Claude 添加(”add acme/data-pipeline”)并确认它发布的 Confirm 按钮;如果仓库不在此频道允许范围内,Claude 在你确认后告知你。

52.4.4 Claude 忘记了我之前给它的指令

你看到的现象

你之前告诉 Claude 的某些内容在后续线程中没有保留。

含义

频道记忆是小而精选的笔记,不是转录,Claude 决定什么值得保存,因此随口提到的细节通常不会被保留。

解决方法

要使指令持久保存,请明确说明,如 remember for this channel: always post reports as a table。保持保存的指令简短;每个频道的记忆预算有限,长条目会挤占其他所有内容。对于更长的操作手册,存储在 Claude 可以读取的仓库中。

通过问它记住了关于频道的什么来验证。参见Claude Tag 记住了什么

52.5 访问和连接

52.5.1 管理员添加的连接没有显示

你看到的现象

你的管理员添加了连接,但 Claude 在你的线程中说它没有该连接。

含义

Claude 不会被告知在其会话启动后添加的连接,因此它不会列出或提供新服务,即使该连接可用。

解决方法

通过名称要求 Claude 使用该服务;连接有效,即使 Claude 没有公布它。或者开始新线程,它会自动拾取连接。对于缺少连接的计划任务,编辑或重新创建计划。如果修复有效,在新线程中问 @Claude what can you access from this channel? 会列出该连接。

52.5.2 Claude 说它不能访问之前读取过的频道

你看到的现象

一条回复从一个频道中提取了发现,而后一条回复说”I can’t access that channel。“或者当你从另一个频道询问时,Claude 说它不能读取它是成员的私有频道。

含义

这通常不意味着访问权限改变了。

对于公开频道,Claude 可以不作为成员就搜索它,但不能不邀请就直接读取频道,因此搜索结果和直接读取来去方式不同。

对于私有频道,成员身份不是问题。私有频道仅能从内部读取。即使 Claude 是成员,它也无法从任何其他频道或私信读取该频道。

解决方法

对于需要直接读取的公开频道,在该频道中使用 /invite @Claude 邀请它,然后在新线程中再次提问。

对于私有频道,在该频道本身中提问,如果 Claude 不是成员则先邀请它。邀请让 Claude 在私有频道内部工作,但不使该频道从其他地方可读。

52.5.3 Claude 说它不能访问某个工具或服务

你看到的现象

Claude 说它没有你期望它访问的服务的连接。

含义

频道可能未被授予该服务的连接;参见每个连接增加了什么

解决方法

请管理员为此频道添加连接并发送连接范围条目。添加后,通过名称要求 Claude 使用该服务,或开始新线程自动拾取连接。如果修复有效,在新线程中问 @Claude what can you access from this channel? 会列出该服务。

52.5.4 连接器在 claude.ai 上有效但在 Slack 中无效

你看到的现象

你在 claude.ai 上使用的连接器在 Slack 中使用 Claude 时缺失,或 Claude 说它没有该服务的访问权限。

含义

你向 Claude 发消息的位置决定了哪些连接器适用。频道仅使用管理员附加到它的连接,个人连接器在那里永远不适用。私信运行在你自己的 claude.ai 账户上并使用该账户的连接器。

你在 claude.ai 的 Customize > Connectors 下设置和认证连接器;Slack 没有自己的连接器设置。设置映射涵盖了每个设置界面。

解决方法

对于频道,请管理员添加连接

对于私信,按以下顺序排查:

  1. 检查你的 Claude 账户是否已连接。私信 @Claude,如果未连接它会提示你连接。
  2. 检查连接器在 claude.ai 的 Customize > Connectors 下是否显示为已连接。
  3. 对于 Team 或 Enterprise 计划上的自定义连接器,Owner 需先将其添加到组织才能连接;参见使用远程 MCP 的第三方连接器
  4. 在 claude.ai 上连接或重新连接连接器后,向 Claude 发送新的顶层私信。会话在启动时加载连接器,因此你现有的私信线程保持启动时的集合,不会拾取更改。

52.5.5 Claude 说它没有互联网访问或不能打开链接

你看到的现象

你粘贴 URL 或要求 Claude 阅读页面,它说网站不被允许、请求被阻止或它没有互联网访问。它可能通过网络搜索找到同一页面但仍然打不开链接。

含义

搜索和打开页面走不同路径。网络搜索在 Anthropic 的服务器上运行,无需设置,搜索会从匹配的页面中带回内容,因此 Claude 通常可以从搜索返回的内容中回答。打开 URL 从频道的沙箱(Claude 运行的隔离工作区)中发生,沙箱仅能到达你组织设置允许的网站;网络搜索设置对此没有影响。

解决方法

向管理员发送你尝试打开的链接以及被阻止主机条目。等待期间,要求 Claude 改为搜索页面;搜索通常带回足够的内容来回答。管理员允许该网站后,重试;如果仍被阻止,开始新线程。

52.5.6 Claude 无法通过 SSH 连接

你看到的现象

Claude 报告无法通过 SSH 到达主机,或数据库的原生协议超时。

含义

Claude 从频道发出的每个请求都通过 Agent Proxy,它仅承载 HTTP 和 HTTPS。非 HTTP 协议(如 SSH 或数据库的原生有线协议)无法通过代理到达任何主机,因此这不是管理员可以添加的连接。

解决方法

如果服务暴露了 HTTP API,请管理员改为添加连接

52.5.7 已达 Claude Tag 支出限额

你看到的现象

Claude 在线程中发布:

You’ve reached a Claude Tag spend limit. Org admins can raise it in claude.ai admin settings. Once the limit is raised, mention me to retry.

你可能还会在达到限额前看到预警。组织限额的消息以”Heads up — your organization has used N% of its monthly Claude Tag spend limit.”开头,频道限额的消息以”Heads up — this channel has used N% of its monthly Claude Tag spend limit.”开头。

含义

使用量达到了管理员设置的上限,可能是整个组织的或此频道的。速率限制看起来类似但是不同的问题,提高支出限额不能清除它。如果你的消息说”Hit the session rate limit — try again in a few seconds.”(或”in ~Ns”当 Claude 知道等待时间时),是太多会话同时启动。等待片刻再提及 Claude。

解决方法

请管理员提高限额;他们在 claude.ai/admin-settings/usage/claude-tag 操作。你的管理员是在 claude.ai 管理你组织 Claude 账户的人,不一定是你的 Slack 管理员。限额提高后,在同一线程中提及 Claude 重试。

52.6 私信不工作

私信运行在你自己的 Claude 账户上而非组织的 Agent。它们需要包含 Claude Code 的席位,并使用你的个人连接器而非频道连接。如果频道工作但私信不工作,首先检查你的 Claude 账户是否已连接;私信 @Claude,如果未连接它会提示你连接。

52.6.1 在私信中遇到环境错误

你看到的现象

Claude 在私信中回复:

I couldn’t find a Claude Code environment for your account. Set one up at claude.ai/code and try again.

含义

私信运行在你自己的 claude.ai 账户上而非组织设置,这就是为什么这出现在私信中而非频道中。通常是短暂的查找失败而非环境缺失。

解决方法

  1. 再次提及 Claude;重试通常清除问题。
  2. 如果持续出现,你账户设置为使用的环境可能不再可用;在 claude.ai/code 检查。

如果频道(非私信)显示提及环境的会话启动失败,向管理员发送环境范围条目

52.6.2 Claude 账户已连接但在此组织中没有访问权限

你看到的现象

Claude 在私信中回复:

Your Claude account is connected, but it doesn’t have access in this organization — usually this means your admin hasn’t assigned you a seat that includes Claude Code. Ask them to add one, then mention me to retry.

Claude 应用的 Messages 标签页和 Slack 的助手面板都算作私信,尽管两者看起来都不是,因此当你以为自己在使用频道时也可能出现此消息。

含义

你的席位类型不包含驱动私信的 Claude Code 引擎。在真正的频道中提及 @Claude 不依赖你的席位类型,继续工作。

解决方法

等待期间频道继续工作,如果你现在需要答案在那里提及 @Claude。然后请管理员(在 claude.ai 管理你组织 Claude 账户的人)关于你的席位分配;关于此消息的管理员条目涵盖修复方法。

52.6.3 Claude 管理员已禁用向 Claude 发送私信

你看到的现象

你私信 Claude 时它回复:

Your Claude admin has disabled sending direct messages to Claude.

含义

私信在组织范围内关闭。

解决方法

改为使用频道,或请管理员启用私信。

52.6.4 不支持群组私信

你看到的现象

Claude 在群组私信中回复:

Group DMs aren’t supported yet. Try a channel or a 1:1 DM instead.

含义

Claude 仅在频道和一对一私信中工作。

解决方法

改为创建一个有相同成员的私有频道。

52.7 相关资源