Claude Code + GitHub Actions 自動修改 Issue 實戰教學

Claude Code + GitHub Actions 能做到哪些事？

• 立即產生 PR、補 bug 或實作功能：只要在 issue 或 PR 留言 @claude implement ...，Claude 就會自動完成工作，並提交 PR。
• 自動代碼審查：PR 中問一句 @claude review code level，由 AI 幫忙分析與修正錯誤。
• 符合既有專案標準：Claude 會自動參考專案裡的 CLAUDE.md 內容，比照程式風格與工程規範。
• 簡易設定，立刻上手：可以透過 CLI /install-github-app 快速部署，也可手動安裝 workflow。

GitHub Actions 要怎麼安裝 Claude Code？

安裝非常簡單，在終端機輸入：

claude
/install-github-app

接著會出現 GitHub 授權與安裝畫面：

接著輸入要連接的 repository，這邊我選擇我的開源專案：

https://github.com/cochiachang/walkassure

接著在 GitHub 設定 Claude 的 API Key：

workflow 檔案該怎麼設定？

在專案內增加 .github/workflows/claude.yml。請參考我在 walkassure 專案的設定：https://github.com/cochiachang/walkassure/tree/main/.github/workflows

name: Claude AI Workflow

on:
  issues:
    types: [opened, edited, labeled]
  issue_comment:
    types: [created]

jobs:
  claude-analysis:
      runs-on: ubuntu-latest
      if: contains(github.event.issue.body, '@claude') || contains(github.event.comment.body, '@claude')

      steps:
        - name: Checkout code
          uses: actions/checkout@v4

        - name: Claude AI 回應
          uses: anthropics/claude-code-action@beta
          with:
            anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}

        - name: Claude AI 呼叫成功通知
          if: always()
          run: echo "✅ Claude 回應觸發成功！"
  notify:
    runs-on: ubuntu-latest
    needs: [claude-analysis]
    if: always()

    steps:
    - name: Send notification
      run: |
        echo "Workflow completed"
        echo "Claude analysis status: ${{ needs.claude-analysis.result }}"
        echo "Build and test status: ${{ needs.build-and-test.result }}"

這個 workflow 的重點：只在 issue 內容或留言包含 @claude 時觸發，呼叫 anthropics/claude-code-action 讓 Claude 分析並回應，最後再用一個 notify job 回報執行結果。

實際跑一個 issue 會發生什麼事？

我在 walkassure 開了一個測試 issue：https://github.com/cochiachang/walkassure/issues/1

接著就可以看到 Claude 已經回應了一個修正，自動分析問題並提出對應的程式碼修改：

整個流程從留言到 Claude 回應，完全不需要離開 GitHub，等於把一個隨叫隨到的 AI 工程師放進了 code review 與 issue 處理流程裡。

常見問題

QClaude Code + GitHub Actions 的觸發條件是什麼？

在這個設定裡，只有當 issue 內容或 issue 留言包含 @claude 時，workflow 才會透過 contains() 條件觸發，避免每個事件都呼叫 API 浪費額度。

QAPI Key 要放在哪裡？

先在 GitHub repository 的 Settings → Secrets and variables → Actions 新增 ANTHROPIC_API_KEY，workflow 裡再用 ${{ secrets.ANTHROPIC_API_KEY }} 引用，不要把 Key 直接寫進 YAML。

QClaude 會不會不遵守專案的程式風格？

不會，Claude 會自動讀取專案內的 CLAUDE.md，比照既有的程式風格與工程規範來產生修改，所以建議先把專案慣例寫進 CLAUDE.md。

Q一定要用 /install-github-app 安裝嗎？

不一定，/install-github-app 只是最快的方式；也可以手動把 workflow YAML 放進 .github/workflows/ 並設定好 Secrets，效果相同。

參考資料

• walkassure 專案
• walkassure 的 GitHub workflows 設定
• 範例 issue #1

延伸閱讀

• Claude Code + GitHub Actions 自動修改 Issue：讓 AI 接手你的 Issue 處理流程：同樣聚焦 Claude Code、GitHub Actions，可接著比較不同情境的做法。
• Claude Code 自動修改 GitHub Issue：用 GitHub CLI 建立修復流程：同樣聚焦 Claude Code，可接著比較不同情境的做法。
• Claude Code 終端操作技巧與 SDK 應用：同樣聚焦 Claude Code，可接著比較不同情境的做法。

最後更新

2026-08-28（原文發布於 2025-07-23，本文保留原始筆記內容並補上 GEO 結構。）

關於作者

Claire Chang ｜ 企業 AI 導入與流程轉型顧問。專注於 AI Agent 架構設計、ERP 系統整合與企業 AI 治理。

首次發布：2025-07-23