Claude Code 2026 完整新手指南：从安装到高级工作流（官方权威版）

curl -fsSL https://claude.ai/install.sh | bash
claude --version  # 验证安装

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

brew install --cask claude-code

winget install Anthropic.ClaudeCode

# 在 WSL2 终端内
curl -fsSL https://claude.ai/install.sh | bash

claude          # 进入交互模式，首次会触发登录

claude auth login
# 浏览器完成登录后，把 OAuth 代码直接粘贴回终端

claude                          # 交互模式
claude "修复 src/app.ts 里的构建错误"  # 单次任务
claude -p "解释认证流程"         # Print 模式（非交互，输出到 stdout）
claude -c                       # 继续上次会话
claude -r                       # 打开会话选择器
claude --from-pr 42             # 从 PR 恢复会话（Week 18 新增）
claude commit                   # 直接运行内置 commit skill

# 简单函数
> 创建一个验证邮箱地址的工具函数，处理边界情况，包含 JSDoc 文档

# 多文件特性实现
> 1. 创建用户个人资料的数据库表
> 2. 创建获取和更新个人资料的 API 端点
> 3. 构建允许用户查看和编辑信息的网页

# 全栈特性（数据库 + 后端 + 前端）
> 构建完整的"用户通知"功能：
> 1. 创建通知表（id, user_id, type, title, message, read, created_at）
> 2. 创建 NotificationService（create/markAsRead/getUnread/getAll）
> 3. 添加 REST 端点：GET /api/notifications, PATCH /api/notifications/:id/read
> 4. 构建 React 通知铃组件（显示未读数量 + 下拉列表）
> 5. 添加 WebSocket 支持，实时显示新通知
> 6. 为 Service 层和 API 层写测试

> 按照 @src/routes/users.ts 和 @src/services/userService.ts 里的模式，
> 为 products、categories、reviews、wishlists 创建 CRUD 端点

> 这个项目是干什么的？
> 解释整体架构和关键设计决策
> 追踪用户点击"提交订单"到发送确认邮件的完整请求流程
> 找到所有处理用户认证的地方
> 解释 @src/middleware/auth.ts 的每一行——处理了哪些边界情况？可能出什么问题？

# 粘贴错误信息
> 运行 npm test 时看到这个错误：
> TypeError: Cannot read properties of undefined (reading 'map')
>     at UserList (/src/components/UserList.tsx:15:23)

# 自动运行并修复
> 运行 npm test，找到失败的测试并修复

# 复杂问题
> 结账页面在手机上显示空白屏，桌面端正常。
> 1. 检查结账组件里的响应式 CSS 和媒体查询
> 2. 查找可能依赖视口的 JavaScript 错误
> 3. 检查是否有第三方脚本阻止了手机渲染
> 4. 提出并应用修复方案

# 找未覆盖的代码
> 找出 auth 模块里没有测试覆盖的函数

# 生成测试
> 为 src/services/payment.ts 编写全面的单元测试，包含边界情况和错误场景

# TDD 流程
> 1. 为一个根据重量、距离、配送速度计算运费的函数写失败测试
> 2. 实现函数使测试通过
> 3. 为非法输入添加边界测试

# 分析覆盖率
> 分析 src/services/ 目录的测试覆盖率，哪些函数没有测试？
> 按风险排序，建议优先补哪些测试

# 智能提交
> 提交我的变更，生成描述性的 commit 消息

# PR 创建
> 创建一个 PR

# 从 PR URL 恢复会话（Week 18 新增）
> /resume
# 在选择器里粘贴 PR URL，自动跳到创建该 PR 的会话

# 响应 PR 评论
> /pr-comments
# Claude 读取 PR 上的审查评论，帮你逐一处理

# 代码审查
claude --from-pr 42   # 从 PR 42 的 Diff 开始会话，进行审查

> /init

# 项目：电商 API

## 技术栈
- Node.js 20 + TypeScript 5.4
- Express.js + Zod 验证
- PostgreSQL + Prisma ORM

## 常用命令
- `npm run dev` — 启动开发服务器
- `npm test` — 运行测试
- `npm run build` — 生产构建

## 代码规范
- API 响应统一格式：{ data, error, meta }
- 错误处理用 src/utils/errors.ts 里的 AppError 类
- 所有数据库查询通过 src/repositories/ 里的 Repository 模式

## 架构说明
- src/routes/ — Express 路由处理器
- src/services/ — 业务逻辑
- src/repositories/ — 数据库访问

/hooks

# macOS：任务完成时桌面通知
osascript -e 'display notification "Claude Code 完成了" with title "Claude Code"'

# 播放音效提示
afplay /System/Library/Sounds/Glass.aiff

# Linux 桌面通知
notify-send 'Claude Code' '任务完成'

# 查看可用 Skills（Week 18：支持输入过滤搜索）
/skills

# 直接调用内置 Skills
claude commit         # 暂存并提交
claude review         # 审查当前变更

---
name: deploy
description: 部署到生产环境
disable-model-invocation: true
allowed-tools: Bash(npm *) Bash(git *)
---

部署流程：
1. 运行 npm test，失败则停止
2. 运行 npm run build
3. 推送到 deploy/production 分支
4. 验证健康检查通过

# 查看当前 Token 用量
/cost

# 压缩上下文（保留摘要，减少 Token 占用）
/compact

# 开新会话（复杂任务结束后避免上下文积累过大）
/clear

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

{
  "autoMode": {
    "hard_deny": [
      "Bash(rm -rf /)",
      "Bash(curl * | bash)"
    ]
  }
}