Context Mode 接入指南：Claude Code / Cursor / VS Code Copilot 实战
Context Mode 接入指南：Claude Code / Cursor / VS Code Copilot 实战
对于个人开发者来说，使用 Context Mode 的核心在于你当前在使用哪款 AI 编码工具。
该项目目前支持 17 个平台，针对个人开发者最常用的几款工具，其接入和使用方式如下：
1. 如果你使用的是 Claude Code（最推荐，全自动）
由于 Claude Code 支持完美的生命周期钩子（Hooks），配合 Context Mode 体验最好，且完全无感。
第一步：安装插件
在你的 Claude Code 终端中直接运行：
bash
/plugin marketplace add mksglu/context-mode
/plugin install context-mode@context-mode
第二步：重启或重载
运行 /reload-plugins 或重启 Claude Code 即可。
如何使用？
你不需要改变任何聊天习惯。当你让 AI 读取大文件或执行复杂命令时，它在底层会自动拦截并启用沙盒化压缩。
小常识：你可以通过在聊天中输入 /context-mode:ctx-stats 来查看它帮你省了多少 Token。
2. 如果你使用的是 Cursor（最常用）
目前该项目的 Cursor 插件正在等待官方审核，个人开发者可以通过本地导入的方式提前享用：
第一步：克隆并链接插件（以 Mac/Linux 为例）
bash
git clone https://github.com/mksglu/context-mode.git
ln -s "$PWD/context-mode" ~/.cursor/plugins/local/context-mode
如果是 Windows 电脑，需要使用
robocopy将项目复制到%USERPROFILE%\.cursor\plugins\local\context-mode
第二步：复制路由规则（关键）
由于 Cursor 限制，必须给它喂一个规则文件，AI 才会乖乖听话：
bash
mkdir -p .cursor/rules
cp node_modules/context-mode/configs/cursor/context-mode.mdc .cursor/rules/context-mode.mdc
如何使用？
重启 Cursor。在 Agent 模式 (Composer) 下聊天时，AI 会读取 .mdc 规则，并优先调用 ctx_execute 等省 Token 的工具。你可以在对话框输入 ctx stats 让 AI 打印省钱日报。
3. 如果你使用的是 VS Code Copilot Chat
第一步：全局安装
bash
npm install -g context-mode
第二步：在你的项目根目录下配置 MCP 服务
创建 .vscode/mcp.json：
json
{
"servers": {
"context-mode": { "command": "context-mode" }
}
}
第三步：配置 Hook（拦截器）
创建 .github/hooks/context-mode.json，把里面配置上项目的 Hook 脚本（具体 JSON 模板可直接参考 GitHub 仓库说明）。重启 VS Code 后即可生效。
💡 个人开发者的最佳实践建议
- 先跑本地诊断：不管装在哪个平台，配置完成后在聊天框对 AI 发送
ctx doctor。如果全显示[x]，说明你的本地 Node.js 环境、SQLite 数据库以及 Hook 全部握手成功。 - 建立”用代码解决问题”的习惯：当你需要 AI 帮你分析一堆日志或者统计多文件数据时，在提示词里明确对它说：“请使用 context-mode 的本地脚本执行功能来统计，不要直接读取原始文件。” 这样能把它的省钱威力发挥到极致。