> ## Content Index
> Fetch the complete content index at: https://www.hubwiz.com/blog/llms.txt
> Use this file to discover other available public pages before exploring further.

# 为Claude Code准备你的代码库
- URL: https://www.hubwiz.com/blog/prepare-your-codebase-for-claude-code/
- Published: 2025-08-10T02:53:10.000Z
- Updated: 2025-08-10T02:53:10.000Z
- Description: 这份全面的指南将向您展示如何仅通过三个步骤设置Claude Code，使其理解您的完整项目，从而最大化其效果和上下文意识。
- Author: admin
- Tags: TOOL, CLAUDE CODE, DEEP GRAPH MCP, #Import 2026-10-14 14:41

这份全面的指南将向您展示如何仅通过三个步骤设置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可以在您的项目中执行这些功能。

我推荐[这个网站](https://aitmpl.com/?source=post%5Fpage-----3e14266e9---------------------------------------)，您可以在这里简单方便地安装所有需要的内容。

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

![](https://www.hubwiz.com/blog/content/images/2025/08/image-120.png)

在这里，您将找到代理、命令、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](https://app.codegpt.co/?ref=hubwiz.com)
- **在“API Connections”部分获取您的API KEY和ORG ID**

![](https://www.hubwiz.com/blog/content/images/2025/08/image-121.png)

- **在Code Graph中上传您的仓库**以获取`CODEGPT_GRAPH_ID`

![](https://www.hubwiz.com/blog/content/images/2025/08/image-122.png)

一旦您将仓库上传到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://www.hubwiz.com/blog/content/images/2025/08/image-123.png)

> 注意：阅读完整的教程以分叉公共仓库并将其用作您自己的：[https://help.codegpt.co/en/articles/9912447-code-graphs](https://help.codegpt.co/en/articles/9912447-code-graphs?ref=hubwiz.com)

### 3.3 连接私有仓库

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

![](https://www.hubwiz.com/blog/content/images/2025/08/image-124.png)

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

![](https://www.hubwiz.com/blog/content/images/2025/08/image-125.png)

## 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](https://medium.com/@dan.avila7/step-by-step-guide-prepare-your-codebase-for-claude-code-3e14262566e9?ref=hubwiz.com)

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