編輯 | 云昭

出品 | 51CTO技術棧（微信號：blog51cto）

Claude Code 終于有了官方大佬出來分享內部的最佳實戰(zhàn)哲學了。

兩天前，Anthropic 官方 YouTube 賬號放出了一個AI應用技術團隊的老大在舊金山的 Code w/ Claude 會議上的分享內容。

這個分享全程25分鐘，可以說句句干貨，講述了 Claude Code 的誕生和最佳實踐原則，用分享者 Cal Rueb 的話說就是揭開“引擎底蓋”，看看底層就是是如何運作的。

Rueb 是 Anthropic 技術團隊成員，加入公司已經(jīng)近兩年，是 CC 的核心貢獻成員。

Rueb 現(xiàn)在主要負責設計該產(chǎn)品的提示詞、系統(tǒng)提示、工具描述和結果處理，同時也參與評估工具更新后的效果。所以，Rueb 將 Claude Code描述為一組強大提示和工具，通過循環(huán)運行模型來完成負責任務的純粹 Agent，并詳細解釋了 CC 的底層運作原理。

最佳實踐部分 cover 了許多厲害的用例，從如何使用 ??claude.md?? 文件到權限控制，從高效上下文管理到有效整合工作流、到進階技巧，再到部署和CI/CD的無頭自動化?？芍^最全的一次官方爆料。

話不多說，這就為為大家奉上 Anthropic 的內部CC最佳實踐。

1.我是如何加入Claude Code團隊的？

大家好，我們開始吧。歡迎來到“Claude Code 最佳實踐”分享會。

這次分享我會先從高層次介紹一下什么是 Claude Code，然后我們會稍微“揭開引擎蓋”，看看它底層是如何工作的。了解工具的工作原理是很有價值的，接著我會講講它的使用場景，以及我們自己團隊和用戶總結出的最佳實踐，幫助你更高效地使用這個工具。

圖片

在正式開始之前，我想先簡單介紹一下自己，以及我是怎么來到這個講臺上的。

我叫 Cal，我在大約一年半前加入了 Anthropic，幫助創(chuàng)建了一個叫“應用 AI（Applied AI）”的團隊。我們團隊的使命是幫助客戶和合作伙伴，基于 Claude 打造出優(yōu)秀的產(chǎn)品和功能。換句話說，我的日常工作之一就是不斷地對 Claude 進行提示（prompting），以獲得最佳輸出。當然，我本身也熱愛編程，我是那種經(jīng)常有點子、啟動很多項目，但很多都沒做完的開發(fā)者——我有一整座“項目墳場”，里面堆滿了我寫了一半的代碼。但我一直喜歡嘗試新東西。

去年年底，有一天我在 Slack 上聽說了一個新的工具，一些同事說它特別酷。于是那個星期五晚上，我下載了它的早期版本——后來就成了 Claude Code。我把它用在了我想做的一個筆記應用上，那整個周末的體驗完全改變了我寫代碼、甚至是思考軟件工程的方式。

我整個周末都在帶著電腦，不停地試 Claude Code，看它工作。我敲下回車，然后切到瀏覽器刷新頁面，看著一個強大而完整的應用一步步呈現(xiàn)在我面前。這種體驗太震撼了。我比平時寫代碼能推進得遠得多。

但我也有點小擔心……畢竟我知道模型的運行成本，我當時就在想：“我是不是用了太多 tokens（調用次數(shù)）？會不會被抓包？”而實際上，我不知道的是 Claude Code 團隊內部其實做了一個排行榜，統(tǒng)計每個 Anthropic 員工使用 Claude Code 的情況，而我那個周末直接沖到了榜首！

這也讓我有機會認識了 Boris、Cat 和 Claude Code 的早期開發(fā)團隊。我們聊了起來，我說，“我超喜歡這個工具，同時我對 prompt 設計也很熟，可以幫上忙嗎？”之后我就加入了他們，成了核心貢獻者之一。

我現(xiàn)在主要負責設計提示詞（prompts）、系統(tǒng)提示、工具描述和結果處理，同時也參與評估工具更新后的效果：當我們更改 prompt 時，如何判斷它是優(yōu)化了還是反而把 Claude Code 搞壞了。

2.CC是純粹的Agen工具，它底層如何工作的？

好，說到這我們正式進入正題。

我目前對 Claude Code 的理解是這樣的：它就像是你團隊里那個“全靠終端”的同事。他們從來不用圖形界面，只用命令行，非常厲害。

圖片

我還記得當我還是一個初級工程師時，我有個導師 Tony。我常跑去請教他，“Tony，幫我看看這個 bug 怎么搞？”然后他會打開終端，飛快地用 bash、Vim 操作一堆命令，每次我都站在旁邊震驚地想：“我也得學會這個??！”（當然，后來也沒學會。）

而 Claude Code 就像是你隨時身邊有個 Tony。

那 Claude Code 背后是怎么運作的呢？

在 Anthropic，我們有個理念叫“用最簡單的方式解決問題”。Claude Code 就是一個我們稱之為“純粹 Agent（智能體）”的工具。也就是說，它本質上是一組說明書（prompt）、一組強大工具，然后模型會以循環(huán)方式運行，直到它覺得完成任務了。

Claude Code 所用的工具，是那種高手在終端上操作時用的工具——可以創(chuàng)建、編輯文件，可以運行命令行工具，也能用 MCP 拉取一些額外的資源。

圖片

至于 Claude 如何理解整個代碼庫呢？一年前你如果要做一個編程 Agent，可能會想，“我得把所有代碼文件都 index（索引）起來，做 embedding，搞一個 RAG 檢索系統(tǒng)?！盋laude Code 完全不這么干。它沒有做索引。

它是“探索式理解”。就像你加入一個新團隊，要了解代碼庫時你會怎么做？你會用搜索工具，比如 ??? grep???、?? find???、?? glob??，去一點點探索。Claude Code 也是這么做的。它會先搜一圈，再根據(jù)結果判斷需不需要再搜，然后繼續(xù)探索。這就是我們說的“agentic search”。

在這些基礎能力之上，Claude Code 還有一個很輕量的 UI 層，能讓你“看”到 Claude 是怎么工作的。還有權限控制機制，當它要做一些“危險操作”（比如寫文件或運行命令）時會彈出提示讓用戶決定是否繼續(xù)。我們也非常注重安全。

此外，由于 Claude 的模型不僅可以通過 Anthropic 的 API 使用，也可以通過 AWS 和 GCP 等云服務訪問，所以你也可以很方便地在這些環(huán)境中運行 Claude Code。

3.CC到底能用來做什么

很多人問我：“Cal，Claude Code 到底能用來做什么？”答案是：幾乎什么都行。

首先是熟悉新項目代碼。你可能剛加入一個團隊，或是開始一個開源項目，一開始效率都很低，因為你在找方向。而 Claude Code 可以幫你快速熟悉代碼，比如：“這個功能在哪實現(xiàn)的？”“看看這段代碼過去幾周的變動歷程？”等等。

另外一個我覺得被低估的用途是——Claude Code 作為你的“思維搭子”。我經(jīng)常在寫代碼前，會跟 Claude 聊一下，“我打算加一個功能，你能不能先看看代碼庫，大概搜搜我們要怎么做？給我?guī)讉€實現(xiàn)方案?！盋laude 會用 agentic search 探索，然后再回來跟我講它找到的路徑。這樣我可以先評估，再決定怎么做。

當然，它也非常擅長寫代碼。無論是從零開始構建項目，還是在已有代碼基礎上修改、擴展，Claude Code 都能處理。我們團隊自己的代碼覆蓋率非常高，就是因為 Claude Code 讓寫單元測試變得非常簡單。

還有一點，我們的提交記錄和 PR 信息也很優(yōu)秀，因為我們每次提交時都會讓 Claude Code 幫我們寫 commit message 或 PR 描述。

在代碼生命周期的其他階段，比如 CI/CD、部署、debug 等，Claude Code 也能大顯身手。很多人會把它嵌入到工作流中，比如用 SDK 無頭調用、集成到 GitHub 中等等。

此外，我們還聽說不少用戶在搞老代碼遷移時（比如從老版本 Java 升級，或從 PHP 遷移到 React）會用 Claude Code 幫忙，因為它能把這些大型項目拆解得更有條理、讓團隊更有信心。

圖片

最后別忘了，Claude Code 非常擅長命令行工具，比如 Git、Docker、BigQuery 等。你再也不用怕卡在 rebase 里出不來了，直接讓 Claude Code 給你搞定，非常強大。

4.秘籍來了！內部最佳實踐

我們說完用法，再來說說最佳實踐。

第一條——使用 ??claude.md?? 文件。Claude Code 是個 Agent，它沒有持久記憶。所以我們共享上下文的方式，是用這個Markdown 文件。只要它在當前目錄中，Claude Code 啟動時就會把它“注入”到 prompt 里。

你可以寫：單元測試的運行方式、項目結構、風格指南等等，讓 Claude 更聰明地工作。你可以把這個文件加入 Git 項目里，所有人共享；也可以放在自己家目錄，讓 Claude 在任何項目中都能知道你的偏好。

圖片

第二條是權限控制。Claude Code 默認對“讀取”操作是自動批準的，但當它要寫入

文件或執(zhí)行腳本命令時，就會彈出確認窗口，讓你點“允許”或者“禁止”，這樣就避免了潛在的破壞性操作。

我們繼續(xù)講權限管理這個話題。

使用權限管理并靈活配置它，會讓你工作更高效。有個叫“自動接受模式”的功能：當你在使用 Cloud Code 時，按下 ??? Shift + Tab??，Claude 就會立刻開始工作。你還可以在設置中配置 Claude，比如對某些 bash 命令默認允許執(zhí)行，比如你已經(jīng)厭煩了反復確認 

?? npm run test??，就可以設定始終允許執(zhí)行這個命令。

圖片

在整合工作流方面，有個關鍵點是：記住 Claude 在終端表現(xiàn)非常出色。如果你常用的一些工具支持命令行訪問，比如 GitHub 就有一個強大的 CLI 工具叫 ??? gh??，你可以通過安裝更多 CLI 工具或掛載更多 MCP 服務器，把更多工作交給 Claude 來做。

從經(jīng)驗來看，如果你在“本地安裝 CLI 工具”和“安裝 MCP 服務器”之間糾結，我建議優(yōu)先考慮 CLI 工具。如果你有自己的內部工具，比如我們在 Anthropic 用的 ?? kube???，你也可以讓 Claude 知道這些工具的存在，并寫進 ?? claude.md??文件中。

接下來是“上下文管理”。

Claude 是一個智能體，運行過程中會不斷調用工具，累積上下文信息。Anthropic 的模型支持最多 20 萬個 token 的上下文窗口，但你確實有可能會把這個窗口填滿。

圖片

當你長時間和 Claude 協(xié)作，來回交互時，你會在界面右下角看到一個提示，說上下文快滿了。那這時你有兩個選擇：

• 輸入?? /clear????命令，清除當前上下文（但不會清除?? claude.md????等關鍵文件），重新開始。
• 輸入??? /compact???，這會觸發(fā) Claude 總結當前會話的過程，相當于說：“我要離開，把這段工作移交給另一個開發(fā)者。”Claude 會生成一個總結，用這個總結作為新的上下文，繼續(xù)任務。

我們花了很多時間打磨這個“compact”功能，讓它在上下文窗口爆滿時，能無縫接續(xù)下去。

5.高效工作流建議

你該怎么更有效使用 Cloud Code？

1）用它做規(guī)劃和任務拆解

不是一上來就“Claude，修這個 bug”。更好的方式是說：“Claude，我遇到了這個 bug。你能搜索一下，找出可能的原因，然后幫我規(guī)劃一個修復方案嗎？”這樣你可以先驗證 Claude 的思路，然后再決定是否執(zhí)行。

2） 關注 To-Do 列表

Claude 在處理大任務時會自動生成 To-Do 列表。你可以一邊觀察這個列表，一邊判斷它有沒有跑偏。如果你發(fā)現(xiàn)不合理的條目，可以按 ?? Escape?? 鍵打斷并說：“Claude，我覺得這個 To-Do 不太對，咱們換個思路?！?/p>

圖片

3）Smart Vibe Coding（有意識地使用 Claude 編碼）

雖然很誘人——只想敲回車讓 Claude 自己完成一切，但其實你可以：

• 用測試驅動開發(fā)；
• 讓 Claude 做小步提交，頻繁運行測試；
• 加入類型檢查和 lint 檢查；
• 定期 commit，如果出錯可以回滾。

4）利用截圖進行調試

Claude 基于多模態(tài)模型。你完全可以截圖粘貼給它，或者直接說“Claude，請看 mock.png，然后幫我寫這個網(wǎng)頁”。

6.進階技巧

1） 開啟多個并行實例

你可以試著開啟多個 Claude 實例。我知道一些 Anthropic 的同事和客戶，最多同時跑四個 Claude 實例，用 Tmux 或多個終端標簽頁來控制。這種“多 Agent 編排”的體驗很有趣。雖然我自己最多能同時用兩個，但我建議你也試試。

2） 善用 Escape 鍵

Claude 工作時，按 ??? Escape???可以中斷它，適時插話很關鍵。如果你按兩次 ?? Escape??

，還有隱藏功能：你可以回到上一個對話節(jié)點，重置當前工具鏈和 MCP 執(zhí)行上下文。

圖片

3）MCP 擴展和 Headless 自動化

如果 Claude 的 bash 和 CLI 工具都搞不定某件事，這時就該考慮 MCP Server 了。

我們最感興趣、也是目前仍在探索的方向是：如何以編程方式調用 Claude。

比如集成進 GitHub Actions。這是我們正在研究的方向，也歡迎你們去探索各種創(chuàng)意用法。

7.實時更新提示

現(xiàn)在我切換到電腦，展示一些今天最新的變化：

• 輸入?? /model???，你可以看到當前使用的 Claude 模型。比如我現(xiàn)在用的是 Sonnet，但我也可以切換到 Opus。
• 輸入??? /config???，可以在配置中切換模型。

新模型支持“工具調用之間思考（think between tool calls）”。以前 Claude 只能在工具調用前思考，現(xiàn)在可以在中間過程也進行深度思考。你會看到 Claude 輸出淺灰色文字，然后調用文件、讀取信息、繼續(xù)分析。

建議你在處理任務或排查 bug 時，插入 ??? think hard??，讓 Claude 更深入思考。

圖片

IDE 插件更新

我們在 VS Code 和 JetBrains 系列中都做了深度集成。Claude 可以知道你當前所在的文件，并根據(jù)上下文進行處理。

8.最后一點建議：保持關注！

我們在 GitHub 上維護了一個開源項目 Claude Code，你可以在那里提交 issue，也可以訂閱更新日志。即使是我本人都經(jīng)?？床煌晡覀儼l(fā)布的新功能。

9.幾個疑惑解答

最后還有四分鐘，我可以回答任何關于 Cloud Code 的問題，也可以現(xiàn)場演示。

支持多個claude.md 文件嗎？

現(xiàn)場一位朋友問到：能否支持一個項目里多個 ??? claude.md??文件？

回答：是的——不過要注意：同一目錄中不能存在多個 ??claude.md???，但你可以在子目錄中放不同的 ?? claude.md??文件。默認只會讀取當前工作目錄的那個，如果你打開的是一個 monorepo 頂層目錄，那可能會“爆掉上下文”，所以 Claude 會自動過濾不相關的。

你也可以在 ?? claude.md???文件里用 ?? @??引用其他文件，來擴展 Claude 的記憶。

圖片

關于 Claude 不聽指令的問題

有觀眾反饋說，明明在 ??? claude.md??里寫了不要生成注釋，Claude 還是會在重構時寫上一堆明顯廢話的注釋。

答：這個問題本質上是模型層面的問題，而不是 prompt 的問題。我們在 3.7 版本中已經(jīng)做了很多抑制注釋生成的工作，在 Claude 4 中這個問題已經(jīng)大大改善了。同時，Claude 4 對于 ??? claude.md???的指令服從度也顯著提升。建議你趁此機會重新檢查一下?? claude.md??文件，看是否需要精簡或更新內容。

關于多 Agent 的上下文繼承

最后有人問：能否讓多個 Claude 實例共享上下文，比如 Agent 2 和 3 繼承 Agent 1 的上下文？

目前官方并未支持原生功能，但你可以采用“寫入共享 markdown 文件”的方法作為 workaround。例如：

• 讓 Claude 把當前任務狀態(tài)寫進?? ticket.md??；
• 然后另一個 Claude 實例讀取這個文件，并繼續(xù)工作。

未來我們可能會設計更原生的上下文同步方式。

好了，這篇文章結束了。評論區(qū)的各位大佬最近有遇到哪些 Vibe Coding 的工具問題，歡迎交流。

參考鏈接：??https://www.youtube.com/watch?v=gv0WHhKelSE??

本文轉載自??51CTO技術棧??，作者：云昭