手把手教你为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集成配置步骤

1. 前往CodeGPT官网免费创建账号：CodeGPT
2. 在“API Connections”（API连接）板块获取API密钥和组织ID

3. 在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科技论谈