GitHub Actions 與程式碼審查
交接重複性工作的最佳場所就是提取請求(pull request)。這是審查發生、變更落地、也是您許多瑣碎工作所在之處。在這裡讓 Claude 工作有兩種方式,它們解決的是不同的問題。一種是您直接開啟的受管服務。另一種是您自行接上的 GitHub Action。讓我們逐一看過兩者,並弄清楚何時該用哪一種。
受管路徑:Code Review
最簡單的選項是 Code Review。這是 Anthropic 託管的服務,透過 Claude GitHub app 審查您的提取請求。您無需建置或託管任何東西。只要開啟它,它就會開始在重要的那些行上,以內嵌註解的形式張貼發現的問題。
您 Claude 組織的擁有者(Owner)可以從 Claude Code 管理員設定中啟用它。您會看到一個「Code review」區段,其中有一個「Allow code review」開關,用來啟動設定流程。
接著,擁有者安裝 Claude GitHub app、挑選它監看的儲存庫,並決定它何時執行。如果該擁有者同時也不是 GitHub 組織的擁有者,就必須先有人安裝並連結該 app。您在時機上有幾種選擇:
- 在 PR 開啟時執行一次
- 在 PR 每次推送時執行
- 僅當有人留言
@claude review時執行
一旦開啟,一切都在 Anthropic 的基礎設施上執行。一組審查代理程式會根據您完整的程式碼庫(而非僅僅獨立看待變更的那些行)來分析差異(diff)。接著它會以內嵌註解的形式,依嚴重程度標記,將發現的問題張貼在特定的行上,並在檢查執行(check run)中附上摘要表。
每個發現的問題都會以 Claude 的留言形式落在相應的行上,附帶清楚的說明與建議的修正方式。
很棒的一點是,它會對發現的問題去重並排序。因此您讀到的不是一堆瑣碎挑剔,而是少數幾個真正值得您關注的問題。
Code Review 會做什麼、不會做什麼
這裡有幾件關於界線的事要記住:
- 它絕不會核准或阻擋 PR。判斷的責任仍在人類身上。Claude 標示出問題;由您決定。
- 它不會推送修正。該服務僅張貼發現的問題。
- 它僅在 Team 與 Enterprise 方案中提供。
由於該服務只張貼發現的問題,針對某個問題採取行動是您該做的:修正程式碼並推送。若要在推送前檢查您的修正,請從您自己的終端機執行 /code-review。它會對您的差異(diff)執行自己的審查,而其 --fix 旗標會將該次審查發現的問題套用到您的工作目錄樹上。
自己動手的路徑:GitHub Action
Code Review 負責審查。當工作超出審查範圍時,您就要改用 GitHub Action。這適用於自訂 CI:根據留言實作變更、執行排程報表,任何您原本會寫一個工作流程(workflow)來做的事。它可以在 PR 留言、排程工作以及任何 GitHub 事件上執行代理程式。
設定從 Claude Code 內部開始。執行 /install-github-app 命令。您需要該儲存庫的管理員權限才能執行此操作。這個斜線命令會引導您完成安裝 GitHub app,並在儲存庫上設定 Anthropic API 金鑰密鑰。
該 action 本身是 anthropics/claude-code-action@v1。以下是您實際會用到的輸入項:
anthropic_api_key— 當執行需要呼叫 Claude API 時為必填,除非您使用claude_code_oauth_token(來自 Claude 訂閱)或工作負載身分聯盟(workload identity federation,透過 Claude Console 服務帳號設定,因此無需儲存的密鑰)進行驗證。不用於下方的雲端供應商。github_token— 選填。不填的話,action 會以您在設定時安裝的 Claude GitHub app 身分進行驗證。只有要覆寫該行為時才傳入 token。trigger_phrase— action 在留言中監聽的字詞。預設為@claude。use_bedrock/use_vertex/use_foundry— 透過 Amazon Bedrock、Google Cloud's Agent Platform 或 Microsoft Foundry 來路由執行,而非透過 Claude API,並以您的雲端帳號登入而非使用 API 金鑰。prompt— 自動化執行的指令。設定後,Claude 會在事件發生時執行,而無需等待被提及。不填的話,action 會等待觸發詞。claude_args— 直接傳遞給 Claude Code 的一串 CLI 參數。
回應 @claude 的工作流程
將一個工作流程放入 .github/workflows/claude.yaml,它就會監聽 PR 留言與議題(issue)留言中的 @claude。以下是整個檔案。id-token: write 權限讓 action 能以 Claude GitHub app 身分登入:
name: Claude Code
on:
issue_comment:
types: [created]
pull_request_review_comment:
types: [created]
jobs:
claude:
if: contains(github.event.comment.body, '@claude')
runs-on: ubuntu-latest
permissions:
contents: write
pull-requests: write
issues: write
id-token: write
actions: read
steps:
- uses: actions/checkout@v6
with:
fetch-depth: 1
- uses: anthropics/claude-code-action@v1
with:
anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
claude_args: "--max-turns 5 --model claude-sonnet-5"現在有人在某個提取請求上寫下 @claude implement the spec in the linked Linear issue,該 action 就會接手處理。Claude 會推送提交(commit),並張貼留言描述它做了什麼。
按排程執行的工作流程
同一個 action 也能用於每日彙整報表。一個 cron 觸發器會在例如 UTC 9:00 時觸發,action 執行您的 prompt,您就可以在該次執行的日誌中閱讀彙整結果。排程執行的作業本身不會張貼留言。您也可以加入一個 workflow_dispatch 觸發器,這樣就能從 Actions 分頁手動啟動它:
name: Daily report
on:
schedule:
- cron: "0 9 * * *"
workflow_dispatch:
jobs:
report:
runs-on: ubuntu-latest
permissions:
contents: read
issues: read
id-token: write
steps:
- uses: anthropics/claude-code-action@v1
with:
anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
prompt: "Generate a summary of yesterday's commits and open issues"
claude_args: |
--allowedTools "mcp__github__list_commits,mcp__github__list_issues"當 action 執行時,您可以在 Actions 分頁中觀察它逐步執行,就像任何其他 GitHub 工作流程一樣。
用 claude_args 調校執行方式
claude_args 這一行就是進行細部調校的地方。以下是幾個值得了解的調整項:
--max-turns 5對代理程式迴圈設下硬性上限,讓它不會無止境地執行下去。- 權限模式(Permission mode)。對於無人看管的工作,您會希望它不要停下來詢問,因為沒有人在那裡回答。
- 允許的工具(Allowed tools)。只給這項工作它所需要的,不多不少。對於報表而言,那就表示只讀(read-only)。
您應該用哪一種?
簡短版本如下:
- 對於 PR 審查,採用受管路徑。啟用 Code Review,讓 GitHub app 張貼內嵌發現的問題,然後修正程式碼並推送。
- 當工作超出審查範圍時,改用 action。使用
/install-github-app進行設定,一個工作流程用於@claude提及,另一個用於 cron,而所有的調校都放在claude_args裡。
從受管服務開始。一旦您需要 Claude 在 CI 中實際做些什麼,而不只是發表評論時,就改用 action。