Claude Code 接入 SonarQube 静态扫描：AI 写代码，质量闭环了

引言你有没有遇到过这种情况：写完代码，提了 PR，结果 CI 流水线扫出一堆质量问题，改来改去浪费了大半天。更尴尬的是，这些问题其实在编码阶段就能发现——只是没有顺手的工具提醒你。SonarQube 是业界最流行的代码质量平台之一，能检测 Bug、漏洞、坏味道、安全热点，还能统计覆盖率和重复代码。而现在，它可以直接集成进 Claude Code，让 AI 在帮你写代码的同时，顺手把代码质量问题也一起解决掉。这篇文章是一份完整的实战指南，从安装到日常使用，手把手带你跑通整个流程。但在正式开始之前，有一个非常重要的坑需要先说清楚——否则你可能会像我们团队一样，折腾半天找不到原因。先说那个大坑：SonarQube Server 版本划重点：sonarqube-cli（以及背后的 sonarqube-mcp-server）不支持 SonarQube Server 9.x，必须使用10.x 或更新版本。我们公司之前部署的是 SonarQube9.9 LTS，这是 SonarQube 历史上非常稳定的一个长期支持版本，很多团队都还在用。但当我们按照官方文档配置完 sonarqube-cli，执行认证和扫描时，始终报错，怎么排查都无法连接成功。最终我们意识到问题所在：sonarqube-mcp-server 使用的是 SonarQube新一代 API（/api/v2/前缀），这些接口在 10.x 版本才正式引入，9.9 LTS 上根本没有这些端点。解决方案：临时新部署了一套 SonarQube Server10.x实例，问题立刻解决。**版本要求确认**：在开始任何配置之前，先确认你的 SonarQube Server 版本。登录 SonarQube 控制台，在右下角或 `Administration System` 中可以看到当前版本号。如果是 9.x，请先升级或另行部署 10.x 实例，再继续本文后续步骤。版本兼容性速查SonarQube Server 版本是否支持 sonarqube-cli / MCP 集成9.9 LTS 及以下❌ 不支持10.0 ~ 10.x✅ 支持SonarQube Cloud✅ 支持架构总览在开始安装之前，先理解整个集成方案的组成，能帮你在遇到问题时更快定位。Claude Code │ ├── sonarqube-agent-plugins ← 插件层：提供斜杠命令和 Skills │ └── /sonar-analyze、/sonar-integrate 等命令 │ ├── sonarqube-cli (sonar) ← CLI 层：轻量命令行工具，处理认证和分析 │ └── ~/.local/share/sonarqube-cli/bin/sonar │ └── sonarqube-mcp-server ← MCP 层：以容器方式运行，提供深度分析能力 └── 通过 Docker/Podman 运行，连接 SonarQube Server API三层各司其职：sonarqube-agent-plugins：官方插件集合，为 Claude Code 注入 Sonar 相关的斜杠命令和 Skillssonarqube-cli：轻量级命令行工具，负责认证和基础分析，不依赖容器sonarqube-mcp-server：以 Docker/Podman 容器运行的 MCP 服务，提供覆盖率、质量门禁、重复检测等高级能力前置条件开始之前，请确认以下环境已就绪：Node.js 18+：插件的SessionStart检查脚本（scripts/setup.js）需要Docker 或 Podman：MCP Server 以容器形式运行macOS 不允许使用 Docker Desktop，推荐用Podman（安装方法见后文）Linux/Windows