Claude Code 零基础入门：从安装到第一个项目

# 使用 nvm 安装（推荐）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc   # 或 source ~/.zshrc
nvm install --lts
nvm use --lts

# 验证
node --version    # 应输出 v20.x.x 或更高
npm --version     # 应输出 10.x.x 或更高

# 在 WSL Ubuntu 中
sudo apt update
sudo apt install nodejs npm
# 或同样使用 nvm

node --version && npm --version

v20.19.0
10.9.2

npm install -g @anthropic-ai/claude-code

claude --version

Claude Code v2.1.x

claude

claude>

# 检查 npm 全局路径是否在 PATH 中
npm config get prefix
# 确保该路径/bin 在你的 PATH 中
export PATH="$(npm config get prefix)/bin:$PATH"
# 永久生效，添加到 ~/.bashrc 或 ~/.zshrc
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.zshrc

# 方案一：使用 nvm 管理的 Node（推荐）
nvm use --lts
npm install -g @anthropic-ai/claude-code

# 方案二：修改 npm 全局目录
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH
npm install -g @anthropic-ai/claude-code

node --version  # 需要 >= 18
# 如果版本过低，用 nvm 升级
nvm install 20
nvm use 20

cd your-project
claude

claude> 帮我看看这个项目的结构
claude> 解释一下 src/index.ts 的主要逻辑
claude> 给用户模块加一个邮箱验证功能

claude -p "这个项目用了什么技术栈？"

# 将文件内容传给 Claude Code 分析
cat error.log | claude -p "分析这些错误日志的根本原因"

# 将 Claude Code 的输出导入文件
claude -p "生成一个 .gitignore 文件用于 Node.js 项目" > .gitignore

flowchart TD
    A[启动 Claude Code] --> B{选择模式}
    B --> C[交互式会话<br/>claude]
    B --> D[单次提问<br/>claude -p "问题"]
    B --> E[管道模式<br/>cat file | claude -p]

    C --> F[探索代码库]
    C --> G[编写/修改代码]
    C --> H[调试与修复]
    C --> I[Git 操作]

    D --> J[快速查询]
    D --> K[脚本集成]

    E --> L[日志分析]
    E --> M[批量处理]

    F --> N[输出结果]
    G --> N
    H --> N
    I --> N
    J --> N
    K --> N
    L --> N
    M --> N

flowchart LR
    A[操作请求] --> B{权限检查}
    B -->|白名单已允许| C[直接执行]
    B -->|需要确认| D[提示用户]
    D -->|用户同意| C
    D -->|用户拒绝| E[跳过操作]
    B -->|自动拒绝| E

    C --> F[继续对话]
    E --> F

flowchart TB
    A["~/.claude/CLAUDE.md<br/>全局配置<br/>所有项目生效"] --> B["项目根目录/CLAUDE.md<br/>项目配置<br/>当前项目生效"]
    B --> C["子目录/CLAUDE.md<br/>目录配置<br/>特定模块生效"]

    D[优先级：子目录 > 项目 > 全局] --> C

cd your-project
claude
claude> /init

# 项目：Weather API

## 技术栈
- Node.js 20 + TypeScript
- Express.js 框架
- SQLite 数据库

## 代码规范
- 使用 ESLint + Prettier
- 缩进：2 空格
- 命名：camelCase 变量，PascalCase 类
- 注释使用中文

## 项目结构
- src/routes/ — 路由定义
- src/models/ — 数据模型
- src/services/ — 业务逻辑
- src/utils/ — 工具函数

## 工作规则
- 修改代码后运行 npm test 验证
- 不要修改 .env 文件
- API 响应统一使用 JSON 格式
- 错误处理使用统一格式 { error: string, code: number }

mkdir weather-api && cd weather-api
git init
claude

claude> 我想创建一个 Node.js + Express 的天气查询 REST API。
项目需求：
1. 查询指定城市的实时天气（调用 OpenWeatherMap API）
2. 查询城市未来 5 天的天气预报
3. 所有响应统一 JSON 格式
4. 包含错误处理和参数验证
5. 使用 TypeScript

weather-api/
├── package.json
├── tsconfig.json
├── .env.example
├── .gitignore
├── CLAUDE.md
├── src/
│   ├── index.ts
│   ├── routes/
│   │   └── weather.ts
│   ├── services/
│   │   └── weatherService.ts
│   ├── middleware/
│   │   └── errorHandler.ts
│   └── types/
│       └── index.ts
└── tests/
    └── weather.test.ts

claude> 端口号改为从环境变量 PORT 读取，默认值 8080

claude> 安装依赖并启动开发服务器

npm install
npm run dev

claude> 启动报错了，帮我看看错误信息并修复

claude> 添加一个缓存层，相同城市的天气数据缓存 10 分钟，减少 API 调用次数

claude> 为 weatherService 编写单元测试，使用 Jest 框架，mock 外部 API 调用

npm test

claude> 提交所有变更，commit message 要清晰描述这次改动

flowchart TD
    A[创建项目目录] --> B[启动 Claude Code]
    B --> C[描述需求]
    C --> D[Claude 生成代码]
    D --> E[审查 Diff]
    E -->|接受| F[代码写入磁盘]
    E -->|拒绝/调整| G[提供反馈]
    G --> D
    F --> H[安装依赖]
    H --> I[启动验证]
    I -->|成功| J[添加功能]
    I -->|失败| K[调试修复]
    K --> I
    J --> L[编写测试]
    L --> M[运行测试]
    M --> N[Git 提交]
    N --> O[项目完成 ✅]

claude> 先读一下 src/routes/weather.ts 和 src/services/weatherService.ts，然后帮我添加一个新端点，获取指定城市的历史天气数据

claude> 帮我创建一个完整的用户认证系统，包括注册、登录、JWT、密码重置、邮箱验证

claude> 第一步：创建用户数据模型和数据库迁移
claude> 第二步：实现注册和登录接口
claude> 第三步：添加 JWT 中间件
claude> 第四步：实现密码重置流程
claude> 第五步：添加邮箱验证

claude> 我需要把这个项目从 Express 迁移到 Fastify，帮我规划一下

flowchart LR
    subgraph 四端使用
        A[终端 CLI<br/>npm install -g<br/>功能最全]
        B[桌面应用<br/>下载 dmg/exe<br/>开箱即用]
        C[VS Code 插件<br/>扩展商店安装<br/>编辑器内使用]
        D[浏览器<br/>claude.ai/code<br/>零安装]
    end

    A --- E[适合：全栈开发者<br/>DevOps 工程师]
    B --- F[适合：前端开发者<br/>非终端用户]
    C --- G[适合：日常编码<br/>轻量任务]
    D --- H[适合：快速体验<br/>临时使用]

flowchart TD
    A[✅ 你在这里<br/>安装与第一个项目] --> B[Step 2<br/>CLAUDE.md 深度定制]
    B --> C[Step 3<br/>Skills 自定义命令]
    C --> D[Step 4<br/>MCP 服务器集成]
    D --> E[Step 5<br/>Hooks 自动化]
    E --> F[Step 6<br/>多 Agent 协作]
    F --> G[Step 7<br/>CI/CD 集成]

    style A fill:#4CAF50,color:#fff
    style B fill:#2196F3,color:#fff
    style C fill:#2196F3,color:#fff
    style D fill:#FF9800,color:#fff
    style E fill:#FF9800,color:#fff
    style F fill:#9C27B0,color:#fff
    style G fill:#9C27B0,color:#fff