Claude Code 实用学习指南

本目录包含 Claude Code CLI 工具的完整学习文档，从基础命令到高级功能，以 Python Web API 项目为例进行实战演练。

文档导航

入门篇

文档	内容	建议学习时长
01-ClaudeCode快速上手.md	安装配置、基础命令、基本操作	30分钟
02-CLI交互技巧.md	命令行高效交互技巧	30分钟

核心功能篇

文档	内容	建议学习时长
03-MCP与工具调用.md	MCP 服务器在 CLI 中的使用	45分钟
04-SubAgent任务分发.md	Task 工具并行处理	40分钟
05-Hooks自动化.md	Hooks 配置、实战、CI/CD 集成	60分钟
06-Skills复用.md	技能创建与共享	35分钟

进阶篇

文档	内容	建议学习时长
07-代码分析与重构.md	批量编辑、智能分析	45分钟
08-ClaudeCode独有技巧.md	自然语言命令、Git 集成	35分钟
09-实战：PythonWebAPI开发.md	FastAPI 项目完整开发	90分钟

高级篇

文档	内容	建议学习时长
10-多模型配置指南.md	配置多个大模型、海外模型（Claude Opus）	30分钟
11-项目规划测试代码审查实战.md	软件工程全流程：规划、测试、代码审查	90分钟

推荐学习路线

初学者路线（总计约 3 小时）

01-ClaudeCode快速上手 → 02-CLI交互技巧 → 
08-ClaudeCode独有技巧 → 09-实战：PythonWebAPI开发

进阶开发者路线（总计约 5 小时）

01-ClaudeCode快速上手 → 02-CLI交互技巧 → 03-MCP与工具调用 →
04-SubAgent任务分发 → 05-Hooks自动化 → 06-Skills复用 →
07-代码分析与重构 → 09-实战：PythonWebAPI开发

实战项目简介

Python FastAPI Web API 开发

• 项目地址: github.com/example/fastapi-todo-api
• 技术栈: FastAPI + SQLAlchemy + Pydantic + pytest
• 展示功能:
  • 使用自然语言命令初始化项目
  • 使用 MCP Browser 测试 API 端点
  • 使用 Sub Agent 并行生成 CRUD 代码
  • 使用 Hooks 自动化测试和 Git 提交
  • 使用 Skills 标准化 API 开发流程

核心命令速查表 (Claude Code 2.1.81)

基础命令

命令	功能	示例
/help	显示帮助信息	/help
/status	查看当前状态	/status
/clear	清除对话历史	/clear
/compact	压缩历史	/compact [说明]
/exit	退出	/exit
/cost	查看 Token 消耗	/cost

模型与上下文管理

命令	功能	示例
/model [名称]	切换模型	/model opus
/context	查看记住的需求	/context
/rewind	回退上一步	/rewind
/forget	删除指定对话	/forget test code

项目与代码核心命令

命令	功能	示例
/init	初始化项目	/init
/memory	更新记忆文件	/memory 添加 Redis 缓存
/diff	查看代码差异	/diff
/review	代码审查	/review src/auth.py
/simplify	精简代码	/simplify src/utils.py
/test	生成并运行测试	/test src/models.py
/todo	生成待办清单	/todo 实现支付功能
/doctor	诊断项目问题	/doctor

辅助配置命令

命令	功能	示例
/btw [问题]	临时提问	/btw datetime 怎么转字符串
/break	暂停任务	/break
/config	配置设置	/config editor vscode
/vim	开启 Vim 模式	/vim

核心功能速查表

功能	使用方式	应用场景
文件操作	自然语言描述	“读取 src/main.py”
代码生成	直接描述需求	“创建一个 User 模型”
批量修改	描述修改范围	“将所有 print 改为 logging”
Git 操作	自然语言命令	“提交当前更改”
终端命令	直接输入	“运行 pytest”
Sub Agent	使用 Task 工具	“并行处理多个文件”

目录结构

Claude Code/
├── README.md                             # 本文件
├── CLAUDE.md                             # 项目配置指南
├── 01-ClaudeCode快速上手.md               # 基础入门 + 斜杠命令详解
├── 02-CLI交互技巧.md                      # CLI 交互
├── 03-MCP与工具调用.md                    # MCP 服务器
├── 04-SubAgent任务分发.md                 # 并行任务
├── 05-Hooks自动化.md                      # Hooks 配置、实战、CI/CD 集成
├── 06-Skills复用.md                       # 技能复用
├── 07-代码分析与重构.md                   # 代码重构
├── 08-ClaudeCode独有技巧.md               # 独有功能
├── 09-实战：PythonWebAPI开发.md           # 实战项目
├── 10-多模型配置指南.md                   # 多模型配置
└── 11-项目规划测试代码审查实战.md          # 软件工程全流程

与 Cursor 的区别

特性	Claude Code	Cursor
使用方式	命令行 CLI	图形界面编辑器
交互模式	自然语言为主	编辑器+AI 面板
文件编辑	批量文件操作	单文件+多文件(Composer)
Sub Agent	显式 Task 工具	隐式自动并行
MCP 使用	通过工具调用	配置面板设置
适用场景	大型重构、批量操作	日常编码、交互式开发

相关资源

• Claude Code 官方文档
• Anthropic 开发者文档
• Python FastAPI 文档