發佈日期:

使用Claude Code自動修改Github的Issue

安裝Claude Code

請先確認你的系統符合以下條件:

步驟 1:安裝 Claude Code CLI

開啟 Terminal(Mac/Linux)或 WSL 的 Ubuntu 終端機,執行:

npm install -g @anthropic-ai/claude-code

安裝完成後,輸入以下指令確認版本:

claude --version

步驟 2:設定 API 金鑰驗證

安裝好後,必須連結你的 Anthropic 帳號:

claude auth login

或是將 API 金鑰寫入環境變數(適合自動化流程):

export ANTHROPIC_API_KEY="你的-api-金鑰"

第一次執行 claude auth login 時,系統會開啟瀏覽器讓你登入並授權。

步驟 3:開始第一個專案

  1. 建立新的專案資料夾並切換進去: mkdir my-claude-project cd my-claude-project
  2. 啟動 Claude: claude

與Github連結

gh 是 GitHub CLI 工具,用於在命令列中與 GitHub 互動。

winget install --id GitHub.cli --accept-source-agreements

接著就是認證GitHub CLI,打開瀏覽器至:https://github.com/login/device

輸入代碼完成認證

GitHub CLI常用指令:

  • gh repo clone – 複製倉庫
  • gh pr create – 建立 Pull Request
  • gh pr list – 列出 PR
  • gh issue create – 建立 Issue
  • gh auth login – 登入 GitHub 需要先安裝並認證才能使用。

使用Github CLI請Claude幫忙修Issue

接著就可以透過Github CLI請Claude自動幫忙修BUG了!

建立 ~/.claude/commands/fix-github-issue.md 這個檔案,內容就是你想讓 Claude Code 幫你「自動處理 GitHub Issue」的完整流程。這個檔案就像是你寫給 Claude 的任務腳本,它會當作「自定義指令」使用。

以下為一個範例內容

# Fix GitHub Issue

## 目標
修復 GitHub 上指定 issue 的 bug,並提交一個 Pull Request。

## 步驟

1. 使用 `gh issue view {input}` 指令讀取 Issue 編號為 `{input}` 的描述內容。
2. 分析問題並找出最可能相關的程式碼區段與檔案。
3. 編寫修正該 bug 的程式碼(請先顯示變更建議讓我確認)。
4. 編寫對應的測試案例來覆蓋此次修正。
5. 若我確認沒問題,請進行 commit,訊息為 `fix: resolve issue #{input}`。
6. 提交 PR,標題為 `Fix for issue #{input}`,描述為修正內容與測試方式。

只要你寫好後,在 Claude 裡輸入:

/project:fix-github-issue 1234

它就會根據那個 markdown 檔案的內容,自動幫你處理 Issue #1234。