Codex与GitHub如何联动？程序员的高效工作流【教程】

Codex与GitHub的深度集成，能让你的开发工作流实现“自动驾驶”。从代码提交、PR审查，到Issue同步和文档更新，一切都可围绕Git事件自动触发AI分析与执行，省去手动触发和反复重建上下文的繁琐步骤。

启用Codex GitHub Actions集成

要想让Codex和GitHub“握手”，第一步就是在项目仓库中开启GitHub Actions，否则后续所有自动化流程都无从谈起。 具体操作很简单：进入仓库的 **Settings → Actions → General**，找到“Workflow permissions”选项。这里有个关键点——必须勾选 **【Allow GitHub Actions to create and approve pull requests】**，并将“Read and write permissions”设为允许。如果你使用的是自定义OIDC令牌，还需要在 Secrets and variables → Actions 中添加 `CODER_TOKEN`（通过 `codex login --oidc` 生成）。 这个权限设置是很多新手会踩的坑。一旦漏掉，后续所有job都会报错“Permission denied: cannot create PR”，而且错误日志还不会明确提示你到底是哪个权限没给够，排查起来很头疼。

配置PR自动审查工作流

当有人提交PR时，我们希望Codex能自动扫描变更文件，并输出一份结构化的审查报告，整个过程无需人工介入。 配置起来也相当直接。首先，在你的仓库路径 `.github/workflows/` 下，新建一个名为 `codex-pr-review.yml` 的文件。然后，将以下内容粘贴进去。记得将 `YOUR_PROJECT_TYPE` 替换成你实际的项目类型，比如 `node`、`python` 或 `go`。 ```yaml name: Codex PR Review on: pull_request: types: [opened, synchronize, reopened] jobs: review: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - name: Setup Codex run: | curl -fsSL https://gitcode.com/GitHub_Trending/codex31/codex/releases/latest/download/codex-x86_64-unknown-linux-musl.tar.gz -o codex.tar.gz tar -xzf codex.tar.gz chmod +x codex - name: Run Review run: ./codex exec "审查本次PR：聚焦${{ github.event.pull_request.title }}涉及的逻辑变更，按YOUR_PROJECT_TYPE规范检查空指针、资源泄漏、API兼容性" --full-auto --output-schema .github/codex-schema.json ``` 最后，还需要在仓库根目录下创建一个 `.github/codex-schema.json` 文件。这个文件必须严格匹配 Codex v2.4.1+ 的 JSON Schema 格式要求，否则 `--output-schema` 这个参数会静默失效，审查结果格式就可能对不上了。

实现Issue到Codex任务自动转化

假设团队成员在GitHub Issue里写了一句“帮我加个导出Excel功能”，我们能否让Codex自动解析这个需求、生成函数草稿、附上测试用例，并直接提交为一个draft PR？当然可以，这里有两条路可以走。 **方式一：利用 Linear+Codex 桥接** 如果你项目已经在用Linear做需求管理，这个方案就很合适。先去 Codex 设置页面 → Add Integration → Linear → 输入你的 API key。然后在Linear中为对应 Project 启用 Codex Sync，之后只要Issue描述里包含 `#codex` 标签，Codex就会自动触发任务提取。 **方式二：纯GitHub原生方案（比较推荐）** 这是一个更通用、没有外部依赖的方案。在 `.github/workflows/issue-to-task.yml` 中配置 `on: issues: types: [opened]` 触发器，然后利用 `actions/github-script@v7` 提取 `issue.body` 内容，再调用 `codex exec` 指令将其转化为可运行的代码。工作流的关键指令如下： `codex exec "将以下需求转为可运行的Python函数：${{ github.event.issue.body }}" --skill python-export-gen` > **有一点必须确认：**在你的 `.codex/skills/python-export-gen/SKILL.md` 文件中，必须明确定义 `input_schema` 字段。如果这个字段缺失，`codex exec` 命令会直接跳过该技能，你的自动化也就泡汤了。

同步Codex本地笔记到GitHub Wiki

很多团队习惯在Codex里记录API设计文档、部署checklist、故障排查流程。如果能把这些内容实时推送到项目的GitHub Wiki，就能确保知识源的唯一性，大家都不用东找西找。 实现这个同步只需要一条命令： `codex wiki sync --target github --repo owner/repo --token ${{ secrets.GITHUB_TOKEN }}` 这条命令会扫描 `.codex/wiki/` 目录下所有的 `.md` 文件，并按照目录结构映射为Wiki页面路径。需要注意的是，在首次运行前，必须手动去GitHub的Wiki页面点击“Create first page”来初始化仓库，否则同步会失败。 另外，这个操作有个不可逆的特性：如果Wiki里已经存在同名页面，命令会默认对其进行覆盖，操作前最好确认一下。