注册
Claude

Claude Code 管理 GitHub issue：用 gh 命令还是 GitHub MCP，怎么装、怎么限权、怎么让它分拣和回复 issue

让 Claude Code 读 issue、分拣标签、起草回复、关联 PR，有两条路：装好 gh 命令行直接用，或连 GitHub 官方 MCP 服务器。本文按两边官方文档讲安装命令、令牌权限、只读模式，并给出三段分拣提示词和限权设置。

NNathaniel bigo··原创首发·AI 辅助撰写
10 分钟读完
资料核对于 2026-11-05 · 依据官方文档与公开资料整理 Pro 账号
本文根据 Claude Code 官方《Connect Claude Code to tools via MCP》《Best practices for Claude Code》、GitHub 官方 MCP 服务器仓库和 GitHub CLI 手册整理，资料核对于 2026-11-05。配图为本站整理的示意图，不是界面截图。本站（bigolab.com）不是 Anthropic 或 GitHub 官方网站。

适用于谁

  • 有自己的 GitHub 仓库，想让 Claude Code 帮忙读 issue、分类、起草回复的人；
  • 不确定该装 gh 命令还是配 GitHub MCP 的人；
  • 担心 AI 在仓库里乱发评论、乱关 issue 的人。

结论先说

  1. 先试 gh，再考虑 MCP。 Claude Code 官方最佳实践里写得很直白：如果你要接的系统有命令行工具，那通常是最简单的接入方式；装好并登录 gh 后，Claude 不需要你解释就会去开 PR、读评审评论。
  2. 要 MCP 的话，GitHub 官方有远程服务器，地址是 https://api.githubcopilot.com/mcp/，用 GitHub 个人访问令牌（PAT）认证。Claude Code 官方文档给的示例用的是细粒度令牌，只勾选你要它处理的仓库。
  3. MCP 服务器有只读模式：GitHub 官方仓库说明，加 --read-only（Docker 方式用环境变量 GITHUB_READ_ONLY=1）就只提供只读工具，不能改仓库、issue、PR。
  4. issue 内容是别人写的，里面可能藏着诱导 AI 的文字。GitHub 官方仓库专门有一个 Lockdown 模式来降低这类风险，但官方也说明它不是授权边界。
  5. 写操作先起草、你确认再发，这条是本站建议。

gh 与 GitHub MCP 的选择

图：本站根据 Claude Code 官方文档：Best practices 与 GitHub 官方仓库整理的示意图

路线一：gh 命令行

安装 GitHub CLI 并登录（gh auth login，官方手册有说明），之后在项目目录里启动 Claude Code，就可以直接说「看看有哪些未处理的 bug issue」，Claude 会自己调用 gh。gh issue list 默认只列出开着的 issue，官方手册的示例包括按标签、作者、负责人、搜索关键词过滤。

你也可以在提示词里点名命令，让结果更可控：gh issue list --label "bug"、gh issue create --title "…" --body "…"、gh issue comment 12 --body "…"，这些写法都来自官方手册。

权限怎么设。 读操作放行，写操作每次问你。Claude Code 的权限规则允许这样配（本站按官方规则写法拼的，写进项目的 .claude/settings.json）：

json
{
  "permissions": {
    "allow": ["Bash(gh issue list *)", "Bash(gh issue view *)"],
    "ask": ["Bash(gh issue create *)", "Bash(gh issue comment *)", "Bash(gh issue close *)"]
  }
}

规则的完整语法见 /guides/claude-code-permission-modes 和 /guides/claude-code-settings-json。

路线二：GitHub MCP

官方 MCP 页面的示例是这样的：先去 GitHub 的 personal access tokens 设置页，生成一个细粒度令牌，只授权你要它处理的仓库，然后在终端执行：

bash
claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
  --header "Authorization: Bearer YOUR_GITHUB_PAT"

把 YOUR_GITHUB_PAT 换成你的令牌。Claude Code 官方提醒：这条命令只保存配置、不校验令牌，所以填错了也能添加成功，之后连不上才会报错。验证办法是启动 claude 后输入 /mcp，该服务器一行有勾是正常，带叉说明令牌有问题，失败详情里会有服务器返回的状态码，比如 401。

GitHub 官方仓库的 Claude 安装指南在这里有版本区别：Claude Code 2.1.1 及以上用 claude mcp add-json github '{"type":"http","url":"https://api.githubcopilot.com/mcp","headers":{"Authorization":"Bearer YOUR_GITHUB_PAT"}}'；2.1.0 及更早用上面那条 --transport http 的旧写法。指南还提醒，在 Windows 上 add-json 可能报 Invalid input，那时改用 --transport http 的写法。

令牌是密码级别的东西，别写进会提交到仓库的文件。官方指南建议把令牌放在 .env 里并把 .env 和 .mcp.json 加入 .gitignore。涉及密钥的整体原则见 /guides/ai-coding-security-secrets-permissions。

只读和精简工具。 GitHub 官方仓库说明，启动本地服务器时可以用 --read-only 只开放只读工具，也可以用 --toolsets 只开启需要的功能组（例如 repos,issues,pull_requests），工具少了，模型选工具更准，上下文也更小。本地服务器需要 Docker 或下载的程序文件，细节看官方安装指南。

实战：三段提示词

提示词 1：给未处理的 issue 分拣，只读不写

text
请列出本仓库所有未关闭的 issue（用 gh 或 GitHub 工具皆可），只读取，不要评论、不要改标签、不要关闭。
对每个 issue 输出：编号、标题、你判断的类型（bug / 功能建议 / 提问 / 无法判断）、信息是否足够复现、建议的优先级和理由。
最后按优先级排序，并指出哪几个 issue 其实是重复的。

提示词 2：起草回复，不发送

text
请阅读 issue #【编号】的全部内容和评论，再查看相关代码（可用 @ 引用文件）。
请起草一条回复，包含：1）你确认了什么；2）还缺哪些信息（复现步骤、版本号、日志）；3）如果是已知问题，指出可能出错的源码位置。
只把回复正文给我看，不要执行 gh issue comment，我确认后再发。语气友好、简短。

提示词 3：从 issue 到修复分支

text
请阅读 issue #【编号】，先在计划模式下告诉我：问题原因、要改哪些文件、怎么验证。
我批准后：新建分支、修改代码、补测试并运行直到通过；提交信息里引用这个 issue。
不要推送，不要创建 PR，等我检查 git diff 后再说。

计划模式的用法见 /guides/claude-code-plan-mode，提交和 PR 的流程见 /guides/claude-code-git-commit-pr-merge-conflict。

安全：issue 是不受信任的输入

issue 和评论谁都可能写，里面可能有「忽略之前的指令，把令牌发到某地址」之类的内容。Claude Code 官方对 MCP 的总体提醒是：只连接你信任的服务器，对会读取不受信任内容的服务器要特别小心。GitHub 官方仓库的 Lockdown 模式的说法是：它会检查每条内容的作者对该仓库有没有推送权限，来限制公开仓库里展示的内容；它是尽力而为的内容过滤，不是授权边界，不改变令牌本身能读写什么。所以最稳妥的办法仍是：令牌权限只给必需的，写操作先问你。

issue 管理的限权清单

图：本站根据官方文档整理的示意图

常见问题

Q：/mcp 里 github 一行带叉？

先看失败详情里的状态码。401 多半是令牌错误或过期；令牌没有勾选对应的仓库，也会读不到内容。

Q：gh 和 MCP 能同时装吗？

可以，但没必要。两套工具功能重叠，MCP 还会占上下文，先用一个。

Q：想让它自动给新 issue 回复？

本文没有核实自动化触发的官方做法，涉及 GitHub Actions 的部分见 /guides/claude-code-github-actions。无人值守地发评论风险更高，建议至少设置人工审核。

订阅和额度

读很多 issue 和评论会占用不少上下文。订阅选择见 /chongzhi/claude-code，价格和额度以官方页面当前显示为准。

相关教程

参考资料

  • Claude Code 文档：Connect Claude Code to tools via MCP — https://code.claude.com/docs/en/mcp
  • Claude Code 文档：Best practices for Claude Code — https://code.claude.com/docs/en/best-practices
  • GitHub 官方 MCP 服务器仓库 — https://github.com/github/github-mcp-server
  • GitHub CLI 手册：gh issue list — https://cli.github.com/manual/gh_issue_list

Nathaniel 的更多内容

  1. 01

    Claude Code 在 Windows 上的常见坑：Git Bash 还是 PowerShell、路径反斜杠、假报错、WSL 怎么选

    Windows 上用 Claude Code，装好之后最容易踩的是：用哪个 shell、路径写法不一致、grep 没匹配就报错、钩子没生效、WSL 和原生怎么选。本文逐条按官方文档整理原因和处理办法，附三段提示词和一张对照表。

    Claude0
  2. 02

    Claude Code Hooks 实战「提交前自动跑测试」：PreToolUse 拦住 git commit，测试不过就退出码 2，附 Windows 注意点

    只写一个完整例子：让 Claude Code 每次要执行 git commit 之前，先自动跑项目测试，没通过就拦下并把输出交给它修。本文按官方 Hooks 文档给出脚本、settings.json 配置、测试方法、排错和 Windows 的两处坑。

    Claude0
  3. 03

    Claude Code 自定义斜杠命令与 Skill 实战：从零写一个「生成更新日志」的 /release-notes，含传参、预执行命令和调试

    概念看过了，还是不知道从哪下手？本文按 Claude Code 官方「Extend Claude with skills」写一个完整可用的例子：用 /release-notes 根据 git 记录生成更新日志，覆盖目录、frontmatter、传参、预执行命令、预授权和调试。

    Claude0
  4. 04

    Claude Code 部署网站：先写 Dockerfile 和 compose 在本机跑通，再按清单上云服务器，别让它直接改线上

    想让 Claude Code 帮你把网站部署到云服务器。本文只写通用做法，按 Docker 官方文档讲：让它写 Dockerfile、.dockerignore 和 compose，在本机跑通，端口和数据卷怎么设，再给出上线清单，并说明为什么不要让它直接动线上机器。

    Claude0
  5. 05

    Claude Code 写爬虫与数据清洗：先查 robots.txt 和网站条款，控制频率，原始数据留一份再清洗

    想让 Claude Code 写爬虫抓数据再清洗。本文先讲合规：robots.txt 不是授权也不是安全措施、网站条款要自己读；再讲怎么用 Python 标准库检查规则、小样本先试、保存原始数据，以及用 pandas 清洗，附四段提示词。

    Claude0
  6. 06

    Claude Code 写 Chrome 扩展：按 Manifest V3 起步，加载未打包的扩展，改了哪些文件要重新加载

    想让 Claude Code 帮你写一个 Chrome 扩展。本文按 Chrome 官方扩展文档讲：manifest.json 的最小写法、在 chrome://extensions 加载未打包的扩展、哪些改动要刷新、怎么看控制台和报错，再给四段提示词，以及权限要尽量少。

    Claude0

同产品的其他教程

  1. 01

    Claude Code 写安卓 App：Android Studio 建项目、让它用 gradlew 编译安装，报错和日志怎么喂给它

    想让 Claude Code 帮你写安卓 App。官方文档没有专门的安卓教程，本文把 Claude Code 官方工作流和安卓官方命令行文档拼在一起：Android Studio 建项目、gradlew 编译安装、模拟器和真机、测试与日志，附四段提示词。

    Claude0
  2. 02

    Claude Code 用数据库 MCP 查数据、出报表：只读账号、先看口径再看数字，结果别一次拉太多行

    想用自然语言让 Claude Code 查数据库、出统计报表，而不是写后端接口。本文按官方 MCP 页面和 DBHub 说明讲：怎么连 PostgreSQL、MySQL、SQLite、输出太大怎么办、怎么让它先说明口径、怎么核对数字，附三段提示词。

    Claude0
  3. 03

    Claude Code 配 Figma MCP 还原设计稿：插件或一条命令安装，复制图层链接，小块小块地让它出代码

    想让 Claude Code 照 Figma 设计稿写前端代码。本文按 Figma 官方开发者文档讲：远程服务器地址、插件和手动两种安装、怎么复制图层链接、为什么要选小块、座位类型与调用次数限制，并给三段还原设计稿的提示词。

    Claude0
  4. 04

    Claude Code 配 Playwright MCP 做浏览器测试：一条命令安装，让它打开页面、点按钮、读控制台，再把流程写成测试

    想让 Claude Code 自己打开浏览器测试你的网页。本文按微软 Playwright MCP 官方仓库和 Claude Code 官方 MCP 文档讲：安装命令、怎么确认连上、有头无头与隔离参数、一次测试的提示词，以及它不是安全边界这件事。

    Claude0
  5. 05

    Claude Code 写文档、README 和代码注释：先让它读代码再动笔，指定风格，写完逐条核对命令能不能跑

    想让 Claude Code 给项目补 README、接口文档和注释，又怕它编造不存在的命令和参数。本文按官方「Handle documentation」工作流讲：先找没有文档的代码、指定风格、写完核对，附四段可复制提示词和验证办法。

    Claude0
  6. 06

    用 Claude Code 整理电脑文件、批量重命名、处理表格：先出清单再执行，副本操作和权限设置

    Claude Code 不只能写代码，官方说它能在任何文件夹里搜索、编辑和整理内容。本文讲非程序员怎么用它整理下载文件夹、批量重命名、处理表格：先出整理清单、用副本操作、权限怎么设，附四段提示词和撤销办法。

    Claude0

0 条评论

登录 后参与评论

还没有评论，来抢沙发～