教學
在開發工作流程中有效使用 Claude Code 的實用範例和模式。
本指南提供使用 Claude Code 常見工作流程的逐步教學。每個教學都包含清晰的說明、範例命令和最佳實踐,幫助您充分利用 Claude Code。
目錄
- 繼續先前的對話
- 理解新的程式碼庫
- 有效修復錯誤
- 重構程式碼
- 處理測試
- 建立拉取請求
- 處理文件
- 處理圖片
- 使用延伸思考
- 設定專案記憶
- 設定模型上下文協定 (MCP)
- 將 Claude 作為類 Unix 工具使用
- 建立自訂斜線命令
- 使用 Git 工作樹執行平行 Claude Code 工作階段
繼續先前的對話
無縫繼續您的工作
使用時機: 您已經使用 Claude Code 處理某項任務,需要在稍後的工作階段繼續進行。
Claude Code 提供兩個選項來繼續先前的對話:
--continue
自動繼續最近的對話--resume
顯示對話選擇器
繼續最近的對話
這會立即繼續您最近的對話,不需任何提示。
以非互動模式繼續
使用 --print
和 --continue
在非互動模式下繼續最近的對話,非常適合腳本或自動化。
顯示對話選擇器
這會顯示一個互動式對話選擇器,顯示:
- 對話開始時間
- 初始提示或對話摘要
- 訊息數量
使用方向鍵導航並按 Enter 選擇對話。
運作方式:
- 對話儲存: 所有對話都會自動儲存在本機,包含完整的訊息歷史記錄
- 訊息反序列化: 繼續時,會還原整個訊息歷史記錄以維持上下文
- 工具狀態: 保留先前對話中的工具使用和結果
- 上下文還原: 對話會在保留所有先前上下文的情況下繼續
提示:
- 對話歷史記錄儲存在您的本機
- 使用
--continue
快速存取最近的對話 - 需要選擇特定過去對話時使用
--resume
- 繼續時,您會在繼續之前看到整個對話歷史記錄
- 繼續的對話會使用與原始對話相同的模型和設定
範例:
理解新的程式碼庫
快速了解程式碼庫概況
使用時機: 您剛加入新專案,需要快速了解其結構。
導航至專案根目錄
啟動 Claude Code
請求高層級概述
深入了解特定元件
提示:
- 從廣泛的問題開始,然後縮小到特定領域
- 詢問專案中使用的編碼慣例和模式
- 請求專案特定術語的詞彙表
尋找相關程式碼
使用時機: 您需要找到與特定功能或功能相關的程式碼。
請 Claude 尋找相關檔案
了解元件之間的互動
了解執行流程
提示:
- 明確說明您在尋找什麼
- 使用專案中的領域語言
有效修復錯誤
診斷錯誤訊息
使用時機: 您遇到錯誤訊息,需要找出並修復其來源。
與 Claude 分享錯誤
請求修復建議
套用修復
提示:
- 告訴 Claude 重現問題的命令並取得堆疊追蹤
- 提及重現錯誤的步驟
- 讓 Claude 知道錯誤是間歇性還是持續性的
重構程式碼
現代化舊程式碼
使用時機: 您需要更新舊程式碼以使用現代模式和實踐。
識別需要重構的舊程式碼
取得重構建議
安全地套用變更
驗證重構
提示:
- 請 Claude 解釋現代方法的好處
- 在需要時要求變更保持向後相容性
- 以小型、可測試的增量進行重構
處理測試
增加測試覆蓋率
使用時機: 您需要為未覆蓋的程式碼新增測試。
識別未測試的程式碼
產生測試框架
新增有意義的測試案例
執行並驗證測試
提示:
- 請求涵蓋邊緣案例和錯誤條件的測試
- 在適當時請求單元測試和整合測試
- 請 Claude 解釋測試策略
建立拉取請求
產生全面的 PR
使用時機: 您需要為您的變更建立一個文件完善的拉取請求。
總結您的變更
使用 Claude 產生 PR
檢視並改進
新增測試詳細資訊
提示:
- 直接請 Claude 為您建立 PR
- 在提交前檢視 Claude 產生的 PR
- 請 Claude 強調潛在風險或考慮事項
處理文件
產生程式碼文件
使用時機: 您需要為您的程式碼新增或更新文件。
識別未文件化的程式碼
產生文件
檢視並改進
驗證文件
提示:
- 指定您想要的文件風格(JSDoc、docstrings 等)
- 在文件中請求範例
- 請求公開 API、介面和複雜邏輯的文件
處理圖片
分析圖片和螢幕截圖
使用時機: 您需要處理程式碼庫中的圖片或取得 Claude 的圖片內容分析協助。
將圖片新增到對話中
您可以使用以下任何方法:
- 將圖片拖放到 Claude Code 視窗中
- 複製圖片並使用 cmd+v (在 Mac 上)貼到 CLI 中
- 提供圖片路徑 claude “Analyze this image: /path/to/your/image.png”
請 Claude 分析圖片
使用圖片作為上下文
從視覺內容取得程式碼建議
提示:
- 當文字描述不清楚或繁瑣時使用圖片
- 包含錯誤、UI 設計或圖表的螢幕截圖以提供更好的上下文
- 您可以在一個對話中處理多個圖片
- 圖片分析適用於圖表、螢幕截圖、模型等
使用延伸思考
利用 Claude 的延伸思考處理複雜任務
使用時機: 當處理複雜的架構決策、具有挑戰性的錯誤或需要深入推理的多步驟實作規劃時。
提供上下文並請 Claude 思考
Claude 會從您的程式碼庫收集相關資訊並使用延伸思考,這將在介面中可見。
使用後續提示改進思考
如何充分利用延伸思考的提示:
延伸思考最適合用於複雜任務,例如:
- 規劃複雜的架構變更
- 除錯複雜問題
- 為新功能建立實作計畫
- 理解複雜的程式碼庫
- 評估不同方法之間的權衡
提示思考的方式會產生不同程度的思考深度:
- “think” 觸發基本延伸思考
- 加強語句如 “think more”、“think a lot”、“think harder” 或 “think longer” 觸發更深入的思考
如需更多延伸思考提示技巧,請參閱延伸思考提示。
Claude 會在回應上方以斜體灰色文字顯示其思考過程。
設定專案記憶
建立有效的 CLAUDE.md 檔案
使用時機: 您想要設定 CLAUDE.md 檔案來儲存重要的專案資訊、慣例和常用命令。
為您的程式碼庫建立 CLAUDE.md
提示:
- 包含常用命令(建置、測試、lint)以避免重複搜尋
- 記錄程式碼風格偏好和命名慣例
- 新增專案特定的重要架構模式
- CLAUDE.md 記憶可用於與團隊共享的指示和您的個人偏好。如需更多詳細資訊,請參閱管理 Claude 的記憶。
設定模型上下文協定 (MCP)
模型上下文協定 (MCP) 是一個開放協定,使 LLM 能夠存取外部工具和資料來源。如需更多詳細資訊,請參閱 MCP 文件。
使用第三方 MCP 伺服器時請自行承擔風險。請確保您信任 MCP 伺服器,並特別注意使用與網際網路通訊的 MCP 伺服器,因為這些可能使您暴露於提示注入風險。
設定 MCP 伺服器
使用時機: 您想要使用模型上下文協定連接專門工具和外部伺服器來增強 Claude 的功能。
新增 MCP Stdio 伺服器
新增 MCP SSE 伺服器
管理您的 MCP 伺服器
提示:
- 使用
-s
或--scope
標記指定設定儲存位置:local
(預設): 僅在目前專案中供您使用(在舊版中稱為project
)project
: 透過.mcp.json
檔案與專案中的所有人共享user
: 在所有專案中供您使用(在舊版中稱為global
)
- 使用
-e
或--env
標記設定環境變數(例如-e KEY=value
) - 使用 MCP_TIMEOUT 環境變數設定 MCP 伺服器啟動逾時(例如
MCP_TIMEOUT=10000 claude
設定 10 秒逾時) - 隨時使用
/mcp
命令檢查 MCP 伺服器狀態 - MCP 遵循客戶端-伺服器架構,其中 Claude Code(客戶端)可以連接到多個專門伺服器
了解 MCP 伺服器範圍
使用時機: 您想要了解不同 MCP 範圍的運作方式以及如何與團隊共享伺服器。
本機範圍 MCP 伺服器
預設範圍(local
)將 MCP 伺服器設定儲存在您的專案特定使用者設定中。這些伺服器僅在您處理目前專案時可用。
專案範圍 MCP 伺服器(.mcp.json)
專案範圍伺服器儲存在專案根目錄的 .mcp.json
檔案中。此檔案應該簽入版本控制以與團隊共享伺服器。
這會建立或更新具有以下結構的 .mcp.json
檔案:
使用者範圍 MCP 伺服器
使用者範圍伺服器在您機器上的所有專案中都可用,並且是您的私人伺服器。
提示:
- 本機範圍伺服器優先於具有相同名稱的專案範圍和使用者範圍伺服器
- 專案範圍伺服器(在
.mcp.json
中)優先於具有相同名稱的使用者範圍伺服器 - 在使用
.mcp.json
中的專案範圍伺服器之前,Claude Code 會提示您核准以確保安全 .mcp.json
檔案旨在簽入版本控制以與團隊共享 MCP 伺服器- 專案範圍伺服器可以輕鬆確保團隊中的每個人都能存取相同的 MCP 工具
- 如果您需要重設已啟用或停用的專案範圍伺服器選擇,請使用
claude mcp reset-project-choices
命令
連接到 Postgres MCP 伺服器
使用時機: 您想要給予 Claude 對 PostgreSQL 資料庫的唯讀存取權以進行查詢和結構描述檢查。
新增 Postgres MCP 伺服器
使用 Claude 查詢您的資料庫
提示:
- Postgres MCP 伺服器為了安全提供唯讀存取
- Claude 可以幫助您探索資料庫結構並執行分析查詢
- 您可以使用這個功能快速了解不熟悉專案中的資料庫結構描述
- 確保您的連接字串使用具有最低所需權限的適當憑證
從 JSON 設定新增 MCP 伺服器
使用時機: 您有單一 MCP 伺服器的 JSON 設定,想要將其新增到 Claude Code。
從 JSON 新增 MCP 伺服器
驗證伺服器已新增
提示:
- 確保 JSON 在您的 shell 中正確轉義
- JSON 必須符合 MCP 伺服器設定結構描述
- 您可以使用
-s global
將伺服器新增到您的全域設定而不是專案特定設定
從 Claude Desktop 匯入 MCP 伺服器
使用時機: 您已經在 Claude Desktop 中設定了 MCP 伺服器,想要在 Claude Code 中使用相同的伺服器而不需要手動重新設定。
從 Claude Desktop 匯入伺服器
選擇要匯入的伺服器
執行命令後,您會看到一個互動式對話框,讓您選擇要匯入的伺服器。
驗證伺服器已匯入
提示:
- 此功能僅適用於 macOS 和 Windows Subsystem for Linux (WSL)
- 它從這些平台上的標準位置讀取 Claude Desktop 設定檔
- 使用
-s global
標記將伺服器新增到您的全域設定 - 匯入的伺服器將與 Claude Desktop 中的名稱相同
- 如果已存在相同名稱的伺服器,它們會獲得數字後綴(例如
server_1
)
將 Claude Code 用作 MCP 伺服器
使用時機: 您想要將 Claude Code 本身用作 MCP 伺服器,讓其他應用程式可以連接並使用 Claude 的工具和功能。
將 Claude 啟動為 MCP 伺服器
從其他應用程式連接
您可以從任何 MCP 客戶端(如 Claude Desktop)連接到 Claude Code MCP 伺服器。如果您使用 Claude Desktop,可以使用此設定新增 Claude Code MCP 伺服器:
提示:
- 伺服器提供對 Claude 工具的存取,如 View、Edit、LS 等
- 在 Claude Desktop 中,嘗試請求 Claude 讀取目錄中的檔案、進行編輯等
- 請注意,此 MCP 伺服器只是將 Claude Code 的工具公開給您的 MCP 客戶端,因此您自己的客戶端負責實作個別工具呼叫的使用者確認
將 Claude 用作類 Unix 工具
將 Claude 新增到您的驗證流程
使用時機: 您想要將 Claude Code 用作 linter 或程式碼審查者。
步驟:
將 Claude 新增到您的建置腳本
管道輸入,管道輸出
使用時機: 您想要將資料管道輸入到 Claude,並以結構化格式取回資料。
透過 Claude 管道傳輸資料
控制輸出格式
使用時機: 您需要特定格式的 Claude 輸出,特別是在將 Claude Code 整合到腳本或其他工具時。
使用文字格式(預設)
這只輸出 Claude 的純文字回應(預設行為)。
使用 JSON 格式
這輸出一個包含成本和持續時間等中繼資料的 JSON 訊息陣列。
使用串流 JSON 格式
這在 Claude 處理請求時即時輸出一系列 JSON 物件。每個訊息都是有效的 JSON 物件,但如果串聯整個輸出則不是有效的 JSON。
提示:
- 當您只需要 Claude 的回應時使用
--output-format text
- 當您需要完整的對話記錄時使用
--output-format json
- 當您需要每個對話回合的即時輸出時使用
--output-format stream-json
建立自訂斜線命令
Claude Code 支援您可以建立的自訂斜線命令,以快速執行特定提示或任務。
建立專案特定命令
使用時機: 您想要為您的專案建立可重複使用的斜線命令,供所有團隊成員使用。
在您的專案中建立命令目錄
為每個命令建立 Markdown 檔案
在 Claude Code 中使用您的自訂命令
提示:
- 命令名稱衍生自檔案名稱(例如
optimize.md
變成/project:optimize
) - 您可以在子目錄中組織命令(例如
.claude/commands/frontend/component.md
變成/project:frontend:component
) - 專案命令可供克隆存放庫的每個人使用
- Markdown 檔案內容在呼叫命令時成為發送給 Claude 的提示
使用 $ARGUMENTS 新增命令引數
使用時機: 您想要建立可以接受使用者額外輸入的靈活斜線命令。
建立具有 $ARGUMENTS 預留位置的命令檔案
使用問題編號使用命令
這會在提示中將 $ARGUMENTS 替換為 “123”。
提示:
- $ARGUMENTS 預留位置會被命令後面的任何文字替換
- 您可以將 $ARGUMENTS 放在命令範本中的任何位置
- 其他有用的應用:為特定函數產生測試案例、為元件建立文件、審查特定檔案中的程式碼或將內容翻譯成指定語言
建立個人斜線命令
使用時機: 您想要建立可在所有專案中使用的個人斜線命令。
在您的主目錄中建立命令目錄
為每個命令建立 Markdown 檔案
使用您的個人自訂命令
提示:
- 個人命令以
/user:
而不是/project:
為前綴 - 個人命令只供您使用,不與團隊共享
- 個人命令在所有專案中都可使用
- 您可以使用這些命令在不同的程式碼庫中保持一致的工作流程
使用 Git 工作樹執行平行 Claude Code 工作階段
使用工作樹建立隔離的編碼環境
使用時機: 您需要同時處理多個任務,並在 Claude Code 實例之間完全隔離程式碼。
了解 Git 工作樹
Git 工作樹允許您將相同存放庫的多個分支簽出到不同的目錄。每個工作樹都有自己的獨立工作目錄和檔案,同時共享相同的 Git 歷史記錄。在官方 Git 工作樹文件中了解更多。
建立新的工作樹
這會建立一個具有存放庫獨立工作副本的新目錄。
在每個工作樹中執行 Claude Code
在另一個終端中:
管理您的工作樹
提示:
- 每個工作樹都有自己獨立的檔案狀態,非常適合平行 Claude Code 工作階段
- 在一個工作樹中進行的變更不會影響其他工作樹,防止 Claude 實例相互干擾
- 所有工作樹共享相同的 Git 歷史記錄和遠端連接
- 對於長時間執行的任務,您可以讓 Claude 在一個工作樹中工作,同時您在另一個工作樹中繼續開發
- 使用描述性目錄名稱以輕鬆識別每個工作樹的用途
- 記得根據您專案的設定在每個新工作樹中初始化您的開發環境。根據您的技術堆疊,這可能包括:
- JavaScript 專案:執行相依性安裝(
npm install
、yarn
) - Python 專案:設定虛擬環境或使用套件管理器安裝
- 其他語言:遵循您專案的標準設定流程
- JavaScript 專案:執行相依性安裝(
後續步驟
Claude Code 參考實作
克隆我們的開發容器參考實作。
Was this page helpful?