44 · GitHub Actions 集成教程

在 GitHub Actions 和 PR 中调用 Claude Code 的安装、认证、工作流配置、触发方式与安全注意事项。

把 Claude Code 接进 GitHub Actions，是「从个人工具到流水线」的关键一跃。这一篇讲怎么安全地做。

「安装」：在 CI 环境里装好 Claude Code，让它能在跑流水线时被调用。

「认证」是重点：CI 环境里没有你的交互式登录，所以要用 token、密钥这类「非交互」的认证方式。

「工作流配置」：在 GitHub Actions 的 workflow 里，配置「什么时候、怎么调用 Claude Code」。

「触发方式」：每次 push 跑、开 PR 才跑、还是定时跑，按需配置，别让它在不该跑的时候烧钱。

「典型场景」：自动审查 PR、自动修 lint 报错、自动生成文档等。

「安全注意事项」：CI 环境里的权限要「最小化」，token 要「妥善保管」（用 GitHub 的 secrets 存，别明文写），输出要「可审查」。

「核心原则」：自动化是「提效」，不是「免责」。它自动跑出来的结果，不能直接放上线，得有审查这道关。

把这三条守住——最小权限、妥善保管凭证、输出可审查——Claude Code 进 CI 才是安全的。

一个自查清单：当你读完这一篇时，可以问自己三个问题——它解决的是什么具体问题？我当前的工作/学习里有没有这个场景？下一步我该学哪一篇？把这三个问题答清楚，你就知道自己有没有真正吃透。

五分钟练习：① 找一个一分钟能完成的代码任务 ② 用这一篇的方法描述给 Codex ③ 看它执行时有没有触发你刚学的那个机制 ④ 验证结果是否符合预期。这一轮做下来，你对这一篇的理解会深 3 倍。

延伸阅读：学完这一篇，你可以看本组里的下一篇，把相邻的概念连起来读；也可以跳到更后面的组学 MCP、子代理、Skills 这些更深的能力。知识是网状的，多跳几篇会理解更深。

复盘清单：每做完一个任务，可以花一分钟复盘——目标说清楚了吗？范围限定了吗？结果验证了吗？审查过 diff 了吗？下次哪里能更好？这 5 步能让你的 Codex 使用从「能用」进化到「好用」。