43 Claude Tag 设置故障排除
Claude Tag 设置中的错误消息及各自修复方法。涵盖权限不匹配、GitHub 访问缺口、会话启动失败和账号错误。
export const BetaNote = () => Claude Tag is in public beta. Features and behavior described here may change before general availability.;
本页涵盖你在设置和管理 Claude Tag 时可能遇到的错误：Slack 应用权限、访客和共享频道、控制台错误、无响应的频道和话题、访问和连接，以及会话启动。每个条目都有相同的三个部分：你看到什么、这意味着什么、以及如何解决。
对于人们可以在频道中自行解决的问题（如缺少回复或话题丢失工作），参见在频道和私信中排除 Claude Tag 故障。
如果有人报告 Claude 无法访问你连接的服务，在做任何其他检查之前先确认两件事：
- 该连接在附加到该频道作用域的包中。
- 测试在新话题中运行；已有话题不会被告知在其启动后添加的连接，但如果请求中指明服务名称，该连接在那里仍然有效。
43.1 Slack 应用权限
本节中的大多数错误出现在 Claude 需要 Slack 权限而你的工作区批准应用时未包含该权限的情况下。对于这些情况，修复方式是 Slack 工作区管理员从 Claude for Slack 重新批准 Claude 应用，这会授予当前权限集。其他内容不会改变，现有设置保留。
43.1.1 此工作区的 Claude 应用安装已过期
你看到的
Claude 回复 @Claude connect：
This workspace’s Claude app installation is out of date — it hasn’t granted the [permission name] permission(s). I can’t create a link code until a Slack admin reinstalls the Claude app or approves its updated permissions. Once that’s done, ask me to link again.
消息中有两个短语是链接：
- reinstalls the Claude app 打开重新安装流程。下文的修复从此链接开始。
- approves its updated permissions 打开 Slack 该工作区的 Manage apps 页面。
在 Enterprise Grid 上，消息会标注”this Slack organization’s Claude app installation”并要求 Slack 组织管理员重新安装组织级应用。组织级重新安装从 Grid 中某个工作区内部运行 Install to entire organization，步骤参见 Claude 在 Enterprise Grid 上完全静默。
有时回复仍会发出代码，但附带安装”已过期”的脚注。下文的重新安装步骤也会清除该脚注。
这意味着什么
Claude 需要 Slack 权限而你的工作区批准应用时未包含该权限，因此应用从未被授予它。Claude 在更新的权限集获得批准之前无法发出配对码。
如何解决
Slack 工作区管理员执行以下三个步骤：
- 点击回复中的 reinstalls the Claude app 链接，或打开 Claude for Slack 并点击 Add to Slack。不要先卸载；这在现有应用上安装，你的设置保留。
- 批准 Slack 显示的同意屏幕；它列出了每个要添加的权限。如果 Slack 显示 Unapproved permissions requested 而非完成，参见请求的未批准权限。
- 再次运行
@Claude connect。如果重新安装成功，回复包含配对码（即原始消息说无法创建的链接码），而非此消息。
将该配对码发送给在控制台中运行 Claude 设置的人；代码 15 分钟后过期。Slack 的 Manage apps 页面列出的是应用请求的权限，而非你的工作区已授予的权限，因此在那里看到缺少的权限被列出并不代表它已被批准。授予发生在同意屏幕上。有关应用权限的一站式参考，参见 Claude Slack 应用可以访问什么。
43.1.2 请求的未批准权限
你看到的
Unapproved permissions requested 是来自 Slack 的消息，不是 Claude 的回复。它出现在以下两个位置之一：
- Add to Slack 后的同意屏幕上，包括之前批准过应用的工作区管理员
- Slack 中 Settings & administration → Manage apps → App requests 下 Claude 条目的待处理状态，适用于要求管理员审批应用的工作区
这意味着什么
Claude 应用请求的权限在你的工作区批准后发生了变化，Slack 要求对新增权限进行重新批准。同意屏幕列出每个要添加的权限，你可以在批准前确切审查将要授予什么；批准仅适用于已安装在你工作区中的 Claude 应用。
如何解决
Slack 工作区管理员在任一位置批准 Claude 应用的更新权限：
- 在 Slack 中，前往 Settings & administration → Manage apps → App requests 并批准 Claude 请求。
- 或打开 Claude for Slack，点击 Add to Slack，并批准同意屏幕。
两种路径授予相同的权限，都不需要先卸载。
如果批准成功，@Claude connect 返回配对码，不再提及安装问题。
43.1.3 仅 Slack 工作区管理员或 Grid 组织管理员可以关联此工作区
你看到的
Claude 回复 @Claude connect：
Only Slack workspace admins (or Enterprise Grid org admins) can link this workspace to a Claude organization. Please ask a workspace admin to mention me with
@Claude connect.
这意味着什么
Slack 报告运行 @Claude connect 的人不具备工作区管理员角色，因此未发出配对码。此回复本身就是信号，没有其他需要检查的。Claude Owner 角色不满足此检查；起作用的是 Slack 侧的角色。
如何解决
让 Slack 工作区管理员替代运行 @Claude connect。在 Enterprise Grid 上，Grid 组织管理员也可以。如果修复成功，他们的回复包含配对码。
43.1.4 缺少必需的 Slack 权限（users:read）
你看到的
Claude 在频道中回复：
Claude can’t check this channel for guests because it’s missing the required Slack permission (users:read). A workspace admin needs to reinstall Claude to grant it.
如果失败发生在 Claude 发布消息而非回复时，没有固定消息；Claude 用自己的话描述问题，底层错误信息为 “message not delivered: Claude can’t check this channel for guests because the Slack app is missing a permission (users:read); a workspace admin must reinstall Claude to grant it.”
这意味着什么
此频道作用域的 Allow Claude to respond to guests 设为 Restrict，因此 Claude 在回复前检查频道中是否有访客，而此安装早于该检查所需的 users:read 权限。
如何解决
从 Claude for Slack 重新批准应用。不要先卸载；重新批准在现有应用上安装。如果修复成功，在受影响频道中提及 Claude 会获得回复而非权限消息。
43.1.5 审计日志显示 Claude 加入无人邀请的频道
你看到的
Slack 审计日志显示 Claude 加入某频道，没有记录邀请人，工作区中没人记得添加过它。
这意味着什么
某位成员在 Claude 私信中建议的频道上选择了 Add to channel。Claude 的欢迎消息（成员首次与 Claude 开启私信时发布的介绍）会建议几个公开频道，每个都带 Add to channel 按钮。选择其中一个会指示 Claude 自行加入该频道。
Claude 使用自己的 channels:join 权限执行此加入操作，因此 Slack 审计日志将加入记录为 Claude 应用，不显示邀请人；成员的选择在 Slack 日志中不可见。Claude 不会自行加入频道。Claude Slack 应用可以访问什么涵盖了成员如何添加它。
如何解决
没有任何配置错误，也没有设置变化。如果 Claude 不应该在该频道中，用 /remove @Claude 移除它，或将作用域的 Claude Tag 版本设为 Off，这样即使被再次添加它也不在那里响应。如果你希望审计日志中的每次加入都归属到某个人，要求成员用 /invite @Claude 而非按钮添加 Claude；Slack 将邀请记录为邀请成员的操作。
43.2 访客和共享频道
Claude 在回复前会检查频道中是否有访客以及是否跨工作区共享。这些检查发布的消息看起来相似，但大多数是拒绝，一个是 Claude 继续回复前的通知。在更改任何内容之前匹配确切的消息文本；每条消息有不同的原因和不同的修复方式。
在 Enterprise Grid 组织级别而非单个工作区内创建的频道，即使只出现在一个工作区的侧边栏中，也算作跨工作区共享，因此一个频道尽管看起来像普通的单工作区频道，也可能触发下方的共享频道消息。
43.2.1 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.
消息中”here”是指向下方访客设置的链接。它标注的角色是 claude.ai 组织 Owner，不是 Slack 管理员。
这意味着什么
频道包含至少一个 Slack 访客账号，且此频道作用域的 Allow Claude to respond to guests 设为 Restrict。Restrict 是默认值。
如何解决
任一方式均可：
- 从频道中移除访客，或将对话移到没有访客的频道；这不更改设置，因此不影响其他频道。
- 或将覆盖此频道作用域的 Allow Claude to respond to guests 设为 Allow。设置在
claude.ai/admin-settings/claude-tag的 Slack 标签 Claude Tag’s access 下，在作用域折叠的 Advanced 部分中。Allow 适用于该作用域覆盖的每个访客频道，访客在那里可以看到 Claude 的回复并与它互动。要仅限一个频道，在该频道自己的作用域上设置。参见限制访客频道了解完整的暴露情况。
Allow 恢复的是回复，不是工作区搜索。Claude 无法从包含访客的频道搜索工作区，即使设置为 Allow。移除访客才能同时恢复搜索。
如果修复成功，在频道中提及 Claude 会获得回复。
43.2.2 暂时无法检查此频道
你看到的
Claude 在频道中回复：
Couldn’t check this channel just now. Please try again in a moment.
这意味着什么
Claude 无法完成此频道的访客检查；可能是访客策略查询或 Slack 成员检查短暂失败，因此 Claude 拒绝了此次回复而非冒险在有访客可能看到的地方发布。这不是配置错误。
如何解决
- 再次提及 Claude；重试通常会清除问题。
- 如果某个频道反复出现此问题，成员检查可能因频道特别大而失败。在该频道作用域上将 Allow Claude to respond to guests 设为 Allow 可移除该作用域覆盖的每个频道的访客检查，通常能阻止消息再次出现；请先权衡 Allow 暴露了什么。
43.2.3 此频道跨多个工作区共享
你看到的
Claude 在频道中回复：
This channel is shared across multiple workspaces, and Claude can’t verify whether it includes guests, so Claude can’t respond here.
相同的检查也会拒绝来自其他对话的请求（例如要求 Claude 在该频道中发布消息），消息结尾为 “shared across multiple workspaces and Claude can’t verify whether it includes guests”。
这意味着什么
此消息来自访客检查，不是工作区共享。此频道作用域的 Allow Claude to respond to guests 设为 Restrict，且频道的成员无法验证，最常见的原因是频道在 Enterprise Grid 组织内共享，因此 Claude 拒绝。
如何解决
使用属于单个工作区的频道。将作用域的访客设置设为 Allow 可移除发布此消息的访客检查，但 Grid 共享频道仍然不像单工作区频道那样工作。当其工作区连接到不同的 Claude 组织时，Claude 改为发布 此频道在多个 Claude 工作区之间共享中的拒绝消息。当它们都属于你的一个 Claude 组织时，Claude 仅使用组织默认访问和设置回复，参见此频道跨多个 Slack 工作区共享。
43.2.4 此频道在多个 Claude 工作区之间共享
你看到的
Claude 在频道中回复：
This channel is shared among several Claude workspaces, so Claude cannot respond here.
此回复仅在有人直接提及 Claude 或在它已加入的话题中称呼它时出现。频道中的其他消息完全不会获得回复。
这意味着什么
频道在你的 Enterprise Grid 中的多个 Slack 工作区之间共享，而这些工作区配对到了不同的 Claude 组织。没有任何单个组织的设置覆盖该频道，因此无论访客策略或任何作用域设置如何，Claude 都拒绝。当 Claude 无法确认这些工作区共享一个 Claude 组织时也会拒绝。
两条相似的消息来自不同的情况。此频道跨多个工作区共享是访客情况，此频道跨多个 Slack 工作区共享是每个工作区都属于你的一个 Claude 组织的情况，此时 Claude 会回复。
如何解决
将对话移到属于单个工作区的频道，或私信中。
43.2.5 此频道跨多个 Slack 工作区共享
你看到的
Claude 在话题中发布通知，然后回答请求：
This channel is shared across several Slack workspaces, so Claude is using only your organization’s default Slack access and settings here — not any workspace- or channel-specific repos, instructions, or memory you’ve configured.
这意味着什么
频道跨多个 Slack 工作区共享，且每个工作区都属于你的 Claude 组织。Claude 在那里工作，但仅使用 Default Slack access 作用域上的访问和设置。附加到工作区或此频道的包、指令和记忆不适用。
通知每个频道最多约每月发布一次，因此此频道中的回复即使没有通知也运行在相同的默认设置下。
如何解决
没有任何故障。要使用频道自己的仓库、连接或指令，在属于单个工作区的频道中工作，或将频道所需的内容添加到 Default Slack access 作用域。在单工作区频道中，请求使用该频道自己的配置，通知不会出现。
43.2.6 Claude 在 Enterprise Grid 中跨工作区共享的频道不可用
你看到的
你要求 Claude 做涉及 Enterprise Grid 中跨工作区共享频道的事情，拒绝消息指明它拒绝的请求并以以下结尾：
Claude isn’t available in channels shared across your Enterprise Grid
这意味着什么
请求需要 Claude 在 Enterprise Grid 中跨多个工作区共享的频道中操作。消息出现在你发出请求的对话中；上方的条目涵盖了 Claude 在共享频道本身中发布的回复。
此拒绝涵盖两种共享情况。即使共享频道的工作区都属于你的一个 Claude 组织且 Claude 在那里回答直接提及，Claude 仍然拒绝从其他对话发出的请求。
如何解决
将请求指向属于单个工作区的频道，或将对话移到那里。
43.2.7 此频道现在跨多个工作区共享
你看到的
Claude 在话题中发布：
This channel is now shared across multiple workspaces, so this thread’s earlier session can’t continue here. Please @-mention me in a new thread.
这意味着什么
频道在此话题会话启动后变为共享，因此会话仍绑定到一个工作区的配置，无法在现在看到该频道的每个工作区面前继续。
如何解决
在新话题中提及 Claude；新话题在频道当前的共享状态下启动。
43.3 控制台错误
43.3.1 无法加载 Slack 作用域
你看到的
claude.ai/admin-settings/claude-tag 的 Slack 标签 Claude Tag’s access 下的横幅显示：
Couldn’t load Slack scopes. Reload the page to try again.
这意味着什么
从 Claude 后端加载作用域列表的请求失败；这不是 Slack 权限问题，你的配置完好。页面显示错误而非空列表，这样加载失败不会看起来像未配置的工作区。
如何解决
- 刷新页面。如果刷新成功，作用域列表正常渲染。这是通常的结果。
- 如果横幅在多次刷新后仍然存在，检查
status.anthropic.com是否有活跃事件，几分钟后重试。 - 如果在没有发布事件的情况下持续存在，联系 Anthropic 支持并提供发生时间。
43.3.2 页面显示你的套餐为 Free
你看到的
你打开管理控制台期望看到组织设置，却进入了个人账号设置页面，显示 Free plan，任何地方都没有 Claude Tag 部分。
这意味着什么
你登录了个人 claude.ai 账号，它是一个独立于你组织的工作区。claude.ai 将个人账号引导到其自己的设置页面而非管理控制台，因此你看到的 Free 是你个人账号的套餐，不是管理页面出了问题。
如何解决
使用 claude.ai 中的工作区切换器切换到你的组织，然后重新打开 claude.ai/admin-settings/claude-tag。如果切换成功，页面显示你组织的套餐和 Claude Tag 设置。
43.4 无响应
本节中的大多数静默问题横跨整个工作区或频道，归结为配置问题。当单个话题安静而 Claude 在其他地方正常回复时，原因是卡住的会话而非设置；参见 Claude 在一个话题中静默但在其他地方正常回复。
43.4.1 Claude 在一个话题中静默但在其他地方正常回复
你看到的
在一个话题中，请求下方出现了 “is thinking…” 行但没有后续回复，而 Claude 在其他频道和话题中正常回复。
这意味着什么
该话题背后的会话卡住了：它既没有回复也没有发布错误。因为 Claude 在其他地方正常回复，问题局限于那一个会话，下方条目中的配置修复均不适用。
如何解决
让话题中的人发送 @Claude !restart。该命令归档卡住的会话并启动一个重新读取话题的新会话，因此在同一话题中发送后续消息即可获得回复。开启新话题并重述请求也可以。
重启会放弃会话正在进行的工作，无法恢复。静默的会话可能仍在处理长任务，因此将 !restart 视为最后手段。
如果相同请求在新鲜会话上再次停滞，从该话题发送反馈，以便 Anthropic 调查。
43.4.2 Claude 在 Enterprise Grid 上完全静默
你看到的
在整个 Grid 的每个频道和私信中，提及 Claude 无反应也无回复，且 Claude 侧没有任何更改。
这意味着什么
在 Enterprise Grid 上，Claude 应用的组织级授权可以在 Slack 侧被撤销而 Claude 侧没有任何变化。当发生时，Claude 完全收不到提及。
如何解决
在现有应用上重新安装。不要先卸载；在上方安装是保留现有设置的方式。
- 作为 Slack 组织 Owner 或组织管理员，登录到 Grid 中的某个工作区，而非组织级管理页面。安装选项只从工作区内部出现。
- 打开 Claude for Slack，选择 Add to Slack，并选择 Install to entire organization。
- 在任意位置提及
@Claude。如果重新安装成功，提及会获得反应和回复。配对在重新安装后保留，因此正常回复意味着你已完成。回复说工作区未设置意味着配对需要重做；参见此工作区尚未为 Claude Tag 设置。
43.4.3 此工作区尚未为 Claude Tag 设置
你看到的
Claude 回复提及：
This workspace isn’t set up for Claude Tag yet. A workspace admin can run
@Claude connect, or set it up here.
结尾有脚注将寻找早期 Claude in Slack的人引导到该产品自己的设置指南。回复因发送者而异：非 Slack 工作区管理员的发送者被告知请其 Claude 工作区 Owner 运行 @Claude connect，没有设置链接。
这意味着什么
Slack 工作区尚未与 Claude 组织配对。
如何解决
运行配对流程。如果修复成功，在工作区中提及 Claude 会获得回复。
43.4.4 Claude Tag 已为你的组织关闭
你看到的
Claude 回复提及：
Claude Tag has been turned off for your Claude organization (the one this Slack workspace is connected to). A Claude admin for that organization can turn it back on in Claude admin settings.
相同的回复出现在每个界面：频道提及、私信和 @Claude connect。在私信中，括号内文字改为你已连接的 claude.ai 账号所属的组织，因为那是设置检查失败的组织。
这意味着什么
管理设置中的 Enable Claude Tag for your organization 开关关闭，或你的组织未启用 Claude Tag。起作用的开关是回复括号内指向的 Claude 组织中的那个。
如何解决
- Owner 在
claude.ai/admin-settings/claude-tag打开开关。如果开关是问题所在，Slack 中的提及现在获得正常回复。 - 如果消息持续，检查工作区配对到了哪个 Claude 组织。如果你的公司有多个（例如试用组织和主要组织并存），错误组织中的 Owner 可以撤销配对，以便你将工作区配对到正确的组织。
- 如果正确的组织开关已开且消息持续，联系你的客户团队确认 Claude Tag 是否已为其启用。
43.4.5 Claude Tag 不可用，因为未启用 Routines
你看到的
Claude 回复提及或私信：
Claude Tag is unavailable because Routines aren’t enabled for your organization. Admins can manage Routines at claude.ai → Admin settings → Claude Code.
消息中”claude.ai → Admin settings → Claude Code”是指向该设置页面的链接。当 Claude 无法在当下检查设置时，回复改为 “Couldn’t verify your organization’s settings right now. Please try again in a moment.”
这意味着什么
你的组织未启用 Routines，Claude Tag 需要它。任何在频道中提及 Claude 或私信它的人都会收到此回复，Claude 不做任何工作。“Couldn’t verify” 回复意味着检查无法完成，而非 Routines 已关闭。
如何解决
管理员在管理设置的 Claude Code 页面启用 Routines，地址为 claude.ai/admin-settings/claude-code。为组织启用 Routines 后，再次提及 Claude；正常回复意味着设置已生效。对于 “Couldn’t verify” 回复，稍等片刻后再次提及 Claude。
43.4.6 受限合规设置阻止 Claude Tag
你看到的
Claude 回复频道中的提及：
Claude isn’t available for organizations with restricted compliance settings.
在与 Claude 的私信中、Claude 应用的 Home 标签上以及 Slack 的助手面板中，消息改为：
Claude in Slack is not available for your organization
在私信和助手面板中，该消息仅对你可见，不保留在对话中，而 Home 标签继续显示它。
同一组织中的其他 Claude Tag 操作返回类似消息，以 “not available for organizations with restricted compliance settings” 结尾。
这意味着什么
你的 Claude 组织有受限合规配置，如 Zero Data Retention (ZDR)。Claude Tag 保留频道记忆和会话记录，因此在合规配置下不可用；参见 Claude Tag 保留什么。
如何解决
没有设置可以解除此限制；Claude Tag 对这些组织不可用。联系你的客户团队了解组织合规配置的问题。
43.4.7 Claude 在此频道中已禁用
你看到的
Claude 在频道中回复：
Claude is disabled in this channel. Your admin can re-enable it here.
仅第一句是固定的。非 Slack 工作区管理员的发送者被告知请其 Claude 工作区 Owner 重新启用，没有设置链接。
这意味着什么
此频道作用域的 Claude Tag version 设为 Off。
如何解决
Owner 在 claude.ai/admin-settings/claude-tag 的 Slack 标签 Claude Tag’s access 下更改作用域的版本设置。如果修复成功，在频道中提及 Claude 会获得回复。
43.5 访问和连接
访问和连接错误通常意味着 Claude 已响应但无法访问连接的服务、仓库或发送者席位不包含的能力。作用域留在 Legacy 上只是看起来像访问问题；在那里，早期 Claude in Slack 而非 Claude Tag 回答，因此包和连接永远不适用。
43.5.1 Claude 说主机不被允许或无法访问互联网
你看到的
频道中的 Claude 说某主机不被允许、网络请求被阻止，或无法获取页面，尽管请求是普通 HTTP。
这意味着什么
频道会话的出站网络访问默认为拒绝。当包的连接或 Domains 列表允许某主机时，或当作用域会话运行的环境的网络访问设置允许时，该主机可达；其他一切被阻止。网络搜索是分开的，无论如何都能工作，因此 Claude 可以从搜索中回答而无法获取同一页面；在 claude.ai 管理设置中启用网络搜索不会为频道打开网络访问。参见网络搜索与网络请求。
如何解决
- 对于特定主机，将它们添加到包的 Domains 列表；如果频道的作用域没有附加包，先附加一个。需要凭据的服务应放在连接中。
- 对于广泛访问，在作用域上固定一个网络访问级别为 Full access 的组织范围环境；参见下方的环境条目。
在新话题中测试。如果修复成功，之前失败的获取在新话题中成功。
43.5.2 连接在一个频道中工作但在另一个中不工作
你看到的
Claude 在一个频道中顺利使用连接的服务，在另一个频道中说它没有该服务的访问。
这意味着什么
包按作用域附加。工作的频道作用域有包；失败的可能没有。
如何解决
将包附加到失败频道的作用域，或将工作移到覆盖作用域下的频道。在新话题中测试，或在已有话题中要求 Claude 按名称使用该服务。如果修复成功，在新话题中问 @Claude what can you access from this channel? 会列出该服务。
43.5.3 GitHub 在此频道中不工作
你看到的
在频道中，Claude 说它没有 GitHub 访问、找不到仓库，或以请求者名义而非自己的名义开 Pull Request。
这意味着什么
最可能的原因是频道的作用域仍将 Claude Tag version 设为 Legacy，因此早期 Claude in Slack 而非 Claude Tag 回答。其他原因是缺少包附加、过期话题、未授予的仓库，或 GitHub App 安装未覆盖的仓库。
如何解决
按顺序检查以下各项；GitHub 在频道中工作过然后停止时也适用相同的检查和顺序。
- 哪个版本回答频道：如果
@Claude以请求者名义开 Pull Request，频道在 Legacy 上，包仅在 Claude Tag 回答处适用。按从早期 Claude in Slack 迁移切换作用域的 Claude Tag version 设置。Pull Request 以 Claude GitHub App 名义打开时说明版本正确。 - 此频道作用域上有 GitHub 访问的包：包按作用域附加，因此携带 GitHub 访问的包必须附加到覆盖此频道的作用域；将包附加到作用域涵盖附加和继承。如果包已附加，在新话题中问
@Claude what can you access from this channel?会列出 GitHub。 - 新话题：新话题会拾取每个配置更改，因此先在新话题中测试再检查其他。
- 包中已授予的仓库：仓库必须列在包的 Repositories 标签中，参见授予仓库访问。如果仓库已授予，在新话题中要求 Claude 从中读取文件即可工作。授予使仓库可被克隆，但代码在请求指明它之前不进入会话。
- GitHub App 安装覆盖该仓库：如果 Claude 报告某仓库不可用、未配置或返回 403，检查安装，因为应用的仓库选择在包授予的上游。在
claude.ai/admin-settings/github，拥有该仓库的组织应在 Connected GitHub accounts 下显示 Connected。如果它出现在 Unlinked accounts 下且状态为 Needs permissions，则安装正在等待 GitHub 组织 Owner。点击 Review permissions 在 github.com 上批准。如果你不是 GitHub 组织 Owner，使用该设置页面上的 Not a GitHub account owner? 下的 Copy message 将请求发送给是的人。如果组织完全未列出，用 Install on another organization 安装应用；关联你的 GitHub 组织涵盖两种情况。
对于 GitHub Enterprise Server 仓库，确认 GHE 主机已注册。github.com App 安装不覆盖它们。
43.5.4 遇到认证错误，无法完成本轮
你看到的
Claude 在话题中发布：
I hit an authentication error and couldn’t finish this turn. This can be temporary (for example a GitHub rate limit) — mention me to retry in a few minutes. If it keeps happening, this session may lack access to a repository it needs, or its credentials or integration may need to be reconnected.
这意味着什么
Claude 自身的请求在轮次中途未通过认证检查，因此它停止了，保留了已完成的工作。原因通常是暂时的，如 GitHub 对会话请求的速率限制，几分钟后重试即可清除。当消息重复时，会话可能无法访问它需要的仓库。
此消息不是指向你连接的服务。当连接服务的凭据失败时，Claude 在回复内部将其报告为工具错误，而非用此通知。私信发送者席位不包含 Claude Code 时，获得的是 你的 Claude 账号已连接，但在此组织中没有访问权限。
如何解决
让请求者几分钟后在同一话题中提及 Claude；会话从停止处继续。如果消息在每次重试时都重复，按 GitHub 在此频道中不工作中的步骤检查该频道的仓库访问，然后开启新话题。如果访问检查没问题但消息仍反复出现，联系 Anthropic 支持并提供频道和发生时间。
43.5.5 你的 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.ai 账号上运行，需要包含 Claude Code 的席位；此用户的席位不包含它。在频道中提及 @Claude 不依赖于发送者的席位。
如何解决
在 claude.ai/admin-settings/members 的 Members 页面上为用户分配包含 Claude Code 的席位，然后让他们在同一私信话题中提及 Claude。如果修复成功，私信获得回复而非此消息。
43.6 会话启动错误
会话启动错误在任何工作开始之前出现。有些是暂时的，重试即可清除；其余指向容量或环境配置而非凭据。
43.6.1 仍在等待可用容量
你看到的
Claude 在话题中发布：
Still waiting for available capacity — your request is queued and will start automatically. Replies in this thread are picked up automatically.
这意味着什么
计算容量暂时繁忙。容量释放后会话自动启动。
如何解决
等待；无需操作。用户应在同一话题中回复如果有更多要补充的内容，因为开启新话题只会在第一个后面排队第二个会话。
43.6.2 会话启动失败：会话容器从未连接
你看到的
Claude 在话题中发布：
Session failed to start: the session container never connected — please try again
这意味着什么
会话的计算容器未及时启动。这是暂时的。
如何解决
在同一话题中提及 Claude 重试。如果重试成功，会话启动，Claude 开始任务。
43.6.3 启动会话时出错
你看到的
Claude 在话题中发布：
Something went wrong starting a session. Try again in a moment.
当 Claude 能说出原因时，它改为发布以下之一：
| 消息 | 原因 |
|---|---|
| “Hit the session rate limit — try again in a few seconds.”（或 Claude 知道等待时间时为 “in ~Ns”） | 一次启动了太多会话；等待，然后再次提及 Claude |
| 指明某特定仓库不可用或未配置的消息 | 该仓库未为此频道授予；参见 GitHub 在此频道中不工作 |
| “That environment or repo isn’t configured for Claude Code. Check claude.ai/code and try again.” | 作用域固定的环境未设置；参见频道会话使用错误的 environment |
| “Claude Code Remote is temporarily degraded. Try again shortly.” | 运行会话的服务暂时不可用；重试 |
| “You don’t have permission to start a session here.” | 权限检查拒绝启动会话；当 Claude 知道哪个检查失败时，消息会指明 |
这意味着什么
这是不映射到更具体消息的会话启动失败的通用类别，因此原因各异。通常是暂时的。
如何解决
在更改任何配置之前，在同一话题中再次提及 Claude；重试通常会清除它。如果出现了上表中的特定消息，按其对应行操作。
43.6.4 频道会话使用了错误的 environment，或找不到 environment
你看到的
频道中的会话在你未预期的 environment 上启动，或会话启动失败并显示上表中的 environment 消息。
这意味着什么
claude.ai/admin-settings/claude-tag 的 Slack 标签 Claude Tag’s access 下，每个作用域都有一个 Environment 选择器（在作用域的 Advanced 部分中），用于固定该作用域中会话使用的 Claude Code environment 或 runner pool。没有固定时，会话使用 Organization default。选择器只列出组织范围的 environment；在个人账号下创建的 environment 不会出现，因为频道会话运行时不附加用户账号。
如何解决
如果你想要的 environment 不在选择器中，从 管理设置 的 Cloud environments 页面将其创建为组织共享 environment，然后在作用域上固定它。不要在 claude.ai/code 创建：在那里创建的 environment 属于你的个人账号，永远不会出现在选择器中。如果修复成功，新话题的会话在固定的 environment 上运行。参见environment 的术语表条目。