AI AI 工具指南
AI 工具教程

Claude + GitHub：三种集成方式，各自怎么用

Claude 接 GitHub 有三种完全不同的方式，很多人会搞混。本文讲清代码研究、终端提交、自动 PR review 各用哪种，附 2026 年 6 月最新配置。

发布于: 更新于: 作者: AI Productivity Guide Team 🌐 查看英文版本

一句话总结

“把 Claude 接上 GitHub”其实指三件完全不同的事，大家经常混为一谈：

  1. claude.ai 的 GitHub 连接器——只读。你把指定的文件和文件夹挂进对话，让 Claude 回答关于代码的问题。它只同步文件名和文件内容（不含提交历史、PR、issue）。所有套餐免费可用，截至 2026 年 6 月仍是 beta。
  2. 终端里的 Claude Code——可读可写。它在你的机器上调用 git 和 GitHub CLI（gh）来暂存提交、开 PR。随 Claude Pro（每月 20 美元）及以上套餐捆绑。
  3. Claude Code GitHub Actions——跑在 GitHub 服务器上。在 PR 或 issue 里 @claude，它就会改代码或 review diff。一条命令搞定安装（/install-github-app），按你的 Claude API key 计费。

本文把三种都讲清楚，然后重点展开多数人最先想用的那种：把连接器当作”对陌生代码库的、把答案钉在源上的研究工具”。

选对那一种

你想…用哪个读还是写跑在哪
问”X 在哪""Y 怎么工作”claude.ai 连接器只读Anthropic 服务器
让 Claude 改文件并帮你开 PRClaude Code（终端）可读可写你的机器
自动 review 每个 PR，或 @claude 修一下Claude Code Action可读可写GitHub runner

只记一条的话：claude.ai 连接器改不了你的代码。它只读文件、给答案。任何会动到分支的事，都得用 Claude Code（本地）或 GitHub Action（CI 里）。

集成一：claude.ai 的 GitHub 连接器

这就是”把代码库当研究工具”的玩法，对刚接手一个代码库的人来说，单位时间产出最高的价值都在这里。难点不在”怎么接”——而在拿到钉在源上的答案，而不是听着对的胡说。

配置方式（2026 年 6 月）

  1. 在 claude.ai 对话里点输入框左下角的 +。
  2. 选 Add from GitHub。还没授权 GitHub 的话，会先跳转去认证。
  3. 在文件浏览器里选指定的文件和文件夹——别整个仓库都选。Anthropic 自己的建议是：“纳入和当前任务最相关的关键文件和目录……但别选无关文件，以免超出 token 预算。”
  4. 发出第一条消息。Claude 读取所选内容并据此作答。

信任答案之前，有两点得先知道：

  • 只同步文件名和文件内容，且仅一个分支。连接器不会取提交历史、PR 或其他元数据。所以”总结最近 5 次提交”属于超纲——它根本没有提交可读。
  • 推送改动后，要点 Sync now 刷新；对话进行到一半时，已挂载的快照不会自动更新。

连接器在所有套餐（含 Free）都能用，截至 2026 年 6 月仍标着 beta。

让它钉在源上，而不是听着对

默认的翻车模式是：一段流畅的回答配上编造的文件路径。下面这些习惯能掐掉它：

  • **先问一个你知道答案的问题。**问一个你能验证的，比如”限流在哪实现？“，再去信那些你验证不了的。在你心里有数的问题上翻了车，立刻重新校准。
  • **逼它先列文件、再深入。**Prompt：列出和认证最相关的 3-5 个文件并带上路径，然后停下。我挑一个一起走。 先盘点再解读，能压住漂移。
  • **每条结论都要 file:line 引用。**然后在 GitHub 里打开 2-3 条核对。模糊总结藏错，具体引用暴露错。
  • **它走错路时直接给锚点。**别跟它争，把文件指给它：“具体看 src/api/rateLimit.ts。” 一个对的提示，胜过三轮纠正。

一份 10 分钟的 onboarding 脚本

先拿一个你自己写的模块来跑——你的熟悉度就是幻觉检测器。

  • 画地图：这个文件夹里最重要的 5 个文件是哪些，各做什么？带路径。
  • 走调用链：从触发这个模块的任意 HTTP 路由或任务开始，走一遍它怎么被调用。每步给 file:line。
  • **施压验证：**把这条调用链里的每个引用都在 GitHub 里打开，逐条标成”对的、走错的、编造的”。哪里让答案摇晃，就把它收进一条更紧的重问，并把好的那版存下来。

集成二：终端里的 Claude Code

想让 Claude 真去改代码、开 PR，就在你的仓库里跑 Claude Code。它不走什么特殊的 GitHub API——而是调用你本地的 git 和 GitHub CLI（gh），所以用的是你自己的凭据和权限。

典型循环：

  • 用自然语言描述要改什么，Claude 就地改文件。
  • 它暂存改动并写提交（默认带一行 Co-Authored-By 标注模型）。
  • 开 PR 时，它分析你分支上的提交，起草一个交代”做了什么、为什么”的标题和正文，再跑 gh pr create。

这条路按定义就可读可写，随 Claude Pro（每月 20 美元，2026 年起已捆绑 Claude Code）、Max 和 API 一起提供。真要改代码用这个；上面的连接器只用来读。

集成三：Claude Code GitHub Actions

这是把 Claude 放到 GitHub 的 runner 上，让它响应仓库里的事件。两种模式：

  • @claude mention——在任意 PR 或 issue 评论里 @claude，它会读上下文连同周边代码，然后实现改动，或解释为什么做不了。
  • 自动 PR review——在每个 pull_request 上跑 code-review 插件，Claude 就会对照你的 CLAUDE.md 规范读 diff，并贴行内评论，不用谁去 @ 它。

一条命令装好

在仓库目录的终端里跑：

/install-github-app

你得是仓库 admin。它会装上 Claude GitHub app（请求 Contents、Issues、Pull requests 的读写权限），把你的 ANTHROPIC_API_KEY 加进仓库 secrets，并在 .github/workflows/ 里放一个 workflow 文件。在 issue 评论里 @claude 测一下就知道通没通。

你真正会粘贴的 v1 配置

截至 2026 年 6 月，这个 action 是 v1 版。一个最小的 @claude 响应 workflow：

name: Claude Code
on:
  issue_comment:
    types: [created]
  pull_request_review_comment:
    types: [created]
jobs:
  claude:
    runs-on: ubuntu-latest
    steps:
      - uses: anthropics/claude-code-action@v1
        with:
          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

几个容易踩的点：

  • v1 自动识别模式——不再有 mode: "tag"。从 beta 升级的话，把 @beta 改成 @v1，用 prompt 替掉 direct_prompt，再把 model/max-turns/custom_instructions 合并进一个 claude_args（例如 claude_args: "--model claude-opus-4-7 --max-turns 10"）。
  • action 默认用 Sonnet 4.6。要让 review 跑在更强的模型上，在 claude_args 里设 --model claude-opus-4-7。
  • 它会读取仓库根目录的 CLAUDE.md 作为代码风格和 review 标准——把这个文件写精炼，它就能塑造每一次回复。

要预算的成本

  • API token 按每次交互计在你的 ANTHROPIC_API_KEY 上。社区反馈：小 PR（约 100 行以内）在 Sonnet 上 review 大概 0.5–2 美元，复杂仓库的大 diff 可达 5–15 美元。Opus 单价更高（截至 2026 年 6 月，每百万 token 输入/输出 5/25，Sonnet 是 3/15），留给真正要紧的 review。
  • GitHub Actions 分钟数由 runner 单独消耗，和 API 成本是两笔账。用 --max-turns 和 workflow 级的 timeout-minutes 给失控任务封顶。

FAQ

  • claude.ai 连接器能改我的代码或开 PR 吗？ 不能。它只读，且只同步文件内容。要改代码用终端里的 Claude Code；要做仓库内自动化用 GitHub Action。
  • 连接器能看到我的提交历史或 PR 吗？ 不能。按 Anthropic 文档，它只同步一个分支上的文件名和内容，明确不取提交历史、PR 或其他元数据。需要 PR 上下文，就在真实的 PR 里 @claude（用 Action）。
  • 每种集成各包含在哪些套餐里？ 连接器所有套餐（含 Free）都能用。终端里的 Claude Code 随 Claude Pro（每月 20 美元）、Max 和 API 捆绑。GitHub Action 按你的 ANTHROPIC_API_KEY 走 API 计费，和聊天套餐分开。
  • 为什么它有时会编函数名？ 跨多文件的长答会漂。缩小文件选择、要 file:line、重问。一个对话里混两个仓库是最常见的诱因——它会搅约定、编路径。
  • 连接器会额外耗 token 吗？ 它用你现有套餐的配额；选的文件越多，每次查占用的上下文越大——这正是”只挂任务需要的文件”的真正理由。
  • Action 里 PR review 该用 Opus 4.7 还是 Sonnet 4.6？ Sonnet 4.6 是默认，多数 review 又好又省。安全敏感或架构棘手的 diff，设 --model claude-opus-4-7——它更高的 SWE-bench 分（87.6% vs 同行约 80%）值这笔多花的钱。

容易踩的坑

  • **把整个仓库（或所有仓库）都挂进连接器对话。**慢、撑爆上下文预算、稀释准确度。只挂任务需要的那几个文件。
  • **信无来源的结论。**没 file:line 的结论，先当猜测，核过一条再说。
  • **一个对话里混两个仓库或三个 PR。**约定会互相渗透，Claude 分不清谁是谁的问题。一个对话一个仓库或一个 PR。
  • **让连接器去做写操作。**它做不了。请求只会给出一个听着对的计划，但没有任何东西真去执行。
  • **推送后忘了 Sync now。**已挂载的快照在你刷新前是冻住的，答案可能在描述旧代码。
  • **把 API key 提交进仓库。**workflow 里一律用 ${{ secrets.ANTHROPIC_API_KEY }} 引用，绝不内联写死。

相关阅读

标签: #Claude #教程 #工作流 #Claude Code

相关文章