---
title: "安装 GitHub 插件"
summary: "安装 github@openai-curated 并连接 GitHub，处理工单、PR 和 CI。仓库访问和写入操作受授权范围限制。"
category: skills
level: starter
surfaces: [cli, app]
tags: ["plugins", "GitHub", "github@openai-curated"]
canonical: /tips/github-codex-plugin/
---

# 安装 GitHub 插件

安装 github@openai-curated 并连接 GitHub，处理工单、PR 和 CI。仓库访问和写入操作受授权范围限制。

安装 github@openai-curated 并连接 GitHub，处理工单、PR 和 CI。仓库访问和写入操作受授权范围限制。

这是把 GitHub 仓库接到 Codex，用来看 PR、分诊 issue、查失败的 Actions，并准备改动。清单 [`plugin.json`](https://github.com/openai/plugins/blob/main/plugins/github/.codex-plugin/plugin.json) 的 name 是 `github`、version 是 `0.1.11`，所以精选 id 是 `github@openai-curated`。现行清单只声明 [`.app.json`](https://github.com/openai/plugins/blob/main/plugins/github/.app.json)，没有 `skills` 字段，也没有 `mcpServers` 字段。不要写成 `github@openai-curated-remote`。

CLI：

```bash
codex plugin add github@openai-curated
codex plugin list
```

TUI `/plugins` 或桌面 Plugins 搜 GitHub 再装，效果一样。装完按提示 Connect GitHub 账号。企业实例才再连 GitHub Enterprise，两份连接器在清单里都是 `required: false`。IDE 扩展没有 `/plugins`，用 CLI 这条。

仓库另有 [`.mcp.json`](https://github.com/openai/plugins/blob/main/plugins/github/.mcp.json)，表名是 `github`，type 是 http，URL 是 `https://api.githubcopilot.com/mcp/`（**有**尾斜杠），`bearer_token_env_var` 是 `GITHUB_PAT_TOKEN`。因为现行 `plugin.json` **没有**挂 `mcpServers`，不要假设 `plugin add` 会自动叠这张 MCP 表。只要 MCP、不要 App 时，走现有的托管 MCP 技巧：启动进程里先 `export GITHUB_PAT_TOKEN`，再 `codex mcp add github --url https://api.githubcopilot.com/mcp/ --bearer-token-env-var GITHUB_PAT_TOKEN`。这是 Bearer，**不要** `mcp login github`。插件已经登记 MCP 时，不要再 `mcp add` 叠一张。

在支持的 Codex 任务视图里，打开 Sources → Use plugins，再搜已安装的 GitHub。ChatGPT 里可以用 `@GitHub`。

0.154 起先看**当前会话**的 `/plugins`；没有再新开。`codex plugin list` 里应看到 `github@openai-curated`。网页 Cloud 不读 `~/.codex/config.toml`。Cloud 用 Plugins 搜 GitHub。

使用注意事项：

- 操作影响：改 issue、推提交、合并 PR 会动真实仓库。


## 来源

- [openai/plugins · github plugin.json](https://github.com/openai/plugins/blob/main/plugins/github/.codex-plugin/plugin.json)
- [openai/plugins · github .mcp.json](https://github.com/openai/plugins/blob/main/plugins/github/.mcp.json)
- [openai/plugins · github .app.json](https://github.com/openai/plugins/blob/main/plugins/github/.app.json)