昆
昆仑AI工具大全KUN.NET
提交工具

第 1 课

Claude Code：插件市场安装与 ctx-doctor 验收

用官方插件市场两行命令安装，重启后跑 /context-mode:ctx-doctor 与 slash 命令表，确认 11 个 MCP 工具与 hooks 就绪。

图文18 分钟

课程目录第 1 / 2 课
  1. 01Claude Code：插件市场安装与 ctx-doctor 验收18 分钟
  2. 02Cursor：MCP+Hooks 手动安装与沙箱工具跟做22 分钟
返回课程介绍

学习位置仅保存在当前浏览器，有效期 180 天。

01 / 图文教材

图文讲义

来源：mksglu/context-mode README · context-mode.com。本讲义为中文跟做整理，非原文搬运。npm：context-mode。

你将得到什么

  • 在 Claude Code 里通过官方插件市场装好 Context Mode（含 hooks + 11 个 MCP 工具）
  • 一次通过的 /context-mode:ctx-doctor 诊断（全部 [x]）
  • 能用 slash 命令查看节省量：/context-mode:ctx-stats

官方定位：Context Mode 在 MCP 层拦截大工具输出，把原始数据放进本地沙箱/FTS5，只把摘要或检索片段送进上下文。插件路径在 Claude Code 上是「全自动」——SessionStart hook 注入路由，无需往项目里写文件。

开始前准备

  1. 确认 Claude Code 版本（官方要求 v1.0.33+）：
claude --version

对照结果：应打印版本号且 ≥ 1.0.33。若终端不认识 /plugin，先升级：

brew upgrade claude-code
# 或
npm update -g @anthropic-ai/claude-code
  1. 本课默认走 插件市场路径（推荐）。若只想先试 MCP 工具、不要 hooks，文末有「MCP-only」备选，功能会弱一档（模型不会被强制改走沙箱）。

步骤 1：添加插件市场并安装

在 Claude Code 会话里依次执行（与官方 README 一致）：

/plugin marketplace add mksglu/context-mode
/plugin install context-mode@context-mode

对照结果：安装命令应成功结束，无报错。然后 重启 Claude Code，或执行：

/reload-plugins

步骤 2：用 ctx-doctor 验收

在会话中执行：

/context-mode:ctx-doctor

对照结果：诊断项应全部显示 [x]。官方说明 doctor 会检查：运行时（Node/Bun）、hooks 注册、FTS5、插件注册与版本。

若有红叉：

  • 运行时：确认本机 node -v ≥ 22.5，或已装 Bun（README：Linux + Node ≥ 22.5 会走内置 node:sqlite）
  • hooks：确认用的是插件路径而不是只加了 MCP
  • 插件：再跑一次 /reload-plugins 后重开会话

也可在终端直接跑（不依赖会话）：

context-mode doctor

（若尚未全局安装 CLI，插件路径下 doctor 仍可通过 slash 命令调用 MCP 工具 ctx_doctor。）

步骤 3：看节省量与常用 slash 命令

/context-mode:ctx-stats

对照结果：应返回本会话的工具调用次数、token/上下文节省比例等统计（新会话可能接近 0，属正常）。

官方 slash 命令速查（Claude Code 专用）：

命令作用
/context-mode:ctx-stats上下文节省：按工具拆分、消耗与节省比
/context-mode:ctx-doctor诊断运行时、hooks、FTS5、插件注册
/context-mode:ctx-index把本地文件/目录编入持久 FTS5 知识库
/context-mode:ctx-search搜索已索引内容
/context-mode:ctx-upgrade拉取最新、重建、迁移缓存、修复 hooks
/context-mode:ctx-purge永久删除知识库中全部已索引内容
/context-mode:ctx-insight打开托管 Insight 看板（Platform，可选）

其他平台没有 slash 时，在聊天里直接输入 ctx stats、ctx doctor 等，由模型调用同名 MCP 工具。第 2 课 Cursor 路径就是这种用法。

步骤 4：确认插件注册了什么

官方 README 写明：Claude Code 插件会注册全部 hooks（PreToolUse、PostToolUse、UserPromptSubmit、PreCompact、SessionStart、Stop）以及 11 个 MCP 工具：

  • 沙箱六件套：ctx_batch_execute、ctx_execute、ctx_execute_file、ctx_index、ctx_search、ctx_fetch_and_index
  • 元工具五件套：ctx_stats、ctx_doctor、ctx_upgrade、ctx_purge、ctx_insight

路由由 SessionStart hook 在运行时注入，不会往你的仓库写 CLAUDE.md（官方为避免污染 git 树已关闭自动写文件）。

可选：状态栏实时看节省

Claude Code 的插件清单无法声明 status line，需要一次性手动改 ~/.claude/settings.json：

{
  "statusLine": {
    "type": "command",
    "command": "context-mode statusline"
  }
}

保存后重启 Claude Code。对照结果：状态栏出现类似 $ saved this session · $ saved across sessions · % efficient 的汇总。

备选：仅 MCP、不要 hooks

若只想试用工具、暂不强制路由：

claude mcp add context-mode -- npx -y context-mode

对照结果：/mcp 列表里能看到 context-mode。注意：没有 hooks 时，模型仍可调用 ctx_*，但不会被强制优先沙箱；官方估无无 hooks 时节省大约 ~60%，有 hooks 约 ~98%。

本课验收清单

  1. /context-mode:ctx-doctor 全部 [x]
  2. /context-mode:ctx-stats 能返回报告（哪怕数值为 0）
  3. 知道下一课要在 Cursor 做「手动 MCP + hooks + .mdc 路由文件」

截图对照

课程封面与站内 Context Mode 工具页使用的界面图来自官方站点 context-mode.com 的产品/OG 视觉；安装成功后以你本机 doctor/stats 输出为准。

本课资料