GitHub 组织的所有者有时会收到一封标题为“[GitHub] Claude is requesting updated permissions”的英文邮件。这是组织中安装的 Anthropic 的 GitHub App“Claude”增加所请求的权限时,由 GitHub 自动发送的通知。即使不批准,Claude 也会以现有权限继续运行,但需要新权限的功能可能无法使用。
要点
- 邮件是什么
- GitHub App 的开发者增加权限时,GitHub 发给每个安装了该 App 的组织所有者的通知。Claude 并没有擅自获得权限,在你批准之前,新权限不会生效。
- 不批准时
- Claude 以现有权限继续运行。使用新权限的功能可能无法按预期工作。批准时不能只选一部分权限,而是一次性接受所请求的全部权限。
- 判断标准
- 如果在使用 Code Review、Claude Tag、插件自动同步、云端会话等在 Anthropic 服务端运行的功能,多半需要批准。如果只在自己的工作流中使用 Claude Code GitHub Actions,就没有太多理由着急,也可以改用权限更小的自建 App。
2026年11月14日对照 GitHub 文档和 Claude Code 文档确认
1. 确认是否真实
不点邮件中的链接,从 GitHub 组织的设置中自行打开 Claude 的页面
2. 看增加了什么
查看页面上列出的新增权限,以及每项权限能做什么(第5节的表格)
3. 按功能决定
所用的 Claude 功能需要就批准,不需要也可以暂时搁置(第6节)
1. “Claude is requesting updated permissions”邮件是什么
收到的邮件是下面这样的(组织名称和编号因组织而异)。
主题[GitHub] Claude is requesting updated permissions
The GitHub App Claude, which is currently installed on your your-org organization, has updated its permissions and is requesting additional access.(安装在你的组织中的 GitHub App Claude 更新了权限,正在请求额外的访问权限。)
You may choose to ignore this request. If you do, Claude will retain its current permissions.(可以忽略此请求。这样的话,Claude 会保留现有权限。)
批准页面:github.com/organizations/your-org/settings/installations/ID/permissions/update
摘自2026年11月14日收到的邮件正文,并附上译文。
根据 GitHub 的文档,GitHub App 的开发者增加仓库或组织的权限时,GitHub 会向安装了该 App 的每个组织的所有者(个人账户则为账户本人)发送邮件。更新后的权限在获得批准之前不会在该组织中生效,App 会继续以现有权限运行。相反,减少权限的变更会立即生效。
也就是说,这封邮件是在询问:Anthropic 修改了 Claude App 的权限列表,你的组织是否也接受新的列表?它并不是在通知 Claude 擅自获得了权限。
Anthropic 也在 Claude Code 文档中说明,这个 App 的权限列表可能会先于使用这些权限的功能发生变化;App 请求新权限时,GitHub 会请组织所有者批准,在批准之前保持原有权限。Claude 的帮助文章(Manage plugins for your organization)还说明,插件自动同步需要为 Claude App 批准 Webhooks(读写),在添加此权限之前就已安装的组织会在 GitHub 上看到“Claude is requesting updated permissions”。不过,截至2026年11月14日,我们没有找到按日期列出哪天增加了哪些权限的变更记录。
2. 如何判断邮件是否真实
请求批准权限的邮件,也很容易被用作引导到虚假登录页面的钓鱼诈骗。与其相信邮件本身,更可靠的方法是确认不通过邮件能否到达同一个页面。
- 发件人
真实的邮件来自 GitHub 的
noreply@github.com。但显示的发件人可以伪造,所以仅凭这一点不能断定是真的。 - 链接目标
批准页面位于
github.com/organizations/…/settings/installations/…。把鼠标悬停在链接上,如果域名不是github.com,就不要打开。 - 自行打开
在 GitHub 上打开组织的 Settings,在左侧 Third-party Access 下选择 GitHub Apps,点击 Claude 旁边的 Configure。这样不用邮件中的链接,也能进入同一个 App 的设置。
- App 开发者
Anthropic 的 App 名称为 Claude,开发者(Developer)为 anthropics(github.com/apps/claude)。开发者不同、或只是名称相似的 App,不要批准。
- 要求输入密码
如果在打开批准页面的途中被要求输入密码或两步验证码,先确认地址栏是
github.com再输入。
设置页面的进入路径参考 Reviewing and modifying installed GitHub Apps(GitHub Docs,2026年11月14日确认)。
3. 不批准会怎样,以及为什么不能只批准一部分
批准
- 所请求的权限全部在该组织中生效
- 使用新权限的 Claude 功能可以运行
- 不能只选择其中一部分权限
不批准(放着不管)
- Claude 以现有权限继续运行
- 需要新权限的功能可能无法按预期工作
- 请求一直处于待处理状态
GitHub 的文档两点都写明了:不批准时 App 会保留现有权限,同时可能无法按预期工作(Approving updated permissions for a GitHub App)。邮件中说可以忽略,意思是不会马上出问题。但要记住,以后想用新功能时,这可能就是它无法运行的原因。
批准是全部接受的方式。Claude Code 文档写道,安装 App 时要接受整个权限列表,GitHub 不允许只批准一部分。在 GitHub 社区,也有用户反映一次更新同时包含了 Members 和 Webhooks、批准按钮只有一个,并且没有拒绝按钮,只能让请求保持待处理(GitHub Community 的讨论,用户的反馈)。
4. 哪些 Claude 功能使用哪些权限
Anthropic 安装到 GitHub 的 App 通常只有“Claude”这一个。根据 Claude Code 文档,这个 App 由所有连接 GitHub 的 Claude 功能共用,而一个 App 只能有一组权限,所以即使组织只用其中一个功能,权限列表中也会包含其他功能所需的权限。
| Claude 的功能 | GitHub App | 主要使用的权限(据 Anthropic 文档) |
|---|---|---|
Claude Code GitHub Actions响应 @claude、/install-github-app | Claude(也可以用自建 App) | Contents、Issues、Pull requests 的读写 |
| Code Review拉取请求的自动审查(Team、Enterprise) | Claude | 为发布结果 check run 所需的 Checks 写入等 |
| 云端会话的自动修复根据 CI 结果修复拉取请求 | Claude | 读取 CI 状态的 Actions、Commit statuses 等 |
| Claude Tag从 Slack 委托的工作所生成的拉取请求 | Claude | 工作流的重新运行与取消、触发 workflow_dispatch、删除运行记录、日志和制品、启用与停用工作流(Actions),编辑 .github/workflows/(Workflows)等 |
| 组织插件的自动同步向插件市场仓库 push 时同步 | Claude | 在仓库中创建 webhook 所需的 Repository hooks 写入 |
| claude.ai 的 GitHub 集成把仓库导入聊天和项目 | Claude | 读取私有仓库的访问权限 |
| GitHub Enterprise Server自行托管的 GitHub | 在自己服务器上创建的另一个 App | 与 github.com 上的 Claude 无关。权限在自己 App 的设置中添加 |
来源:Claude Code GitHub Actions(GitHub App permissions 一节)、Code Review、Claude Code with GitHub Enterprise Server、Claude Tag 的 Configure GitHub access、Sync your organization's plugins from a repository、GitHub integration(均于2026年11月14日确认)。
云端会话本身的机制见 Claude Code 的云端会话是什么,从 Slack 使用的 Claude Tag 见 Claude Tag 是什么,用本地命令进行的审查与 App 版 Code Review 的区别见 Claude Code 的 /code-review 是什么。
5. 如何阅读权限列表:每项允许什么、哪些权限强
Claude Code 文档中列出了 github.com 上 Claude App 拥有的权限(2026年11月14日确认)。下面结合 GitHub 对各权限的说明,列出每项权限在 GitHub 上允许做什么。强弱的标准是本文自行划分的三档:“影响范围大的写入”“写入”“读取”。
| 权限 | 访问 | 在 GitHub 上允许的操作 | Anthropic 文档中的用途 |
|---|---|---|---|
| Contents | 读写 | 读写文件、分支和提交 | 克隆仓库和 push 分支 |
| Workflows | 读写 | 修改 .github/workflows/ 中的文件 | Claude Tag 修复工作流文件的拉取请求 |
| Actions | 读写 | 查看工作流的运行记录、日志和制品,重新运行等 | 读取 CI 结果。在 Claude Tag 中还可以重新运行与取消、触发 workflow_dispatch、删除运行记录、日志和制品、启用与停用工作流 |
| Repository creation | 读写 | 在组织中创建仓库、fork 仓库。App 自动获得其创建的仓库的访问权限 | 未找到用途说明 |
| Repository hooks界面上显示为 Webhooks | 读写 | 创建和修改仓库的 webhook | 插件市场的自动同步 |
| Pull requests | 读写 | 创建拉取请求并发表评论 | 创建拉取请求和发布审查评论 |
| Issues | 读写 | 创建 Issue 并发表评论 | 在 Issue 中被提及时回复 |
| Checks | 读写 | 创建和更新 check run | Code Review 结果的 check run |
| Discussions | 读写 | 读写 Discussions | 为今后的功能准备(GitHub Actions 的安全文档) |
| Administration | 读取 | 查看仓库设置(写入权限则可以更改设置或删除仓库) | 未找到用途说明 |
| Members组织权限 | 读取 | 查看组织的成员和团队 | 设置时确认连接者在组织中的角色 |
| StatusesCommit statuses | 读取 | 查看提交状态(CI 是否通过) | 读取以 status 而非 check run 返回结果的 CI |
| Dependabot alerts | 读取 | 查看 Dependabot 警报 | 未找到用途说明 |
| Merge queues | 读取 | 查看合并队列 | 未找到用途说明 |
| Metadata | 读取 | 仓库的基本信息 | GitHub 要求所有 App 都具备 |
权限和访问级别来自 Claude Code GitHub Actions 中的列表。在 GitHub 上允许的操作摘要自 Permissions required for GitHub Apps 和 Choosing permissions for a GitHub App。用途来自上一节的来源和 Manage plugins for your organization,只有 Discussions 的用途来自 claude-code-action 的 security.md(均于2026年11月14日确认)。“未找到用途说明”的意思是我们查阅的 Anthropic 文档中没有提到。
阅读列表时有三个要点。第一,同名的权限从“读取”变成“读写”后,分量会大不相同。Anthropic 举的例子是 Actions:从读取变成写入后,App 不仅能查看工作流的运行结果,还能重新运行。第二,Repository creation 是能在组织中创建新仓库的权限,按照 GitHub 的说明,App 会自动获得其创建的仓库的访问权限。即使用 Only select repositories 缩小了范围,App 自己创建的仓库也包括在内。第三,Administration 在 Claude 的列表中只有读取,所以 App 不能更改设置或删除仓库。
以前收到过的同类邮件(用户的反馈,非官方)
- 2026年2月至3月:Checks 从读取变为读写(claude-code-action 的 Issue #1041)
- 2026年5月:Members 的读取和 Webhooks 的读写(GitHub Community 的讨论)
- 2026年11月:Repository creation 的写入(同一讨论中11月6日和13日的评论)
日期和内容都来自用户的帖子。不过关于 Webhooks,Claude 的帮助文章说明是为了插件的自动同步(第1节)。你的组织会增加哪些权限,请以批准页面上显示的列表为准。目前反馈的权限都包含在上表 Anthropic 的列表中。
6. 是否应该批准:按所用功能判断
在使用 Code Review结果以 check run 发布,因此使用 Checks 的写入。审查功能扩展时,可能需要新的权限。
考虑批准通过 Claude Tag 从 Slack 委托工作如果 Claude 管理设置的 Git providers 中显示 Needs permissions,说明有待批准的请求。点击 Review permissions 可以进入 GitHub 的批准页面。
考虑批准从 GitHub 自动同步组织的插件要在仓库中创建 webhook,因此需要 Webhooks(Repository hooks)的读写。Claude 的帮助文章也说明,在添加此权限之前就已安装的组织会看到“Claude is requesting updated permissions”,需要批准。
考虑批准在云端会话中使用拉取请求的自动修复使用 Actions 和 Statuses 读取 CI 结果。
考虑批准只使用 Claude Code GitHub Actions使用的是 Contents、Issues、Pull requests 这三项。不使用新权限,所以没有太多理由急着批准。如果不想给予宽泛的权限,可以改用自建 App(步骤见下文)。
可以暂缓只通过 claude.ai 的 GitHub 集成读取仓库这是读取文件的用途,不是使用新增权限的功能。
可以暂缓
“考虑批准”表示该功能很可能需要新权限。帮助文章说明 Webhooks 用于插件的自动同步,但没有按日期记录何时增加了哪些权限的变更记录(2026年11月14日确认)。
拿不准时,最快的办法是把批准页面上显示的每项新增权限拿到第5节的表格中查,看它是否对应你所用功能的用途。如果请求中包含用途不明的强写入权限(例如 Repository creation),而你又没有使用需要它的功能,也可以先保持待处理,观望一下。
批准的步骤
- 在 GitHub 上打开组织的 Settings,在 Third-party Access 下选择 GitHub Apps。
- 点击 Claude(开发者 anthropics)旁边的 Configure。邮件中的批准链接也指向这个 App 设置中的页面。
- 阅读所请求的新增权限列表,并与第5节的表格对照。
- 如果接受,点击批准按钮。如果不接受,什么都不做直接关闭页面即可(保持现有权限)。
缩小范围:Only select repositories
在同一个 Configure 页面的 Repository access 中,选择 Only select repositories 而不是 All repositories,就能让 Claude 只访问你选择的仓库。权限的种类无法更改,但可以缩小权限作用的范围。如前所述,唯一的例外是 App 会自动获得其自己创建的仓库的访问权限。从一个仓库开始的配置实例,请见 安全地开始使用 Claude Code 云端会话。
批准后想撤回时
GitHub 没有逐项撤销已批准权限的操作。可以采取的办法有以下三种。
- 暂停
在 Configure 页面使用 Suspend,可以在保留安装的同时停止 App 对组织资源的访问。使用 Unsuspend 可以恢复。
- 卸载
使用 Uninstall 移除 App。Code Review、Claude Tag 等其他功能也会停止。重新安装时,要再次接受当时的整个权限列表(也有用户反馈,重新安装时同样的权限会一起出现)。
- 自建 App
如果只用 Claude Code GitHub Actions,可以创建只拥有 Contents、Issues、Pull requests 的自建 GitHub App 来使用。不过 Code Review 和云端会话的自动修复需要官方 App。
Suspend 和 Uninstall 参考 Reviewing and modifying installed GitHub Apps,自建 App 参考 Claude Code GitHub Actions 和 claude-code-action 的 setup.md(2026年11月14日确认)。
只用 GitHub Actions 时:改用自建 App 的流程
- 在组织中创建新的 GitHub App,把仓库权限限制为 Contents、Issues、Pull requests 的读写(步骤见 claude-code-action 的 setup.md)。
- 把 App 的 ID 和私钥存为 Actions 的 secret(
APP_ID、APP_PRIVATE_KEY),在工作流中用actions/create-github-app-token生成该 App 的令牌,并传给github_token。 - 确认没有其他功能依赖 Claude 的官方 App 之后,再移除官方 App。
Claude API 密钥或 OAuth 令牌的 secret 需要另外准备,与 GitHub App 无关。
7. 面向组织管理员:谁能批准、在哪里查看记录
只有安装了该 App 的账户的所有者才能批准。对组织来说就是组织所有者(Organization owner),邮件也会发给每位所有者。第一次连接 Claude Tag 的人,需要既是 GitHub 组织的所有者,又是 Claude 组织的 Owner。
GitHub 的文档把批准人定为所有者。Claude 的帮助文章(Manage plugins for your organization)写的是,Webhooks 的批准由“repository or organization admin”完成。
App 的权限是否更新过,事后可以在组织的审计日志中确认。只有组织所有者才能查看审计日志。
- 打开组织的 Settings,在左侧 Archive 下依次选择 Logs 和 Audit log。
- 在搜索框中输入
action:integration_installation.version_updated。GitHub 对这一事件的说明是“Permissions for a GitHub App were updated”(GitHub App 的权限已更新)。 - 安装中仓库的增减可以用
integration_installation.repositories_added和repositories_removed搜索,App 的暂停可以用integration_installation.suspend搜索。
来源:Reviewing the audit log for your organization、Audit log events for your organization(GitHub Docs,2026年11月14日确认)。
组织最好事先决定的事
这类邮件今后可能还会收到。把在用哪些 Claude 功能、由谁批准、增加强写入权限(Contents、Workflows、Actions、Repository creation、Webhooks)时与谁商量,整理到一份文档里,每次判断都会更快。
总结
- “Claude is requesting updated permissions”是 Anthropic 的 GitHub App Claude 增加权限时,GitHub 发给组织所有者的通知。
- 要确认是否真实,不要用邮件中的链接,而是从组织 Settings 的 GitHub Apps 打开 Claude(开发者 anthropics)查看。
- 不批准时,App 以现有权限运行。使用新权限的功能可能无法运行。不能只批准一部分权限。
- 这个 App 由 GitHub Actions、Code Review、Claude Tag、插件同步等共用,所以列表中也包含你不用的功能所需的权限。
- 如果在用 Code Review 等服务端功能,考虑批准;如果只用 GitHub Actions,也可以暂缓或改用自建 App。
- 可以用 Only select repositories 缩小范围。权限更新的记录在审计日志中显示为
integration_installation.version_updated。
常见问题
Q. “Claude is requesting updated permissions”邮件是诈骗吗?
真实的邮件是 GitHub App 的开发者增加权限时,GitHub 自动发送的通知。但也可能是伪造的,所以不要点邮件中的链接,而是在 GitHub 上从组织 Settings 的 GitHub Apps 打开 Claude(开发者 anthropics)的 Configure,确认是否显示同样的请求。
Q. 不批准的话,Claude 会无法使用吗?
不会。根据 GitHub 的说明,不批准时 App 会以现有权限继续运行。不过,使用新权限的功能可能无法按预期工作。
Q. 可以只批准一部分权限吗?
不可以。Claude Code 文档说明,GitHub 不允许只批准一部分。想缩小范围时,可以用 Only select repositories 限制 Claude 能访问的仓库,或者在只用 GitHub Actions 的情况下改用权限更小的自建 App。
Q. 谁可以批准?
安装了该 App 的账户的所有者。对组织来说就是组织所有者,邮件也会发给他们。App 权限更新的记录,可以在组织的审计日志中搜索 integration_installation.version_updated 查看。
Q. 为什么 Claude 一次又一次地请求权限?
因为一个 App 由 GitHub Actions、Code Review、Claude Tag、插件同步等共用,每增加一项功能,权限列表就会变化。Anthropic 说明,权限列表可能会先于使用这些权限的功能发生变化。
更新记录
- 2026年11月14日发布。
来源
- Approving updated permissions for a GitHub App(GitHub Docs)
- Modifying a GitHub App registration(GitHub Docs)
- Reviewing and modifying installed GitHub Apps(GitHub Docs)
- Choosing permissions for a GitHub App(GitHub Docs)
- Permissions required for GitHub Apps(GitHub Docs)
- Audit log events for your organization(GitHub Docs)
- Claude Code GitHub Actions(Anthropic)
- Claude Code with GitHub Enterprise Server(Anthropic)
- Code Review(Anthropic)
- Configure GitHub access(Claude Tag,Anthropic)
- Manage plugins for your organization(Claude 的帮助文章)
- Sync your organization's plugins from a repository(Anthropic)
- claude-code-action 的 security.md(Anthropic,仅用于 Discussions 的用途)
- GitHub App permission updates should allow per-scope approve/reject(GitHub Community,用户的讨论)
- Claude GitHub app requesting updated permissions(claude-code-action 的 Issue,用户的反馈)