【AI智能体】Claude Code 集成Github CLI 实现高效项目协同使用详解
目录一、前言二、Github CLI 介绍2.1 什么是 GitHub CLI2.2 GitHub CLI 日常使用场景2.3 GitHub CLI 优缺点2.3.1 GitHub CLI 使用优点2.3.2 GitHub CLI 使用缺点2.4 GitHub CLI 常用命令汇总2.4.1 核心命令2.4.2 GitHub Actions 命令2.4.3 认证与配置命令2.4.4 扩展与高级命令三、Github CLI 安装部署详细过程3.1 前置准备3.1.1 执行安装命令3.1.2 认证与配置四、Git Cli 使用案例详解4.1 Git Cli 常用命令4.1.1 克隆仓库4.1.2 创建仓库4.1.3 查看提交历史记录五、GitHub CLI Claude Code 结合使用过程5.1 为什么需要结合使用5.2 核心使用场景5.2 基于Claude Code 集成并使用Git CLI5.2.1 检出最近的提交记录5.2.2 提交代码5.2.3 代码review六、写在文末一、前言2026年随着各类AI工具的广泛使用普通人也能在日常的生活和工作中享受到各种AI工具带来的便捷。在AI编程领域尤其是给很多程序员带来了很多编程方面的提效近期一直比较火热的AI编程工具Claude Code 在全世界都引起了不少的热度加上各种CLI工具的盛行Claude Code与这些CLI工具结合后进一步释放生产力本篇将详细介绍不久前刚发布的Github CLI工具以及如何在Claude Code中集成和使用Github CLI。二、Github CLI 介绍2.1 什么是 GitHub CLIGitHub CLI命令行界面工具简称gh是 GitHub 官方推出的命令行工具让你可以直接在终端中操作 GitHub 的各项功能无需在浏览器和终端之间来回切换。它的核心理念是将 GitHub 带入命令行主要围绕三大核心功能构建Issues问题管理、Pull Requests拉取请求管理和 Repositories仓库管理。git 入口GitHub CLI 快速入门 - GitHub Enterprise Server 3.15 Docs2.2 GitHub CLI 日常使用场景在下面的一些场景中你可以考虑使用GitHub CLI 借助CLI你可以更高效完成一些相比传统git命令做的事情日常开发克隆仓库、创建分支、提交 PR全程不离终端代码审查快速检出他人 PR 到本地测试、批准或评论Issue 管理创建、查看、筛选指派给自己的 IssueCI/CD 监控查看 Actions 运行状态和失败日志重新运行任务仓库维护创建/删除仓库、管理 Release、查看项目统计自动化脚本批量操作 Issue/PR集成到 CI 流程中2.3 GitHub CLI 优缺点尽管使用GitHub CLI 相关的命令带来了一种比较新的操作Git的团队协同方式但也需要区分具体的使用场景否则在实际使用过程中会引入新的麻烦下面列举了GitHub CLI 的优缺点提供技术选项。2.3.1 GitHub CLI 使用优点GitHub CLI 具有下面的优点优点说明高效快捷无需在终端和浏览器间切换命令行操作更快可脚本化支持 JSON 输出易于集成到自动化脚本和 CI/CD统一认证一次登录Git 操作push/pull自动共享凭证功能全面覆盖 Issues、PR、Actions、Release、Codespaces 等核心功能节省资源不占用浏览器标签页适合低配机器或远程开发扩展性强支持自定义别名和第三方扩展2.3.2 GitHub CLI 使用缺点在实际安装和使用过程中发现GitHub CLI 具有下面的一些缺点缺点说明学习成本需要记忆命令和参数不如浏览器图形界面直观复杂操作不便多条件筛选、可视化对比如 PR 代码差异图不如网页清晰无实时预览编写 Issue/PR 时看不到 Markdown 渲染效果部分功能缺失项目管理Project Board、Insights 分析等仍需浏览器节省资源不占用浏览器标签页适合低配机器或远程开发错误提示有限失败时的错误信息有时不够友好排查困难2.4 GitHub CLI 常用命令汇总为了方便后续的学习和使用下面详细总结了GitHub CLI的常用命令2.4.1 核心命令这些命令是安装了CLI 命令之后日常工作中经常会涉及到的需要深度学习和掌握命令功能说明常用示例gh repo管理仓库gh repo create my-project --public创建公开仓库gh repo clone owner/repo克隆仓库gh repo view查看当前仓库信息gh repo delete删除仓库gh issue管理 Issuesgh issue list列出所有 Issuegh issue list --label bug筛选带bug标签的 Issuegh issue view 15查看编号15的 Issuegh issue create --title 标题 --body 描述创建 Issuegh pr管理 Pull Requestsgh pr list列出所有 PRgh pr list --state all查看所有状态的 PRgh pr view 321查看 PR 详情gh pr create --base main --head feature创建 PRgh pr merge 17 --squash合并 PRgh issue status查看 Issue 状态显示相关 Issue 的概览状态gh pr status查看 PR 状态显示当前分支的 PR 状态、需要审查的 PR 等gh browse在浏览器中打开快速打开当前仓库的 GitHub 页面gh codespace管理 Codespaces连接和管理 GitHub Codespaces 开发环境2.4.2 GitHub Actions 命令命令功能说明常用示例gh run管理工作流运行gh run list列出最近运行记录gh run view RUN_ID查看运行详情gh run view --log查看运行日志gh run rerun RUN_ID重新运行工作流gh workflow管理工作流gh workflow list列出仓库中的所有工作流gh cache管理 Actions 缓存管理 GitHub Actions 的缓存文件2.4.3 认证与配置命令这些命令主要是在安装配置阶段会涉及的命令功能说明常用示例gh auth login登录 GitHub 账户交互式登录流程支持浏览器认证或 Token 认证gh auth status查看认证状态确认当前登录账户和配置状态gh auth setup-git配置 Git 凭证将gh设置为 Git 的凭证助手自动管理 Git 操作认证gh config管理配置设置和查看gh的配置选项2.4.4 扩展与高级命令命令功能说明常用示例gh run管理工作流运行gh run list列出最近运行记录gh run view RUN_ID查看运行详情gh run view --log查看运行日志gh run rerun RUN_ID重新运行工作流gh workflow管理工作流gh workflow list列出仓库中的所有工作流gh cache管理 Actions 缓存管理 GitHub Actions 的缓存文件三、Github CLI 安装部署详细过程下面介绍两种具体的安装方式3.1 前置准备请提前在本地电脑安装git服务并且准备好git账号确保能够从git代码仓库正确拉取到代码3.1.1 执行安装命令打开本地powrshell窗口执行下面的命令wget install --id GitHub.cli这个过程时间可能有点长等待其执行完成即可安装完成后可以通过 gh -version 查看版本信息看到下面的信息说明安装成功3.1.2 认证与配置使用下面的命令登录对git 进行认真操作执行下面的命令时注意重启一个窗口否则会报错底层会做一些环境变量的配置gh 登录授权并获取tokengh auth login选择第一个之后紧接着弹出下面的选项让你选择我这里选择https输入Y紧接着选择登录到web浏览器中拷贝里面的地址在浏览器打开打开后出现下面这个让你登录的界面点击contineu之后这里输入的验证码就是上个窗口中给的那个拷贝进去之后输入验证成功后看到下面的页面浏览器授权成功后再回到CMD窗口时可以看到已经认证并配置完成了四、Git Cli 使用案例详解接下来通过一些实际案例操作演示下如何使用Git Cli 工具4.1 Git Cli 常用命令上面安装了Git cli命令并且完成认证配置之后就可以直接通过CLI相关命令操作git了4.1.1 克隆仓库当你需要克隆某个仓库的时候以前需要输入git clone 命令然后完成账号秘密的输入等信息现在只需要在打开的CMD窗口中之间输入下面的命令即可gh repo clone git用户名/项目分支名示例gh repo clone octo-org/octo-repo 将 octo-org/octo-repo 远程仓库克隆到本地计算机目录可以执行此命令下面是我远程仓库中的一个演示项目参考上面的说明执行下面的命令整个过程的执行速度很快中间不再需要做任何其他的认证过程4.1.2 创建仓库创建新仓库对很多新手来说创建一个git仓库并且推送项目代码到仓库下仍然是一件比较繁琐的事情基于CLI 命令就能很方便做这件事创建仓库命令如下在下面的命令后面还可以通过--public、--private等标志指定可见性。gh repo create 仓库名如下打开CMD窗口后通过上面的命令创建一个git仓库gh repo create rpc-pro整个执行的速度非常快秒级就完成执行完成后在git中就能看到这个新的仓库了4.1.3 查看提交历史记录执行下面的命令可以检查提交历史记录gh pr list # 查看 PR 历史以上演示了基于Git CLI常用的操作命令使用场景更多的使用场景还可以在官方git上面去进一步探究https://docs.github.com/zh/enterprise-server3.15/github-cli/github-cli/quickstart五、GitHub CLI Claude Code 结合使用过程5.1 为什么需要结合使用GitHub CLI (gh) 和 Claude Code 是两个独立的工具但结合使用可以发挥强大的协同效应gh提供与 GitHub 平台交互的命令行接口管理 Issue、PR、仓库等Claude CodeAnthropic 官方推出的 AI 编程助手能在终端中理解代码库、编写代码、执行命令结合的核心价值让 AI 能够直接操作 GitHub实现从理解需求到提交代码到创建 PR的全流程自动化。5.2 核心使用场景在下面的一些场景中将两者结合可以充分发挥其最大价值场景具体实现工具组合自动修复 Issue在 Issue 中 claudeAI 分析问题并提交 PRActions ghAI 代码审查每次 PR 自动触发Claude 评论修改建议Actions批量处理问题使用night-queue工具结合gh Claude 自动处理所有未解决的 Issuegh Claude CLI自动化 PR 创建Claude 根据需求自动创建分支、编写代码、提交 PRActions ghIssue 分类打标Claude 分析 Issue 内容自动添加对应标签Actions gh5.2 基于Claude Code 集成并使用Git CLI下面演示下如何在Claude Code 中使用Git CLI基于上述安装了CLI 并且使用 gh auth login 完成了认证与配置之后5.2.1 检出最近的提交记录打开Claude Code 窗口后直接输入提示词询问最近的提交记录由于CLI 命令已经集成进去可以直接在Claude Code 中操作5.2.2 提交代码编写代码并提交新增一个接口然后直接基于Claude Code 调用 Git CLI相关的命令对编写的代码进行提交在提交的过程中发现由于Master分支是受保护的不允许直接合并因此AI创建了一个feature的分支并将代码提交到了这个分支上最终可以在git上看到提交的分支代码5.2.3 代码review有了Claude Code 这样的顶级AI编程大模型在过去很多开发团队在review代码的时候很大程度上需要依赖团队中那些比较有经验的成员现在一种人机共创的review代码模式就产生了即借助Claude Code 基于已经集成好的Git CLI 工具对团队成员提交的代码进行review首先让Claude Code 给出初步的review意见然后再由人工去做检查即可可以大大提升review的效率下面看具体的操作案例。如下本地编写一个接口并手动提交代码打开Claude Code 输入下面的提示词对feature分支上近3天提交的代码进行review并且给出你的review建议输入之后Claude Code 会基于Git Cli 工具对当前分支上近期提交的代码记录进行检查然后开始review经过一段时间的读取解析和review之后最终给出了AI自己的建议六、写在文末本文通过案例操作详细演示了Git CLI 的使用最后还演示了如何在Claude Code 中集成和使用Git CLI希望对看到的同学有用本篇到此结束感谢观看。