Skip to content

🚀 中级教程 - 进阶篇

适合:已经能够基本使用 Claude Code,想要深入学习的开发者

📋 前置要求

在学习本章节之前,请确保你已经:

  • ✅ 完成 初级教程 的学习
  • ✅ 能够正常启动和使用 Claude Code
  • ✅ 了解基本的终端命令和 Git 操作

🎯 斜杠命令详解

斜杠命令是 Claude Code 的核心功能,掌握它们能大幅提升你的工作效率。

项目初始化命令

/init - 初始化项目配置

bash
# 在项目根目录执行
/init

这个命令会:

  1. 分析你的项目结构

🎬 /init 命令演示

  1. 自动生成 CLAUDE.md 配置文件
  2. 记录项目的技术栈、架构和开发规范

最佳实践:每个新项目开始时都应该执行 /init

🎬 /init 命令演示

### 会话管理命令

/compact - 压缩对话历史

bash
# 当对话变得很长时使用
/compact

使用场景

  • 对话历史过长,响应变慢
  • 想要清理无关的上下文
  • 开始新的任务方向

/resume - 恢复上次会话

bash
# 启动 Claude Code 后执行
/resume

功能说明

  • 自动加载上次的对话上下文
  • 恢复之前的工作进度
  • 继续未完成的任务

/clear - 清除对话历史

bash
# 完全重新开始
/clear

配置管理命令

/config - 查看和修改配置

bash
# 查看当前配置
/config

# 修改特定配置项
/config set theme dark

/model - 切换 AI 模型

bash
# 查看可用模型
/model

# 切换到特定模型
/model claude-sonnet-4-5-20250929

🎬 /model 命令演示

🎬 /model 命令演示

**可用模型**: | 模型 | 特点 | 适用场景 | |------|------|----------| | Claude Sonnet 4.5 | 平衡性能和成本 | 日常开发(推荐) | | Claude Opus 4.6 | 最强推理能力 | 复杂架构设计 | | Claude Haiku 4.5 | 最快响应速度 | 简单任务、代码补全 |

代码操作命令

/diff - 查看代码变更

bash
# 查看当前会话的所有修改
/diff

/undo - 撤销上次修改

bash
# 撤销最近一次代码修改
/undo

帮助命令

/help - 获取帮助

bash
# 查看所有可用命令
/help

# 查看特定命令的帮助
/help init

🧠 思考模式(2025 新功能)

Claude Code 在 2025 年引入了强大的思考模式功能,让 AI 能够进行更深入的推理。

思考模式命令

命令思考深度适用场景
think标准一般问题分析
think harder深度复杂逻辑推理
ultrathink最大架构设计、疑难问题

使用方法

在对话中直接使用这些关键词:

bash
# 标准思考
think 这个函数的性能瓶颈在哪里?

# 深度思考
think harder 如何重构这个模块以支持插件化?

# 最大思考预算
ultrathink 设计一个高并发的消息队列系统

最佳实践

  1. 日常开发:使用默认模式或 think
  2. 复杂问题:使用 think harder 获得更详细的分析
  3. 架构设计:使用 ultrathink 获得最全面的方案

💡 提示

ultrathink 会消耗更多 token,建议仅在需要深度分析时使用。


📁 CLAUDE.md 项目配置

CLAUDE.md 是 Claude Code 的项目配置文件,它告诉 AI 如何理解和处理你的项目。

文件位置

项目根目录/
├── CLAUDE.md          # 项目级配置
├── src/
│   └── CLAUDE.md      # 目录级配置(可选)
└── ...

配置文件结构

markdown
# 项目名称

## 项目概述
简要描述项目的目的和功能。

## 技术栈
- 前端:React 18 + TypeScript
- 后端:Node.js + Express
- 数据库:PostgreSQL
- 部署:Docker + Kubernetes

## 目录结构
## 开发规范

src/ ├── components/ # React 组件 ├── services/ # 业务逻辑 ├── utils/ # 工具函数 └── types/ # TypeScript 类型定义

- 使用 ESLint + Prettier 进行代码格式化
- 组件使用函数式写法 + Hooks
- 提交信息遵循 Conventional Commits

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

## 注意事项
- API 密钥存放在 .env 文件中
- 不要直接修改 generated/ 目录下的文件

配置最佳实践

  1. 保持简洁:只包含 AI 需要知道的关键信息
  2. 及时更新:项目结构变化时同步更新配置
  3. 分层配置:大型项目可以在子目录添加局部配置

🔄 Git 集成与版本控制

Claude Code 与 Git 深度集成,可以帮助你更高效地管理代码版本。

智能提交

bash
# 让 Claude Code 帮你写提交信息
请帮我提交当前的修改

# 或者指定提交范围
请提交 src/components 目录下的修改

Claude Code 会:

  1. 分析你的代码变更

  2. 生成符合规范的提交信息

  3. 执行 git add 和 git commit

🎬 智能提交演示

🎬 智能提交演示

分支管理

bash
# 创建功能分支
请创建一个新分支来开发用户登录功能

# 合并分支
请将 feature/login 分支合并到 main

代码审查

bash
# 审查当前分支的修改
请审查我这个分支的代码修改

# 审查特定 PR
请审查 PR #123 的代码

解决冲突

bash
# 当遇到合并冲突时
请帮我解决当前的合并冲突

Claude Code 会:

  1. 分析冲突的原因
  2. 理解双方的修改意图
  3. 提供合理的解决方案

🛠️ 工作流程最佳实践

开发新功能的标准流程

bash
# 1. 初始化项目(首次)
/init

# 2. 创建功能分支
请创建 feature/user-profile 分支

# 3. 描述需求
我需要实现用户个人资料页面,包括:
- 头像上传
- 基本信息编辑
- 密码修改

# 4. 逐步实现
先实现头像上传功能

# 5. 测试验证
请帮我写单元测试

# 6. 代码审查
请审查我刚才的修改

# 7. 提交代码
请提交这些修改

# 8. 合并到主分支
请将这个分支合并到 main

修复 Bug 的标准流程

bash
# 1. 描述问题
用户登录后页面白屏,控制台报错 Cannot read property name of undefined

# 2. 定位问题
请帮我找到这个 bug 的原因

# 3. 修复问题
请修复这个问题

# 4. 验证修复
请确认修复是否完整

# 5. 提交修复
请提交这个 bug 修复

代码重构的标准流程

bash
# 1. 说明重构目标
我想重构 UserService,它现在太臃肿了

# 2. 获取建议
请分析 UserService 并给出重构建议

# 3. 分步执行
请先提取认证相关的逻辑到 AuthService

# 4. 确保测试通过
请运行测试确保重构没有破坏功能

# 5. 提交重构
请分多次提交这些重构修改

📊 多文件项目管理

跨文件修改

bash
# 批量重命名
请将所有文件中的 UserService 重命名为 UserManager

# 批量更新导入
请更新所有引用 old-module 的文件,改为引用 new-module

项目结构调整

bash
# 移动文件
请将 utils/helpers.ts 移动到 shared/utils/ 目录

# 创建新模块
请创建一个新的 notification 模块,包含基本的目录结构

依赖管理

bash
# 添加依赖
请添加 axios 库并配置基础的 HTTP 客户端

# 更新依赖
请将 React 升级到最新版本,并修复可能的兼容性问题

💡 效率提升技巧

1. 使用上下文引用

bash
# 引用之前的代码
请用类似 UserService 的方式实现 ProductService

# 引用文件
请参考 src/config/database.ts 的配置方式

2. 批量操作

bash
# 一次性处理多个文件
请为 src/components 下的所有组件添加 PropTypes 验证

3. 模板复用

bash
# 基于现有代码创建新代码
请基于 UserController 创建 ProductController

4. 智能搜索

bash
# 搜索特定模式
请找出所有使用了 deprecated API 的地方

# 搜索并替换
请将所有 console.log 替换为 logger.debug

🎓 练习任务

完成以下练习来巩固你的学习:

练习 1:项目配置

  1. 在你的项目中执行 /init
  2. 检查生成的 CLAUDE.md 文件
  3. 根据项目实际情况补充和修改配置

练习 2:Git 工作流

  1. 创建一个新的功能分支
  2. 让 Claude Code 帮你实现一个小功能
  3. 使用智能提交功能提交代码
  4. 合并到主分支

练习 3:代码重构

  1. 找一个你项目中需要重构的文件
  2. 让 Claude Code 分析并给出建议
  3. 按照建议逐步执行重构
  4. 确保测试通过后提交

➡️ 下一步

恭喜你完成了中级教程!现在你已经掌握了 Claude Code 的核心功能。

准备好挑战更高级的内容了吗?

进入高级教程 →


📚 相关资源

Claude Code 中文文档 - 社区翻译项目