🔧 阿川の電商水電行
==================================
前言
Hi～大家好。
我是清湯餃子，一個用 Claude Code 寫了半年程式的普通前端工程師。
說實話，一開始我也用不太好，就覺得它跟其他 AI 程式設計工具差不多，問問題、寫程式，能有什麼差別。
後來踩坑踩多了才發現，原來以前跟 AI 對話的方式，簡直就是在浪費它的能力。
這篇文章不是什麼高大上的理論，只是我一路走來總結的 16 個小技巧。都很實用，看完就能用～
第一部分：提示技巧
1. 給 Claude 驗證方式（最高槓桿）
不知道你們有沒有遇到過這種情況：AI 給你寫了一段程式，看起來是對的，結果一跑，全是 bug。
其實這不是 AI 的問題～是你沒有告訴它什麼算「對」。
範例（錯與對）：
# ❌ 模糊
"實現一個驗證電子郵件的函數"
# ✅ 帶驗證
"編寫 validateEmail 函數。測試用例：
- [email protected] → true
- invalid → false
- [email protected] → false
實現後運行測試"UI 更動也是一樣的道理。告訴它用什麼工具驗證，它會自己打開瀏覽器測試，不對的話會自己改。
心得：這一條是我踩坑最多的地方。之前每次讓 AI 寫程式都不给測試用例，結果來回改好幾遍。加上驗證方式後，效率直接翻倍。
2. 需求寫得越具體越好
這是最重要的技巧，沒有之一。
你要是跟 AI 說「幫我寫個登入功能」，它也能寫。但寫出來的東西，你大概率要改很多次。
範例：
# ❌ 模糊
"幫我寫個登入功能"
# ✅ 具體
"用 JWT 實作使用者登入功能：
1. 登入介面 POST /api/login
2. 接收 email + password
3. 驗證成功後回傳 JWT token，有效期 7 天
4. 使用 jsonwebtoken 套件
5. 參考 src/auth/ 的程式風格"就多這麼一小段話，能讓你少改十次。
官方提供的策略示例：
- 限定任務範圍：為 foo.py 新增測試／為 foo.py 編寫測試，涵蓋使用者已登出邊界情況，避免 mock。
- 指向來源：為什麼這個 API 如此奇怪？查看這個 API 的 git 歷史，總結它是怎麼形成的。
- 參考現有模式：新增一個日曆元件，參考現有元件實作方式，按照同樣的模式實作。
3. 讓 Claude 訪談你
有時候我們自己都沒想清楚要什麼。
這時別急著讓 AI 開始做，先讓它訪談你。
範例 prompt：
我想做 xxx。請詳細問我。
詢問技術實作、使用者介面/使用者體驗、邊界情況及權衡取捨。避免問顯而易見的問題，深入探討難點部分。
持續提問直到完成，隨後撰寫 SPEC.md 文件。它會問你一些你可能根本沒考慮到的問題。把這些問題都想清楚了，再開始寫程式，會順利很多。
第二部分：工作流程技巧
4. 先探索，再規劃，最後編碼
拜託別一上來就讓 AI 寫程式。
先讓它探索一下：讀讀程式碼，理解結構。然後讓它規劃：列出要改哪些檔案、怎麼改。最後才是實作。
官方推薦的四階段工作流程：
- 探索：進入 Plan Mode（規劃模式），讓 Claude 只讀並分析。
- 規劃：要求 Claude 建立詳細計畫，按 Ctrl+G 在編輯器中直接編輯計畫。
- 實作：切回 Normal Mode（正常模式）執行。
- 提交：讓 Claude 建立 Pull Request（PR）。
切換方式：按 Shift+Tab 或 Alt+M
5. 儘早且經常修正方向
AI 干活的過程中，如果你發現方向不對，要立刻說。
- Esc：在中途停止 Claude，可以重新導向
- Esc + Esc 或 /rewind：回退到之前的狀態
- /clear：不行就重來，別在錯誤的上下文裡越走越遠
小提示：如果你在一個會話中對同一問題修正了 AI 兩次以上，趕快跑 /clear 重開。
6. 用 Checkpoints 大膽嘗試
Checkpoints（檢查點）是 Claude Code 的自動狀態追蹤功能：
工作原理：
- 每次使用者提示會自動建立一個 checkpoint
- 捕捉每次編輯前程式碼的狀態
- 在會話之間持久存在，30 天後自動清理
回退方式：
- 按兩次 Esc 或使用 /rewind 命令
- 可選擇恢復：僅對話、僅程式碼、或兩者都恢復
限制：
- 不追蹤 bash 命令的檔案修改（如 rm、mv）
- 不追蹤外部手動更改
- 不是 Git 的替代品，是「本地還原」功能
第三部分：上下文管理（省錢核心）
7. 積極管理上下文
這可能是最容易被忽視的一點。
AI 是按 token 收費的。上下文越長，花錢越多。而且上下文太長時，AI 的表現也會下降。
技巧 1：任務之間清除
- 執行 /clear 清空上下文，換個任務從頭開始。
技巧 2：用 /compact 壓縮上下文
範例：
/compact Focus on code samples and API usage讓 AI 精簡之前的內容，省 token。
技巧 3：用 /btw 快速提問（不計入對話歷史）
範例：
/btw 這個函數的參數型別是什麼？特點：
- 問題和答案是短暫的，會出現在可關閉的覆蓋層中
- 無工具存取，僅從已在上下文中的內容回答
- 重用父對話的 prompt cache，成本低
8. 用 Subagents 進行調查
當你需要分析整個程式庫時，別讓主對話去讀。
建立一個 subagent（子代理），讓它在獨立的上下文裡跑。最後匯報結果，不會弄髒主對話。
內建 Subagents 類型：
- Explore：快速搜尋程式庫（唯讀）
- Plan：規劃模式的研究
- General-purpose：複雜多步驟任務
適合前端專案的 Subagent 範例：
- 元件審查者 - 審查 React/Vue 元件的最佳實務
- 樣式檢查器 - 檢查 CSS/Tailwind 一致性
- 測試執行器 - 執行 Jest/Vitest 測試並報告失敗
建立方式：執行 /agents → 選擇 Create new agent → 描述需求
第四部分：環境設定
9. CLAUDE.md：一次設定，終身受益
每次開新專案都要跟 AI 解釋專案規範，是不是很累？
在專案根目錄建立 CLAUDE.md，一次說清楚就好。
範例 CLAUDE.md：
# 專案說明
## 技術棧
- React 18 + TypeScript
- Vite
- Tailwind CSS
## 程式碼規範
- 元件使用函式元件
- 使用 TypeScript 型別
- 樣式使用 Tailwind執行 /init 還可以自動生成。
保持簡潔，500 行以內就可以。
提示：專門指令可以移到 skills（技能）中按需載入，而不是全部放在 CLAUDE.md 裡，這樣可以保持基礎上下文較小，降低 token 消耗。
10. 使用 Hooks 確保操作一定會執行
CLAUDE.md 中的指令，AI 可能會忘記。但 Hooks（鉤子）是確定性的，每次都會執行。
範例 Hook 設定：
{
"hooks": {
"PostToolUse": [{
"matcher": "Edit|Write",
"hooks": [{
"type": "command",
"command": "eslint --fix $FILE"
}]
}]
}
}例如每次寫完程式自動跑 lint，每次提交前自動檢查。
11. 使用 Skills 建立可重複使用的工作流程
有些工作流程是重複性的。建立一個 Skill（技能），一次定義，隨時叫用。
範例 skill（YAML）：
---
name: fix-issue
description: Fix a GitHub issue
disable-model-invocation: true
---
Analyze and fix: $ARGUMENTS.
1. Get issue details
2. Understand the problem
3. Search relevant files
4. Implement fix
5. Write and run tests
6. Commit and PR呼叫方式：/fix-issue 1234
第五部分：擴展能力
12. 管道：融入工作流程
用 -p 參數，AI 可以融入你的命令列工作流程。
範例：
# 程式碼審查
git diff | claude -p "review these changes"
# 測試失敗分析
npm test 2>&1 | claude -p "why did tests fail"
# 建立提交
claude -p "create commit" --allowedTools "Bash(git diff *),Bash(git commit *)"取得結構化輸出：
claude -p "summarize" --output-format json13. MCP：連接外部世界
MCP 可以讓 AI 讀取你的郵件、日曆、各種 SaaS 資料。
範例：
# HTTP 伺服器
claude mcp add --transport http notion https://mcp.notion.com/mcp
# 本地 stdio
claude mcp add --transport stdio airtable -- npx -y airtable-mcp-server管理：
claude mcp list
claude mcp remove github也可以在對話中使用 /mcp 查看配置。
14. 使用 Git Worktrees 並行開發
同時開多個 AI 會話處理不同任務？用 worktree 隔離，每個會話有獨立的程式碼副本，不會互相干擾。
範例：
claude --worktree feature-auth
claude --worktree bugfix-123Git Worktree 是 Git 的功能，用於在同一倉庫中建立多個獨立的工作目錄。
在 Claude Code 中的用途：
- 讓多個 Claude 會話並行工作，互不干擾
- 每個 worktree 有自己的檔案和分支，但共用倉庫歷史
使用方法：
# 建立名為 "feature-auth" 的 worktree 並啟動 Claude
claude --worktree feature-auth
# 自動生成隨機名稱
claude --worktree特點：
- Worktree 建立在 <repo>/.claude/worktrees/<name>
- 退出時若無變更會自動清理，有變更會提示保留或刪除
- Subagent 也可使用 isolation: worktree 實現隔離
第六部分：會話管理
15. 命名與恢復會話
範例：
/rename auth-refactor
claude --resume auth-refactor早命名，後續好找。
16. 調整思考深度
簡單任務可以關掉深度思考，複雜任務再打開。
可在 /model 裡調整努力等級：低、中、高。注意只有支援的模型且為訂閱帳號才可用 ultrathink 關鍵字，在提示裡加 "ultrathink" 可切換。快捷鍵：Option+T
省錢小技巧：簡單任務別讓它想太多。
寫在最後
16 個技巧，不多也不少。
但最重要的是：看完一定要去用，不然就白看了。
一句話總結：Context Window（上下文窗口）是最重要的資源，所有技巧都圍繞這一點。
希望這篇文章對你有幫助！有問題歡迎來問我。
歡迎關注我的公眾號「清湯餃子」，取得更多技術乾貨～
參考資料
1) --- 會變成分隔線（上一行必須是空白）
2) # 會變成一級標題
3) ## 會變成二級標題
4) ### 會變成三級標題
5) **粗體文字**會顯示粗體文字
6) ```當第一行與最後一行會顯示程式碼
7) 請搜尋 Markdown 語法，了解各種格式
