Logo
Published on

Claude Code Best Practices：Anthropic 官方最佳實踐指南

在 AI 輔助開發工具快速發展的今天，Claude Code 已成為許多開發者的得力助手。2025 年 5 月 22 日，在美國舊金山的一場技術分享會上，Anthropic Applied AI 團隊的核心貢獻者 Cal 分享了官方的 Claude Code 最佳實踐指南。這場演講不僅深入探討了 Claude Code 的運作原理，更提供了一系列實用的技巧和工作流程，幫助開發者更有效地利用這項強大的工具。

講者背景與初次體驗

Cal 是 Anthropic Applied AI 團隊的核心貢獻者，已在 Anthropic 工作約一年半，主要負責協助客戶與合作夥伴建構優質產品與服務。這意味著他大部分時間都在與 Claude 模型互動，尋求最佳的輸出結果。

作為一個熱愛開發但常常半途而廢的開發者，Cal 在去年底首次接觸 Claude Code 後，對其留下了深刻印象。他分享了一個令人印象深刻的經歷：利用 Claude Code 在一個週末內大幅推進了原本難以完成的筆記應用程式專案，體驗到一種全新的軟體工程工作方式。

正是這種驚人的生產力提升，讓 Cal 成為內部 Claude Code 使用量的冠軍，並最終成為該工具的核心貢獻者之一，專注於系統提示、工具運作方式及評估機制的改進。

Claude Code 運作原理：像一位精通終端機的同事

Cal 用了一個很生動的比喻來解釋 Claude Code 的本質：它就像「一位精通終端機的同事」，能在終端機中迅速處理各種複雜的指令與操作。這讓人想起許多開發者都有過的經歷——身邊總有那麼一位技術大神，能夠在命令列中快速解決各種看似複雜的問題。

從技術層面來看，Anthropic 秉持「簡單有效」的原則，將 Claude Code 設計為一個「純粹的代理程式」(pure agent)。其核心組成包括：

核心組件

指令系統：提供模型執行任務的基礎引導，就像給一個新同事詳細的工作指南。

強大工具集：賦予模型實際操作的能力，包括：

  • 建立與編輯檔案
  • 使用終端機執行 Bash 命令
  • 透過 MCP (Model-Controlled Programs) 協議整合外部功能

循環執行機制：模型在接收到指令後，會持續運用這些工具，直到它認為任務完成為止。

Claude Code 透過這些強大的工具和豐富的資源來理解程式碼並執行任務，這使其能像人類開發者一樣，在命令列環境中流暢地操作，從而實現高效的自動化開發。

五大最佳實踐指南

為了從 Claude Code 中獲取最大效益，Cal 提出了五個關鍵的最佳實踐：

1. 善用 Claude.md 檔案作為模型「記憶」

Claude Code 代理程式本身不具備跨會話記憶，因此 Claude.md 檔案成為共享狀態和關鍵指令的主要方式。

檔案作用：啟動 Claude Code 時，系統會將 Claude.md 的內容注入提示，告知模型重要的開發者指令。

放置位置：

  • 專案目錄中：與團隊成員共享專案特定的指令
  • 家用目錄：存放個人化的通用指令

建議內容：

  • 單元測試運行方式
  • 專案結構概覽
  • 測試檔案位置
  • 模組定義
  • 程式碼風格指南

進階功能：新版本允許在 Claude.md 中使用 @ 符號引用其他檔案，進一步擴展知識庫。

2. 優化權限管理

Claude Code 預設允許讀取操作，但對於可能修改系統的操作會提示用戶確認。

快速批准：使用 Shift + Tab 鍵可讓 Claude Code 直接開始工作，無需逐一確認。

自訂批准設定：可在設定中配置特定 Bash 命令（如 npm run test）始終自動批准，加速重複性任務的執行。

3. 整合外部工具與服務

Claude Code 天生擅長使用終端機工具，可透過整合 CLI 工具來大幅擴展其能力。

推薦 CLI 工具：

  • GitHub 的 gh 工具：執行 GitHub 相關操作
  • 各種語言和框架的官方 CLI 工具

選擇建議：優先使用廣為人知且文檔齊全的 CLI 工具，而非額外設定 MCP 伺服器，除非是內部特有的工具需求。

4. 高效的上下文管理

Anthropic 模型擁有 200,000 令牌的上下文窗口，但長時間會話可能會耗盡。

警告機制：當上下文窗口即將填滿時，右下角會出現警告提示。

管理命令：

  • /clear 命令：清除當前會話的所有上下文（保留 Claude.md 內容），重新開始
  • /compact 命令：將當前會話內容摘要成簡潔的訊息，以該摘要作為新會話的起始上下文

Cal 特別強調，團隊投入大量時間優化 /compact 功能，確保摘要的有效性和連續性。

5. 智慧型工作流程技巧

規劃優先：讓 Claude Code 先制定解決方案計畫，再執行實際操作。這讓開發者能夠審核方案並避免不必要的錯誤。

測試驅動開發 (TDD)：鼓勵讓 Claude Code 執行小規模修改後立即運行測試，確保程式碼正確性。

持續整合實踐：

  • 定期檢查 TypeScript 和 Linting
  • 經常提交程式碼，便於問題發生時快速回溯

視覺化除錯：Claude Code 支援多模態輸入，可直接貼上錯誤截圖或指定圖片檔案，讓模型根據視覺資訊進行分析和開發。

進階使用技巧與最新功能

並行處理能力

經驗豐富的使用者可以嘗試在不同終端機或 tmux 分頁中同時運行多個 Claude Code 實例，協同處理更複雜的任務。

即時控制技巧

中斷與介入：在 Claude Code 執行期間按下 Escape 可中斷其操作並及時修正方向。

回溯功能：連續按兩次 Escape 鍵可以回溯對話，重置到之前的狀態。

模型切換與思考機制

模型選擇：

  • 使用 /model 命令查看當前運行的模型（預設為 Sonnet）
  • 透過 /config 或直接在命令中切換至其他模型（如 Opus）

思考能力提升：新版本的 Claude 模型能夠在執行工具呼叫之間進行「擴展思考」，這顯著提升了解決複雜問題的能力。

IDE 整合改進

Claude Code 與 VS Code 和 JetBrains 等 IDE 的整合已大幅增強，能更好地感知當前檔案和專案上下文，提供更精準的協助。

問答環節重點整理

多個 Claude.md 檔案的處理

Claude Code 預設只讀取：

  • 當前工作目錄的 Claude.md
  • 用戶主目錄下的 Claude.md

雖然子目錄中的 Claude.md 不會自動讀取，但 Claude Code 在搜尋時會「發現」並考慮相關的子目錄檔案。開發者也可以在主 Claude.md 中使用 @ 符號引用其他檔案。

指令遵循改進

過去的模型版本可能會忽略某些指令，但新版本的 Claude 在遵循指令和減少不必要的內聯註釋方面已大幅改進，能更嚴格按照 Claude.md 的指示執行。

多代理執行與上下文共享

目前 Claude Code 主要被設計為單一強大的代理程式。若要實現多個代理程式之間的上下文共享，Cal 建議讓代理程式將共享狀態寫入共同檔案（如 ticket.md），然後另一個代理程式讀取該檔案來獲取上下文，模擬多個開發者透過檔案溝通的模式。

個人心得與延伸閱讀

可惜這場演講的影片太晚放出來了，很多的內容都已經知道的差不多了，而且這段期間 Claude Code 功能更新速度非常快，少了蠻多這段期間出的新功能，尤其是 sub-agent 的概念。

不過，這場演講的價值在於它來自 Anthropic 官方團隊的核心貢獻者，提供了第一手的專業見解和使用建議。對於想要深入掌握 Claude Code 的開發者來說，還是值得看一下。

如果您想瞭解更多 Claude Code 的實用技巧，可以參考我之前分享的文章：Claude Code Tips，其中涵蓋了更多日常使用的小技巧和經驗分享。

總結

Claude Code 作為 AI 輔助開發的強大工具，其潛力遠不止於簡單的程式碼生成。透過遵循這些官方最佳實踐，開發者可以將其轉化為真正的生產力倍增器：

  1. 建立有效的知識管理：透過 Claude.md 檔案系統性地傳達專案需求和規範
  2. 優化工作流程：合理配置權限和自動化設定，減少重複性操作
  3. 善用工具生態：整合現有 CLI 工具，擴展 Claude Code 的能力範圍
  4. 管理上下文資源：適時使用清理和壓縮命令，維持高效的對話狀態
  5. 採用智慧工作方式：結合規劃、測試和視覺化除錯，提升開發品質

隨著 AI 技術的不斷演進，掌握這些最佳實踐不僅能幫助我們更好地利用當前的工具，更重要的是培養與 AI 協作的思維模式。在這個人工智慧與人類智慧相輔相成的時代，學會如何有效地與 AI 工具協作，將成為每個開發者必備的核心技能。

支持創作

如果這篇文章對您有幫助，歡迎透過 贊助連結 支持我持續創作優質內容。您的支持是我前進的動力！

圖片來源：AI 產生