为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组织IDCODEGPT_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_KEY
、CODEGPT_ORG_ID
和CODEGPT_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
汇智网翻译整理,转载请标明出处
