手把手教你為Claude Code準備代碼庫
本文圍繞Claude Code的核心配置流程展開，通過三個關鍵步驟，助力Claude Code完整理解你的項目架構與業務邏輯。在此基礎上，既能最大化提升該工具的實用價值，也能增強其上下文感知能力，為后續高效開展開發協作筑牢基礎。
步驟一：Claude Code基礎配置
首先，建議使用??/init??命令完成Claude Code的基礎配置。
# 導航至項目根目錄
cd your-project
# 初始化Claude Code
claude
# 生成項目文檔
/init執行上述命令后，會生成一個??CLAUDE.md??文件，該文件是Claude理解項目的主要參考依據，包含項目概述、技術棧、文件夾結構及開發規范等內容。
測試Claude的理解程度通過以下問題，驗證Claude是否已理解你的項目：
- “這個項目的功能是什么？”
- “請解釋項目的文件夾結構。”
- “該項目使用了哪些技術？”
完成上述測試后，建議讓Claude Code結合初步獲取的上下文信息，對??CLAUDE.md??文件進行優化，這是一種良好的實踐方式。
步驟二：通過智能體、命令與MCP自定義配置（避免過度配置）
為Claude Code添加這些功能后，你可以為其賦予更多可在項目內執行的操作能力。
推薦一個實用網站：https://www.aitmpl.com/，你可以在該網站上通過簡單便捷的方式安裝所需的全部配置。
瀏覽并安裝適用于不同語言和框架的Claude Code配置模板，其中涵蓋100多個智能體。
在該網站上，你可以找到智能體（Agents）、命令（Commands）、MCP（模塊化協作程序）和模板（Templates），還能創建自定義的Claude Code執行工作流。
提示：建議僅為每個項目安裝必要的配置！若Claude Code擁有過多選項，會導致其注意力分散，我們要避免這種情況。
步驟三：將Deep Graph MCP與代碼庫集成
Deep Graph是一款MCP（模塊化協作程序），可為Claude Code提供用于理解完整代碼庫的高級工具。
它為Claude Code新增了6款工具，使其能夠以更高級的方式讀取代碼、執行語義搜索和節點搜索，極大增強Claude對項目整體上下文的理解能力。
要使用Deep Graph，需通過Claude Code的MCP集成功能進行對接，此過程需準備以下數據：
- YOUR_CODEGPT_API_KEY = CodeGPT的API密鑰
- CODEGPT_ORG_ID = CodeGPT的組織ID
- CODEGPT_GRAPH_ID = 代碼庫在CodeGPT中對應的CODEGRAPH（代碼圖譜）ID
CodeGPT集成配置步驟
- 前往CodeGPT官網免費創建賬號：CodeGPT
- 在“API Connections”（API連接）板塊獲取API密鑰和組織ID
- 在Code Graph（代碼圖譜）中上傳代碼庫，獲取CODEGPT_GRAPH_ID
將代碼庫上傳至CodeGPT后，你就能獲取對應的CODEGPT_GRAPH_ID了。
安裝MCP
輸入你的API密鑰（YOUR_CODEGPT_API_KEY）、組織ID（CODEGPT_ORG_ID）和代碼圖譜ID（CODEGPT_GRAPH_ID），執行以下命令安裝MCP：
claude mcp add "Deep-Graph-MCP" npx -- -y mcp-code-graph@latest YOUR_CODEGPT_API_KEY CODEGPT_ORG_ID CODEGPT_GRAPH_ID實用技巧：可為MCP命名為代碼庫名稱，方便Claude Code識別該MCP對應的代碼庫。例如：
claude mcp add "My-repo-MCP" npx -- -y mcp-code-graph@latest YOUR_CODEGPT_API_KEY CODEGPT_ORG_ID CODEGPT_GRAPH_ID在CodeGPT中加載代碼圖譜時，也能查看連接MCP的完整操作說明。
注：如需查看復刻公共代碼庫并自用的完整教程，請訪問：https://help.codegpt.co/en/articles/9912447-code-graphs
連接私有代碼庫
若需連接私有代碼庫，可進入“Connections”（連接）板塊添加Git代碼托管平臺。
可以連接來自GitHub、GitLab、GitLab本地部署版和Bitbucket的私有代碼庫：
驗證MCP安裝情況
執行安裝命令后，可通過以下命令檢查MCP是否安裝成功：
# 查看已安裝的MCP
claude mcp list
# 獲取服務器詳情
claude mcp get "Deep-Graph-MCP"使用Deep Graph MCP
現在，你可以針對代碼庫提出更復雜的問題：
- “Deep Graph MCP：找到認證邏輯相關代碼”
- “Deep Graph MCP：展示錯誤處理模式”
- “Deep Graph MCP：若修改用戶服務，會影響哪些部分？”
- “Deep Graph MCP：展示項目中的所有API端點”
最后一步：再次更新CLAUDE.md文件
至此，你已為Claude Code配置了完全適配項目的工作環境。此時，可讓Claude Code結合Deep Graph MCP讀取??README.md???文件，并再次更新??CLAUDE.md??。
完成這最后一步后，無論你的需求表述多么模糊，都能看到Claude準確理解你意圖的效果。
本文轉載自??AI科技論談??，作者：AI科技論談
