Claude Code Guardian

Code Guardian Studio

基于 Claude Code + MCP 构建的 AI 代码重构引擎，适用于大型代码库。

版本： 4.1.0 | 许可证： MIT（开放核心）

网站与文档： https://codeguardian.studio

---

为什么选择 CCG？

CCG 脱颖而出，成为面向 Claude Code 的功能最全面的 MCP 服务：

	CCG	Guardrails AI	NeMo	Semgrep MCP
MCP 工具	113+	-	-	~10
代码分析	✅	❌	❌	✅
热点检测	✅	❌	❌	❌
工作流管理	✅	❌	❌	❌
会话持久化	✅	❌	❌	❌
记忆系统	✅	❌	❌	❌
进度仪表板	✅	❌	❌	❌
潜在链推理	✅	❌	❌	❌
防护规则	✅	✅	✅	✅

主要差异：

• 一体化： 在单个服务中集成防护、指标、工作流和记忆
• 113+ 个 MCP 工具： 功能最全面的工具集
• 会话管理： 在不同对话间恢复工作
• 实时进度： 通过实时仪表板跟踪重构进度
• 潜在链： 针对复杂任务的多阶段推理

想了解详细对比？ 请参阅 CCG 与竞品对比

---

什么是 Code Guardian Studio？

Code Guardian Studio（CCG）是一个 MCP 服务，可将 Claude Code 转变为智能重构助手。它会扫描代码库、查找热点、生成优化报告，并帮助你安全地重构代码。

关键数据（CCG 在自身项目上的实测结果）

指标	数值
分析行数	68,000
扫描文件数	212
发现热点数	20
分析耗时	< 1 分钟

3 分钟快速入门

只需一条命令，即可开始首次代码分析：

# Install globally
npm install -g codeguardian-studio

# Run quickstart (auto-initializes + analyzes your code)
ccg quickstart

就是这么简单！快速入门命令会：

• 在项目中初始化 CCG
• 扫描代码库
• 分析代码复杂度和热点
• 生成详细的 Markdown 报告

打开生成的报告，并从得分最高的热点开始修复。

想要更多控制权？ 请参阅手动设置或阅读完整的快速入门指南。

功能

代码优化器（8 个工具）

• code_scan_repository - 绘制整个代码库的结构图
• code_metrics - 计算复杂度、嵌套度和分支得分
• code_hotspots - 查找需要关注的文件
• code_refactor_plan - 生成分步重构计划
• code_record_optimization - 记录优化会话
• code_generate_report - 创建 Markdown 报告
• code_quick_analysis - 一次调用完成扫描、指标分析和热点查找
• code_optimizer_status - 查看模块状态

其他模块

• 记忆 - 跨会话持久化存储
• 防护 - 阻止危险模式（虚假测试、空 catch 等）
• 工作流 - 任务管理与跟踪
• 潜在链 - 针对复杂任务的多阶段推理
• Agent - 专用 Agent 协调
• 思考 - 结构化推理模型
• 文档 - 文档管理
• 测试 - 测试运行器集成

定价

方案	价格	适用对象
Dev	免费	独立开发者，完全离线使用
Team	$19/月	产品团队和代理机构
Enterprise	定制	大型组织和合规需求

Dev 级别完全本地运行，并支持可自托管。Team/Enterprise 需要通过 api.codeguardian.studio 验证许可证。

请参阅许可证等级了解功能对比。

链接

• 网站： https://codeguardian.studio
• 案例研究： https://codeguardian.studio/case-study
• 合作伙伴： https://codeguardian.studio/partners
• GitHub： https://github.com/phuongrealmax/code-guardian
• MCP 目录： https://mcp.so/server/code-guardian
• GitHub Action： ccg-action - 用于 PR 分析的 CI/CD 集成

手动设置

如果你更喜欢逐步控制：

# 1. Install
npm install -g codeguardian-studio

# 2. Initialize CCG in your project
ccg init

# 3. Run analysis with custom options
ccg code-optimize --report

# 4. For advanced options
ccg code-optimize --help-advanced

更多详情请参阅用户指南。

安装要求

CCG 使用 better-sqlite3（原生 SQLite 绑定），需要在系统上安装构建工具：

Linux (Ubuntu/Debian)

sudo apt-get update
sudo apt-get install build-essential python3
npm install -g codeguardian-studio

macOS

# Install Xcode Command Line Tools
xcode-select --install

npm install -g codeguardian-studio

Windows

# Install Visual Studio Build Tools
# Download from: https://visualstudio.microsoft.com/downloads/

npm install -g codeguardian-studio

Docker

FROM node:20-slim

# Install build dependencies
RUN apt-get update && apt-get install -y \
    build-essential \
    python3 \
    && rm -rf /var/lib/apt/lists/*

RUN npm install -g codeguardian-studio

故障排除

错误：gyp ERR! stack Error: not found: make

• 解决方案：安装构建工具（请参阅上文对应操作系统的说明）

错误：Module did not self-register

• 解决方案：Node.js 版本不匹配。使用以下命令重新构建：

  npm rebuild better-sqlite3
  

ARM64 兼容性：

• ✅ 支持 Apple Silicon (M1/M2/M3)
• ✅ 支持 Ubuntu ARM64
• 在某些平台上可能需要从源代码构建

文档

• 功能 - 113+ 个 MCP 工具的完整指南
• 用户指南 - 完整的功能文档
• 快速入门 - 3 分钟快速开始
• 对比 - CCG 与竞品对比
• 迁移指南 - 升级到 v4.0.0
• 许可证系统 - 开源核心架构
• 更新日志 - 版本历史

社区与支持

有问题或想法？欢迎与我们交流！

• 💬 GitHub 讨论区 - 提问、分享想法并获取帮助
• 🐛 报告问题 - 报告错误并提交功能请求
• ⭐ 在 GitHub 上为我们点星 - 表达你的支持！

许可证

MIT（开源核心）。详情请参阅 LICENSE。

---

由 Claude 构建。受 Guardian 保护。