Claude Code 零基础入门实战教程

# 检查 Node.js 版本（npm 安装方式需要）
node --version
# 期望输出：v18.x.x 或更高

# 检查 npm 版本
npm --version
# 期望输出：9.x.x 或更高

# 检查 Git 是否安装
git --version
# 期望输出：git version 2.x.x

curl -fsSL https://claude.ai/install.sh | sh

irm https://claude.ai/install.ps1 | iex

claude --version
# 期望输出类似：Claude Code v2.1.x

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

claude --version

brew install claude-code

# 检查 claude 是否在 PATH 中
which claude

# 如果为空，手动添加 PATH（原生安装器通常安装在 ~/.local/bin）
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# 方案一：使用 nvm 管理 Node.js
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 18
npm install -g @anthropic-ai/claude-code

# 方案二：修改 npm 全局目录
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

# 在 PowerShell（管理员）中运行
wsl --install
# 重启后，在 Ubuntu 终端中继续安装 Claude Code

claude

Please visit https://console.anthropic.com/device
and enter code: XXXX-XXXX

export ANTHROPIC_API_KEY="sk-ant-xxxxx"
claude

# 写入 shell 配置文件
echo 'export ANTHROPIC_API_KEY="sk-ant-xxxxx"' >> ~/.bashrc
source ~/.bashrc

╭───────────────────────────────────────╮
│  Claude Code                          │
│  Model: claude-sonnet-4-6             │
│  cwd: /home/user/my-project           │
╭───────────────────────────────────────╮
>

> 列出当前项目的文件结构

> 这个项目用了什么技术栈？

> 解释一下 src/auth/login.ts 的逻辑

mkdir my-todo-app && cd my-todo-app

claude

> /init

# 项目：个人任务管理应用

## 技术栈
- 后端：Node.js + Express
- 数据库：SQLite（better-sqlite3）
- 前端：HTML + CSS + 原生 JavaScript

## 项目结构
- server.js — 主服务入口
- db/ — 数据库初始化和操作
- public/ — 静态前端文件
- routes/ — API 路由

## 编码规范
- 使用 CommonJS 模块（require/module.exports）
- 函数和变量使用驼峰命名
- API 返回 JSON 格式
- 错误处理统一返回 { error: "错误信息" }

## 开发命令
- 启动开发服务器：node server.js
- 安装依赖：npm install

~/.claude/CLAUDE.md          ← 全局配置（所有项目共享）
项目根目录/CLAUDE.md          ← 项目配置（团队成员共享）
项目根目录/.claude/CLAUDE.md  ← 项目私有配置（不提交到 Git）

> 根据CLAUDE.md中的技术栈，帮我创建完整的项目结构。包括：
> 1. package.json
> 2. server.js 主入口
> 3. SQLite 数据库初始化脚本
> 4. RESTful API（增删改查任务）
> 5. 简洁的前端页面

让我创建项目结构...
  ✓ 创建 package.json
  ✓ 创建 server.js
  ✓ 创建 db/init.js
  ✓ 创建 routes/tasks.js
  ✓ 创建 public/index.html
  ✓ 创建 public/style.css
  ✓ 创建 public/app.js
  ✓ 运行 npm install

> 启动开发服务器并测试 API 是否正常

node server.js
# 输出：Server running on http://localhost:3000

# 创建任务
curl -X POST http://localhost:3000/api/tasks \
  -H "Content-Type: application/json" \
  -d '{"title":"学习 Claude Code","description":"完成入门教程"}'

# 获取所有任务
curl http://localhost:3000/api/tasks

> 给任务添加优先级字段（高/中/低），前端加一个优先级筛选下拉框

> 添加任务完成状态切换功能，完成后显示删除线

> 写一个简单的测试文件

> 初始化 Git 仓库，创建 .gitignore，提交初始代码

git init
# 创建 .gitignore（包含 node_modules, .env 等）
git add .
git commit -m "Initial commit: Todo app with Express + SQLite"

flowchart TD
    A[安装 Claude Code] --> B[首次认证]
    B --> C[打开项目目录]
    C --> D[运行 claude 启动]
    D --> E[运行 /init 生成 CLAUDE.md]
    E --> F[编辑 CLAUDE.md 设定规则]
    F --> G{任务类型}

    G -->|新功能| H[用自然语言描述需求]
    G -->|修 Bug| I[描述问题现象]
    G -->|重构| J[说明重构目标]

    H --> K[Claude Code 执行]
    I --> K
    J --> K

    K --> L{满意？}
    L -->|是| M[git commit 提交]
    L -->|否| N[/undo 撤销或补充指令]
    N --> K

    M --> O[继续下一个任务]

    style A fill:#4A90D9,color:#fff
    style B fill:#4A90D9,color:#fff
    style K fill:#E8A838,color:#fff
    style M fill:#5CB85C,color:#fff

# 默认模式：每次危险操作都询问
claude

# 接受所有读取操作，写入和命令仍需确认
claude --allowedTools Read,Glob,Grep

# 自动接受所有操作（仅用于可信环境）
claude --dangerouslySkipPermissions

{
  "permissions": {
    "allow": [
      "Bash(npm test)",
      "Bash(npm run lint)",
      "Bash(node *)"
    ],
    "deny": [
      "Bash(rm -rf *)",
      "Bash(git push *)"
    ]
  }
}

> /plan
已进入计划模式。我会分析并制定方案，但不会修改任何文件。

> 重构整个认证模块，支持 OAuth2 和 JWT 两种方式

## 实施计划

### 第一阶段：数据模型设计
1. 创建 User 模型（支持 OAuth 账号关联）
2. 创建 Session 模型（JWT Token 管理）
...

### 第二阶段：OAuth2 集成
1. 添加 OAuth2 客户端配置
2. 实现 GitHub/Google 登录流程
...

### 第三阶段：JWT 认证
1. 实现 JWT 签发和验证
2. 添加 Token 刷新机制
...

### 预计影响文件
- src/auth/ 目录（重写）
- src/routes/login.ts（修改）
- src/middleware/auth.ts（新建）

是否开始执行？

> /model claude-opus-4-6

claude --model claude-opus-4-6

> /compact

> /clear

> 查看 src/utils/helpers.js 中的 formatDate 函数，帮它加上时区支持

> 审查最近一次 Git 提交的代码，指出潜在问题

> 运行测试，如果失败了分析原因并修复

> 为 src/api/ 目录下的所有路由生成 API 文档

> 将 src/utils.js 拆分成独立的模块文件，保持功能不变

> /plan
> 我需要给这个项目添加缓存层，比较 Redis 和 Memcached 的优劣，给出推荐方案

> 提交当前更改，commit message 用中文描述

# My Project
这是一个 Web 应用

> /undo

# 正确
cd ~/projects/my-app && claude

# 错误（在 home 目录启动，上下文太大）
cd ~ && claude