08-Claude Code 独有技巧
08-Claude Code 独有技巧
Claude Code CLI 有许多独特功能，包括自然语言 Git 操作、代码库问答、批量编辑等，掌握这些技巧能大幅提升效率。
一、自然语言 Git 操作
1.1 基础 Git 命令
# 使用自然语言执行 Git 操作>查看当前有哪些修改>显示最近的提交历史>创建一个新分支 feature/login>切换到 main 分支>合并 feature/login 分支1.2 智能提交
# 智能生成提交消息>提交当前更改 Claude 会：1. 查看gitdiff2. 分析修改内容3. 生成合适的提交消息4. 执行提交 示例输出： 检测到修改： - src/auth.py：添加用户登录功能 - tests/test_auth.py：添加登录测试 建议提交消息："feat: 实现用户登录功能"是否提交？(y/n)1.3 提交消息优化
# 优化提交历史>重写最近的3次提交，合并为一个# 交互式变基>交互式变基 main 分支，我需要修改历史提交1.4 代码审查集成
# 审查 PR>查看最近的 PR 有哪些文件修改>分析 PR#123 的代码质量>为 PR#123 生成审查意见二、代码库范围问答
2.1 全局代码理解
# 理解整个代码库>这个项目的主要功能是什么？ Claude 会： - 分析项目结构 - 阅读关键文件 - 理解业务逻辑 - 生成项目说明2.2 跨文件分析
# 跨文件查询>项目中哪里使用了 JWT 认证？>找出所有调用 payment API 的地方>搜索处理用户权限的代码2.3 架构分析
# 架构理解>分析项目的架构设计 Claude 输出： 架构分析： ├── 应用类型：Web API(FastAPI)├── 架构模式：分层架构 │ ├── 表现层：routers/ │ ├── 业务层：services/ │ ├── 数据层：models/, db/ │ └── 工具层：utils/ ├── 依赖注入：使用依赖注入容器 ├── 认证机制：JWT Token └── 数据持久化：PostgreSQL + SQLAlchemy三、批量文件编辑
3.1 批量修改模式
# 批量修改多个文件>将 src/ 下所有 Python 文件的 print 改为 logging Claude 执行：1. 查找所有包含 print 的文件2. 逐个文件修改3. 添加 logging 导入4. 统一应用修改3.2 条件批量修改
# 带条件的批量修改>在 src/services/ 下所有使用数据库的文件中， 添加连接池配置>为所有 API 路由函数添加性能监控装饰器3.3 批量生成
# 批量生成代码>为 src/models/ 下每个类生成对应的 CRUD 服务>为所有 Pydantic 模型生成单元测试四、高级上下文管理
4.1 对话压缩
# 压缩历史对话>/compact Claude 会总结之前的对话要点，节省上下文空间。 输出示例： 对话已压缩。要点总结： - 项目：FastAPI Web 应用 - 当前任务：添加用户认证 - 已完成：User 模型、登录 API - 下一步：JWT 集成4.2 上下文切换
# 清除上下文重新开始>/clear# 在对话中引用之前的上下文>基于刚才讨论的方案，实现具体的代码4.3 多轮对话追踪
# 追踪复杂任务的进度>显示当前任务的进度 Claude 输出： 当前任务进度： ✓1. 设计 User 模型 ✓2. 创建数据库表 ✓3. 实现注册 API ⏳4. 实现登录 API（进行中） - 需要生成 JWT - 需要验证密码 ⏸5. 实现权限控制（待开始）五、终端命令增强
5.1 自然语言命令
# 用自然语言执行复杂命令>找出项目中所有大于 1MB 的日志文件并删除>统计 src/ 目录下有多少行 Python 代码>列出最近一周修改过的文件5.2 命令解释
# 解释命令含义>解释这条命令的作用：find.-name"*.py"-execgrep-l"TODO"{}\;Claude 解释： 这个命令的作用是：1.find.- 从当前目录开始查找2.-name"*.py"- 查找所有 .py 文件3.-execgrep-l"TODO"{}\;- 在每个文件中搜索"TODO"4.-l参数只显示包含匹配内容的文件名 整体：找出所有包含"TODO"的 Python 文件5.3 命令建议
# 获取命令建议>我想备份数据库，应该用什么命令？ Claude 建议： 备份 PostgreSQL 数据库： pg_dump-hlocalhost-Uusername dbname>backup.sql 或创建压缩备份： pg_dump-hlocalhost-Uusername dbname|gzip>backup.sql.gz六、项目级配置
6.1 CLAUDE.md 配置
在项目根目录创建CLAUDE.md文件：
# CLAUDE.md ## 项目信息 - **名称**: FastAPI Todo API - **技术栈**: FastAPI + SQLAlchemy + PostgreSQL - **Python版本**: 3.9+ ## 开发规范 - 使用 Pydantic V2 - 使用 SQLAlchemy 2.0 语法 - 所有函数添加类型注解 - 使用 Google Style Docstrings ## 常用命令 ```bash # 运行开发服务器 uvicorn app.main:app --reload # 运行测试 pytest tests/ -v # 代码格式化 black src/ tests/项目结构
app/ ├── main.py # FastAPI 应用入口 ├── models/ # SQLAlchemy 模型 ├── schemas/ # Pydantic 模型 ├── routers/ # API 路由 └── services/ # 业务逻辑### 6.2 自动加载配置 ```bash # Claude Code 启动时自动读取 CLAUDE.md > 显示当前项目配置 Claude 输出： 从 CLAUDE.md 加载的配置： - 项目: FastAPI Todo API - Python: 3.9+ - 框架: FastAPI + SQLAlchemy6.3 个性化设置
// ~/.claude/settings.json{"preferences":{"editor":"cursor","auto_execute_commands":false,"confirm_destructive_operations":true,"default_python_version":"3.9"},"project_defaults":{"test_framework":"pytest","linter":"flake8","formatter":"black"}}七、智能辅助功能
7.1 错误诊断
# 自动诊断错误>测试失败了，帮我排查原因 Claude 会：1. 运行测试查看错误2. 分析错误信息3. 定位问题代码4. 提供修复建议7.2 代码补全建议
# 获取代码建议>基于 src/models/user.py 的 User 类， 我应该如何实现对应的 Service 层？ Claude 建议： 建议实现 UserService：1. create_user - 创建用户2. get_user - 获取用户3. update_user - 更新用户4. delete_user - 删除用户5. authenticate - 用户认证7.3 学习辅助
# 学习新技术>项目中使用了依赖注入，请解释这个模式>FastAPI 的 BackgroundTasks 是如何工作的？>SQLAlchemy 的 session 生命周期是什么？八、与 Cursor 协同
8.1 配合使用
# 在 Claude Code 中打开 Cursor>在 cursor 中打开 src/main.py# 编辑后返回>已保存，继续下一步8.2 工作流切换
| 场景 | 推荐工具 |
|---|---|
| 探索性开发 | Cursor |
| 批量重构 | Claude Code |
| 代码审查 | Claude Code |
| 快速修复 | Cursor |
| 架构设计 | Claude Code |
8.3 数据同步
# Skills 共享~/.cursor/skills/# 两个工具共用# 项目配置CLAUDE.md# Claude Code 读取.cursor/rules/# Cursor 读取九、效率技巧总结
9.1 常用快捷操作
# 快速导航>cdsrc/services>ls*.py>catmain.py|head-20# 快速编辑>编辑 src/config.py，将 DEBUG 改为 False>在 src/main.py 第45行添加日志9.2 高效工作流
# 完整开发流程示例>创建一个新功能模块 user/auth Claude 自动：1. 创建目录结构2. 生成模型代码3. 生成服务代码4. 生成 API 路由5. 生成测试代码6. 运行测试验证7. 提交代码到 Git9.3 调试流程
# 快速调试>运行测试，找出失败原因>修复失败的测试>再次运行测试验证>提交修复十、下一步学习
完成本指南后，进入实战阶段：
- 09-实战：PythonWebAPI开发.md - 综合运用所有技巧