本页汇总实战课程和深度配置的环境配置要求，帮助你在开始学习前了解需要准备什么。
一、基础环境
| 需求 | 最低要求 | 推荐配置 | 说明 |
|---|---|---|---|
| Claude 订阅 | Pro ($20/mo) | Max 5x ($100/mo) | Pro 可完成全部教程；Max 解锁并行体验 |
| 操作系统 | macOS 13+ / Ubuntu 22.04+ / Windows 11 (WSL2) | macOS 14+ | macOS 下功能支持最完整 |
| Node.js | 18+ | 22 LTS | MCP 安装依赖 |
| Python | 3.10+ | 3.12+ | 学术研究统计分析模块需要 |
| Claude Code | v2.1.80+ | 最新版 | 课程基于 v2.1.84 编写 |
| 终端 | 任意现代终端 | Warp / iTerm2 | StatusLine 渲染兼容性最佳 |
二、Claude 订阅等级对比
Pro 和 Max 在功能上完全一致——包括 SubAgent、所有模型（含 Opus 4.6）。差异仅在用量配额。
| 维度 | Pro ($20/mo) | Max 5x ($100/mo) | Max 20x ($200/mo) |
|---|---|---|---|
| 用量倍率 | 1x（基准） | 5x | 20x |
| 5 小时窗口消息数 | ~45 条 | ~225 条 | ~900 条 |
| 每周 Opus 时长 | 有限 | 15-35h | 24-40h |
| SubAgent | 可用，受频率限制 | 充裕，支持并行编排 | 几乎无限制 |
| 超额购买 | 不支持 | 按 API 费率购买额外用量 | 按 API 费率购买额外用量 |
Pro 订阅可以使用 SubAgent，功能上无差异。多 SubAgent 并行编排（如 5 个 SubAgent 并行精读）会加速消耗配额，Pro 用户可能在单次教程中触达限制。所有标注"推荐 Max"的步骤均提供 Pro 替代方案（顺序执行代替并行），学习效果相同。
各模块订阅等级速查
| 模块 | 最低等级 | 推荐等级 | Pro 替代方案 |
|---|---|---|---|
| 通用场景 | Pro | Pro | -- |
| 文献综述（学术） | Pro | Max | SubAgent 顺序执行 |
| 统计分析（学术） | Pro | Max | 专家盲审逐个执行 |
| 参考文献（学术） | Pro | Pro | -- |
| 实验设计（学术） | Pro | Max | 缩减并行 MCP 调用 |
| 软件开发 | Pro | Max | Worktree 顺序切换 |
| 知识库（知识管理） | Pro | Max | 减少同时 MCP 数量 |
| 生活管理（知识管理） | Pro | Pro | -- |
| 深度配置 | Pro | Pro | -- |
三、各领域 MCP 需求
MCP 采用按模块逐步安装策略。你不需要提前安装所有 MCP——每个模块的"环境配置"章节会指导你安装当前所需的 MCP。通用场景零依赖即可开始学习。
通用场景
无额外 MCP 要求。通用场景全部模块仅需 Claude Code 本体。
学术研究
| MCP | 用途 | 涉及场景 |
|---|---|---|
| Semantic Scholar | 英文学术检索 | 文献综述、统计分析、参考文献、实验设计 |
| OpenAlex | 开放获取学术数据 | 文献综述、参考文献 |
| CNKI（可选） | 中文学术检索 | 文献综述 |
| Firecrawl | 摘要提取 / 内容抓取 | 文献综述、实验设计 |
| EXA / Tavily / Linkup | 网络学术资源补充 | 文献综述、实验设计 |
安装节奏: 文献综述场景安装核心三件套（Semantic Scholar + OpenAlex + Firecrawl），后续模块仅安装增量部分。
软件开发
| MCP | 用途 | 涉及场景 |
|---|---|---|
| context7 | 技术文档实时查询 | 全部软件开发场景 |
| playwright（可选） | 浏览器自动化 / E2E 测试 | 部分软件开发场景 |
安装节奏: 软件开发场景安装 context7。
知识管理
按场景按需安装，最多涉及 6 个 MCP（exa-search, firecrawl, linkup, openalex, semantic-scholar, tavily）。生活管理模块无额外 MCP 要求。
深度配置
MCP 安装本身即教学内容（详见 MCP 完全指南），你会在课程中逐步完成配置。
四、各领域 Skill 需求
| 领域 | 所需 Skill | 来源 |
|---|---|---|
| 学术研究 | semantic-scholar-research-guide, field-evolution-review, field-overview-review, literature-set-review, academic-ref-check, firecrawl-abstract, humanizer-zh, ssci-chart-style, data-visualization, academic-paper-converter, matplotlib-pro | 课程内置 |
| 软件开发 | frontend-design, web-design-guidelines, taste-skill | 课程内置 |
| 知识管理 | 无额外 Skill 要求 | -- |
| 深度配置 | skill-creator（作为教学对象） | 课程内置 |
所有 Skill 均在课程中提供安装指引。学术研究学员还可选装社区扩展 Skill（Imbad0202/academic-research-skills），教程中以外部链接形式推荐。
五、平台兼容性
macOS（推荐）
所有教程均在 macOS 下开发和验证，功能支持最完整。StatusLine 模块（详见 自定义状态栏）和 Hooks 通知模块（详见 Hooks 完全指南）依赖 macOS 特性，在其他平台上需替代方案。
Linux（Ubuntu 22.04+）
核心教程（通用场景、学术研究、软件开发、知识管理）全部兼容。深度配置中 Hooks 通知的 macOS 专属功能不可用，教程中会标注 Linux 替代方案。
Cowork 和 Dispatch 在 Linux 上的集成尚不完整（截至 2026-03）。
Windows 11（WSL2）
Claude Code 不原生运行在 Windows 上，必须通过 WSL2 使用。
安装步骤: PowerShell (管理员) → wsl --install → 重启 → 在 Ubuntu 终端中安装 Claude Code。
兼容性: 核心教程全部可完成。已知限制:
- Node.js 和 Python 必须安装在 WSL 内部，而非 Windows 侧
- 项目应放在 WSL 原生路径（
~/）而非/mnt/c/，否则 I/O 性能显著下降 - Hooks 通知的 macOS 专属功能不可用
- Bun 运行时可能在 WSL2 上出现 segfault（已知问题，等待上游修复）
- Cowork/Dispatch 与 WSL2 的跨环境集成尚未完善
六、环境准备建议
- 从通用场景开始: 零依赖，安装好 Claude Code 即可直接学习
- 按需安装 MCP: 不要一次性预装全部，每个模块会指导你安装当前所需的 MCP
- Pro 订阅足够: 全部教程可在 Pro 下完成，标注"推荐 Max"的步骤都有 Pro 替代方案
- 优先使用 macOS: 如果有多台设备可选，macOS 的功能覆盖最全
- WSL2 用户注意路径: 将项目放在
~/而非/mnt/c/，性能差异非常显著
七、常见问题
SubAgent 在 Pro 订阅下能用吗？
可以。Pro 和 Max 功能完全一致，差异仅在用量配额。教程中所有"推荐 Max"的步骤均提供 Pro 替代方案。
需要预装所有 MCP 吗？
不需要。按模块逐步安装，每个模块开头会指导安装当前所需的 MCP。通用场景零依赖直接开始。
Windows 用户能完成所有教程吗？
核心教程全部可完成。受限内容仅 Hooks 通知的 macOS 专属功能，教程中会标注平台差异。
不同订阅等级需要不同学习路径吗？
不需要。全部教程以 Pro 为基准设计，需要注意的差异在具体步骤中标注，Pro 用户按替代方案操作即可。