Code Guardian Studio（简称 CCG）是一款面向大型代码仓库的 AI 驱动代码重构引擎，构建于 Claude Code + MCP 之上。它本质上是一个 MCP 服务器，将 Claude Code 转变为智能重构助手：扫描代码库、发现热点、生成优化报告，并帮助开发者安全地完成重构。当前版本为 4.1.0，采用 MIT（open-core）许可。
用途 CCG 主要服务于大规模代码库的重构与优化场景。它能够自动分析代码结构，识别代码复杂度高、嵌套深、分支多的文件（即“热点”），并据此生成可执行的优化方案，帮助开发者按优先级逐步修复代码问题。
主要能力
- Code Optimizer 模块（8 个工具）：
- code_scan_repository：映射整个代码库
- code_metrics：计算复杂度、嵌套、分支评分
- code_hotspots：定位需要关注的文件
- code_refactor_plan：生成分步重构计划
- code_record_optimization：记录优化会话
- code_generate_report：生成 Markdown 报告
- code_quick_analysis：一次调用完成扫描 + 指标 + 热点分析
- code_optimizer_status：查看模块状态
-
其他模块：Memory（跨会话持久存储）、Guard（拦截危险模式，如伪造测试、空 catch 等）、Workflow（任务管理与追踪）、Latent Chain（面向复杂任务的多阶段推理）、Agents（专用智能体协调）、Thinking（结构化推理模型）、Documents（文档管理）、Testing（测试运行器集成）。
-
平台级特性：共提供 113+ 个 MCP 工具；支持会话管理，可跨对话继续工作；提供实时进度仪表板以追踪重构进度；Latent Chain 支持多阶段推理处理复杂任务。
使用方式 3 分钟快速上手：一条命令即可完成首次代码分析。quickstart 命令会自动：在项目中初始化 CCG、扫描代码库、分析代码复杂度与热点、生成详细的 Markdown 报告。随后可打开生成的报告，从评分最高的热点开始修复。如需更精细的控制，可使用手动设置。项目还提供 GitHub Action（ccg-action）用于 CI/CD 集成与 PR 分析。
安装要求 CCG 使用 better-sqlite3（原生 SQLite 绑定），需要系统安装构建工具。Linux（Ubuntu/Debian）等系统需预先安装相应构建工具。常见问题包括：缺少 make 导致 gyp 报错，需安装构建工具；Node.js 版本不匹配导致“Module did not self-register”，可用 npm rebuild better-sqlite3 重建。ARM64 兼容性方面，支持 Apple Silicon（M1/M2/M3）与 Ubuntu ARM64，部分平台可能需要从源码构建。
适用场景 适用于大型代码仓库的代码质量评估、技术债识别、重构优先级排序、CI/CD 中的 PR 分析，以及需要跨会话持续跟踪重构进度的开发团队。
限制与许可 Dev 层级完全本地化且可自托管；Team/Enterprise 层级需要通过 api.codeguardian.studio 进行许可验证。采用 MIT（open-core）许可，各层级功能对比可参见其 License Tiers 页面。
