1. 一键安装（macOS / Linux）
curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash带 UI 可视化版本：
curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash -s -- --ui安装内容：
- 二进制：
~/.local/bin/codebase-memory-mcp - Claude 配置：自动写入
~/.claude.json - 索引缓存：
~/.cache/codebase-memory-mcp/
2. 验证安装成功
执行三条命令：
which codebase-memory-mcp
codebase-memory-mcp --version
claude mcp list | grep codebase-memory-mcp出现以下结果即为成功：
- 路径正常显示
- 版本号
0.6.x claude mcp list显示 connected ✓
必须重启 Claude Code 才能生效！
3. 如何让 AI 自动使用它
只要你说这些话，Claude 会自动调用 codebase-memory：
- 探索代码库 / 理解架构
- 列出函数 / 查看结构
- 谁调用了这个函数 / 调用链
- 依赖分析 / 改动影响
- 死代码 / 未使用函数
- 给我架构概览
强制触发（最稳）：
用 codebase memory 索引这个项目用 codebase memory 分析调用链4. 核心 CLI 命令
索引当前项目
codebase-memory-mcp cli index_repository '{"repo_path":"'$(pwd)'"}'查看已索引项目
codebase-memory-mcp cli list_projects '{}'搜索函数/类
codebase-memory-mcp cli search_graph '{"name_pattern":".*Handler.*","label":"Function"}'追踪函数调用链
codebase-memory-mcp cli trace_path '{"function_name":"你的函数名","direction":"both"}'查看项目架构
codebase-memory-mcp cli get_architecture '{"project":"项目名"}'5. 批量索引多个 Git 仓库（脚本）
保存为 cbm-index.sh：
#!/usr/bin/env bash
set -euo pipefail
for parent in "$@"; do
for repo in "$parent"/*/; do
repo="${repo%/}"
if [ -d "$repo/.git" ]; then
echo "索引：$repo"
codebase-memory-mcp cli index_repository "$(printf '{"repo_path":"%s"}' "$repo")"
fi
done
done
echo "已索引项目："
codebase-memory-mcp cli list_projects '{}'运行：
chmod +x cbm-index.sh
./cbm-index.sh ~/Workspaces6. 取消索引 / 删除数据
查看索引列表
codebase-memory-mcp cli list_projects '{}'删除单个项目索引
codebase-memory-mcp cli delete_project '{"project":"项目全名"}'清空所有索引
rm -rf ~/.cache/codebase-memory-mcp关闭自动索引
codebase-memory-mcp config set auto_index false7. 完整卸载
codebase-memory-mcp uninstall
rm -f ~/.local/bin/codebase-memory-mcp
rm -rf ~/.cache/codebase-memory-mcp然后重启 Claude Code。
8. 常见问题（10 秒解决）
❌ AI 还是用 find/grep
解决：重启 Claude Code + 说关键词：用 codebase memory
❌ command not found
export PATH="$HOME/.local/bin:$PATH"❌ project not found
重新索引当前目录：
codebase-memory-mcp cli index_repository '{"repo_path":"'$(pwd)'"}'❌ 索引把多个项目合并了
必须按 Git 仓库单独索引，不要索引父目录。
9. UI 可视化（如果安装了 --ui）
访问：
http://localhost:9749可查看：
- 3D 代码知识图谱
- 函数调用关系
- 类依赖
- 模块架构
除非注明，否则均为李锋镝的博客原创文章，转载必须以链接形式标明本文链接
文章评论