常見工作流程

使用 Claude Code 探索程式碼庫、修復錯誤、重構、測試和其他日常任務的逐步指南。

本頁涵蓋日常開發的簡短食譜。如需更高層級的提示和背景資訊管理指導，請參閱最佳實踐。

本頁涵蓋：

提示食譜，用於探索程式碼、修復錯誤、重構、測試、PR 和文件
繼續之前的對話，以便任務可以跨越多個會話
使用 worktrees 執行平行會話，以便並行編輯不會衝突
編輯前規劃，以在變更觸及磁碟前檢查變更
將研究委派給 subagents，以保持主要背景資訊清潔
將 Claude 管道輸入指令碼，用於 CI 和批次處理

提示食譜

這些是日常任務的提示模式，例如探索陌生程式碼、除錯、重構、編寫測試和建立 PR。每個都可在任何 Claude Code 介面中工作；根據您的專案調整措辭。

了解新的程式碼庫

如需在 monorepo 或大型程式碼庫中配置 Claude Code，請參閱 Monorepos 和大型儲存庫。

快速取得程式碼庫概覽

假設您剛加入一個新專案，需要快速了解其結構。

導航到專案根目錄

cd /path/to/project

將 /path/to/project 替換為您專案的路徑。

啟動 Claude Code

claude

要求高層級概覽

give me an overview of this codebase

深入探討特定元件

explain the main architecture patterns used here

what are the key data models?

how is authentication handled?

尋找相關程式碼

假設您需要找到與特定功能或功能相關的程式碼。

要求 Claude 尋找相關檔案

find the files that handle user authentication

取得元件如何互動的背景資訊

how do these authentication files work together?

了解執行流程

trace the login process from front-end to database

有效地修復錯誤

假設您遇到了錯誤訊息，需要找到並修復其來源。

與 Claude 分享錯誤

I'm seeing an error when I run npm test

要求修復建議

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

應用修復

update user.ts to add the null check you suggested

重構程式碼

假設您需要更新舊程式碼以使用現代模式和實踐。

如需將整個程式碼庫移植到新語言，請參閱部落格上的Anthropic 如何使用 Claude Code 執行大規模程式碼遷移。

識別用於重構的舊版程式碼

find deprecated API usage in our codebase

取得重構建議

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

安全地應用變更

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

驗證重構

run tests for the refactored code

使用測試

假設您需要為未涵蓋的程式碼新增測試。

識別未測試的程式碼

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

產生測試框架

add tests for the notification service

新增有意義的測試案例

add test cases for edge conditions in the notification service

執行並驗證測試

run the new tests and fix any failures

Claude 可以產生遵循您專案現有模式和慣例的測試。要求測試時，請明確說明您想驗證的行為。Claude 會檢查您現有的測試檔案，以符合已在使用的風格、框架和斷言模式。

為了獲得全面的涵蓋範圍，要求 Claude 識別您可能遺漏的邊界情況。Claude 可以分析您的程式碼路徑，並建議測試錯誤條件、邊界值和容易忽視的意外輸入。

建立提取請求

您可以直接要求 Claude 建立提取請求（「為我的變更建立 pr」），或逐步引導 Claude 完成：

總結您的變更

summarize the changes I've made to the authentication module

產生提取請求

create a pr

檢查並細化

enhance the PR description with more context about the security improvements

若要稍後找到會話，請執行 claude --from-pr 1234，並使用您自己的 PR 編號，這會開啟會話選擇器，篩選連結到該 PR 的會話，或將 PR URL 貼到 /resume 選擇器搜尋中。當 Claude 使用 gh pr create 或 glab mr create 建立提取請求時，Claude Code 會將會話連結到 PR，以及當 Claude 處理現有 PR 時。

處理文件

假設您需要為程式碼新增或更新文件。

識別未記錄的程式碼

find functions without proper JSDoc comments in the auth module

產生文件

add JSDoc comments to the undocumented functions in auth.js

檢查並增強

improve the generated documentation with more context and examples

驗證文件

check if the documentation follows our project standards

在筆記和非程式碼資料夾中工作

Claude Code 可在任何目錄中工作。在筆記保管庫、文件資料夾或任何 markdown 檔案集合中執行它，以搜尋、編輯和重新組織內容，就像您處理程式碼一樣。

.claude/ 目錄和 CLAUDE.md 與其他工具的配置目錄並存，不會產生衝突。Claude 在每次工具呼叫時都會重新讀取檔案，所以它會在下次讀取該檔案時看到您在另一個應用程式中所做的編輯。

使用影像

假設您需要在程式碼庫中使用影像，並希望 Claude 幫助分析影像內容。

將影像新增到對話中

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

將影像拖放到 Claude Code 視窗中
複製影像並使用 Ctrl+V 將其貼到 CLI 中，或在 Windows 和 WSL 上使用 Alt+V
向 Claude 提供影像路徑。例如，「分析此影像：/path/to/your/image.png」

要求 Claude 分析影像

What does this image show?

Describe the UI elements in this screenshot

Are there any problematic elements in this diagram?

使用影像作為背景資訊

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?

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

Generate CSS to match this design mockup

What HTML structure would recreate this component?

參考檔案和目錄

使用 @ 快速包含檔案或目錄，無需等待 Claude 讀取它們。

參考單個檔案

Explain the logic in @src/utils/auth.js

這會在對話中包含檔案的完整內容。

參考目錄

What's the structure of @src/components?

參考 MCP 資源

Show me the data from @github:repos/owner/repo/issues

這使用 @server:resource 格式從連接的 MCP 伺服器取得資料。有關詳細資訊，請參閱 MCP 資源。

按排程執行 Claude

假設您想讓 Claude 自動定期處理任務，例如每天早上檢查開放 PR、每週審計依賴項或在夜間檢查 CI 失敗。

根據您想讓任務執行的位置選擇排程選項：

選項	執行位置	最適合
Routines	雲端，預設由 Anthropic 管理	應該在您的電腦關閉時執行的任務。也可以由 API 呼叫或 GitHub 事件觸發，除了排程。在 claude.ai/code/routines 配置。
桌面排程任務	您的機器，通過桌面應用	需要直接存取本地檔案、工具或未提交變更的任務。
GitHub Actions	您的 CI 管道	與儲存庫事件（如開啟的 PR）相關的任務，或應與工作流程配置一起存在的 cron 排程。
`/loop`	當前 CLI 會話	會話開啟時的快速輪詢。任務在您開始新對話時停止；`--resume` 和 `--continue` 恢復未過期的任務。

詢問 Claude 其功能

Claude 內建存取其文件，可以回答有關其自身功能和限制的問題。

範例問題

can Claude Code create pull requests?

how does Claude Code handle permissions?

what skills are available?

how do I use MCP with Claude Code?

how do I configure Claude Code for Amazon Bedrock?

what are the limitations of Claude Code?

繼續之前的對話

當任務跨越多個會話時，從您停止的地方繼續，而不是重新解釋背景資訊。Claude Code 在本地儲存每個對話。

claude --continue

這會繼續當前目錄中最近的會話；如果還沒有，它會列印 No conversation found to continue 並退出。使用 claude --resume 從清單中選擇，或從執行中的會話內使用 /resume。有關命名、分支和完整選擇器參考，請參閱管理會話。

使用 worktrees 執行平行會話

在一個終端中處理功能，同時 Claude 在另一個終端中修復錯誤，而不會編輯衝突。每個 git worktree 是其自己分支上的單獨簽出，從現有提交建立，因此儲存庫需要至少先有一個提交。

claude --worktree feature-auth

在第二個終端中使用不同的名稱執行相同的命令以啟動隔離的平行會話。在沒有提交的儲存庫中，命令失敗並顯示 Failed to resolve base branch "HEAD": git rev-parse failed。有關清理、.worktreeinclude 和非 git VCS 支援，請參閱 Worktrees。要從一個螢幕而不是單獨的終端監視平行會話，請參閱背景代理。

編輯前規劃

對於您想在變更觸及磁碟前檢查的變更，切換到 plan mode。Claude 讀取檔案並提出計畫，但在您批准前不進行編輯。狀態列會在 plan mode 啟用時顯示 ⏸ plan mode on。

claude --permission-mode plan

您也可以在會話期間按 Shift+Tab 直到狀態列顯示 ⏸ plan mode on。有關批准流程和在文字編輯器中編輯計畫，請參閱 Plan mode。

將研究委派給 subagents

探索大型程式碼庫會用檔案讀取填滿您的背景資訊。委派探索，以便只有發現結果返回。

use a subagent to investigate how our auth system handles token refresh

subagent 在其自己的背景資訊視窗中讀取檔案並報告摘要。有關定義具有自己工具和提示的自訂代理，請參閱 Subagents。

將 Claude 管道輸入指令碼

以非互動方式執行 Claude，用於 CI、提交前 hooks 或批次處理。Stdin 和 stdout 像任何 Unix 工具一樣工作。

git log --oneline -20 | claude -p "summarize these recent commits"

有關輸出格式、權限標誌和扇出模式，請參閱非互動模式。

後續步驟

lightbulb 最佳實踐

從 Claude Code 中獲得最大收益的模式

rotate-left 管理會話

繼續、命名和分支對話

code-branch Worktrees

執行隔離的平行會話

puzzle-piece 擴展 Claude Code

新增 skills、hooks、MCP、subagents 和外掛

common-workflows.md +69 −66

6 6

7> 使用 Claude Code 探索程式碼庫、修復錯誤、重構、測試和其他日常任務的逐步指南。7> 使用 Claude Code 探索程式碼庫、修復錯誤、重構、測試和其他日常任務的逐步指南。

8 8

~~9本頁涵蓋日常開發的簡短食譜。如需更高層級的提示和背景資訊管理指導，請參閱[最佳實踐](/zh-TW/best-practices)。~~9本頁涵蓋日常開發的簡短食譜。如需更高層級的提示和背景資訊管理指導，請參閱[最佳實踐](/docs/zh-TW/best-practices)。

10 10

11本頁涵蓋：11本頁涵蓋：

12 12

27 了解新的程式碼庫27 了解新的程式碼庫

28</h3>28</h3>

29 29

~~30如需在 monorepo 或大型程式碼庫中配置 Claude Code，請參閱 [Monorepos 和大型儲存庫](/zh-TW/large-codebases)。~~30如需在 monorepo 或大型程式碼庫中配置 Claude Code，請參閱 [Monorepos 和大型儲存庫](/docs/zh-TW/large-codebases)。

31 31

32<h4 id="get-a-quick-codebase-overview">32<h4 id="get-a-quick-codebase-overview">

33 快速取得程式碼庫概覽33 快速取得程式碼庫概覽

40 ```bash theme={null}40 ```bash theme={null}

41 cd /path/to/project 41 cd /path/to/project

42 ```42 ```

44 將 `/path/to/project` 替換為您專案的路徑。

43 </Step>45 </Step>

44 46

45 <Step title="啟動 Claude Code">47 <Step title="啟動 Claude Code">

49 </Step>51 </Step>

50 52

51 <Step title="要求高層級概覽">53 <Step title="要求高層級概覽">

~~52 ```text theme={null}~~54 ```text wrap theme={null}

53 give me an overview of this codebase55 give me an overview of this codebase

54 ```56 ```

55 </Step>57 </Step>

56 58

57 <Step title="深入探討特定元件">59 <Step title="深入探討特定元件">

~~58 ```text theme={null}~~60 ```text wrap theme={null}

59 explain the main architecture patterns used here61 explain the main architecture patterns used here

60 ```62 ```

61 63

~~62 ```text theme={null}~~64 ```text wrap theme={null}

63 what are the key data models?65 what are the key data models?

64 ```66 ```

65 67

~~66 ```text theme={null}~~68 ```text wrap theme={null}

67 how is authentication handled?69 how is authentication handled?

68 ```70 ```

69 </Step>71 </Step>

85 87

86<Steps>88<Steps>

87 <Step title="要求 Claude 尋找相關檔案">89 <Step title="要求 Claude 尋找相關檔案">

~~88 ```text theme={null}~~90 ```text wrap theme={null}

89 find the files that handle user authentication91 find the files that handle user authentication

90 ```92 ```

91 </Step>93 </Step>

92 94

93 <Step title="取得元件如何互動的背景資訊">95 <Step title="取得元件如何互動的背景資訊">

~~94 ```text theme={null}~~96 ```text wrap theme={null}

95 how do these authentication files work together?97 how do these authentication files work together?

96 ```98 ```

97 </Step>99 </Step>

98 100

99 <Step title="了解執行流程">101 <Step title="了解執行流程">

100 ```text theme={null}102 ```text wrap theme={null}

101 trace the login process from front-end to database103 trace the login process from front-end to database

102 ```104 ```

103 </Step>105 </Step>

108 110

109 * 明確說明您要尋找的內容111 * 明確說明您要尋找的內容

110 * 使用專案中的領域語言112 * 使用專案中的領域語言

111 * 為您的語言安裝[程式碼智能外掛](/zh-TW/discover-plugins#code-intelligence)，以便 Claude 進行精確的'前往定義'和'尋找參考'導航113 * 為您的語言安裝[程式碼智能外掛](/docs/zh-TW/discover-plugins#code-intelligence)，以便 Claude 進行精確的'前往定義'和'尋找參考'導航

112</Tip>114</Tip>

113 115

114***116***

121 123

122<Steps>124<Steps>

123 <Step title="與 Claude 分享錯誤">125 <Step title="與 Claude 分享錯誤">

124 ```text theme={null}126 ```text wrap theme={null}

125 I'm seeing an error when I run npm test127 I'm seeing an error when I run npm test

126 ```128 ```

127 </Step>129 </Step>

128 130

129 <Step title="要求修復建議">131 <Step title="要求修復建議">

130 ```text theme={null}132 ```text wrap theme={null}

131 suggest a few ways to fix the @ts-ignore in user.ts133 suggest a few ways to fix the @ts-ignore in user.ts

132 ```134 ```

133 </Step>135 </Step>

134 136

135 <Step title="應用修復">137 <Step title="應用修復">

136 ```text theme={null}138 ```text wrap theme={null}

137 update user.ts to add the null check you suggested139 update user.ts to add the null check you suggested

138 ```140 ```

139 </Step>141 </Step>

155 157

156假設您需要更新舊程式碼以使用現代模式和實踐。158假設您需要更新舊程式碼以使用現代模式和實踐。

157 159

160如需將整個程式碼庫移植到新語言，請參閱部落格上的[Anthropic 如何使用 Claude Code 執行大規模程式碼遷移](https://claude.com/blog/ai-code-migration)。

161

158<Steps>162<Steps>

159 <Step title="識別用於重構的舊版程式碼">163 <Step title="識別用於重構的舊版程式碼">

160 ```text theme={null}164 ```text wrap theme={null}

161 find deprecated API usage in our codebase165 find deprecated API usage in our codebase

162 ```166 ```

163 </Step>167 </Step>

164 168

165 <Step title="取得重構建議">169 <Step title="取得重構建議">

166 ```text theme={null}170 ```text wrap theme={null}

167 suggest how to refactor utils.js to use modern JavaScript features171 suggest how to refactor utils.js to use modern JavaScript features

168 ```172 ```

169 </Step>173 </Step>

170 174

171 <Step title="安全地應用變更">175 <Step title="安全地應用變更">

172 ```text theme={null}176 ```text wrap theme={null}

173 refactor utils.js to use ES2024 features while maintaining the same behavior177 refactor utils.js to use ES2024 features while maintaining the same behavior

174 ```178 ```

175 </Step>179 </Step>

176 180

177 <Step title="驗證重構">181 <Step title="驗證重構">

178 ```text theme={null}182 ```text wrap theme={null}

179 run tests for the refactored code183 run tests for the refactored code

180 ```184 ```

181 </Step>185 </Step>

199 203

200<Steps>204<Steps>

201 <Step title="識別未測試的程式碼">205 <Step title="識別未測試的程式碼">

202 ```text theme={null}206 ```text wrap theme={null}

203 find functions in NotificationsService.swift that are not covered by tests207 find functions in NotificationsService.swift that are not covered by tests

204 ```208 ```

205 </Step>209 </Step>

206 210

207 <Step title="產生測試框架">211 <Step title="產生測試框架">

208 ```text theme={null}212 ```text wrap theme={null}

209 add tests for the notification service213 add tests for the notification service

210 ```214 ```

211 </Step>215 </Step>

212 216

213 <Step title="新增有意義的測試案例">217 <Step title="新增有意義的測試案例">

214 ```text theme={null}218 ```text wrap theme={null}

215 add test cases for edge conditions in the notification service219 add test cases for edge conditions in the notification service

216 ```220 ```

217 </Step>221 </Step>

218 222

219 <Step title="執行並驗證測試">223 <Step title="執行並驗證測試">

220 ```text theme={null}224 ```text wrap theme={null}

221 run the new tests and fix any failures225 run the new tests and fix any failures

222 ```226 ```

223 </Step>227 </Step>

237 241

238<Steps>242<Steps>

239 <Step title="總結您的變更">243 <Step title="總結您的變更">

240 ```text theme={null}244 ```text wrap theme={null}

241 summarize the changes I've made to the authentication module245 summarize the changes I've made to the authentication module

242 ```246 ```

243 </Step>247 </Step>

244 248

245 <Step title="產生提取請求">249 <Step title="產生提取請求">

246 ```text theme={null}250 ```text wrap theme={null}

247 create a pr251 create a pr

248 ```252 ```

249 </Step>253 </Step>

250 254

251 <Step title="檢查並細化">255 <Step title="檢查並細化">

252 ```text theme={null}256 ```text wrap theme={null}

253 enhance the PR description with more context about the security improvements257 enhance the PR description with more context about the security improvements

254 ```258 ```

255 </Step>259 </Step>

256</Steps>260</Steps>

257 261

258當您使用 `gh pr create` 建立 PR 時，會話會自動連結到該 PR。要稍後返回它，請執行 `claude --from-pr 123`，將 123 替換為 PR 編號，或將 PR URL 貼到[`/resume` 選擇器](/zh-TW/sessions#use-the-session-picker)搜尋中。262若要稍後找到會話，請執行 `claude --from-pr 1234`，並使用您自己的 PR 編號，這會開啟會話選擇器，篩選連結到該 PR 的會話，或將 PR URL 貼到 [`/resume` 選擇器](/docs/zh-TW/sessions#use-the-session-picker)搜尋中。當 Claude 使用 `gh pr create` 或 `glab mr create` 建立提取請求時，Claude Code 會將會話連結到 PR，以及當 Claude [處理現有 PR](/docs/zh-TW/agent-view#pull-request-status) 時。

259 263

260<Tip>264<Tip>

261 在提交前檢查 Claude 產生的 PR，並要求 Claude 突出顯示潛在的風險或考慮事項。265 在提交前檢查 Claude 產生的 PR，並要求 Claude 突出顯示潛在的風險或考慮事項。

269 273

270<Steps>274<Steps>

271 <Step title="識別未記錄的程式碼">275 <Step title="識別未記錄的程式碼">

272 ```text theme={null}276 ```text wrap theme={null}

273 find functions without proper JSDoc comments in the auth module277 find functions without proper JSDoc comments in the auth module

274 ```278 ```

275 </Step>279 </Step>

276 280

277 <Step title="產生文件">281 <Step title="產生文件">

278 ```text theme={null}282 ```text wrap theme={null}

279 add JSDoc comments to the undocumented functions in auth.js283 add JSDoc comments to the undocumented functions in auth.js

280 ```284 ```

281 </Step>285 </Step>

282 286

283 <Step title="檢查並增強">287 <Step title="檢查並增強">

284 ```text theme={null}288 ```text wrap theme={null}

285 improve the generated documentation with more context and examples289 improve the generated documentation with more context and examples

286 ```290 ```

287 </Step>291 </Step>

288 292

289 <Step title="驗證文件">293 <Step title="驗證文件">

290 ```text theme={null}294 ```text wrap theme={null}

291 check if the documentation follows our project standards295 check if the documentation follows our project standards

292 ```296 ```

293 </Step>297 </Step>

324 您可以使用以下任何方法：328 您可以使用以下任何方法：

325 329

326 1. 將影像拖放到 Claude Code 視窗中330 1. 將影像拖放到 Claude Code 視窗中

327 2. 複製影像並使用 Ctrl+V 將其貼到 CLI 中。在 macOS 上，Cmd+V 也適用於 iTerm2。331 2. 複製影像並使用 `Ctrl+V` 將其貼到 CLI 中，或在 [Windows 和 WSL 上使用 `Alt+V`](/docs/zh-TW/interactive-mode#general-controls)

328 3. 向 Claude 提供影像路徑。例如，「分析此影像：/path/to/your/image.png」332 3. 向 Claude 提供影像路徑。例如，「分析此影像：/path/to/your/image.png」

329 </Step>333 </Step>

330 334

331 <Step title="要求 Claude 分析影像">335 <Step title="要求 Claude 分析影像">

332 ```text theme={null}336 ```text wrap theme={null}

333 What does this image show?337 What does this image show?

334 ```338 ```

335 339

336 ```text theme={null}340 ```text wrap theme={null}

337 Describe the UI elements in this screenshot341 Describe the UI elements in this screenshot

338 ```342 ```

339 343

340 ```text theme={null}344 ```text wrap theme={null}

341 Are there any problematic elements in this diagram?345 Are there any problematic elements in this diagram?

342 ```346 ```

343 </Step>347 </Step>

344 348

345 <Step title="使用影像作為背景資訊">349 <Step title="使用影像作為背景資訊">

346 ```text theme={null}350 ```text wrap theme={null}

347 Here's a screenshot of the error. What's causing it?351 Here's a screenshot of the error. What's causing it?

348 ```352 ```

349 353

350 ```text theme={null}354 ```text wrap theme={null}

351 This is our current database schema. How should we modify it for the new feature?355 This is our current database schema. How should we modify it for the new feature?

352 ```356 ```

353 </Step>357 </Step>

354 358

355 <Step title="從視覺內容取得程式碼建議">359 <Step title="從視覺內容取得程式碼建議">

356 ```text theme={null}360 ```text wrap theme={null}

357 Generate CSS to match this design mockup361 Generate CSS to match this design mockup

358 ```362 ```

359 363

360 ```text theme={null}364 ```text wrap theme={null}

361 What HTML structure would recreate this component?365 What HTML structure would recreate this component?

362 ```366 ```

363 </Step>367 </Step>

383 387

384<Steps>388<Steps>

385 <Step title="參考單個檔案">389 <Step title="參考單個檔案">

386 ```text theme={null}390 ```text wrap theme={null}

387 Explain the logic in @src/utils/auth.js391 Explain the logic in @src/utils/auth.js

388 ```392 ```

389 393

391 </Step>395 </Step>

392 396

393 <Step title="參考目錄">397 <Step title="參考目錄">

394 ```text theme={null}398 ```text wrap theme={null}

395 What's the structure of @src/components?399 What's the structure of @src/components?

396 ```400 ```

~~397~~

398 這提供了帶有檔案資訊的目錄清單。

399 </Step>401 </Step>

400 402

401 <Step title="參考 MCP 資源">403 <Step title="參考 MCP 資源">

402 ```text theme={null}404 ```text wrap theme={null}

403 Show me the data from @github:repos/owner/repo/issues405 Show me the data from @github:repos/owner/repo/issues

404 ```406 ```

405 407

406 這使用 @server:resource 格式從連接的 MCP 伺服器取得資料。有關詳細資訊，請參閱 [MCP 資源](/zh-TW/mcp#use-mcp-resources)。408 這使用 @server:resource 格式從連接的 MCP 伺服器取得資料。有關詳細資訊，請參閱 [MCP 資源](/docs/zh-TW/mcp#use-mcp-resources)。

407 </Step>409 </Step>

408</Steps>410</Steps>

409 411

411 提示：413 提示：

412 414

413 * 檔案路徑可以是相對的或絕對的415 * 檔案路徑可以是相對的或絕對的

416 * 輸入 `@` 以開啟路徑建議功能表，然後按 Enter 或 Tab 以接受反白顯示的路徑，再按 Enter 以傳送訊息

414 * @ 檔案參考會在檔案的目錄和父目錄中新增 `CLAUDE.md` 到背景資訊417 * @ 檔案參考會在檔案的目錄和父目錄中新增 `CLAUDE.md` 到背景資訊

415 * 目錄參考顯示檔案清單，而不是內容418 * 目錄參考顯示檔案清單，而不是內容

416 * 您可以在單個訊息中參考多個檔案（例如「@file1.js and @file2.js」）419 * 您可以在單個訊息中參考多個檔案（例如「@file1.js and @file2.js」）

427根據您想讓任務執行的位置選擇排程選項：430根據您想讓任務執行的位置選擇排程選項：

428 431

429| 選項 | 執行位置 | 最適合 |432| 選項 | 執行位置 | 最適合 |

430| :--------------------------------------- | :---------------- | :------------------------------------------------------------------------------------------------------------- |433| :--------------------------------------- | :------------------ | :------------------------------------------------------------------------------------------------------------- |

435 438

436<Tip>439<Tip>

437 為排程任務編寫提示時，明確說明成功是什麼樣子以及如何處理結果。任務自主執行，所以它無法提出澄清問題。例如：「檢查標記為 `needs-review` 的開放 PR，對任何問題留下內聯評論，並在 `#eng-reviews` Slack 頻道中發佈摘要。」440 為排程任務編寫提示時，明確說明成功是什麼樣子以及如何處理結果。任務自主執行，所以它無法提出澄清問題。例如：「檢查標記為 `needs-review` 的開放 PR，對任何問題留下內聯評論，並在 `#eng-reviews` Slack 頻道中發佈摘要。」

449 範例問題452 範例問題

450</h4>453</h4>

451 454

452```text theme={null}455```text wrap theme={null}

453can Claude Code create pull requests?456can Claude Code create pull requests?

454```457```

455 458

456```text theme={null}459```text wrap theme={null}

457how does Claude Code handle permissions?460how does Claude Code handle permissions?

458```461```

459 462

460```text theme={null}463```text wrap theme={null}

461what skills are available?464what skills are available?

462```465```

463 466

464```text theme={null}467```text wrap theme={null}

465how do I use MCP with Claude Code?468how do I use MCP with Claude Code?

466```469```

467 470

468```text theme={null}471```text wrap theme={null}

469how do I configure Claude Code for Amazon Bedrock?472how do I configure Claude Code for Amazon Bedrock?

470```473```

471 474

472```text theme={null}475```text wrap theme={null}

473what are the limitations of Claude Code?476what are the limitations of Claude Code?

474```477```

475 478

497claude --continue500claude --continue

498```501```

499 502

500這會繼續當前目錄中最近的會話；如果還沒有，它會列印 `No conversation found to continue` 並退出。使用 `claude --resume` 從清單中選擇，或從執行中的會話內使用 `/resume`。有關命名、分支和完整選擇器參考，請參閱[管理會話](/zh-TW/sessions)。503這會繼續當前目錄中最近的會話；如果還沒有，它會列印 `No conversation found to continue` 並退出。使用 `claude --resume` 從清單中選擇，或從執行中的會話內使用 `/resume`。有關命名、分支和完整選擇器參考，請參閱[管理會話](/docs/zh-TW/sessions)。

501 504

502<h2 id="run-parallel-sessions-with-worktrees">505<h2 id="run-parallel-sessions-with-worktrees">

503 使用 worktrees 執行平行會話506 使用 worktrees 執行平行會話

504</h2>507</h2>

505 508

506在一個終端中處理功能，同時 Claude 在另一個終端中修復錯誤，而不會編輯衝突。每個 worktree 是其自己分支上的單獨簽出。509在一個終端中處理功能，同時 Claude 在另一個終端中修復錯誤，而不會編輯衝突。每個 [git worktree](https://git-scm.com/docs/git-worktree) 是其自己分支上的單獨簽出，從現有提交建立，因此儲存庫需要至少先有一個提交。

507 510

508```bash theme={null}511```bash theme={null}

509claude --worktree feature-auth512claude --worktree feature-auth

510```513```

511 514

512在第二個終端中使用不同的名稱執行相同的命令以啟動隔離的平行會話。有關清理、`.worktreeinclude` 和非 git VCS 支援，請參閱 [Worktrees](/zh-TW/worktrees)。要從一個螢幕而不是單獨的終端監視平行會話，請參閱[背景代理](/zh-TW/agent-view)。515在第二個終端中使用不同的名稱執行相同的命令以啟動隔離的平行會話。在沒有提交的儲存庫中，命令失敗並顯示 `Failed to resolve base branch "HEAD": git rev-parse failed`。有關清理、`.worktreeinclude` 和非 git VCS 支援，請參閱 [Worktrees](/docs/zh-TW/worktrees)。要從一個螢幕而不是單獨的終端監視平行會話，請參閱[背景代理](/docs/zh-TW/agent-view)。

513 516

514<h2 id="plan-before-editing">517<h2 id="plan-before-editing">

515 編輯前規劃518 編輯前規劃

516</h2>519</h2>

517 520

518對於您想在變更觸及磁碟前檢查的變更，切換到 plan mode。Claude 讀取檔案並提出計畫，但在您批准前不進行編輯。521對於您想在變更觸及磁碟前檢查的變更，切換到 plan mode。Claude 讀取檔案並提出計畫，但在您批准前不進行編輯。狀態列會在 plan mode 啟用時顯示 `⏸ plan mode on`。

519 522

520```bash theme={null}523```bash theme={null}

521claude --permission-mode plan524claude --permission-mode plan

522```525```

523 526

524您也可以在會話期間按 `Shift+Tab` 切換到 plan mode。有關批准流程和在文字編輯器中編輯計畫，請參閱 [Plan mode](/zh-TW/permission-modes#analyze-before-you-edit-with-plan-mode)。527您也可以在會話期間按 `Shift+Tab` 直到狀態列顯示 `⏸ plan mode on`。有關批准流程和在文字編輯器中編輯計畫，請參閱 [Plan mode](/docs/zh-TW/permission-modes#analyze-before-you-edit-with-plan-mode)。

525 528

526<h2 id="delegate-research-to-subagents">529<h2 id="delegate-research-to-subagents">

527 將研究委派給 subagents530 將研究委派給 subagents

529 532

530探索大型程式碼庫會用檔案讀取填滿您的背景資訊。委派探索，以便只有發現結果返回。533探索大型程式碼庫會用檔案讀取填滿您的背景資訊。委派探索，以便只有發現結果返回。

531 534

532```text theme={null}535```text wrap theme={null}

533use a subagent to investigate how our auth system handles token refresh536use a subagent to investigate how our auth system handles token refresh

534```537```

535 538

536subagent 在其自己的背景資訊視窗中讀取檔案並報告摘要。有關定義具有自己工具和提示的自訂代理，請參閱 [Subagents](/zh-TW/sub-agents)。539subagent 在其自己的背景資訊視窗中讀取檔案並報告摘要。有關定義具有自己工具和提示的自訂代理，請參閱 [Subagents](/docs/zh-TW/sub-agents)。

537 540

538<h2 id="pipe-claude-into-scripts">541<h2 id="pipe-claude-into-scripts">

539 將 Claude 管道輸入指令碼542 將 Claude 管道輸入指令碼

545git log --oneline -20 | claude -p "summarize these recent commits"548git log --oneline -20 | claude -p "summarize these recent commits"

546```549```

547 550

548有關輸出格式、權限標誌和扇出模式，請參閱[非互動模式](/zh-TW/headless)。551有關輸出格式、權限標誌和扇出模式，請參閱[非互動模式](/docs/zh-TW/headless)。

549 552

550<h2 id="next-steps">553<h2 id="next-steps">

551 後續步驟554 後續步驟

552</h2>555</h2>

553 556

554<CardGroup cols={2}>557<CardGroup cols={2}>

555 <Card title="最佳實踐" icon="lightbulb" href="/zh-TW/best-practices">558 <Card title="最佳實踐" icon="lightbulb" href="/docs/zh-TW/best-practices">

556 從 Claude Code 中獲得最大收益的模式559 從 Claude Code 中獲得最大收益的模式

557 </Card>560 </Card>

558 561

559 <Card title="管理會話" icon="rotate-left" href="/zh-TW/sessions">562 <Card title="管理會話" icon="rotate-left" href="/docs/zh-TW/sessions">

560 繼續、命名和分支對話563 繼續、命名和分支對話

561 </Card>564 </Card>

562 565

563 <Card title="Worktrees" icon="code-branch" href="/zh-TW/worktrees">566 <Card title="Worktrees" icon="code-branch" href="/docs/zh-TW/worktrees">

564 執行隔離的平行會話567 執行隔離的平行會話

565 </Card>568 </Card>

566 569

567 <Card title="擴展 Claude Code" icon="puzzle-piece" href="/zh-TW/features-overview">570 <Card title="擴展 Claude Code" icon="puzzle-piece" href="/docs/zh-TW/features-overview">

568 新增 skills、hooks、MCP、subagents 和外掛571 新增 skills、hooks、MCP、subagents 和外掛

569 </Card>572 </Card>

570</CardGroup>573</CardGroup>

common-workflows.md 2026-09-09 22:58 UTC to 2026-09-10 23:00 UTC

常見工作流程

提示食譜

了解新的程式碼庫

快速取得程式碼庫概覽

導航到專案根目錄

啟動 Claude Code

要求高層級概覽

深入探討特定元件

尋找相關程式碼

要求 Claude 尋找相關檔案

取得元件如何互動的背景資訊

了解執行流程

有效地修復錯誤

與 Claude 分享錯誤

要求修復建議

應用修復

重構程式碼

識別用於重構的舊版程式碼

取得重構建議

安全地應用變更

驗證重構

使用測試

識別未測試的程式碼

產生測試框架

新增有意義的測試案例

執行並驗證測試

建立提取請求

總結您的變更

產生提取請求

檢查並細化

處理文件

識別未記錄的程式碼

產生文件

檢查並增強

驗證文件

在筆記和非程式碼資料夾中工作

使用影像

將影像新增到對話中

要求 Claude 分析影像

使用影像作為背景資訊

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

參考檔案和目錄

參考單個檔案

參考目錄

參考 MCP 資源

按排程執行 Claude

詢問 Claude 其功能

範例問題

繼續之前的對話

使用 worktrees 執行平行會話

編輯前規劃

將研究委派給 subagents

將 Claude 管道輸入指令碼

後續步驟