网易首页 > 网易号 > 正文 申请入驻

为什么你的Claude Code工作流一跑就报OIDC错误?

0
分享至

把 Claude Code 塞进 GitHub Actions,最省事的写法只有三步,第一次就能跑通,所以大多数仓库到这儿就停了。真正会咬人的地方,恰恰是这版最简配置没写出来的部分:提交是以谁的身份推的、作业令牌能干什么、除了你的团队还有谁能启动一次握着 API 密钥的运行。


这个动作叫 anthropics/claude-code-action@v1,在 Actions 作业里跑 Claude Code。不给 prompt 输入时,它等着被 @claude 提及;给了 prompt,它就在触发工作流的那个事件上直接跑。配置时要写 id-token: write,按模式给最窄的作业权限,并且用 Claude GitHub App 而不是 GITHUB_TOKEN,否则它推上去的提交不会触发 CI。

一次运行里其实有三道关卡:Claude 启动前的三项检查、两套彼此独立的认证,以及推送身份决定 CI 到底跑不跑。

两种模式,由一个输入决定

mode 输入已经取消,动作自己判断模式。没有 prompt 就是交互模式:它在 issue 或 PR 评论、PR 评审、新开 issue 的正文或标题里找触发词(默认 @claude),然后在一个持续更新的评论里回复。label_trigger(默认 claude)和 assignee_trigger 也能从标签或指派启动同一套流程。

设了 prompt 就是自动化模式:Claude 在任何事件上运行,包括 schedule,结果默认写进工作流运行日志而不是评论。纯文本 prompt 起步时既没有 shell 也没有 GitHub API 访问权,需要什么工具就在 claude_args 里用 --allowedTools 授予。作业上的 if: 不是装饰,它避免每条评论都拉起一个 runner,动作自己还会再核一遍触发词。

权限里 actions: read 出现两次是故意的。作业权限让令牌能读运行记录;additional_permissions 才是让动作启动 CI 工具(mcp__github_ci__get_ci_status、mcp__github_ci__get_workflow_run_details、mcp__github_ci__download_job_log)的开关。

认证是两个独立的问题

第一个问题是 Claude 怎么够到模型:Anthropic API 密钥、Claude 订阅的 OAuth 令牌、针对 Claude Console 服务账号的工作负载身份联合,或者 Amazon Bedrock、Google Cloud 的 Agent Platform(use_vertex)、Microsoft Foundry,各自走 OIDC。

第二个问题是动作怎么够到 GitHub:默认它申请一个 OIDC 令牌,拿去和 Anthropic 换一个 Claude GitHub App 的安装令牌,然后以 claude[bot] 的身份推送和评论。

两个答案都可能需要 id-token: write,所以这条权限出现在每个示例里。默认路径上漏了它,运行会停在“Could not fetch an OIDC token. Did you remember to add id-token: write to your workflow permissions?”。第一次提 PR 的人还会撞上第二条报错:工作流文件本身是新增或改动的时候,令牌交换会被拒绝,动作会记录说这是预期行为,合并 PR 之后工作流才开始工作。

用云厂商时,GitHub 身份要自己选:官方 App、只注册 Contents、Issues 和 Pull requests 三项权限的自定义 App,或者 GITHUB_TOKEN。官方 App 安装时带全套权限,包括 Actions 和 Workflows 的写权限,因为 GitHub 不允许只接受其中一部分;想把这个动作压到三项权限,就得走自定义 App。

身份还决定 CI 看不看得见 Claude 的活。用 GITHUB_TOKEN 推的分支不会触发 push 运行,所以任何会提交的工作流都得留着 App 或自定义 App 的令牌。

每个作业的最小权限

作业权限管的是作业自己的 GITHUB_TOKEN,不是动作换来的那个 App 令牌。这就是为什么 Anthropic 的代码评审示例里,作业只拿读权限加 id-token: write,却能发出行内评论——评论是用 Claude App 的令牌写的。只在 Claude 必须提交的地方给写权限,而且只给跑它的那个作业。

谁能启动它

Claude 启动前,动作会对操作者做两项检查。在 issue 和 PR 事件上,用户必须有写权限,没有的话会收到“Actor does not have write permissions to the repository”。在所有事件上(包括 schedule),机器人操作者会被拒绝,报错以“Workflow initiated by non-human actor:”开头,结尾提示把它加进 allowed_bots 列表,或者用 '*' 放行所有机器人。

这两个逃生口在动作自己的安全文档里都带警告。allowed_bots 里的机器人完全不检查仓库权限,所以在公开仓库上用 '*',等于任何能评论的 GitHub App 都能用自己控制的 prompt 驱动 Claude。allowed_non_write_users 绕过写权限检查,只在配了 github_token 时生效,而且只应该在作业权限小到只能打标签的场景里用。

对于作者没有写权限的 PR,restrict_untrusted_prs(默认开启)会禁掉那些从检出代码里跑命令的操作,哪怕 claude_args 里放行了也一样;Claude 仍然可以读、改、推。在公开仓库上,include_comments_by_actor 可以收窄哪些人的评论能进到 prompt 里。

常见问题

  • Claude 不回 @claude 评论?按顺序查:仓库装了 Claude GitHub App、API 密钥或 OAuth 令牌的 secret 存在、评论里的 @claude 是完整单词(不是 @claude-bot 也不是 /claude)、评论者有写权限。
  • 能用 Claude Max 订阅吗?可以。本地跑 claude setup-token,把结果存成 CLAUDE_CODE_OAUTH_TOKEN secret,传给 claude_code_oauth_token 输入而不是 anthropic_api_key;Pro、Max、Ultra、Team 和 Enterprise 套餐都在可列范围内,运行走订阅而不是 API 计费。跨仓库共享的 secret 要用 API 密钥,因为令牌绑定在生成它那个人的订阅上。
  • Bedrock 或 Vertex 能跑吗?能。设 use_bedrock: "true" 或 use_vertex: "true"(Foundry 是 use_foundry),先用云厂商自己的 OIDC 动作完成认证,给 id-token: write,再通过 claude_args 传模型 ID。

以上每个输入、默认值和报错信息,都读自 v1.0.273 版本的动作源码与 Anthropic 文档,不是一次录下来的运行日志。

特别声明:以上内容(如有图片或视频亦包括在内)为自媒体平台“网易号”用户上传并发布,本平台仅提供信息存储服务。

Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.

相关推荐
热点推荐
大四女生凌晨外出失联近两年未归,失联前最后身影曝光:身穿红裙白袜,脚上没穿鞋;母亲称曾住酒店寻人4个多月无果

大四女生凌晨外出失联近两年未归,失联前最后身影曝光:身穿红裙白袜,脚上没穿鞋;母亲称曾住酒店寻人4个多月无果

极目新闻
2026-11-17 17:21:30
65岁刘德华自曝每天吃6颗鸡蛋,吃素13年曾迷上咖啡:每天喝20杯

65岁刘德华自曝每天吃6颗鸡蛋,吃素13年曾迷上咖啡:每天喝20杯

开开森森
2026-11-16 20:46:35
比普京特朗普先到深圳的,是两架军用大飞机,信号不一般

比普京特朗普先到深圳的,是两架军用大飞机,信号不一般

赵探长TALK
2026-11-17 11:02:02
财政不再兜底、大公交退市、老年卡取消,四部委文件真如此说了?

财政不再兜底、大公交退市、老年卡取消,四部委文件真如此说了?

云霄纪史观
2026-11-17 04:30:23
10月澳洲市场:比亚迪销量再破万,经销商协会坐不住了

10月澳洲市场:比亚迪销量再破万,经销商协会坐不住了

汽车公社
2026-11-16 13:41:48
又投中5个三分!抱歉雷阿伦:你的历史第三要不保了

又投中5个三分!抱歉雷阿伦:你的历史第三要不保了

篮球大视野
2026-11-17 20:36:34
这次发射失败,美军有点慌了

这次发射失败,美军有点慌了

枢密院十号
2026-11-17 00:35:37
79岁路都走不稳还开演唱会捞金,全网恶评如潮,她却扬言回馈粉丝

79岁路都走不稳还开演唱会捞金,全网恶评如潮,她却扬言回馈粉丝

背包旅行
2026-11-17 12:11:31
消失前,他喘着粗气说:“一个人都没有”

消失前,他喘着粗气说:“一个人都没有”

中国新闻周刊
2026-11-17 18:55:45
伊拉克总理下令,欠中方的工程款立即结清,只向中方提了一个要求

伊拉克总理下令,欠中方的工程款立即结清,只向中方提了一个要求

墨兰史书
2026-11-17 14:00:04
网传蔚来财务暴雷?官方报案!与事实严重不符

网传蔚来财务暴雷?官方报案!与事实严重不符

闪电新闻
2026-11-17 17:49:33
说实话,这种局面不能再延续下去了,否则中国真的有点危险了!

说实话,这种局面不能再延续下去了,否则中国真的有点危险了!

今夜繁星坠落
2026-11-15 23:17:03
车间用纺织机器吹头发拍视频走红,次日被开除,网友:太作死了

车间用纺织机器吹头发拍视频走红,次日被开除,网友:太作死了

秒懂资讯
2026-11-17 16:58:55
11月17日俄乌:克宫引以为傲的克里米亚大桥被炸塌了

11月17日俄乌:克宫引以为傲的克里米亚大桥被炸塌了

山河路口
2026-11-17 19:39:00
网友称安徽芜湖一小区有高空作业人员疑似被人割断安全绳,报消防后获救,物业:系5楼住户用钝器切割,目前警方正在侦办中

网友称安徽芜湖一小区有高空作业人员疑似被人割断安全绳,报消防后获救,物业:系5楼住户用钝器切割,目前警方正在侦办中

潇湘晨报
2026-11-17 11:31:12
男子被熟人骗至缅甸电诈园区,姐姐赴泰国营救

男子被熟人骗至缅甸电诈园区,姐姐赴泰国营救

网易新闻出品
2026-11-16 18:25:30
俄罗斯被曝将芬兰退出北约列为结束俄乌战争的条件之一,芬兰国防部长公开表示:没有谈判余地,俄罗斯心知肚明,提出这种要求简直荒谬至极

俄罗斯被曝将芬兰退出北约列为结束俄乌战争的条件之一,芬兰国防部长公开表示:没有谈判余地,俄罗斯心知肚明,提出这种要求简直荒谬至极

吉刻新闻
2026-11-15 18:22:34
77岁被骗光积蓄,83岁公开告诉媒体自己仍有性生活、91岁近乎全裸地登上杂志封面,双腿修长迷人!传奇"超模"卡门用一生证明:年龄只是数字

77岁被骗光积蓄,83岁公开告诉媒体自己仍有性生活、91岁近乎全裸地登上杂志封面,双腿修长迷人!传奇"超模"卡门用一生证明:年龄只是数字

回京历史梦
2026-11-17 14:24:26
普京今日飞抵深圳!中方定名中俄美,波兰不服:让欧盟替代俄参会

普京今日飞抵深圳!中方定名中俄美,波兰不服:让欧盟替代俄参会

国际法大视野
2026-11-17 18:58:03
突发!美国多家大银行集体崩了。。。

突发!美国多家大银行集体崩了。。。

云头条
2026-11-17 05:07:09
2026-11-18 02:00:49
灰度测试中
灰度测试中
生活正在重构,目前还在灰度测试阶段,暂不全量发布。
212文章数 90关注度
往期回顾 全部

科技要闻

硅谷大佬组局,帮黄仁勋杀回来!

头条要闻

中国女子在希腊失踪半年 保险箱发现10万欧元现金

头条要闻

中国女子在希腊失踪半年 保险箱发现10万欧元现金

体育要闻

伪强队?拥4亿豪阵欧国联6连败+世界杯出局

娱乐要闻

陈晓楠对话厉娜和许飞引全网热议

财经要闻

10万人逼宫英伟达,黄仁勋要复职了?

汽车要闻

更豪华更好开 问界新M8细节升级见真章

态度原创

家居
本地
亲子
游戏
公开课

家居要闻

2026建博会(广州) 公装联探展交流活动

本地新闻

乌兰察布:以前种土豆,现在种Token

亲子要闻

宝宝气人但是聪明的4个行为

小伙表示连玩7天《GTA6》 这下PS5可惨了

公开课

李玫瑾:为什么性格比能力更重要?

无障碍浏览 进入关怀版