Claude Code：常見的開發者使用案例

Claude Code 是一個在您的終端機中執行的命令列代理，可以讀取您的儲存庫、編輯檔案、執行命令，並在執行可能具有破壞性的操作前請求確認。它旨在協助軟體開發生命週期的每個階段——從探索陌生的程式碼庫到發佈和維護生產程式碼。

下表總結了 Claude Code 在開發生命週期中的適用位置。本文的其餘部分將介紹開發者最常使用它的十項任務，每項任務都包含範例提示和預期結果。

1. 探索	2. 設計	3. 建置	4. 部署	5. 支援和擴展
探索程式碼庫和歷史記錄	規劃專案	實現程式碼	自動化 CI/CD	除錯錯誤
搜尋文件	開發技術規格	撰寫並執行測試	設定環境	大規模重構
上線和學習	定義架構	建立提交和 PR	管理部署	監控使用情況和效能

如何使用本指南

下面的每個使用案例都包括何時使用、範例提示和預期結果。除了第 9 項（問題追蹤器整合）需要一次性 MCP 連接器設定外，其他項目都不需要任何設定。

使用案例大致按照大多數開發者遇到它們的早期程度排序。選擇與您目前任務相符的案例。

使用案例

1. 修復失敗的測試

何時使用：測試失敗且原因不明顯。使用此功能讓 Claude Code 找出根本原因並提出修復方案，無需您先識別原始檔案。

範例提示：

> the tests in tests/auth.test.ts are failing, can you figure out why and fix them

預期結果：Claude Code 讀取測試檔案，追蹤被測試模組的程式碼路徑，識別不匹配之處，並提出編輯建議。您批准變更後，它會重新執行測試套件以確認修復。

2. 理解陌生程式碼

何時使用：您需要在進行變更前理解模組、函式或子系統的運作方式——例如在繼承程式碼或檢查陌生區域時。

範例提示：

> walk me through how the payment retry logic works

預期結果：Claude Code 找出相關檔案、讀取實現方式，並用簡明語言解釋控制流程：進入點、決策分支、邊界情況，以及程式碼如何連接到系統的其餘部分。提出後續問題（例如「X 在哪裡設定」）以深入探討。

3. 找出某事發生的位置

何時使用：您知道程式碼庫中存在某個行為，但無法透過檔案名稱或簡單文字搜尋找到它。

範例提示：

> where do we validate email addresses in this codebase? I want to add a new rule

預期結果：Claude Code 搜尋儲存庫、開啟候選檔案，並傳回檔案路徑和行號，附帶足夠的周圍內容以識別正確的匹配項。如果存在多個位置，它會指出哪一個是真實來源。

4. 分類錯誤或堆疊追蹤

何時使用：您有執行時期錯誤、堆疊追蹤或日誌輸出，需要將其對應回負責的程式碼。

範例提示：

<table class="prompt"> <colgroup> <col style="width: 100%" /> </colgroup>
<tbody> <tr class="odd"> <td>&gt; getting this in production:<br />
TypeError: Cannot read properties of undefined (reading 'sessionId')<br />    
at validateSession (src/auth/session.ts:47)<br />     at middleware
(src/auth/middleware.ts:12)<br /> what's going on?</td> </tr> </tbody>
</table>

預期結果：Claude Code 讀取追蹤中參考的檔案，解釋未定義的內容及原因，並提出修復方案。對於沒有清晰堆疊追蹤的錯誤，貼上任何可用的日誌輸出，Claude Code 將從上下文重建失敗。

5. 按計畫重構

何時使用：變更跨越多個檔案，您想在進行任何編輯前檢查完整範圍。

先決條件：按 Shift+Tab 直到模式指示器顯示「plan.」

範例提示：

> refactor the auth module to use the new session store instead of SessionCache

預期結果：Claude Code 分析程式碼並產生編號計畫，列出它將修改的每個檔案和每個檔案中的變更。您可以按原樣批准計畫或修改它（例如「不要觸及登出路由」）。在您批准前不會編輯任何檔案。

參考： 權限

6. 為現有程式碼編寫測試

何時使用：原始檔案缺乏測試覆蓋率，或您需要編寫符合專案現有測試慣例的額外邊界情況測試。

範例提示：

> add tests for @src/billing/invoice.ts — cover the edge cases around partial refunds. match the style of the existing tests in tests/billing/

預期結果：Claude Code 會讀取原始檔案和參考測試目錄，以現有風格產生新的測試檔案，並執行它以確認測試通過。如果仍有明顯的覆蓋率缺口，它會標記並詢問是否要解決。

7. 審查拉取請求

何時使用：您需要審查或總結拉取請求，特別是在您不太熟悉的程式碼庫區域。

前置條件：GitHub CLI 已驗證（執行 gh auth login 一次）。

範例提示：

<table class="prompt"> <colgroup> <col style="width: 100%" /> </colgroup>
<tbody> <tr class="odd"> <td>&gt; /pr-comments
https://github.com/acme/api/pull/4471<br /> &gt; is the error handling
solid?</td> </tr> </tbody> </table>

預期結果：Claude Code 會取得差異、審查意見和 CI 狀態，然後在完整的儲存庫上下文中讀取變更的檔案。它可以提供重點審查、草擬審查意見、驗證特定問題或總結拉取請求。

8. 加入新儲存庫

何時使用：您首次在儲存庫中工作，需要其架構、建置命令和慣例的結構化概述。

範例提示：

<table class="prompt"> <colgroup> <col style="width: 100%" /> </colgroup>
<tbody> <tr class="odd"> <td>&gt; /init<br /> &gt; give me a tour of this
codebase — where's the entry point, how is it structured, what should I
read first</td> </tr> </tbody> </table>

預期結果：/init 掃描專案並寫入 CLAUDE.md 檔案，總結建置命令、架構和慣例。後續的導覽提示會產生專案結構的引導式逐步解說。專案上下文在工作階段的其餘時間保持載入。

參考：記憶體和 CLAUDE.md

9. 端對端處理問題

何時使用：您想在單一對話中讀取工單、實施修復並驗證，無需切換工具。

前置條件：透過 MCP 連接的問題追蹤器（一次性 .mcp.json 設定）。

範例提示：

<table class="prompt"> <colgroup> <col style="width: 100%" /> </colgroup>
<tbody> <tr class="odd"> <td>&gt; what's the top-priority issue assigned
to me?<br /> &gt; go ahead and fix it</td> </tr> </tbody> </table>

預期結果：Claude Code 查詢問題追蹤器、讀取工單、定位相關程式碼、提出修復方案並執行測試。工作階段以可審查的差異和關閉工單所需的上下文結束。

參考：MCP

10. 將重複性工作轉換為斜線命令

何時使用：您定期重複相同的多步驟提示（提交前檢查、站立會議摘要、拉取請求說明、發行說明），並希望讓整個團隊可重複使用。

範例提示：

> make me a /ship command that runs the tests, runs the linter, looks at git diff, and drafts a conventional-commit message — then shows me the message without committing

預期結果：Claude Code 將 markdown 檔案寫入 .claude/commands/。/ship 命令立即可用，無需重新啟動，並與克隆儲存庫的任何人共享。

參考：斜線命令

附錄：快速參考

#	使用案例	範例提示
1	修復失敗的測試	`[file] 中的測試失敗 — 找出原因並修復`
2	理解陌生程式碼	`向我說明 [module] 如何運作`
3	找出發生位置	`我們在此程式碼庫中的何處 [action]？`
4	分類錯誤	貼上堆疊追蹤，然後詢問：`發生了什麼？`
5	按計畫重構	Shift+Tab → 計畫模式 → 描述重構
6	編寫測試	`為 @[file] 新增測試 — 符合 [dir] 中的風格`
7	審查拉取請求	`/pr-comments [URL]` 然後提出您的問題
8	上線到儲存庫	`/init` 然後「給我一個導覽」
9	從頭到尾處理一個問題	`我的最高優先級問題是什麼？` → `繼續修復它`
10	建立斜線命令	`為我建立一個 /[name] 命令，用於 [steps]`

附錄：資源目錄

資源	連結
快速入門	code.claude.com/docs/en/quickstart
常見工作流程	code.claude.com/docs/en/common-workflows
權限	code.claude.com/docs/en/permissions
記憶體和 `CLAUDE.md`	code.claude.com/docs/en/memory
MCP 連接器	code.claude.com/docs/en/mcp
斜線命令	code.claude.com/docs/en/slash-commands

如需 /init、@-參考、權限模式、技能、MCP 和掛鉤的詳細資訊，請參閱 code.claude.com/docs。Claude Code 頻繁更新—在內部分發前，請根據 code.claude.com/docs 驗證版本特定的詳細資訊。