實戰範例｜Claude Code 教學

可篩選案例

目前顯示 8 / 8 個案例

案例 1：JavaScript → TypeScript 全專案重構

某電商後台擁有逾兩萬行 JavaScript 程式碼，型別錯誤頻繁導致線上事故，團隊決定遷移至 TypeScript 以提升可維護性。工程師以一句指令請 Claude Code 掃描所有 .js 檔案、推導函式簽名與物件結構，逐檔自動加入型別注釋，並針對無法推導的邊界情況插入 // TODO: 補型別 標記。Claude Code 同步更新 tsconfig.json、調整 ESLint 規則，並執行 tsc --noEmit 確認零錯誤後才回報完成。最終專案在三個工作天內完成遷移，型別覆蓋率達 94%，原本每週平均兩次的型別相關線上事故歸零。

# 範例指令
"請把 src/ 底下所有 .js 檔轉為 TypeScript，
 推導型別並加上型別注釋，轉完後執行 tsc --noEmit 確認無誤。"

案例 2：根據錯誤日誌自動定位並修復 Bug

線上服務凌晨爆出大量 NullPointerException，錯誤日誌顯示問題發生在訂單結帳流程，但 stack trace 跨越七個模組，人工排查耗時。工程師將完整日誌貼給 Claude Code，並附上問題發生的時間區間與使用者操作路徑。Claude Code 解析 stack trace，定位到 OrderService.calculateDiscount() 在優惠券過期邊界條件下未做 null 檢查，隨即提出最小化修補程式並說明根本原因。工程師審查後合併修正，並由 Claude Code 自動補寫邊界情境的單元測試，確保同類問題不再復發。

# 範例指令
"以下是今天 02:00–03:00 的錯誤日誌，
 請找出根本原因並提出修復方案，修完後補上對應的單元測試。"

案例 3：串接第三方 API（金流與物流）

新創公司需在兩週內同時串接綠界金流與黑貓物流 API，兩套文件格式迥異且均有沙箱環境限制。工程師提供 API 文件 PDF 與現有訂單資料模型，請 Claude Code 設計統一的 Adapter 層，隔離外部 API 差異。Claude Code 讀取文件後自動生成請求/回應的 TypeScript interface、實作 Adapter 類別、撰寫 mock server 供本地測試，並在每支 API 方法上加入 retry 邏輯與結構化日誌。整合測試全數通過後，Claude Code 輸出一份完整的串接說明供維運團隊參考，上線後兩個月未出現金流或物流異常。

# 範例指令
"根據附件 API 文件，設計一個 Adapter 層統一金流與物流介面，
 實作後請補上整合測試與 mock server，完成後產出串接說明文件。"

案例 4：自動生成單元測試（覆蓋率從 12% 到 80%）

老舊後端服務測試覆蓋率僅 12%，每次上線前需要大量人工回歸，上線風險居高不下。工程師指定 Jest 作為測試框架，請 Claude Code 分析所有 service 層函式的輸入輸出，自動生成正常路徑、邊界條件與錯誤情境的測試案例。Claude Code 先以 coverage --reporter=lcov 取得基線報告，再依覆蓋率最低的模組優先補寫測試，並在完成後重新執行報告確認數字。整個過程耗費約四小時，覆蓋率從 12% 提升至 82%，後續上線信心大幅提升，手動回歸時間縮短七成。

# 範例指令
"請分析 src/services/ 底下所有函式，
 用 Jest 自動生成單元測試，覆蓋正常、邊界與錯誤情境，
 完成後執行 coverage report 並告知覆蓋率變化。"

案例 5：程式碼文件自動生成（JSDoc + OpenAPI）

團隊接手一個缺乏文件的 Express REST API 專案，新進工程師上手困難，前後端溝通成本極高。工程師請 Claude Code 掃描所有 route handler 與 middleware，自動推導參數型別與回傳結構，生成標準 JSDoc 注釋與 OpenAPI 3.0 規格檔。Claude Code 在生成過程中遇到邏輯不清的端點時，主動標記「文件待確認」並列出疑問，由工程師補充後再完成剩餘部分。最終輸出的 openapi.yaml 可直接匯入 Postman 與 Swagger UI，新進工程師上手時間從兩週縮短為三天。

# 範例指令
"掃描 src/routes/ 所有端點，生成 JSDoc 注釋與 OpenAPI 3.0 規格，
 遇到邏輯不清的地方請標記並提問，不要自行猜測。"

案例 6：資料庫 Migration 安全執行

電商平台訂單表需新增多個欄位並調整索引，資料量逾三千萬筆，直接執行 DDL 可能造成長時間鎖表影響線上服務。工程師描述需求與現有 schema，請 Claude Code 規劃零停機 migration 策略。Claude Code 提出「先加欄位（允許 NULL）→ 背景填值 → 加非空約束 → 刪舊欄位」的分階段方案，自動生成每個階段的 SQL 腳本與回滾腳本，並附上預估鎖定時間與監控指標。工程師在預備環境驗證後執行，整個 migration 在業務低峰期順利完成，期間服務可用率維持 99.98%。

# 範例指令
"訂單表有三千萬筆資料，需新增三個欄位並調整複合索引，
 請規劃零停機 migration 策略，生成分階段 SQL 與回滾腳本。"

案例 7：效能優化（API 回應從 4.2 秒降至 180 毫秒）

使用者回報商品列表頁載入緩慢，APM 顯示某支 API 平均回應時間 4.2 秒，但程式碼乍看無異常。工程師將 API 實作、ORM 查詢與 APM 火焰圖截圖提供給 Claude Code。Claude Code 分析後發現三個問題：N+1 查詢、未命中快取的重複計算、以及在迴圈內重複建立資料庫連線。Claude Code 依影響程度排序，提出加入 eager loading、引入 Redis 快取計算結果、以及連線池設定的具體修改，並在每項修改後附上預期改善幅度。套用所有優化後實測回應時間降至 180 毫秒，P99 延遲從 8 秒降至 420 毫秒。

# 範例指令
"以下是慢查詢 API 的實作與 APM 火焰圖，
 請找出效能瓶頸並依影響程度排序，提出具體優化方案與預期改善幅度。"

案例 8：Legacy 程式碼理解與安全現代化

十年前以 PHP 5.6 撰寫的核心模組仍在線上運行，原始作者已離職，程式碼幾乎無注釋，新成員不敢輕易改動。工程師請 Claude Code 閱讀整個模組，輸出「業務流程圖」、「函式呼叫樹」與「已知風險清單」，再逐步協助現代化。Claude Code 先生成可讀的 Mermaid 流程圖與函式依賴圖，標記出使用已廢棄 API、SQL injection 風險與硬編碼密鑰等問題，再依風險等級提出改寫優先序。工程師按建議分批改寫，每批改動均由 Claude Code 補充回歸測試，六週後模組完成現代化，安全掃描漏洞數從 17 個降至零。

# 範例指令
"請閱讀 legacy/ 模組，輸出業務流程圖、函式呼叫樹與風險清單，
 再依風險等級建議現代化優先序，不要急著改動程式碼。"

你可以直接複製的實作模板

1) 先描述目標、限制、驗收條件
2) 要求列出受影響檔案與風險
3) 指定先做最小可行改動
4) 執行必要檢查命令並回報結果
5) 若失敗，要求提出修正與再次驗證