本页汇总实战课程和深度配置的环境配置要求，帮助你在开始学习前了解需要准备什么。
一、基础环境
| 需求 | 最低要求 | 推荐配置 | 说明 |
|---|---|---|---|
| Claude 订阅 | Pro ($20/mo) | Max 5x ($100/mo) | Pro 可完成全部教程；Max 解锁并行体验 |
| 操作系统 | macOS 13+ (ARM64/Intel) / Ubuntu 22.04+ (apt/dnf/apk) / Windows 11 (WSL2 或 PowerShell) | macOS 14+ | macOS 下功能支持最完整 |
| Node.js | 18+ | 22 LTS | MCP 安装依赖 |
| Python | 3.10+ | 3.12+ | 学术研究统计分析模块需要 |
| Claude Code | v2.1.110+ | v2.1.126+ | 课程基于 v2.1.126 编写。首装推荐 native installer（curl claude.ai/install.sh | bash / irm claude.ai/install.ps1 | iex）；老 npm 装机用 claude install 迁移；npm 安装方式已弃用 |
| 终端 | 任意现代终端 | Warp / iTerm2 | StatusLine 渲染兼容性最佳 |
二、Claude 订阅等级对比
Pro 和 Max 在功能上完全一致——包括 SubAgent、所有模型（含 Opus 4.7 + 1M context）。差异仅在用量配额。
| 维度 | Pro ($20/mo) | Max 5x ($100/mo) | Max 20x ($200/mo) |
|---|---|---|---|
| 用量倍率 | 1x（基准） | 5x | 20x |
| 5 小时窗口消息数 | ~45 条 | ~225 条 | ~900 条 |
| 每周 Opus 4.7 时长 | 有限 | 15-35h | 24-40h |
| SubAgent | 可用，受频率限制（含 Forked subagent v2.1.117+） | 充裕，支持并行编排 | 几乎无限制 |
| 超额购买 | 不支持 | 按 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, systematic-review, meta-analysis, theoretical-review, review-methodology-foundations, academic-ref-check, firecrawl-abstract, humanizer-zh, ssci-plots, 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+）
支持 apt (Debian/Ubuntu)、dnf (Fedora/RHEL)、apk (Alpine) 包管理器安装。GitHub Enterprise Server 集成可用。核心教程全部兼容。深度配置中 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 的跨环境集成尚未完善
六、环境准备建议
- 安装 native binary:
claude install latest安装 Claude Code（npm 安装方式已弃用） - 从通用场景开始: 零依赖，安装好 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 用户按替代方案操作即可。
macOS 安装时 Keychain 弹窗反复出现？
macOS Keychain 有时锁定 Claude Code 的 OAuth token。在 Keychain Access 中搜索 "claude" 相关条目，解锁或删除后重新 /login。
下载 Claude Code 连不上？
下载源已从 storage.googleapis.com 迁移到 downloads.claude.ai/claude-code-releases。确认防火墙/代理允许新域名。