載入中

實戰中的 Claude Code

第 59 課6 分鐘
載入中

Claude Code 不僅僅是一個用於寫程式碼的工具——它被設計為在軟體專案的每個階段都能與您並肩工作。把它想像成團隊中的另一位工程師,能夠處理從初始設置到部署與支援的一切事務。

五個專案階段:發現、設計、建構、部署和「支援與擴展」,每個階段各有三項 Claude Code 任務。

/init 指令

當您開始在專案中使用 Claude Code 時,您要做的第一件事就是執行 /init 指令。這會告訴 Claude 掃描您整個程式碼庫,理解您專案的結構、相依項目、編碼風格與架構。

Claude 會將其學到的所有內容總結在一個名為 CLAUDE.md 的特殊檔案中。這個檔案會自動被包含在所有未來對話的上下文中,因此 Claude 會記住關於您專案的重要細節。

您可以為不同範圍建立多個 CLAUDE.md 檔案:

  • 專案(Project)——在所有參與該專案的工程師之間共享
  • 本機(Local)——您個人的筆記,不會提交到 git
  • 使用者(User)——用於您所有的專案

執行 /init 時,您可以加入特殊指示,說明您希望 Claude 關注的領域。所產生的檔案將包含建構指令、編碼準則,以及 Claude 應遵循的專案特定模式。

Claude Code 終端機輸入了「/init」,並顯示建議「Initialize a new CLAUDE.md file with codebase documentation」。

您也可以使用 # 指令快速將筆記加入您的 CLAUDE.md 檔案。例如,輸入 # Always use descriptive variable names 會提示您將這項準則加入到專案、本機或使用者記憶中。

常見工作流程

當您把 Claude 當作效率倍增器來運用時,它的效果最好。您提供的上下文和結構越多,得到的結果就越好。以下是最有效的工作流程:

三步驟工作流程:將上下文餵給 Claude,要求它規劃解決方案,然後要求它實作,詳述於下方。

第 1 步:將上下文餵給 Claude

在要求 Claude 建構某項功能之前,先找出您程式碼庫中與您想建立的功能相關的檔案。先請 Claude 讀取並分析這些檔案。這能讓 Claude 獲得您編碼模式的範例,以及它可以在其基礎上建構的現有功能。

第 2 步:要求 Claude 規劃解決方案

不要直接跳到實作階段,而是請 Claude 仔細思考問題並制定計畫。明確告訴 Claude 先不要撰寫任何程式碼——只需專注於所需的做法和步驟。

第 3 步:要求 Claude 實作解決方案

一旦您有了紮實的計畫,就請 Claude 實作它。Claude 會根據您們已經一起完成的上下文和規劃工作來撰寫程式碼。

測試驅動開發工作流程

為了獲得更好的結果,您可以採用測試驅動的做法:

VS Code 中的 Claude Code 終端機輸入了 /clear,其說明顯示為「Clear conversation history and free up context」。

  1. 將上下文餵給 Claude——和之前一樣,向 Claude 展示相關檔案
  2. 要求 Claude 思考測試案例——讓 Claude 腦力激盪,思考哪些測試能驗證您的新功能
  3. 要求 Claude 實作這些測試——選擇最相關的測試,並讓 Claude 撰寫它們
  4. 要求 Claude 撰寫能通過測試的程式碼——Claude 會反覆修改實作,直到所有測試都通過

這種做法通常能產生更穩健的程式碼,因為 Claude 有明確的成功標準可以努力達成。

實際範例

以下是這些工作流程在實務中的運作方式。假設您想為一個現有專案加入文件轉換工具:

// First, ask Claude to read relevant files
> Read the math.py and document.py files

// Then ask for planning (not implementation)
> Plan to implement document_path_to_markdown tool:
1. Create a function that:
   - Takes a file path parameter
   - Validates the file exists  
   - Determines file type from extension
   - Reads binary data from file
   - Leverages existing binary_document_to_markdown function
   - Returns markdown string
2. Add appropriate documentation
3. Register the tool with MCP server
4. Add tests

// Finally, ask for implementation
> Implement the plan

接著 Claude 會建立該函式、更新必要的檔案、撰寫測試,甚至執行測試套件以驗證一切運作正常。

其他指令

Claude Code 包含幾個實用的指令:

  • /clear - 清除對話歷史並重置上下文
  • /init - 掃描程式碼庫並建立 CLAUDE.md 文件
  • # - 將筆記加入您的 CLAUDE.md 檔案

Claude 也能處理例行的開發任務,例如將變更加入暫存並提交到 git、執行測試以及管理相依項目。您不必在編輯器和終端機之間來回切換,而是可以請 Claude 處理這些任務,讓您專注於大局。

成功運用 Claude Code 的關鍵在於,要記得它被設計為一個協作夥伴,而不只是一個程式碼產生器。您提供的上下文和結構越多,Claude 就能越有效地幫助您建構與維護您的專案。