本指南提供使用 Claude Code 常見工作流程的逐步教學。每個教學都包含清晰的說明、範例命令和最佳實踐,幫助您充分利用 Claude Code。

目錄

繼續先前的對話

無縫繼續您的工作

使用時機: 您已經使用 Claude Code 處理某項任務,需要在稍後的工作階段繼續進行。

Claude Code 提供兩個選項來繼續先前的對話:

  • --continue 自動繼續最近的對話
  • --resume 顯示對話選擇器
1

繼續最近的對話

claude --continue

這會立即繼續您最近的對話,不需任何提示。

2

以非互動模式繼續

claude --continue --print "Continue with my task"

使用 --print--continue 在非互動模式下繼續最近的對話,非常適合腳本或自動化。

3

顯示對話選擇器

claude --resume

這會顯示一個互動式對話選擇器,顯示:

  • 對話開始時間
  • 初始提示或對話摘要
  • 訊息數量

使用方向鍵導航並按 Enter 選擇對話。

運作方式:

  1. 對話儲存: 所有對話都會自動儲存在本機,包含完整的訊息歷史記錄
  2. 訊息反序列化: 繼續時,會還原整個訊息歷史記錄以維持上下文
  3. 工具狀態: 保留先前對話中的工具使用和結果
  4. 上下文還原: 對話會在保留所有先前上下文的情況下繼續

提示:

  • 對話歷史記錄儲存在您的本機
  • 使用 --continue 快速存取最近的對話
  • 需要選擇特定過去對話時使用 --resume
  • 繼續時,您會在繼續之前看到整個對話歷史記錄
  • 繼續的對話會使用與原始對話相同的模型和設定

範例:

# 繼續最近的對話
claude --continue

# 使用特定提示繼續最近的對話
claude --continue --print "Show me our progress"

# 顯示對話選擇器
claude --resume

# 以非互動模式繼續最近的對話
claude --continue --print "Run the tests again"

理解新的程式碼庫

快速了解程式碼庫概況

使用時機: 您剛加入新專案,需要快速了解其結構。

1

導航至專案根目錄

cd /path/to/project 
2

啟動 Claude Code

claude 
3

請求高層級概述

> give me an overview of this codebase 
4

深入了解特定元件

> explain the main architecture patterns used here 
> what are the key data models?
> how is authentication handled?

提示:

  • 從廣泛的問題開始,然後縮小到特定領域
  • 詢問專案中使用的編碼慣例和模式
  • 請求專案特定術語的詞彙表

尋找相關程式碼

使用時機: 您需要找到與特定功能或功能相關的程式碼。

1

請 Claude 尋找相關檔案

> find the files that handle user authentication 
2

了解元件之間的互動

> how do these authentication files work together? 
3

了解執行流程

> trace the login process from front-end to database 

提示:

  • 明確說明您在尋找什麼
  • 使用專案中的領域語言

有效修復錯誤

診斷錯誤訊息

使用時機: 您遇到錯誤訊息,需要找出並修復其來源。

1

與 Claude 分享錯誤

> I'm seeing an error when I run npm test 
2

請求修復建議

> suggest a few ways to fix the @ts-ignore in user.ts 
3

套用修復

> update user.ts to add the null check you suggested 

提示:

  • 告訴 Claude 重現問題的命令並取得堆疊追蹤
  • 提及重現錯誤的步驟
  • 讓 Claude 知道錯誤是間歇性還是持續性的

重構程式碼

現代化舊程式碼

使用時機: 您需要更新舊程式碼以使用現代模式和實踐。

1

識別需要重構的舊程式碼

> find deprecated API usage in our codebase 
2

取得重構建議

> suggest how to refactor utils.js to use modern JavaScript features 
3

安全地套用變更

> refactor utils.js to use ES2024 features while maintaining the same behavior 
4

驗證重構

> run tests for the refactored code 

提示:

  • 請 Claude 解釋現代方法的好處
  • 在需要時要求變更保持向後相容性
  • 以小型、可測試的增量進行重構

處理測試

增加測試覆蓋率

使用時機: 您需要為未覆蓋的程式碼新增測試。

1

識別未測試的程式碼

> find functions in NotificationsService.swift that are not covered by tests 
2

產生測試框架

> add tests for the notification service 
3

新增有意義的測試案例

> add test cases for edge conditions in the notification service 
4

執行並驗證測試

> run the new tests and fix any failures 

提示:

  • 請求涵蓋邊緣案例和錯誤條件的測試
  • 在適當時請求單元測試和整合測試
  • 請 Claude 解釋測試策略

建立拉取請求

產生全面的 PR

使用時機: 您需要為您的變更建立一個文件完善的拉取請求。

1

總結您的變更

> summarize the changes I've made to the authentication module 
2

使用 Claude 產生 PR

> create a pr 
3

檢視並改進

> enhance the PR description with more context about the security improvements 
4

新增測試詳細資訊

> add information about how these changes were tested 

提示:

  • 直接請 Claude 為您建立 PR
  • 在提交前檢視 Claude 產生的 PR
  • 請 Claude 強調潛在風險或考慮事項

處理文件

產生程式碼文件

使用時機: 您需要為您的程式碼新增或更新文件。

1

識別未文件化的程式碼

> find functions without proper JSDoc comments in the auth module 
2

產生文件

> add JSDoc comments to the undocumented functions in auth.js 
3

檢視並改進

> improve the generated documentation with more context and examples 
4

驗證文件

> check if the documentation follows our project standards 

提示:

  • 指定您想要的文件風格(JSDoc、docstrings 等)
  • 在文件中請求範例
  • 請求公開 API、介面和複雜邏輯的文件

處理圖片

分析圖片和螢幕截圖

使用時機: 您需要處理程式碼庫中的圖片或取得 Claude 的圖片內容分析協助。

1

將圖片新增到對話中

您可以使用以下任何方法:

  1. 將圖片拖放到 Claude Code 視窗中
  2. 複製圖片並使用 cmd+v (在 Mac 上)貼到 CLI 中
  3. 提供圖片路徑 claude “Analyze this image: /path/to/your/image.png”
2

請 Claude 分析圖片

> What does this image show? 
> Describe the UI elements in this screenshot 
> Are there any problematic elements in this diagram? 
3

使用圖片作為上下文

> Here's a screenshot of the error. What's causing it? 
> This is our current database schema. How should we modify it for the new feature? 
4

從視覺內容取得程式碼建議

> Generate CSS to match this design mockup 
> What HTML structure would recreate this component? 

提示:

  • 當文字描述不清楚或繁瑣時使用圖片
  • 包含錯誤、UI 設計或圖表的螢幕截圖以提供更好的上下文
  • 您可以在一個對話中處理多個圖片
  • 圖片分析適用於圖表、螢幕截圖、模型等

使用延伸思考

利用 Claude 的延伸思考處理複雜任務

使用時機: 當處理複雜的架構決策、具有挑戰性的錯誤或需要深入推理的多步驟實作規劃時。

1

提供上下文並請 Claude 思考

> I need to implement a new authentication system using OAuth2 for our API. Think deeply about the best approach for implementing this in our codebase. 

Claude 會從您的程式碼庫收集相關資訊並使用延伸思考,這將在介面中可見。

2

使用後續提示改進思考

> think about potential security vulnerabilities in this approach 
> think harder about edge cases we should handle 

如何充分利用延伸思考的提示:

延伸思考最適合用於複雜任務,例如:

  • 規劃複雜的架構變更
  • 除錯複雜問題
  • 為新功能建立實作計畫
  • 理解複雜的程式碼庫
  • 評估不同方法之間的權衡

提示思考的方式會產生不同程度的思考深度:

  • “think” 觸發基本延伸思考
  • 加強語句如 “think more”、“think a lot”、“think harder” 或 “think longer” 觸發更深入的思考

如需更多延伸思考提示技巧,請參閱延伸思考提示

Claude 會在回應上方以斜體灰色文字顯示其思考過程。


設定專案記憶

建立有效的 CLAUDE.md 檔案

使用時機: 您想要設定 CLAUDE.md 檔案來儲存重要的專案資訊、慣例和常用命令。

1

為您的程式碼庫建立 CLAUDE.md

> /init 

提示:

  • 包含常用命令(建置、測試、lint)以避免重複搜尋
  • 記錄程式碼風格偏好和命名慣例
  • 新增專案特定的重要架構模式
  • CLAUDE.md 記憶可用於與團隊共享的指示和您的個人偏好。如需更多詳細資訊,請參閱管理 Claude 的記憶

設定模型上下文協定 (MCP)

模型上下文協定 (MCP) 是一個開放協定,使 LLM 能夠存取外部工具和資料來源。如需更多詳細資訊,請參閱 MCP 文件

使用第三方 MCP 伺服器時請自行承擔風險。請確保您信任 MCP 伺服器,並特別注意使用與網際網路通訊的 MCP 伺服器,因為這些可能使您暴露於提示注入風險。

設定 MCP 伺服器

使用時機: 您想要使用模型上下文協定連接專門工具和外部伺服器來增強 Claude 的功能。

1

新增 MCP Stdio 伺服器

# 基本語法
claude mcp add <name> <command> [args...]

# 範例:新增本機伺服器
claude mcp add my-server -e API_KEY=123 -- /path/to/server arg1 arg2
2

新增 MCP SSE 伺服器

# 基本語法
claude mcp add --transport sse <name> <url>

# 範例:新增 SSE 伺服器
claude mcp add --transport sse sse-server https://example.com/sse-endpoint
3

管理您的 MCP 伺服器

# 列出所有已設定的伺服器
claude mcp list

# 取得特定伺服器的詳細資訊
claude mcp get my-server

# 移除伺服器
claude mcp remove my-server

提示:

  • 使用 -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 範圍的運作方式以及如何與團隊共享伺服器。

1

本機範圍 MCP 伺服器

預設範圍(local)將 MCP 伺服器設定儲存在您的專案特定使用者設定中。這些伺服器僅在您處理目前專案時可用。

# 新增本機範圍伺服器(預設)
claude mcp add my-private-server /path/to/server

# 明確指定本機範圍
claude mcp add my-private-server -s local /path/to/server
2

專案範圍 MCP 伺服器(.mcp.json)

專案範圍伺服器儲存在專案根目錄的 .mcp.json 檔案中。此檔案應該簽入版本控制以與團隊共享伺服器。

# 新增專案範圍伺服器
claude mcp add shared-server -s project /path/to/server

這會建立或更新具有以下結構的 .mcp.json 檔案:

{
  "mcpServers": {
    "shared-server": {
      "command": "/path/to/server",
      "args": [],
      "env": {}
    }
  }
}
3

使用者範圍 MCP 伺服器

使用者範圍伺服器在您機器上的所有專案中都可用,並且是您的私人伺服器。

# 新增使用者伺服器
claude mcp add my-user-server -s user /path/to/server

提示:

  • 本機範圍伺服器優先於具有相同名稱的專案範圍和使用者範圍伺服器
  • 專案範圍伺服器(在 .mcp.json 中)優先於具有相同名稱的使用者範圍伺服器
  • 在使用 .mcp.json 中的專案範圍伺服器之前,Claude Code 會提示您核准以確保安全
  • .mcp.json 檔案旨在簽入版本控制以與團隊共享 MCP 伺服器
  • 專案範圍伺服器可以輕鬆確保團隊中的每個人都能存取相同的 MCP 工具
  • 如果您需要重設已啟用或停用的專案範圍伺服器選擇,請使用 claude mcp reset-project-choices 命令

連接到 Postgres MCP 伺服器

使用時機: 您想要給予 Claude 對 PostgreSQL 資料庫的唯讀存取權以進行查詢和結構描述檢查。

1

新增 Postgres MCP 伺服器

claude mcp add postgres-server /path/to/postgres-mcp-server --connection-string "postgresql://user:pass@localhost:5432/mydb"
2

使用 Claude 查詢您的資料庫

# 在您的 Claude 工作階段中,您可以詢問有關您的資料庫的問題

> describe the schema of our users table
> what are the most recent orders in the system?
> show me the relationship between customers and invoices

提示:

  • Postgres MCP 伺服器為了安全提供唯讀存取
  • Claude 可以幫助您探索資料庫結構並執行分析查詢
  • 您可以使用這個功能快速了解不熟悉專案中的資料庫結構描述
  • 確保您的連接字串使用具有最低所需權限的適當憑證

從 JSON 設定新增 MCP 伺服器

使用時機: 您有單一 MCP 伺服器的 JSON 設定,想要將其新增到 Claude Code。

1

從 JSON 新增 MCP 伺服器

# 基本語法
claude mcp add-json <name> '<json>'

# 範例:使用 JSON 設定新增 stdio 伺服器
claude mcp add-json weather-api '{"type":"stdio","command":"/path/to/weather-cli","args":["--api-key","abc123"],"env":{"CACHE_DIR":"/tmp"}}'
2

驗證伺服器已新增

claude mcp get weather-api

提示:

  • 確保 JSON 在您的 shell 中正確轉義
  • JSON 必須符合 MCP 伺服器設定結構描述
  • 您可以使用 -s global 將伺服器新增到您的全域設定而不是專案特定設定

從 Claude Desktop 匯入 MCP 伺服器

使用時機: 您已經在 Claude Desktop 中設定了 MCP 伺服器,想要在 Claude Code 中使用相同的伺服器而不需要手動重新設定。

1

從 Claude Desktop 匯入伺服器

# 基本語法 
claude mcp add-from-claude-desktop 
2

選擇要匯入的伺服器

執行命令後,您會看到一個互動式對話框,讓您選擇要匯入的伺服器。

3

驗證伺服器已匯入

claude mcp list 

提示:

  • 此功能僅適用於 macOS 和 Windows Subsystem for Linux (WSL)
  • 它從這些平台上的標準位置讀取 Claude Desktop 設定檔
  • 使用 -s global 標記將伺服器新增到您的全域設定
  • 匯入的伺服器將與 Claude Desktop 中的名稱相同
  • 如果已存在相同名稱的伺服器,它們會獲得數字後綴(例如 server_1)

將 Claude Code 用作 MCP 伺服器

使用時機: 您想要將 Claude Code 本身用作 MCP 伺服器,讓其他應用程式可以連接並使用 Claude 的工具和功能。

1

將 Claude 啟動為 MCP 伺服器

# 基本語法
claude mcp serve
2

從其他應用程式連接

您可以從任何 MCP 客戶端(如 Claude Desktop)連接到 Claude Code MCP 伺服器。如果您使用 Claude Desktop,可以使用此設定新增 Claude Code MCP 伺服器:

{
  "command": "claude",
  "args": ["mcp", "serve"],
  "env": {}
}

提示:

  • 伺服器提供對 Claude 工具的存取,如 View、Edit、LS 等
  • 在 Claude Desktop 中,嘗試請求 Claude 讀取目錄中的檔案、進行編輯等
  • 請注意,此 MCP 伺服器只是將 Claude Code 的工具公開給您的 MCP 客戶端,因此您自己的客戶端負責實作個別工具呼叫的使用者確認

將 Claude 用作類 Unix 工具

將 Claude 新增到您的驗證流程

使用時機: 您想要將 Claude Code 用作 linter 或程式碼審查者。

步驟:

1

將 Claude 新增到您的建置腳本

// package.json
{
    ...
    "scripts": {
        ...
        "lint:claude": "claude -p 'you are a linter. please look at the changes vs. main and report any issues related to typos. report the filename and line number on one line, and a description of the issue on the second line. do not return any other text.'"
    }
}

管道輸入,管道輸出

使用時機: 您想要將資料管道輸入到 Claude,並以結構化格式取回資料。

1

透過 Claude 管道傳輸資料

cat build-error.txt | claude -p 'concisely explain the root cause of this build error' > output.txt

控制輸出格式

使用時機: 您需要特定格式的 Claude 輸出,特別是在將 Claude Code 整合到腳本或其他工具時。

1

使用文字格式(預設)

cat data.txt | claude -p 'summarize this data' --output-format text > summary.txt

這只輸出 Claude 的純文字回應(預設行為)。

2

使用 JSON 格式

cat code.py | claude -p 'analyze this code for bugs' --output-format json > analysis.json

這輸出一個包含成本和持續時間等中繼資料的 JSON 訊息陣列。

3

使用串流 JSON 格式

cat log.txt | claude -p 'parse this log file for errors' --output-format stream-json

這在 Claude 處理請求時即時輸出一系列 JSON 物件。每個訊息都是有效的 JSON 物件,但如果串聯整個輸出則不是有效的 JSON。

提示:

  • 當您只需要 Claude 的回應時使用 --output-format text
  • 當您需要完整的對話記錄時使用 --output-format json
  • 當您需要每個對話回合的即時輸出時使用 --output-format stream-json

建立自訂斜線命令

Claude Code 支援您可以建立的自訂斜線命令,以快速執行特定提示或任務。

建立專案特定命令

使用時機: 您想要為您的專案建立可重複使用的斜線命令,供所有團隊成員使用。

1

在您的專案中建立命令目錄

mkdir -p .claude/commands
2

為每個命令建立 Markdown 檔案

echo "Analyze the performance of this code and suggest three specific optimizations:" > .claude/commands/optimize.md 
3

在 Claude Code 中使用您的自訂命令

claude > /project:optimize 

提示:

  • 命令名稱衍生自檔案名稱(例如 optimize.md 變成 /project:optimize)
  • 您可以在子目錄中組織命令(例如 .claude/commands/frontend/component.md 變成 /project:frontend:component)
  • 專案命令可供克隆存放庫的每個人使用
  • Markdown 檔案內容在呼叫命令時成為發送給 Claude 的提示

使用 $ARGUMENTS 新增命令引數

使用時機: 您想要建立可以接受使用者額外輸入的靈活斜線命令。

1

建立具有 $ARGUMENTS 預留位置的命令檔案

echo "Find and fix issue #$ARGUMENTS. Follow these steps: 1.
Understand the issue described in the ticket 2. Locate the relevant code in
our codebase 3. Implement a solution that addresses the root cause 4. Add
appropriate tests 5. Prepare a concise PR description" >
.claude/commands/fix-issue.md 
2

使用問題編號使用命令

claude > /project:fix-issue 123 

這會在提示中將 $ARGUMENTS 替換為 “123”。

提示:

  • $ARGUMENTS 預留位置會被命令後面的任何文字替換
  • 您可以將 $ARGUMENTS 放在命令範本中的任何位置
  • 其他有用的應用:為特定函數產生測試案例、為元件建立文件、審查特定檔案中的程式碼或將內容翻譯成指定語言

建立個人斜線命令

使用時機: 您想要建立可在所有專案中使用的個人斜線命令。

1

在您的主目錄中建立命令目錄

mkdir -p ~/.claude/commands 
2

為每個命令建立 Markdown 檔案

echo "Review this code for security vulnerabilities, focusing on:" >
~/.claude/commands/security-review.md 
3

使用您的個人自訂命令

claude > /user:security-review 

提示:

  • 個人命令以 /user: 而不是 /project: 為前綴
  • 個人命令只供您使用,不與團隊共享
  • 個人命令在所有專案中都可使用
  • 您可以使用這些命令在不同的程式碼庫中保持一致的工作流程

使用 Git 工作樹執行平行 Claude Code 工作階段

使用工作樹建立隔離的編碼環境

使用時機: 您需要同時處理多個任務,並在 Claude Code 實例之間完全隔離程式碼。

1

了解 Git 工作樹

Git 工作樹允許您將相同存放庫的多個分支簽出到不同的目錄。每個工作樹都有自己的獨立工作目錄和檔案,同時共享相同的 Git 歷史記錄。在官方 Git 工作樹文件中了解更多。

2

建立新的工作樹

# 使用新分支建立新工作樹
git worktree add ../project-feature-a feature-a

# 或使用現有分支建立工作樹
git worktree add ../project-bugfix bugfix-123 

這會建立一個具有存放庫獨立工作副本的新目錄。

3

在每個工作樹中執行 Claude Code

# 導航到您的工作樹 
cd ../project-feature-a

# 在此隔離環境中執行 Claude Code
claude 
4

在另一個終端中:

cd ../project-bugfix
claude
5

管理您的工作樹

# 列出所有工作樹
git worktree list

# 完成後移除工作樹
git worktree remove ../project-feature-a 

提示:

  • 每個工作樹都有自己獨立的檔案狀態,非常適合平行 Claude Code 工作階段
  • 在一個工作樹中進行的變更不會影響其他工作樹,防止 Claude 實例相互干擾
  • 所有工作樹共享相同的 Git 歷史記錄和遠端連接
  • 對於長時間執行的任務,您可以讓 Claude 在一個工作樹中工作,同時您在另一個工作樹中繼續開發
  • 使用描述性目錄名稱以輕鬆識別每個工作樹的用途
  • 記得根據您專案的設定在每個新工作樹中初始化您的開發環境。根據您的技術堆疊,這可能包括:
    • JavaScript 專案:執行相依性安裝(npm installyarn)
    • Python 專案:設定虛擬環境或使用套件管理器安裝
    • 其他語言:遵循您專案的標準設定流程

後續步驟

Claude Code 參考實作

克隆我們的開發容器參考實作。

Was this page helpful?