cc-baseline —— Claude Code 装配基线核对

定位

对照「本机装配基线」逐项核对 Claude Code 的安装 / 注册 / 启用状态，缺什么给什么修复命令。纯只读，不改任何配置。

所谓「基线」，就是一台机器上 Claude Code「该长什么样」的规格：必备 CLI、全局 npm 包、MCP 注册、插件精简集、系统配置、权限与规范基线。这份清单本身就是资产——cc-baseline 既是核对器，也是这份规格的落地处。

何时用

换机器 / 重装 CC 后，核对哪些工具没装回来；
怀疑环境不全（「我的 cc 配置全吗」「必备插件 / MCP 装齐了没」）；
只想做一次工具链体检。

对话里说「cc-baseline」「核对下基线」「工具链体检」「环境自检」「换机器后核对一下 cc 装配」等都会触发。旧称 cc-doctor。

怎么用

直接跑脚本：

bash ${CLAUDE_PLUGIN_ROOT}/skills/cc-baseline/scripts/check.sh

输出是分六类的清单 + 汇总，三种状态标记：

✓ 绿 = 已装 / 已启用；
✗ 红 = 必需项缺失，行尾直接给修复命令；
○ 黄 = 可选项未装（brew / jq / cc-switch App 等），不算故障。

退出码：必需项齐全 = 0，有必需项缺失 = 1（可选项缺失不影响退出码）。

可选 --health 参数会额外实连核对核心 MCP（含 playwright），比纯文件检查更慢但更真。

查哪六类

类别	检查项	数据来源
CLI 工具	node / npm / claude / rtk / codegraph / brew / jq	`command -v`
全局 npm 包	codegraph / lighthouse-mcp	`$(npm root -g)/<pkg>` 目录
MCP 注册	codegraph / lighthouse-mcp	`~/.claude.json` 的 `mcpServers`（含各 project scope）
插件	必备精简集（superpowers / skill-creator / code-review / frontend-design / playwright / claude-hud / remember / 各语言 LSP / security-guidance 等）+ 可选（context7 / vercel）	`~/.claude/plugins/installed_plugins.json`
系统配置	RTK hook / RTK 压缩豁免 / claude-hud 状态栏 / cc-switch App	`settings.json`、`rtk/config.toml`、`/Applications`
配置基线	bypassPermissions / bypass 警告已接受 / 家目录已信任 / codegraph 白名单 / 全局 CLAUDE.md 含「始终中文回复」/ 默认关闭自动更新	`settings.json`、`~/.claude.json`、`~/.claude/CLAUDE.md`

跑完把结果回报，有 ✗ 就把对应修复命令一并列出，你决定要不要补齐。

几个「为什么这么查」的坑

这些是脚本刻意的实现选择，也解释了为什么别的查法会误报：

插件用 installed_plugins.json 判断，不用 claude plugin list。三个坑叠加：① 插件可以装在项目 scope，这类在用户全局 enabledPlugins 里根本没有，只查全局会误报缺失；② claude plugin list 慢（逐个实连 MCP 做健康检查）、输出不稳定，且跑它本身会触发 CC 重建 installed_plugins.json，越查越乱；③ installed_plugins.json 是磁盘上的安装事实，一次文件读，快且确定，覆盖所有 scope。
MCP 注册要扫所有 scope：~/.claude.json 顶层 mcpServers 之外，各 projects[<path>].mcpServers 也要并进来，否则 project scope 注册的 MCP 会漏报。
npm 全局包查目录不查 npm ls -g：后者慢且对子依赖误判；[ -d "$(npm root -g)/<pkg>" ] 又快又准。
家目录信任弹窗（"Is this a project you trust?"）由 ~/.claude.json 的 projects[<dir>].hasTrustDialogAccepted 控制，不是 settings.json。家目录默认 false，设 true 免弹。
bypass 权限警告弹窗由 ~/.claude.json 顶层的 bypassPermissionsModeAccepted 控制（未公开字段）。设 permissions.defaultMode=bypassPermissions 后每次启动会弹警告，把这个字段设 true 可永久免弹。
「始终中文回复」查的是全局 CLAUDE.md 的正文（grep 关键字），不是文件存不存在——这条规范必须写进全局 CLAUDE.md 才对所有会话生效。
默认关自动更新只有 env.DISABLE_AUTOUPDATER=1 一条路：settings.json 没有顶层开关，/config 里也没有。注意 env 是整体替换，若 settings.local.json 也写了 env 会把 user 层顶掉。

各工具的标准安装命令

脚本里对每个 ✗ 都内嵌了对应修复命令，核心几条：

# MCP 载体（全局 npm 包）
npm i -g @colbymchenry/codegraph @danielsogl/lighthouse-mcp

# 注册进 CC
codegraph install -t claude -l global -y
claude mcp add lighthouse-mcp -s user -- node "$(npm root -g)/@danielsogl/lighthouse-mcp/dist/index.js"

# RTK（省 token 命令代理）
brew install rtk && rtk init -g --auto-patch

# 插件 marketplace + 安装
claude plugin marketplace add jarrodwatts/claude-hud
claude plugin install claude-hud@claude-hud   # 装完在 CC 里跑 /claude-hud:setup 配状态栏

# 默认关闭自动更新
jq '.env.DISABLE_AUTOUPDATER="1"' ~/.claude/settings.json > /tmp/s.json && mv /tmp/s.json ~/.claude/settings.json

装完 MCP / 插件 / 状态栏后必须重启 CC 会话才生效，补齐后重跑 check.sh 复核。

cc-baseline 装配基线核对

定位

何时用

怎么用

查哪六类

几个「为什么这么查」的坑

各工具的标准安装命令

相关