AI 代理與 MCP
進階
AI 代理與 MCP

每個 Pull Request 自動做 AI 程式碼審查

用 GitHub Actions 在每次 Pull Request 自動執行 Claude Code 審查,寫好專案規則,控制費用,並保留人工核准。
30 分鐘
6 步
GitHub Actions 分鐘數加上 AI 用量
編
AI 有解編輯部
最後更新 2026 年 11 月 5 日・CC BY 4.0
用到的工具
Claude Code
GitHub Actions
人工審查最容易因為忙碌而草草帶過。讓 AI 先看一輪,把明顯的錯誤、漏掉的邊界情況和安全問題先抓出來,人就能專心看設計和需求。
AI 審查的角色是第一道濾網,不是最後核准者。
你需要準備
•
一個 GitHub 專案,而且你有管理員權限
•
Claude API 金鑰,或符合資格的 Claude 訂閱
•
安裝好 Claude Code 與 GitHub CLI(gh)
進度 0/6
1

快速安裝

在專案裡打開 Claude Code,執行:
文字
/install-github-app
依照提示安裝 GitHub App、設定金鑰,並選擇加入審查工作流程。它會開好一個 Pull Request,合併後就生效。
這個指令只支援 github.com 的專案。如果失敗,用下一步手動設定。
2

手動設定(可選)

1.
到 github.com/apps/claude 安裝 Claude GitHub App。
2.
在專案的 Settings、Secrets and variables、Actions 新增 ANTHROPIC_API_KEY。
3.
建立 .github/workflows/code-review.yml:
YAML
name: Code Review on: pull_request: types: [opened, synchronize, ready_for_review, reopened] jobs: review: runs-on: ubuntu-latest permissions: contents: read pull-requests: read issues: read id-token: write steps: - uses: actions/checkout@v6 with: fetch-depth: 1 - uses: anthropics/claude-code-action@v1 with: anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }} plugin_marketplaces: "https://github.com/anthropics/claude-plugins-official.git" plugins: "code-review@claude-plugins-official" prompt: "/code-review:code-review --comment ${{ github.repository }}/pull/${{ github.event.pull_request.number }}" claude_args: '--allowedTools "mcp__github_inline_comment__create_inline_comment"'
這段設定來自官方文件。--comment 讓審查結果留言在 Pull Request 上,沒有加的話只會寫在執行紀錄裡。設定會更新,使用前請對照最新的 Claude Code 文件。
3

寫好專案的審查規則

沒有規則時,AI 只能給一般性建議。在專案根目錄的 CLAUDE.md 寫下重點:
文字
審查時請特別注意: - 資料庫查詢必須有權限檢查 - 金額一律使用整數分,不用浮點數 - API 錯誤訊息不能回傳內部資訊 - 新增的資料表都要有 RLS 規則 不用評論排版,這些由 formatter 處理。
檔案要精簡,代理每次執行都會讀取,內容越多成本越高。
4

開一個測試 Pull Request

故意放一個小問題,例如漏掉空值檢查,確認它抓得到、留言有出現在正確的位置。
AI 會略過草稿、已關閉的 Pull Request、判斷不需審查的小改動,以及已經有 Claude 留言的 Pull Request,所以沒看到留言時先確認這些狀況。
5

控制費用

每次執行會用掉 GitHub Actions 分鐘數和 AI 用量。可以這樣控制:
•
用 --max-turns 限制回合數
•
替工作流程設定逾時
•
用 paths 排除文件和產生的檔案
•
大改動拆成小的 Pull Request,審查結果也會更好
6

保留人工核准

在分支保護規則要求至少一位真人核准,並要求測試通過。AI 的評論可以幫助判斷,不能取代核准。
注意
金鑰一定要放在 GitHub Secrets,不要寫進工作流程檔。工作流程權限給最小範圍就好。公開專案中,來自 fork 的 Pull Request 拿不到 Secrets,所以這個審查只會跑在同專案分支的 Pull Request 上。Pull Request 內容也可能夾帶給 AI 的指令,不要因為 AI 說沒問題就合併。
你照著做成功了嗎?
成為第一個回報的人。你的回報會決定攻略排序與作者分潤。
下一步
•
測試失敗時讓 AI 協助,看〈讓 AI 修 CI 失敗:讀錯誤、提修改,由人合併〉。
•
想補上測試,看〈讓 AI 補測試:先列行為,再寫測試,最後驗證測試真的有用〉。
收錄在學習路線
廣告版位
想讓正在用 AI 的人看到你的產品?了解廣告合作
問與答
卡住的地方、補充的做法都可以留在這裡
還沒有人留言。
更多「AI 代理與 MCP」攻略