五一假期装 Claude Code：半天从零到跑通（特工宇宙）

来源类型： 实战教程
日期： 2026-05
标签： #ClaudeCode #VibeCoding #安装教程 #特工宇宙 #nvm #node

核心问题

"我有个朋友，五一假期突然来了兴致，想 Vibe Coding 一个自己的网站。"

"想法很好，但他卡在了第一步：不会装 Claude Code。"

三分钟安装 Claude Code（macOS）

第一步：安装 nvm

brew install nvm

# 配置 .zshrc
echo '# 永久加载 nvm
export NVM_DIR="$HOME/.nvm"
[ -s "/opt/homebrew/opt/nvm/nvm.sh" ] && \. "/opt/homebrew/opt/nvm/nvm.sh"
[ -s "/opt/homebrew/opt/nvm/etc/bash_completion.d/nvm" ] && \. "/opt/homebrew/opt/nvm/etc/bash_completion.d/nvm"' >> ~/.zprofile
source ~/.zprofile

第二步：安装 node

nvm install node

第三步：安装 Claude Code（国内镜像源）

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmmirror.com

# 安装完成后试试
claude

第四步：配置登录状态

"按 ⬆️ + Command + 。 打开隐藏文件，找到 .claude.json。"

{
  "hasCompletedOnboarding": true
}

第五步：打开 Claude Code

"半个下午从零到跑通，五一剩下的时间就可以愉快地 Vibe Coding 了。"

关键洞察

1. 安装门槛真实存在

• 对非开发者：有点门槛
• 卡在第一步 = 卡在 Vibe Coding 整个旅程

2. 国内镜像源关键

• registry.npmmirror.com 加速
• 避免 npm 官方源卡顿

3. .claude.json 配置

• hasCompletedOnboarding: true
• 跳过引导，直接可用

与已有知识的关联

• wiki/entities/claude-code — Claude Code
• wiki/entities/anthropic — Anthropic
• wiki/concepts/vibe-coding — Vibe Coding
• wiki/concepts/nvm-install — nvm 安装
• wiki/concepts/npm-mirror — npm 国内镜像
• wiki/entities/tegezhouyu — 特工宇宙（来源）

资料来源

• 原文：https://mp.weixin.qq.com/s/HH3CJnkMT4q1G7vi484PfQ
• 原始文件：raw/articles/微信文章3/五一假期，花半天装个 Claude Code 玩玩？.md
• 编辑：特工小师 / 特工小饼
• 来源：特工宇宙

我的判断（高置信度）

这是 2026 年 Claude Code 中文安装最实战的教程——半天从零到跑通。

关键洞察：
1. "非开发者卡在安装" —— 是普遍痛点
2. "国内镜像源" —— 加速关键
3. "hasCompletedOnboarding: true" —— 跳过引导
4. "半天跑通" —— 时间可控
5. "Vibe Coding 起步" —— 是核心场景

预测：
- 2026 H2：可能涌现更多"AI 工具小白友好"安装教程
- 2027：可能形成"AI 工具标准化安装流程"
- 2028：可能不需要"安装"概念
- 对国内开发者的建议：
使用 npm 国内镜像——加速明显
- 使用 brew + nvm——macOS 标配
- .claude.json 配置——跳过引导
- 对工具派的启示：
"安装门槛" 是 AI 工具普及最大障碍
- 国内镜像源 是中国市场关键
- 配置文件 trick 可产品化
- 对内容创作者的启示：
"朋友卡住" 是好内容起点
- 实战教程 比理论更有价值
- 场景化建议 是关键