白話文讀懂Claude Code最佳實踐指南，學不會退網
今天來說說claude code。
這是一篇關于Claude Code 最佳實踐的分享文章。
原文有點晦澀難懂，我對此進行了修改優化，增加一些截圖，配合各位讀者朋友進行閱讀。
為了更加通俗易懂并且容易入門，我結合了4月份Claude Code 官方出品的一篇文章進行解讀，如有謬誤，懇請勘誤。
本篇文章主要介紹：
- 介紹Claude Code的概念。
- 探討Claude Code內部工作原理。
- 探討Claude Code的理想應用場景。
- 分享Claude Code最佳實踐指南。
首先介紹一下原作者。
原分享人（作者）Cal，大約一年半前加入 Anthropic，參與創建了“應用 AI”團隊。然后他的的日常工作就是大量地與 Claude 交互，通過提示工程（Prompt Engineering）來挖掘模型的最佳性能。
Cal也是一個瘋狂癡迷AI編程的奇人，因為瘋狂刷Claude Code的token，使用量飆升到了內部排行榜榜首，依托他對提示工程的理解，成功加入了這個團隊，成為核心貢獻者之一。
同樣的道理：AI時代，抓住機會正確地卷，一切皆有可能。
目前他本人主要負責提示工程、系統提示、工具集成以及效果評估等工作，確保對工具的每一次迭代都能帶來真正的提升。
Claude Code 是什么？
Claude Code不知道什么時候火起來的，姑且不論。
很多開發者朋友都在問，它到底是什么？
就像MCP剛出來那會，有人就問，MCP到底是什么？
來自Cal的一個很形象的比喻：
Claude Code 就像你們公司團隊里那個總是在默默無聞（Terminal）里完成所有工作（coding）的全棧技術大牛。
Claude Code大牛從不使用圖形用戶界面（GUI），能力超群。
很多人會問，Claude Code 為什么這么難用（我也覺得）？
根據他們官網的描述，Claude Code 刻意追求低級和開放性，提供接近原始模型的訪問，而無需強制執行特定的工作流程。這種設計理念打造了一個靈活、可定制、可腳本化且安全的強大工具。
對于剛接觸編碼工具的工程師來說，學習難度較高。
但是，如果在你的電腦上擁有了 Claude Code，就如同擁有了一個什么都可以幫你做的全棧大牛（除了不能幫你生娃）。
忍受一下學習的苦，也未嘗不可。
深入理解：Claude Code 的工作原理
Cal談到，在 Anthropic內部，員工比較信奉“可以奏效的簡單方案”（The Simple Thing That Works），也就是說，有一些非必要的流程消耗可以砍掉了。
Claude Code 就是非常純粹的 AI 智能體（AI Agent），因為它只懂得幫你干活，很純粹，很簡單，沒有任何心眼子。
核心： AI 智能體
Claude Code為什么這么簡單高效呢？
Claude Code作為一個成功的AI智能體，制勝的秘訣在于：
- 有明確的指令 (Instructions)
- 裝備了強大的工具集 (Powerful Tools)：比如說編輯/創建文件、使用CLI或MCP工具、提交commit等。
- 有循環執行機制 (Loop)
模型會根據指令，在一個循環中持續調用工具，直到它自主判斷任務已經完成。
Claude Code 的工具集正是那些終端高手所鐘愛的：創建和編輯文件的工具、執行終端命令的工具等。
獨特的代碼理解方式
與傳統編程AI工具不同，Claude Code 在理解代碼庫時，不進行任何形式的索引或 RAG（檢索增強生成）。
它的工作方式更像一個新人加入團隊后熟悉項目的過程——通過探索來理解，稱之“智能體式搜索”。它會使用glob、grep、find 等命令在代碼庫中穿梭，閱讀文件，理解項目結構和邏輯。
這意味著模型可以先進行一次搜索，然后根據搜索結果判斷：“嗯，我可能還需要了解另外幾件事。” 于是它會進行更多的搜索，逐步構建起對整個代碼庫的認知。
完善的輔助系統
在這個核心智能體之上，他們還構建了一些關鍵部分：
輕量級用戶界面：讓你能實時觀察 Claude Code 的工作過程。
權限系統：在 AI 智能體執行讀取等安全操作時自動放行，但在執行寫入文件、運行命令等可能具有風險的操作時，會請求人類用戶授權，確保安全可控。
安全性與靈活性：由于 Claude Code 只是模型之上的一個輕量級封裝，你可以輕松地將其指向通過 AWS、GCP 等云服務商提供的 Claude 模型，以滿足不同的安全與合規需求。
Claude Code 使用入門
這部分主要認識一下CLAUDE.md文件，其他更加復雜的用法，，有機會看看。
為什么CLAUDE.md這么重要？
CLAUDE.md 是一個特殊文件，Claude 在發起對話時會自動將其拉入上下文中。
也就是說，它可以存儲如下信息：
- 常用 bash 命令
- 核心文件和實用函數
- 代碼風格指南、存儲庫規則
- 開發者環境設置、測試說明
- 項目特有的任何意外行為或警告
- 其他信息
CLAUDE.md 的格式實例如下：
# Bash commands
- npm run build: Build the project
- npm run typecheck: Run the typechecker
# 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剛啟動Claude Code，運行 /init 命令，會自動為你生成一個 CLAUDE.md。
新手用戶，可能會誤輸入指令，導致本地文件被刪以及更多系統bug，不過不用擔心。
Claude Code默認會請求任何可能修改系統的操作的權限，比如說文件寫入、bash 命令、MCP工具等等。
有四種方法可以管理允許的工具：
- 在會話期間出現提示時， 選擇“始終允許” 。
- 使用/permissions指令啟動Claude Code后，可以添加或移除允許列表中的工具。
你可以在里面添加允許的操作，比如添加 Edit 以始終允許文件編輯。
你也可以在Deny里面添加被拒絕執行的命令。
并且你還可以添加多個空間。
Claude Code中配置MCP工具
Claude Code默認通過CLI向導（claude mcp add）來配置MCP工具.
claude mcp add <server-name> -s user -- <command> [args...]部分SSE服務的，添加方法如下：
# 基礎
claude mcp add --transport sse <名稱> <URL>
# 添加SSE服務器
claude mcp add --transport sse sse-server https://example.com/sse-endpoint
# 添加帶自定義請求頭的SSE服務器
claude mcp add --transport sse api-server https://api.example.com/mcp -e X-API-Key=your-key使用命令行可進行MCP的管理。
# List all configured servers
claude mcp list
# Get details for a specific server
claude mcp get my-server
# Remove a server
claude mcp remove my-serverClaude Code 的應用場景
Claude Code 的應用范圍非常廣泛，幾乎涵蓋了軟件開發的全周期。
項目探索與上手 (Exploration)
當你加入一個新團隊或接觸一個開源項目時，往往需要花費大量時間熟悉代碼，Claude Code 可以極大縮短這個過程。
你可以直接問它：
這個產品功能是在哪里實現的？
或者
通過 Git 歷史，告訴我這段代碼在過去幾周發生了哪些變化？
成為你的伙伴 (Thought Partner)
在動手編碼前，你可以讓 Claude Code 扮演大軍師的角色。
你可以說：
我準備改造AI-Media2Doc功能，請你先研究一下代碼庫，為我提供兩到三種不同的實現方案，并分析優劣。暫時不要寫任何代碼。
Claude 會利用其智能體式搜索能力，為你提供決策參考。
高效構建與編碼 (Building & Coding)
從零到一：
你可以把它放進一個空目錄，讓它為你創建一個全新的應用或游戲。
在現有代碼庫中工作：
它能極大地提升日常開發效率，例如，為現有代碼快速添加單元測試。在 Claude Code 團隊內部，我們的單元測試覆蓋率非常高，這很大程度上歸功于此。此外，我們還可以讓它自動生成高質量的 Git 提交信息和 PR 描述。
部署與運維 (Deployment & Lifecycle)
通過 Claude Code SDK，你可以“無頭模式”（Headless Mode）以編程方式使用它，將其集成到 CI/CD 流程或 GitHub Actions 中，實現自動化工作流。
支持與規模化 (Support & Scaling)
幫助你更快地定位和修復 Bug。
許多團隊因為技術債而推遲了大型重構項目（如舊版 Java 升級、PHP 遷移到 React）。Claude Code 這樣的工具，使得這類原本望而生畏的項目變得更具可行性。
它精通各類命令行工具，如 Git、Docker、BigQuery 等。當你遇到棘手的 git rebase 沖突時，不必再頭痛，直接啟動 Claude Code，告訴它情況，讓它幫你解決。
最佳實踐與高級技巧
基礎最佳實踐
首先善用 claude.md 文件
這是在不同會話或團隊成員間共享狀態和指令的核心方式，相當于 Claude 的“長期記憶”。當 Claude 啟動時，它會自動讀取當前工作目錄下的 claude.md 文件，并將其內容作為核心指令。
你可以在里面存放項目特定的信息，如“如何運行單元測試”、“項目目錄結構概覽”、“團隊代碼風格指南”等。
你也可以在你的用戶主目錄（Home Directory）下放置一個全局的 claude.md 來存放通用指令。
智能管理權限
默認情況下，寫文件或執行命令需要手動確認。你可以使用“自動接受模式”（快捷鍵 Shift + Tab）讓 Claude 直接執行。
你可以在設置中將某些常用且安全的命令（如 npm run test）配置為始終自動批準，從而減少不必要的中斷。
優化集成設置
如果你使用的工具有命令行版本（如 GitHub 的 gh），請務必安裝它。這能讓 Claude 更方便地與外部服務交互。
如果你的公司有內部命令行工具，記得在 claude.md 文件里告訴 Claude 它的存在和用法。
有效管理上下文
模型擁有 20 萬 token 的超大上下文窗口，但在長時間的會話中仍有可能被填滿。
當右下角出現上下文即將用盡的警告時，你有兩個選擇：
/clear：清空當前會話，重新開始。
/compact：它會啟動一個內部提示，讓模型將當前會話的所有工作總結成一份摘要，然后用這份摘要作為新會話的“種子”，讓你無縫地繼續工作。
構建高效工作流
先計劃，后執行：
不要直接命令“修復這個bug”，而是說:
我遇到了這個bug，請先調查原因，然后給我一個修復計劃。
這樣你可以在它動手前驗證其思路是否正確。
利用待辦事項 (To-Do List)：在處理復雜任務時，Claude 會生成一個待辦事項列表。你可以觀察這個列表，如果發現方向不對，可以隨時按 Escape 鍵打斷它，并調整計劃。
擁抱測試驅動開發 (TDD)：讓 Claude 進行小范圍修改、運行測試、檢查代碼規范、然后提交。這種小步快跑的方式能確保項目不會偏離軌道。
利用多模態能力：你可以隨時粘貼截圖，或者讓 Claude 讀取圖片文件（如 mock.png），并根據視覺設計來構建界面。
高級技巧
當你熟練后，可以嘗試在 Tmux 或多個終端標簽頁中同時運行多個 Claude 智能體，讓它們并行處理不同任務。
這是一個有趣的挑戰，比如我就可以開3個終端同時并行運行。
Escape 鍵
單擊 Escape，隨時用它來打斷 Claude 的當前操作，并給出新的指示。知道何時打斷，是最大化效率的關鍵。
雙擊 Escape，雙擊可以讓你撤銷到上一次對話，相當于一次“重置”。
無頭模式與自動化，探索如何通過編程方式（SDK）在各種場景（如 GitHub Actions）中使用 Claude，將 AI 智能體的能力“撒”向開發工作流的每一個角落。
新功能速覽與問答
Claude發布新功能的速度非常快。
你現在可以在 Claude 中輸入 /model 來查看并切換當前使用的模型（如從 Sonnet 切換到 Opus）。
工具調用間的思考過程，從 Claude 3（Opus）開始，模型可以在兩次工具調用之間進行“思考”。你會看到用淺灰色文本顯示的思考過程，這對于理解其決策路徑和調試非常有幫助。
Claude Code與 VS Code 和 JetBrains 的集成為你帶來更流暢的體驗。
其實現在就可以在VS Code里面直接使用了，用起來崽爽。
現場問答 (Q&A)
問：一個項目里可以有多個 claude.md 文件嗎？
答： 在同一個目錄下不行。
Claude 啟動時只讀取當前工作目錄下的 claude.md。為避免在單一代碼庫（Monorepo）中上下文爆炸，它不會默認讀取子目錄的 claude.md。
但你可以在主 claude.md 中用 @ 符號引用其他文件，或者在啟動 Claude 時，鼓勵它去搜索并閱讀相關子目錄中的 claude.md。
問：我讓 Claude 遵守 claude.md 里的指令（比如不留注釋），但它不聽怎么辦？
答： 這是一個典型的模型行為問題，尤其在舊模型上更常見。好消息是，新一代模型（如 Opus）在遵循指令方面的能力已大幅提升。
問：可以實現多智能體并行執行，并讓它們共享上下文嗎？
答： 目前我們的理念是專注于打造一個極度強大的單一智能體。對于多智能體協作，今天的最佳實踐是通過文件進行狀態同步。你可以讓一個智能體將其中間結果或狀態寫入一個共享文件（如 ticket.md），然后讓另一個智能體去讀取這個文件，從而實現間接的協作。未來我們可能會探索更原生的多智能體協作功能。
參考：Claude Code：代理編碼的最佳實踐
本文轉載自?????AIGC新知?????，作者：絳燁
