Claude 安装codebase-memory-mcp 教程

codebase-memory-mcp 是本地代码库向量记忆MCP服务，用于给Claude建立代码知识库、跨会话记忆项目架构、接口、业务逻辑，分一键脚本安装（推荐） 、手动二进制部署 、源码编译三种方案，分别适配 Claude Desktop 桌面客户端与终端 Claude Code。

一、一键自动安装（自动写入Claude配置，最简单）

macOS / Linux（终端执行）

bash 复制代码

# 标准版（无可视化图谱UI）
curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash

# 带3D知识图谱可视化UI版本
curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash -s -- --ui

# 仅安装二进制，不自动修改任何AI工具配置
curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash -s -- --skip-config

Windows（PowerShell管理员）

powershell 复制代码

Invoke-WebRequest -Uri https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.ps1 -OutFile install.ps1
.\install.ps1

# 带UI版本
.\install.ps1 -ui
# 仅二进制不自动配置
.\install.ps1 -skip-config

脚本会：

下载对应系统静态二进制（Go单文件，无运行时依赖）
自动识别本地 Claude Desktop / Claude Code，写入MCP配置
自动添加PATH全局命令 codebase-memory-mcp

二、手动安装（源码/二进制包，适合自定义路径）

方式1：下载预编译二进制

打开 Release：https://github.com/DeusData/codebase-memory-mcp/releases
下载对应系统包：
- macOS arm64(M系列) / x86
- Linux amd64
- Windows amd64
解压，赋予执行权限（mac/Linux）

bash 复制代码

# macOS/Linux
chmod +x codebase-memory-mcp
mv codebase-memory-mcp ~/.local/bin/
# 验证
codebase-memory-mcp --version

方式2：本地Go源码编译（需Go1.23+）

bash 复制代码

git clone https://github.com/DeusData/codebase-memory-mcp.git
cd codebase-memory-mcp
CGO_ENABLED=1 go build -o codebase-memory-mcp ./cmd/codebase-memory-mcp/
# 移动到全局目录
sudo mv codebase-memory-mcp /usr/local/bin

三、分别配置两种Claude客户端

场景A：Claude Desktop（桌面App）

找到配置文件路径
- macOS：~/Library/Application Support/Claude/claude_desktop_config.json
- Windows：%APPDATA%\Claude\claude_desktop_config.json
- Linux：~/.config/Claude/claude_desktop_config.json
写入MCP配置

json 复制代码

{
  "mcpServers": {
    "codebase-memory": {
      "command": "codebase-memory-mcp",
      "args": []
    }
  }
}

若二进制不在PATH，替换command为绝对路径，例：/Users/xxx/.local/bin/codebase-memory-mcp

完全关闭重启 Claude Desktop

场景B：Claude Code（终端CLI，npm全局安装）

全局可用（所有项目共享记忆）

bash 复制代码

claude mcp add --scope user codebase-memory -- codebase-memory-mcp

仅当前项目生效

bash 复制代码

claude mcp add codebase-memory -- codebase-memory-mcp

查看已加载MCP服务验证

bash 复制代码

claude mcp list
# 输出包含 codebase-memory 即成功

项目本地配置文件（.mcp.json，团队共享）

项目根目录新建 .mcp.json

json 复制代码

{
  "mcpServers": {
    "codebase-memory": {
      "command": "codebase-memory-mcp"
    }
  }
}

四、初始化与使用

重启Claude后直接对话指令：

建立代码库索引（首次必执行）

Index this project
记忆项目关键信息

记住这个项目使用Gin框架，用户登录接口是POST /api/login，JWT存在redis
查询历史记忆

回顾这个项目的数据库设计与权限逻辑
打开图谱可视化（带UI版本）

Show memory graph

五、常见问题排错

macOS 提示无法验证开发者

bash 复制代码

xattr -cr ~/.local/bin/codebase-memory-mcp

codebase-memory-mcp 命令找不到

确认二进制目录加入PATH；或配置文件写绝对路径

Claude识别不到MCP服务

完全退出App/终端，重新打开；执行 /mcp（Claude Code）查看加载列表

索引代码报错无权限

给项目文件夹完整读写权限，关闭项目内 .gitignore 屏蔽的超大文件目录

六、卸载

一键卸载脚本

bash 复制代码

# mac/linux
curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/uninstall.sh | bash
# Windows PowerShell
.\uninstall.ps1

手动清理

删除二进制 rm ~/.local/bin/codebase-memory-mcp
从 claude_desktop_config.json 删除 codebase-memory 配置块
Claude Code移除MCP

bash 复制代码

claude mcp remove codebase-memory

删除本地记忆库：项目根目录 .codebase-memory/ 文件夹