安装指南
3 分钟完成安装和配置
前置要求
- 1.Node.js 18+ - 下载安装
- 2.支持的开发工具 - Cursor / Claude Code / Codex CLI / Qwen Code / Windsurf（任选其一）
安装 Vibe Tutor
使用 npm 全局安装：
npm install -g vibe-tutor安装完成后，可以运行 vibe-tutor --version 验证安装。
配置开发工具
根据你使用的开发工具选择对应命令：
vibe-tutor install cursor安装后自动发现，重启即可使用
vibe-tutor install claude自动配置 enabledPlugins，重启即可使用
vibe-tutor install codex自动创建市场配置，重启即可使用
vibe-tutor install qwen自动启用扩展，重启即可使用
vibe-tutor install windsurf写入 ~/.codeium/windsurf/，重启即可在 Cascade 中使用
安装完成后请完全重启开发工具以加载插件。
验证安装（30 秒）
重启开发工具后，在 AI 对话框输入下面命令——能看到方法论 14 步引导就装好了：
/tutor-init$tutor-init@tutor-init（也可直接描述需求，skill 按 description 自动匹配）输几个字母（比如 /tut）就会弹出命令列表，选 tutor-init 即可。CLI 自动补全命名空间，不用记长全名。
✓ 免费版完全离线：装好后直接在 AI 对话框输入命令就能用，不需要注册。
✓ 所有 hook + 7 个 skill 全部 Free 可用。
完整命令列表（含 Pro 专享）→ 命令参考
（可选）注册账号
Free 用户用不到这一步。想做以下任一件事时才注册：
- 用 Pro 独有功能（/tutor-insight 跨项目复盘、/tutor-coach 教练复盘、/tutor-rescue 卡住急救）
- 访问 SaaS 控制台 （看 dashboard / 偏离检测 / 健康度评分）
- 报名月度小组答疑会（Pro 福利，每月 1 次免费）
vibe-tutor login首次跑会跳转浏览器到注册页面，注册完成后自动授权回 CLI。
免费版不存储任何项目数据到云端：telemetry CLI 端就会跳过 Free 用户。
非 GUI 环境（SSH、Docker 等）？CLI 会输出授权链接，复制到浏览器打开即可。
安装常见问题
Q: 装完开发工具没反应？
A: 确保已完全重启开发工具（不是关窗口，是退出进程）。各平台安装后会自动启用，无需手动配置。
Q: Codex CLI 装完看不到插件？
A: Codex 限制：在 TUI 里输 /plugins 找到 vibe-tutor 手动点 Install 一次（installer 已经预注册好）。
Q: Qwen Code 扩展未启用？
A: 运行 qwen extensions enable vibe-tutor（安装时会自动尝试，失败时手动跑一次）
想知道如何卸载 / 更新？→ 命令参考的 CLI 章节
安装遇到问题？
联系支持