Claude Code 最佳實踐

​

給 Claude 一種驗證其工作的方式

• 在一個提示中：要求 Claude 運行檢查並在同一消息中迭代，如上表所示。
• 在整個會話中：將檢查設置為 /goal 條件。單獨的評估器在每次轉換後重新檢查它，Claude 繼續工作直到目標解決。如果 Claude 停滯，Claude Code 最終會停止運行，目標仍然設置 — 請參閱 /goal 評估如何運作。
• 作為確定性門：Stop hook 將您的檢查作為腳本運行，並阻止轉換結束直到它通過。Stop input 涵蓋連續阻止的上限。
• 由第二意見：驗證子代理或動態工作流檢查自己的發現，有一個新鮮的模型嘗試反駁結果，所以做工作的代理不是給它評分的那個。

​

先探索，然後規劃，然後編碼

read /src/auth and understand how we handle sessions and login.
also look at how we manage environment variables for secrets.

I want to add Google OAuth. What files need to change?
What's the session flow? Create a plan.

implement the OAuth flow from your plan. write tests for the
callback handler, run the test suite and fix any failures.

commit with a descriptive message and open a PR

​

在提示中提供具體的背景資訊

​

提供豐富的內容

• 使用 @ 參考檔案，而不是描述程式碼的位置。Claude 會在回應前讀取檔案。
• 直接貼上影像。複製/貼上或拖放影像到提示中。
• 提供文件和 API 參考的 URL。使用 /permissions 將常用網域加入允許清單。
• 透過執行 cat error.log | claude 來傳送檔案內容，直接傳送資料。
• 讓 Claude 自行取得所需內容。告訴 Claude 使用 Bash 命令、MCP 工具或讀取檔案來自行提取背景資訊。

​

設定你的環境

​

撰寫有效的 CLAUDE.md

# 程式碼風格
- 使用 ES modules (import/export) 語法，而不是 CommonJS (require)
- 盡可能解構匯入 (例如 import { foo } from 'bar')

# 工作流程
- 完成一系列程式碼變更後，務必進行型別檢查
- 優先執行單一測試，而不是整個測試套件，以提高效能

​

設定權限

• 權限允許清單：允許你知道是安全的特定工具，如 npm run lint 或 git commit
• 沙箱：啟用作業系統級隔離，限制檔案系統和網路存取，讓 Claude 在定義的邊界內更自由地工作

​

使用 CLI 工具

​

連接 MCP 伺服器

​

設定 hooks

​

建立技能

---
name: api-conventions
description: REST API design conventions for our services
---
# API 慣例
- 為 URL 路徑使用 kebab-case
- 為 JSON 屬性使用 camelCase
- 始終為清單端點包含分頁
- 在 URL 路徑中版本化 API (/v1/, /v2/)

---
name: fix-issue
description: Fix a GitHub issue
disable-model-invocation: true
---
分析並修復 GitHub 議題：$ARGUMENTS。

1. 使用 `gh issue view` 取得議題詳細資訊
2. 理解議題中描述的問題
3. 搜尋程式碼庫以尋找相關檔案
4. 實現必要的變更以修復議題
5. 編寫並執行測試以驗證修復
6. 確保程式碼通過 linting 和型別檢查
7. 建立描述性提交訊息
8. 推送並建立 PR

​

建立自訂子代理

---
name: security-reviewer
description: Reviews code for security vulnerabilities
tools: Read, Grep, Glob, Bash
model: opus
---
你是一名資深安全工程師。檢查程式碼以查找：
- 注入漏洞 (SQL、XSS、命令注入)
- 驗證和授權缺陷
- 程式碼中的祕密或認證
- 不安全的資料處理

提供特定的行參考和建議的修復。

​

安裝外掛程式

​

有效溝通

​

詢問代碼庫問題

• 日誌記錄如何工作？
• 我如何建立新的 API 端點？
• foo.rs 第 134 行的 async move { ... } 做什麼？
• CustomerOnboardingFlowImpl 處理哪些邊界情況？
• 為什麼此代碼在第 333 行呼叫 foo() 而不是 bar()？

​

讓 Claude 採訪您

I want to build [brief description]. Interview me in detail using the AskUserQuestion tool.

Ask about technical implementation, UI/UX, edge cases, concerns, and tradeoffs. Don't ask obvious questions, dig into the hard parts I might not have considered.

Keep interviewing until we've covered everything, then write a complete spec to SPEC.md.

​

管理您的工作階段

​

及早且頻繁地修正方向

• Esc：使用 Esc 鍵在 Claude 執行中途停止。內容會被保留，因此您可以重新導向。
• Esc + Esc 或 /rewind：按兩次 Esc 或執行 /rewind 以開啟倒帶選單，並復原先前的對話和程式碼狀態，或從選定的訊息進行摘要。
• "Undo that"：讓 Claude 復原其變更。
• /clear：在不相關的任務之間重設內容。包含無關內容的長工作階段可能會降低效能。

​

積極管理內容

• 在任務之間頻繁使用 /clear 以完全重設內容視窗
• 當自動壓縮觸發時，Claude 會摘要最重要的內容，包括程式碼模式、檔案狀態和關鍵決策
• 為了獲得更多控制，執行 /compact <instructions>，例如 /compact Focus on the API changes
• 若要只壓縮對話的一部分，使用 Esc + Esc 或 /rewind，選擇訊息檢查點，然後選擇從此處摘要或摘要至此處。第一個選項會壓縮該點之後的訊息，同時保留較早的內容；第二個選項會壓縮較早的訊息，同時保留最近的訊息完整。請參閱倒帶選單的摘要選項。
• 在 CLAUDE.md 中使用 "When compacting, always preserve the full list of modified files and any test commands" 之類的指示來自訂壓縮行為，以確保關鍵內容在摘要後倖存
• 對於不需要保留在內容中的問題，使用 /btw。答案永遠不會進入對話歷史，因此您可以檢查詳細資訊而不會增加內容。

​

使用子代理進行調查

Use subagents to investigate how our authentication system handles token
refresh, and whether we have any existing OAuth utilities I should reuse.

​

使用檢查點倒帶

​

復原對話

​

自動化和擴展

​

運行非交互模式

# One-off queries
claude -p "Explain what this project does"

# Structured output for scripts
claude -p "List all API endpoints" --output-format json

# Streaming for real-time processing
claude -p "Analyze this log file" --output-format stream-json --verbose

​

運行多個 Claude 會話

• Worktrees：在隔離的 git 檢出中運行單獨的 CLI 會話，以便編輯不會衝突
• 跨會話訊息：讓您自己運行的會話相互傳遞發現
• 桌面應用：以視覺方式管理多個本地會話，每個會話都在自己的 worktree 中
• Claude Code 在網路上：在雲端運行會話，預設情況下在 Anthropic 管理的基礎設施上
• Agent view：研究預覽。執行 claude agents 以分派在背景中持續運行的會話，並從一個螢幕監視它們
• Agent teams：實驗性且預設停用。多個會話的自動協調，具有共享任務、訊息和團隊領導

​

跨文件扇出

for file in $(cat files.txt); do
  claude -p "Migrate $file from Python 2 to Python 3. Return OK or FAIL." \
    --allowedTools "Edit,Bash(git commit *)"
done

claude -p "<your prompt>" --output-format json | your_command

​

使用 auto mode 自主運行

claude --permission-mode auto -p "fix all lint errors"

​

添加對抗性審查步驟

使用子代理根據 PLAN.md 審查速率限制器差異。檢查
每個要求都已實施、列出的邊界情況都有測試，以及
任務範圍之外沒有任何內容更改。報告缺陷，而不是風格偏好。

​

避免常見的失敗模式

• 廚房水槽會話。 你從一項任務開始，然後問 Claude 一些無關的事情，然後回到第一項任務。上下文充滿了無關的資訊。

  修正：在無關的任務之間使用 /clear。

• 一次又一次地更正。 Claude 做錯了什麼，你更正它，它仍然是錯的，你再次更正。上下文被失敗的方法污染了。

  修正：在兩次失敗的更正後，使用 /clear 並寫一個更好的初始提示，納入你所學到的內容。

• 過度指定的 CLAUDE.md。 如果你的 CLAUDE.md 太長，Claude 會忽略其中一半，因為重要的規則在雜訊中丟失了。

  修正：無情地修剪。如果 Claude 已經在沒有指令的情況下正確地做了某事，請刪除它或將其轉換為 hook。

• 信任然後驗證的差距。 Claude 產生了一個看起來合理的實現，但沒有處理邊界情況。

  修正：始終提供驗證（測試、指令碼、螢幕截圖）。如果你無法驗證它，就不要發佈它。

• 無限探索。 你要求 Claude「調查」某些東西而沒有限定範圍。Claude 讀取數百個檔案，填滿了上下文。

  修正：將調查範圍縮小或使用子代理，以便探索不會消耗你的主要上下文。

​

培養您的直覺

​

相關資源

• Claude Code 如何工作：代理循環、工具和 context 管理
• 擴展 Claude Code：skills、hooks、MCP、subagents 和 plugins
• 常見工作流：調試、測試、PR 等的分步配方
• CLAUDE.md：存儲項目約定和持久 context