今天來說說claude code。

這是一篇關(guān)于Claude Code 最佳實踐的分享文章。

原文有點晦澀難懂，我對此進(jìn)行了修改優(yōu)化，增加一些截圖，配合各位讀者朋友進(jìn)行閱讀。

為了更加通俗易懂并且容易入門，我結(jié)合了4月份Claude Code 官方出品的一篇文章進(jìn)行解讀，如有謬誤，懇請勘誤。

本篇文章主要介紹：

• 介紹Claude Code的概念。
• 探討Claude Code內(nèi)部工作原理。
• 探討Claude Code的理想應(yīng)用場景。
• 分享Claude Code最佳實踐指南。

首先介紹一下原作者。

原分享人（作者）Cal，大約一年半前加入 Anthropic，參與創(chuàng)建了“應(yīng)用 AI”團(tuán)隊。然后他的的日常工作就是大量地與 Claude 交互，通過提示工程（Prompt Engineering）來挖掘模型的最佳性能。

Cal也是一個瘋狂癡迷AI編程的奇人，因為瘋狂刷Claude Code的token，使用量飆升到了內(nèi)部排行榜榜首，依托他對提示工程的理解，成功加入了這個團(tuán)隊，成為核心貢獻(xiàn)者之一。

同樣的道理：AI時代，抓住機(jī)會正確地卷，一切皆有可能。

目前他本人主要負(fù)責(zé)提示工程、系統(tǒng)提示、工具集成以及效果評估等工作，確保對工具的每一次迭代都能帶來真正的提升。

Claude Code 是什么？

Claude Code不知道什么時候火起來的，姑且不論。

很多開發(fā)者朋友都在問，它到底是什么？

就像MCP剛出來那會，有人就問，MCP到底是什么？

來自Cal的一個很形象的比喻：

Claude Code 就像你們公司團(tuán)隊里那個總是在默默無聞（Terminal）里完成所有工作（coding）的全棧技術(shù)大牛。

Claude Code大牛從不使用圖形用戶界面（GUI），能力超群。

很多人會問，Claude Code 為什么這么難用（我也覺得）？

根據(jù)他們官網(wǎng)的描述，Claude Code 刻意追求低級和開放性，提供接近原始模型的訪問，而無需強(qiáng)制執(zhí)行特定的工作流程。這種設(shè)計理念打造了一個靈活、可定制、可腳本化且安全的強(qiáng)大工具。

對于剛接觸編碼工具的工程師來說，學(xué)習(xí)難度較高。

但是，如果在你的電腦上擁有了 Claude Code，就如同擁有了一個什么都可以幫你做的全棧大牛（除了不能幫你生娃）。

忍受一下學(xué)習(xí)的苦，也未嘗不可。

深入理解：Claude Code 的工作原理

Cal談到，在 Anthropic內(nèi)部，員工比較信奉“可以奏效的簡單方案”（The Simple Thing That Works），也就是說，有一些非必要的流程消耗可以砍掉了。

Claude Code 就是非常純粹的 AI 智能體（AI Agent），因為它只懂得幫你干活，很純粹，很簡單，沒有任何心眼子。

核心： AI 智能體

Claude Code為什么這么簡單高效呢？

Claude Code作為一個成功的AI智能體，制勝的秘訣在于：

• 有明確的指令 (Instructions)
• 裝備了強(qiáng)大的工具集 (Powerful Tools)：比如說編輯/創(chuàng)建文件、使用CLI或MCP工具、提交commit等。
• 有循環(huán)執(zhí)行機(jī)制 (Loop)

模型會根據(jù)指令，在一個循環(huán)中持續(xù)調(diào)用工具，直到它自主判斷任務(wù)已經(jīng)完成。

Claude Code 的工具集正是那些終端高手所鐘愛的：創(chuàng)建和編輯文件的工具、執(zhí)行終端命令的工具等。

獨特的代碼理解方式

與傳統(tǒng)編程AI工具不同，Claude Code 在理解代碼庫時，不進(jìn)行任何形式的索引或 RAG（檢索增強(qiáng)生成）。

它的工作方式更像一個新人加入團(tuán)隊后熟悉項目的過程——通過探索來理解，稱之“智能體式搜索”。它會使用glob、grep、find 等命令在代碼庫中穿梭，閱讀文件，理解項目結(jié)構(gòu)和邏輯。

這意味著模型可以先進(jìn)行一次搜索，然后根據(jù)搜索結(jié)果判斷：“嗯，我可能還需要了解另外幾件事。” 于是它會進(jìn)行更多的搜索，逐步構(gòu)建起對整個代碼庫的認(rèn)知。

完善的輔助系統(tǒng)

在這個核心智能體之上，他們還構(gòu)建了一些關(guān)鍵部分：

輕量級用戶界面：讓你能實時觀察 Claude Code 的工作過程。

權(quán)限系統(tǒng)：在 AI 智能體執(zhí)行讀取等安全操作時自動放行，但在執(zhí)行寫入文件、運(yùn)行命令等可能具有風(fēng)險的操作時，會請求人類用戶授權(quán)，確保安全可控。

安全性與靈活性：由于 Claude Code 只是模型之上的一個輕量級封裝，你可以輕松地將其指向通過 AWS、GCP 等云服務(wù)商提供的 Claude 模型，以滿足不同的安全與合規(guī)需求。

Claude Code 使用入門

這部分主要認(rèn)識一下CLAUDE.md文件，其他更加復(fù)雜的用法，，有機(jī)會看看。

為什么CLAUDE.md這么重要？

CLAUDE.md 是一個特殊文件，Claude 在發(fā)起對話時會自動將其拉入上下文中。

也就是說，它可以存儲如下信息：

• 常用 bash 命令
• 核心文件和實用函數(shù)
• 代碼風(fēng)格指南、存儲庫規(guī)則
• 開發(fā)者環(huán)境設(shè)置、測試說明
• 項目特有的任何意外行為或警告
• 其他信息

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，運(yùn)行 /init 命令，會自動為你生成一個 CLAUDE.md。

新手用戶，可能會誤輸入指令，導(dǎo)致本地文件被刪以及更多系統(tǒng)bug，不過不用擔(dān)心。

Claude Code默認(rèn)會請求任何可能修改系統(tǒng)的操作的權(quán)限，比如說文件寫入、bash 命令、MCP工具等等。

有四種方法可以管理允許的工具：

• 在會話期間出現(xiàn)提示時， 選擇“始終允許” 。

• 使用/permissions指令啟動Claude Code后，可以添加或移除允許列表中的工具。

你可以在里面添加允許的操作，比如添加 Edit 以始終允許文件編輯。

你也可以在Deny里面添加被拒絕執(zhí)行的命令。

并且你還可以添加多個空間。

Claude Code中配置MCP工具

Claude Code默認(rèn)通過CLI向?qū)В╟laude mcp add）來配置MCP工具.

claude mcp add <server-name> -s user -- <command> [args...]

部分SSE服務(wù)的，添加方法如下：

# 基礎(chǔ)  
claude mcp add --transport sse <名稱> <URL>

# 添加SSE服務(wù)器  
claude mcp add --transport sse sse-server https://example.com/sse-endpoint

# 添加帶自定義請求頭的SSE服務(wù)器  
claude mcp add --transport sse api-server https://api.example.com/mcp -e X-API-Key=your-key

使用命令行可進(jìn)行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-server

Claude Code 的應(yīng)用場景

Claude Code 的應(yīng)用范圍非常廣泛，幾乎涵蓋了軟件開發(fā)的全周期。

項目探索與上手 (Exploration)

當(dāng)你加入一個新團(tuán)隊或接觸一個開源項目時，往往需要花費大量時間熟悉代碼，Claude Code 可以極大縮短這個過程。

你可以直接問它：

這個產(chǎn)品功能是在哪里實現(xiàn)的？

或者

通過 Git 歷史，告訴我這段代碼在過去幾周發(fā)生了哪些變化？

成為你的伙伴 (Thought Partner)

在動手編碼前，你可以讓 Claude Code 扮演大軍師的角色。

你可以說：

我準(zhǔn)備改造AI-Media2Doc功能，請你先研究一下代碼庫，為我提供兩到三種不同的實現(xiàn)方案，并分析優(yōu)劣。暫時不要寫任何代碼。

Claude 會利用其智能體式搜索能力，為你提供決策參考。

高效構(gòu)建與編碼 (Building & Coding)

從零到一：

你可以把它放進(jìn)一個空目錄，讓它為你創(chuàng)建一個全新的應(yīng)用或游戲。

在現(xiàn)有代碼庫中工作：

它能極大地提升日常開發(fā)效率，例如，為現(xiàn)有代碼快速添加單元測試。在 Claude Code 團(tuán)隊內(nèi)部，我們的單元測試覆蓋率非常高，這很大程度上歸功于此。此外，我們還可以讓它自動生成高質(zhì)量的 Git 提交信息和 PR 描述。

部署與運(yùn)維 (Deployment & Lifecycle)

通過 Claude Code SDK，你可以“無頭模式”（Headless Mode）以編程方式使用它，將其集成到 CI/CD 流程或 GitHub Actions 中，實現(xiàn)自動化工作流。

支持與規(guī)模化 (Support & Scaling)

幫助你更快地定位和修復(fù) Bug。

許多團(tuán)隊因為技術(shù)債而推遲了大型重構(gòu)項目（如舊版 Java 升級、PHP 遷移到 React）。Claude Code 這樣的工具，使得這類原本望而生畏的項目變得更具可行性。

它精通各類命令行工具，如 Git、Docker、BigQuery 等。當(dāng)你遇到棘手的 git rebase 沖突時，不必再頭痛，直接啟動 Claude Code，告訴它情況，讓它幫你解決。

最佳實踐與高級技巧

基礎(chǔ)最佳實踐

首先善用 claude.md 文件

這是在不同會話或團(tuán)隊成員間共享狀態(tài)和指令的核心方式，相當(dāng)于 Claude 的“長期記憶”。當(dāng) Claude 啟動時，它會自動讀取當(dāng)前工作目錄下的 claude.md 文件，并將其內(nèi)容作為核心指令。

你可以在里面存放項目特定的信息，如“如何運(yùn)行單元測試”、“項目目錄結(jié)構(gòu)概覽”、“團(tuán)隊代碼風(fēng)格指南”等。

你也可以在你的用戶主目錄（Home Directory）下放置一個全局的 claude.md 來存放通用指令。

智能管理權(quán)限

默認(rèn)情況下，寫文件或執(zhí)行命令需要手動確認(rèn)。你可以使用“自動接受模式”（快捷鍵 Shift + Tab）讓 Claude 直接執(zhí)行。

你可以在設(shè)置中將某些常用且安全的命令（如 npm run test）配置為始終自動批準(zhǔn)，從而減少不必要的中斷。

優(yōu)化集成設(shè)置

如果你使用的工具有命令行版本（如 GitHub 的 gh），請務(wù)必安裝它。這能讓 Claude 更方便地與外部服務(wù)交互。

如果你的公司有內(nèi)部命令行工具，記得在 claude.md 文件里告訴 Claude 它的存在和用法。

有效管理上下文

模型擁有 20 萬 token 的超大上下文窗口，但在長時間的會話中仍有可能被填滿。

當(dāng)右下角出現(xiàn)上下文即將用盡的警告時，你有兩個選擇：

/clear：清空當(dāng)前會話，重新開始。

/compact：它會啟動一個內(nèi)部提示，讓模型將當(dāng)前會話的所有工作總結(jié)成一份摘要，然后用這份摘要作為新會話的“種子”，讓你無縫地繼續(xù)工作。

構(gòu)建高效工作流

先計劃，后執(zhí)行：

不要直接命令“修復(fù)這個bug”，而是說:

我遇到了這個bug，請先調(diào)查原因，然后給我一個修復(fù)計劃。

這樣你可以在它動手前驗證其思路是否正確。

利用待辦事項 (To-Do List)：在處理復(fù)雜任務(wù)時，Claude 會生成一個待辦事項列表。你可以觀察這個列表，如果發(fā)現(xiàn)方向不對，可以隨時按 Escape 鍵打斷它，并調(diào)整計劃。

擁抱測試驅(qū)動開發(fā) (TDD)：讓 Claude 進(jìn)行小范圍修改、運(yùn)行測試、檢查代碼規(guī)范、然后提交。這種小步快跑的方式能確保項目不會偏離軌道。

利用多模態(tài)能力：你可以隨時粘貼截圖，或者讓 Claude 讀取圖片文件（如 mock.png），并根據(jù)視覺設(shè)計來構(gòu)建界面。

高級技巧

當(dāng)你熟練后，可以嘗試在 Tmux 或多個終端標(biāo)簽頁中同時運(yùn)行多個 Claude 智能體，讓它們并行處理不同任務(wù)。

這是一個有趣的挑戰(zhàn)，比如我就可以開3個終端同時并行運(yùn)行。

Escape 鍵

單擊 Escape，隨時用它來打斷 Claude 的當(dāng)前操作，并給出新的指示。知道何時打斷，是最大化效率的關(guān)鍵。

雙擊 Escape，雙擊可以讓你撤銷到上一次對話，相當(dāng)于一次“重置”。

無頭模式與自動化，探索如何通過編程方式（SDK）在各種場景（如 GitHub Actions）中使用 Claude，將 AI 智能體的能力“撒”向開發(fā)工作流的每一個角落。

新功能速覽與問答

Claude發(fā)布新功能的速度非?？?。

你現(xiàn)在可以在 Claude 中輸入 /model 來查看并切換當(dāng)前使用的模型（如從 Sonnet 切換到 Opus）。

工具調(diào)用間的思考過程，從 Claude 3（Opus）開始，模型可以在兩次工具調(diào)用之間進(jìn)行“思考”。你會看到用淺灰色文本顯示的思考過程，這對于理解其決策路徑和調(diào)試非常有幫助。

Claude Code與 VS Code 和 JetBrains 的集成為你帶來更流暢的體驗。

其實現(xiàn)在就可以在VS Code里面直接使用了，用起來崽爽。

現(xiàn)場問答 (Q&A)

問：一個項目里可以有多個 claude.md 文件嗎？

答： 在同一個目錄下不行。

Claude 啟動時只讀取當(dāng)前工作目錄下的 claude.md。為避免在單一代碼庫（Monorepo）中上下文爆炸，它不會默認(rèn)讀取子目錄的 claude.md。

但你可以在主 claude.md 中用 @ 符號引用其他文件，或者在啟動 Claude 時，鼓勵它去搜索并閱讀相關(guān)子目錄中的 claude.md。

問：我讓 Claude 遵守 claude.md 里的指令（比如不留注釋），但它不聽怎么辦？

答： 這是一個典型的模型行為問題，尤其在舊模型上更常見。好消息是，新一代模型（如 Opus）在遵循指令方面的能力已大幅提升。

問：可以實現(xiàn)多智能體并行執(zhí)行，并讓它們共享上下文嗎？

答： 目前我們的理念是專注于打造一個極度強(qiáng)大的單一智能體。對于多智能體協(xié)作，今天的最佳實踐是通過文件進(jìn)行狀態(tài)同步。你可以讓一個智能體將其中間結(jié)果或狀態(tài)寫入一個共享文件（如 ticket.md），然后讓另一個智能體去讀取這個文件，從而實現(xiàn)間接的協(xié)作。未來我們可能會探索更原生的多智能體協(xié)作功能。

參考：Claude Code：代理編碼的最佳實踐

本文轉(zhuǎn)載自?????AIGC新知?????，作者：絳燁