Claude Code 最佳實踐

​

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

​

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

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 在回應前讀取文件。
• 直接粘貼圖像。複製/粘貼或將圖像拖放到提示中。
• 提供 URL 用於文檔和 API 參考。使用 /permissions 將常用域名列入白名單。
• 通過運行 cat error.log | claude 管道數據，直接發送文件內容。
• 讓 Claude 獲取它需要的內容。告訴 Claude 使用 Bash 命令、MCP 工具或通過讀取文件自己拉取上下文。

​

配置您的環境

​

編寫有效的 CLAUDE.md

# Code style
- Use ES modules (import/export) syntax, not CommonJS (require)
- Destructure imports when possible (eg. import { foo } from 'bar')

# Workflow
- Be sure to typecheck when you're done making a series of code changes
- Prefer running single tests, and not the whole test suite, for performance

See @README.md for project overview and @package.json for available npm commands.

# Additional Instructions
- Git workflow: @docs/git-instructions.md
- Personal overrides: @~/.claude/my-project-instructions.md

• 主文件夾（~/.claude/CLAUDE.md）：適用於所有 Claude 會話
• 項目根目錄（./CLAUDE.md）：簽入 git 以與您的團隊共享
• 父目錄：對於 monorepos 很有用，其中 root/CLAUDE.md 和 root/foo/CLAUDE.md 都會自動拉入
• 子目錄：當在這些目錄中的文件上工作時，Claude 按需拉入子 CLAUDE.md 文件

​

配置權限

• Auto mode：一個單獨的分類器模型審查命令並僅阻止看起來有風險的內容：範圍升級、未知基礎設施或由敵對內容驅動的操作。最適合當您信任任務的總體方向但不想點擊每一步時
• 權限白名單：允許您知道安全的特定工具，如 npm run lint 或 git commit
• 沙箱：啟用操作系統級隔離，限制文件系統和網絡訪問，允許 Claude 在定義的邊界內更自由地工作

​

使用 CLI 工具

​

連接 MCP servers

​

設置 hooks

​

創建 skills

---
name: api-conventions
description: REST API design conventions for our services
---
# API Conventions
- Use kebab-case for URL paths
- Use camelCase for JSON properties
- Always include pagination for list endpoints
- Version APIs in the URL path (/v1/, /v2/)

---
name: fix-issue
description: Fix a GitHub issue
disable-model-invocation: true
---
Analyze and fix the GitHub issue: $ARGUMENTS.

1. Use `gh issue view` to get the issue details
2. Understand the problem described in the issue
3. Search the codebase for relevant files
4. Implement the necessary changes to fix the issue
5. Write and run tests to verify the fix
6. Ensure code passes linting and type checking
7. Create a descriptive commit message
8. Push and create a PR

​

創建自定義 subagents

---
name: security-reviewer
description: Reviews code for security vulnerabilities
tools: Read, Grep, Glob, Bash
model: opus
---
You are a senior security engineer. Review code for:
- Injection vulnerabilities (SQL, XSS, command injection)
- Authentication and authorization flaws
- Secrets or credentials in code
- Insecure data handling

Provide specific line references and suggested fixes.

​

安裝 plugins

​

有效溝通

​

詢問代碼庫問題

• 日誌記錄如何工作？
• 我如何創建新的 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。Context 被保留，所以您可以重定向。
• Esc + Esc 或 /rewind：按 Esc 兩次或運行 /rewind 打開倒帶菜單並恢復之前的對話和代碼狀態，或從選定的消息進行總結。
• 「撤銷那個」：讓 Claude 恢復其更改。
• /clear：在不相關的任務之間重置 context。具有不相關 context 的長會話可能會降低性能。

​

積極管理 context

• 在任務之間頻繁使用 /clear 以完全重置 context window
• 當自動壓縮觸發時，Claude 總結最重要的內容，包括代碼模式、文件狀態和關鍵決策
• 為了更好地控制，運行 /compact <instructions>，如 /compact Focus on the API changes
• 要僅壓縮對話的一部分，使用 Esc + Esc 或 /rewind，選擇消息檢查點，然後選擇 從此處進行總結。這會壓縮該點之後的消息，同時保持早期 context 完整。
• 在 CLAUDE.md 中使用像 「壓縮時，始終保留完整的修改文件列表和任何測試命令」 這樣的指令自定義壓縮行為，以確保關鍵 context 在總結中存活。
• 對於不需要留在 context 中的快速問題，使用 /btw。答案出現在可關閉的覆蓋層中，永遠不會進入對話歷史記錄，所以您可以檢查詳細信息而不會增加 context。

​

使用 subagents 進行調查

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

use a subagent to review this code for edge cases

​

使用檢查點倒帶

​

恢復對話

claude --continue    # Resume the most recent conversation
claude --resume      # Select from recent conversations

​

自動化和擴展

​

運行非交互模式

# 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

​

運行多個 Claude 會話

• Claude Code 桌面應用：以視覺方式管理多個本地會話。每個會話都有自己的隔離 worktree。
• Claude Code 在網絡上：在 Anthropic 的安全雲基礎設施上在隔離的 VM 中運行。
• Agent teams：多個會話的自動協調，具有共享任務、消息和團隊領導。

​

跨文件扇出

for file in $(cat files.txt); do
  claude -p "Migrate $file from React to Vue. 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"

​

避免常見的失敗模式

• 廚房水槽會話。 您從一個任務開始，然後詢問 Claude 不相關的事情，然後回到第一個任務。Context 充滿了不相關的信息。

  修復：在不相關的任務之間使用 /clear。

• 一次又一次地改正。 Claude 做錯了什麼，您改正它，它仍然是錯的，您再次改正。Context 被失敗的方法所污染。

  修復：在兩次失敗的改正後，/clear 並編寫一個更好的初始提示，包含您學到的內容。

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

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

• 信任然後驗證的差距。 Claude 產生看起來合理的實施，但不處理邊界情況。

  修復：始終提供驗證（測試、腳本、截圖）。如果您無法驗證它，不要發布它。

• 無限探索。 您要求 Claude「調查」某些內容而不限定範圍。Claude 讀取數百個文件，填滿 context。

  修復：狹隘地限定調查範圍或使用 subagents，以便探索不會消耗您的主 context。

​

培養您的直覺

​

相關資源

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