为Claude Code准备你的代码库

这份全面的指南将向您展示如何仅通过三个步骤设置Claude Code,使其理解您的完整项目,从而最大化其效果和上下文意识。

为Claude Code准备你的代码库

这份全面的指南将向您展示如何仅通过三个步骤设置Claude Code,使其理解您的完整项目,从而最大化其效果和上下文意识。

1、基本Claude Code设置

要开始,我建议使用/init命令创建基本的Claude Code配置。

# 导航到您的项目根目录  
cd your-project  

# 初始化Claude Code  
claude  

# 生成项目文档  
/init

这会创建一个CLAUDE.md文件,作为Claude理解您的项目的主参考。该文件包括项目概述、技术栈、文件夹结构和发展惯例。

测试Claude的理解能力

通过询问以下关键问题来验证Claude是否理解您的项目:

> 这个项目是做什么的?  
> 解释文件夹结构  
> 这个项目使用了哪些技术?

在用这些问题测试之后,建议让Claude Code改进CLAUDE.md文件,使用这个初始上下文。

2、自定义代理、命令和MCP(但不要过度)

将这些功能添加到Claude Code中,可以让它执行更多功能,Claude可以在您的项目中执行这些功能。

我推荐这个网站,您可以在这里简单方便地安装所有需要的内容。

浏览并安装适用于不同语言和框架的Claude Code配置模板,包括100多个代理。

在这里,您将找到代理、命令、MCP、模板,还可以创建自己的自定义Claude Code执行工作流程。

重要提示:我建议只为每个项目安装必要的内容!如果Claude Code有太多选项,它会开始失去焦点,这正是我们想要避免的。

3、使用你的代码库安装Deep Graph MCP

Deep Graph是一个MCP,它为Claude Code提供了高级的工具,用于完全理解您的代码库。

它为Claude Code增加了6个新工具,使其能够以更高级的方式读取代码,执行语义搜索和基于节点的搜索。这极大地增强了Claude对您项目的整体上下文理解能力。

要使用它,我们需要通过Claude Code的MCP集成来集成它,为此我们需要以下数据:

  • YOUR_CODEGPT_API_KEY = CodeGPT API密钥
  • CODEGPT_ORG_ID = CodeGPT组织ID
  • CODEGPT_GRAPH_ID = 您在CodeGPT中的代码库的CODEGRAPH ID

3.1 设置CodeGPT集成

  • 免费创建一个CodeGPT账户CodeGPT
  • 在“API Connections”部分获取您的API KEY和ORG ID
  • 在Code Graph中上传您的仓库以获取CODEGPT_GRAPH_ID

一旦您将仓库上传到CodeGPT,您就可以获得CODEGPT_GRAPH_ID

3.2 安装MCP

使用您的API密钥YOUR_CODEGPT_API_KEYCODEGPT_ORG_IDCODEGPT_GRAPH_ID运行此命令:

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中加载Code Graph时看到连接MCP的完整说明。

注意:阅读完整的教程以分叉公共仓库并将其用作您自己的:https://help.codegpt.co/en/articles/9912447-code-graphs

3.3 连接私有仓库

如果您要连接私有仓库,可以前往Connections以添加Git提供者。

您可以从Github、Gitlab、Gitlab On Premise和Bitbucket连接私有仓库:

3.4 验证MCP安装

运行命令后,可以通过运行以下命令检查是否正确安装了MCP:

# 检查已安装的MCP  
claude mcp list  

# 获取服务器详细信息  
claude mcp get "Deep-Graph-MCP"

3.5 使用Deep Graph MCP

现在您可以就您的代码库提出复杂的问题:

> Deep Graph MCP: 找到认证逻辑  
> Deep Graph MCP: 显示错误处理模式  
> Deep Graph MCP: 如果我修改用户服务,会有什么影响?  
> Deep Graph MCP: 显示此项目中的所有API端点

4、再次更新CLAUDE.md

现在您已经为Claude Code配置了一个针对您项目的完整工作环境,请让它阅读README.md,并使用Deep Graph MCP再次更新它。

有了这个最终的细节,您将能够看到Claude如何理解您告诉它的任何事情,无论请求多么模糊。


原文链接:Step-by-Step Guide: Prepare Your Codebase for Claude Code

汇智网翻译整理,转载请标明出处