Claude Code 常见操作实战指南

1. 代码重构操作

场景 1.1：重命名函数

**任务：**将 getUserData 重命名为 fetchUserProfile

操作步骤：

步骤 1：搜索所有使用该函数的地方

告诉 Claude Code：

复制代码

"请搜索代码库中所有使用 getUserData 的地方"

Claude Code 会执行：

使用 Grep 工具搜索 "getUserData"
显示所有包含该函数的文件

步骤 2：查看具体使用情况

告诉 Claude Code：

复制代码

"显示这些文件中 getUserData 的具体使用代码"

Claude Code 会：

使用 Grep 的 content 模式显示匹配行
带上下文显示（-A, -B 参数）

步骤 3：执行重命名

告诉 Claude Code：

复制代码

"将所有文件中的 getUserData 重命名为 fetchUserProfile"

Claude Code 会：

逐个文件使用 Edit 工具
使用 replace_all=true 替换所有出现
保持代码格式不变

完整示例对话：

复制代码

用户: "我想把 getUserData 函数重命名为 fetchUserProfile"

Claude Code:
1. 搜索代码库找到 5 个文件使用了该函数
2. 显示使用情况供确认
3. 逐个文件进行重命名
4. 报告完成情况

场景 1.2：提取重复代码为函数

**任务：**发现多处重复的日期格式化代码，提取为公共函数

操作步骤：

步骤 1：识别重复代码

告诉 Claude Code：

复制代码

"搜索代码中所有日期格式化的代码模式"

步骤 2：创建公共函数

告诉 Claude Code：

复制代码

"在 utils/date.js 中创建一个 formatDate 函数"

Claude Code 会：

使用 Write 工具创建新文件（如果不存在）
或使用 Edit 工具添加到现有文件

步骤 3：替换重复代码

告诉 Claude Code：

复制代码

"将所有重复的日期格式化代码替换为对 formatDate 的调用"

Claude Code 会：

在每个文件顶部添加 import
使用 Edit 工具替换重复代码
保持功能一致性

场景 1.3：修改函数签名

**任务：**给函数添加新参��

原函数：

javascript 复制代码

function sendEmail(to, subject, body) {
  // ...
}

目标：

javascript 复制代码

function sendEmail(to, subject, body, options = {}) {
  // ...
}

操作步骤：

告诉 Claude Code：

复制代码

"给 sendEmail 函数添加一个可选的 options 参数，
并更新所有调用该函数的地方"

Claude Code 会：

使用 Grep 找到函数定义
使用 Grep 找到所有调用
使用 Edit 修改函数定义
评估是否需要修改调用处（可选参数通常不需要）

2. Bug 修复操作

场景 2.1：修复特定错误

**任务：**修复 "Cannot read property 'name' of undefined" 错误

操作步骤：

步骤 1：定位错误位置

告诉 Claude Code：

复制代码

"在代码中搜索可能导致 'Cannot read property name of undefined' 的地方"

或提供错误堆栈：

复制代码

"这是错误堆栈：
Error: Cannot read property 'name' of undefined
  at UserProfile.render (UserProfile.js:45)

请帮我修复"

步骤 2：分析和修复

Claude Code 会：

使用 Read 读取相关文件
分析代码逻辑
使用 Edit 添加空值检查
解释修复原因

示例修复：

javascript 复制代码

// 修复前
function render() {
  return <div>{user.name}</div>
}

// 修复后
function render() {
  return <div>{user?.name || 'Guest'}</div>
}

场景 2.2：修复测试失败

**任务：**运行测试发现失败，需要修复

操作步骤：

步骤 1：运行测试

告诉 Claude Code：

复制代码

"运行测试套件"

Claude Code 会：

使用 Bash 执行 npm test 或 pytest
显示测试结果

步骤 2：分析失败原因

告诉 Claude Code：

复制代码

"分析测试失败的原因并修复"

Claude Code 会：

读取失败的测试文件
读取被测试的代码
识别问题
修复代码或测试

步骤 3：验证修复

Claude Code 会：

再次运行测试
确认通过

3. 新功能开发

场景 3.1：添加新的 API 端点

**任务：**添加一个获取用户统计信息的 API 端点

操作步骤：

步骤 1：探索现有结构

告诉 Claude Code：

复制代码

"我想添加一个新的 API 端点来获取用户统计信息。
先帮我了解一下现有的 API 端点是如何组织的。"

Claude Code 会：

使用 Glob 查找路由文件
使用 Read 读取示例端点
总结项目结构和模式

步骤 2：实现端点

告诉 Claude Code：

复制代码

"按照现有模式，创建一个 GET /api/users/:id/stats 端点"

Claude Code 会：

在路由文件中添加新路由
创建控制器函数
实现业务逻辑
遵循项目的代码风格

步骤 3：测试

告诉 Claude Code：

复制代码

"帮我测试这个新端点"

Claude Code 会：

使用 Bash 执行 curl 命令
或启动开发服务器
验证响应

场景 3.2：添加表单验证

**任务：**为注册表单添加验证逻辑

操作步骤：

告诉 Claude Code：

复制代码

"为注册表单添加以下验证：
- 邮箱格式验证
- 密码长度至少 8 位
- 密码必须包含数字和字母
- 用户名不能包含特殊字符"

Claude Code 会：

找到表单组件
添加验证函数
集成到表单提交流程
添加错误提示显示

场景 3.3：实现暗黑模式

**任务：**为应用添加暗黑模式切换功能

操作步骤：

步骤 1：规划实现

告诉 Claude Code：

复制代码

"我想为应用添加暗黑模式功能，请先制定一个实现计划"

Claude Code 会：

进入计划模式（如果是复杂任务）
探索现有的样式系统
提出实现方案
等待用户批准

步骤 2：实现

批准计划后，Claude Code 会：

创建主题上下文/状态管理
定义暗黑模式样式变量
创建主题切换组件
更新现有组件支持主题
添加本地存储持久化

4. Git 操作

场景 4.1：创建提交

**任务：**提交当前的代码更改

操作步骤：

告诉 Claude Code：

复制代码

"请帮我提交当前的更改"

Claude Code 会自动：

运行 git status 查看更改
运行 git diff 查看具体变更
查看 git log 学习提交风格
生成有意义的提交信息
添加文件并创建提交
运行 git status 验证

提交信息格式：

复制代码

简洁的提交标题

详细描述（如需要）

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

场景 4.2：创建 Pull Request

**任务：**为当前分支创建 PR

操作步骤：

告诉 Claude Code：

复制代码

"请为当前分支创建一个 Pull Request"

Claude Code 会：

分析分支的所有提交
生成 PR 描述（包括 Summary 和 Test plan）
推送到远程（如需要）
使用 gh pr create 创建 PR
返回 PR URL

PR 描述格式：

markdown 复制代码

## Summary
- 主要变更点 1
- 主要变更点 2
- 主要变更点 3

## Test plan
- [ ] 测试项 1
- [ ] 测试项 2
- [ ] 测试项 3

🤖 Generated with [Claude Code](https://claude.com/claude-code)

场景 4.3：查看和切换分支

操作示例：

复制代码

"显示所有分支"
→ Claude Code 执行: git branch -a

"切换到 develop 分支"
→ Claude Code 执行: git checkout develop

"创建新分支 feature/user-auth"
→ Claude Code 执行: git checkout -b feature/user-auth

"查看当前分支的提交历史"
→ Claude Code 执行: git log --oneline -10

5. 项目设置和配置

场景 5.1：初始化新项目

**任务：**创建一个新的 React 项目

操作步骤：

告诉 Claude Code：

复制代码

"帮我创建一个新的 React 项目，使用 Vite"

Claude Code 会：

执行 npm create vite@latest my-app -- --template react
进入项目目录
安装依赖 npm install
可选：初始化 git 仓库
可选：创建初始提交

场景 5.2：添加依赖包

操作示例：

复制代码

"安装 axios 和 react-router-dom"
→ Claude Code 执行: npm install axios react-router-dom

"安装 jest 作为开发依赖"
→ Claude Code 执行: npm install --save-dev jest

"全局安装 typescript"
→ Claude Code 执行: npm install -g typescript

场景 5.3：配置 ESLint

**任务：**为项目添加 ESLint 配置

操作步骤：

告诉 Claude Code：

复制代码

"帮我配置 ESLint，使用 Airbnb 风格指南"

Claude Code 会：

安装必要的包
创建 .eslintrc.json 配置文件
添加 npm scripts
可选：运行 lint 检查现有代码

6. 调试和问题诊断

场景 6.1：分析错误日志

**任务：**应用崩溃，需要分析日志

操作步骤：

告诉 Claude Code：

复制代码

"应用崩溃了，日志在 logs/error.log，帮我分析一下"

Claude Code 会：

使用 Read 读取日志文件
识别错误模式
定位相关代码
提出修复建议

场景 6.2：性能分析

**任务：**应用运行缓慢，需要优化

操作步骤：

告诉 Claude Code：

复制代码

"应用的用户列表页面加载很慢，帮我找出原因并优化"

Claude Code 会：

读取相关组件代码
识别性能问题（如不必要的重渲染、大数据集处理等）
提出优化方案（如 memo, useMemo, 虚拟滚动等）
实现优化

场景 6.3：依赖冲突解决

**任务：**npm install 失败，依赖冲突

操作步骤：

告诉 Claude Code：

复制代码

"npm install 失败了，提示依赖冲突，帮我解决"

Claude Code 会：

读取 package.json
分析错误信息
提出解决方案（更新版本、使用 --legacy-peer-deps 等）
执行修复

7. 文档和注释

场景 7.1：生成函数文档

**任务：**为函数添加 JSDoc 注释

操作步骤：

告诉 Claude Code：

复制代码

"为 src/utils/api.js 中的所有函数添加 JSDoc 注释"

Claude Code 会：

读取文件
分析每个函数
生成详细的 JSDoc 注释
使用 Edit 添加注释

示例输出：

javascript 复制代码

/**
 * 获取用户信息
 * @param {string} userId - 用户 ID
 * @param {Object} options - 可选配置
 * @param {boolean} options.includeProfile - 是否包含详细资料
 * @returns {Promise<User>} 用户对象
 * @throws {Error} 当用户不存在时抛出错误
 */
async function getUserInfo(userId, options = {}) {
  // ...
}

场景 7.2：生成 README

**任务：**为项目创建 README 文档

操作步骤：

告诉 Claude Code：

复制代码

"帮我创建一个 README.md 文件，包含项目介绍、安装步骤和使用说明"

Claude Code 会：

分析项目结构
读取 package.json 了解依赖
生成完整的 README
包含安装、使用、API 文档等部分

8. 测试相关操作

场景 8.1：运行测试

操作示例：

复制代码

"运行所有测试"
→ Claude Code 执行: npm test

"只运行用户相关的测试"
→ Claude Code 执行: npm test -- user

"运行测试并生成覆盖率报告"
→ Claude Code 执行: npm test -- --coverage

"以监听模式运行测试"
→ Claude Code 执行: npm test -- --watch

场景 8.2：编写单元测试

**任务：**为函数编写测试

操作步骤：

告诉 Claude Code：

复制代码

"为 src/utils/validation.js 中的 validateEmail 函数编写单元测试"

Claude Code 会：

读取函数代码
创建测试文件
编写多个测试用例（正常情况、边界情况、错误情况）
运行测试验证

9. 代码审查和质量

场景 9.1：代码审查

**任务：**审查最近的代码更改

操作步骤：

告诉 Claude Code：

复制代码

"审查我最近的代码更改，给出改进建议"

Claude Code 会：

使用 git diff 查看更改
分析代码质量
检查：
- 代码风格
- 潜在 bug
- 性能问题
- 安全问题
- 最佳实践
提供具体的改进建议

场景 9.2：代码格式化

操作示例：

复制代码

"运行 Prettier 格式化所有代码"
→ Claude Code 执行: npx prettier --write .

"检查代码格式"
→ Claude Code 执行: npx prettier --check .

"格式化特定文件"
→ Claude Code 执行: npx prettier --write src/App.js

10. 高级操作

场景 10.1：批量文件操作

**任务：**更新所有组件的 import 路径

操作步骤：

告诉 Claude Code：

复制代码

"将所有文件中的 '../components' 改为 '@/components'"

Claude Code 会：

使用 Grep 找到所有匹配的文件
逐个使用 Edit 工具修改
报告修改的文件数量

场景 10.2：代码库迁移

**任务：**从 JavaScript 迁移到 TypeScript

操作步骤：

告诉 Claude Code：

复制代码

"帮我将项目从 JavaScript 迁移到 TypeScript，
从 src/utils 目录开始"

Claude Code 会：

安装 TypeScript 依赖
创建 tsconfig.json
逐个文件转换：
- 重命名 .js 为 .ts
- 添加类型注解
- 修复类型错误
更新构建配置

场景 10.3：使用代理探索大型代码库

**任务：**理解一个不熟悉的大型项目

操作步骤：

告诉 Claude Code：

复制代码

"这是一个大型 React 项目，帮我理解它的架构，
特别是路由、状态管理和 API 调用是如何组织的"

Claude Code 会：

启动 Explore 代理
系统性地探索代码库
识别关键文件和模式
生成架构总结
绘制组件关系图（文字描述）

实用技巧

技巧 1：清晰的指令

好的指令：

复制代码

"在 src/components/Button.js 中，
将 onClick 处理函数改为异步函数，
并添加 loading 状态"

不好的指令：

复制代码

"改一下按钮"

技巧 2：提供上下文

好的指令：

复制代码

"我在实现用户认证功能。
现在需要在登录成功后将 token 保存到 localStorage，
并重定向到 dashboard 页面"

不好的指令：

复制代码

"保存 token"

技巧 3：分步骤处理复杂任务

好的方式：

复制代码

1. "先帮我搜索现有的认证相关代码"
2. （查看结果后）"好的，现在在 auth.js 中添加 token 保存逻辑"
3. "现在更新登录组件调用这个新函数"

不好的方式：

复制代码

"实现完整的认证系统"（太宽泛）

技巧 4：利用并行执行

好的指令：

复制代码

"同时做这些事：
1. 运行测试
2. 检查 git 状态
3. 查看最近的提交"

Claude Code 会并行执行这些独立操作。

技巧 5：验证更改

好的习惯：

复制代码

"修改完成后，运行测试确保没有破坏现有功能"

常见问题解决

问题 1：找不到文件

**症状：**Claude Code 说找不到某个文件

解决：

复制代码

"使用 glob 模式搜索：**/*filename*"
或
"列出 src 目录的所有文件"

问题 2：修改没有生效

**症状：**Edit 操作失败

原因：

old_string 不唯一
缩进不匹配
包含了行号

解决：

复制代码

"请先显示该文件的相关部分，
然后我确认后再修改"

问题 3：命令执行超时

**症状：**长时间运行的命令被中断

解决：

复制代码

"运行这个命令，设置 10 分钟超时"
或
"在后台运行这个命令"

总结

Claude Code 的强大之处在于：

理解意图：能理解自然语言指令
自动化：自动选择合适的工具和步骤
安全性：多重检查防止危险操作
效率：并行执行独立操作
上下文感知：考虑项目结构和代码风格

最佳实践：

清晰表达需求
提供足够上下文
复杂任务分步骤
验证重要更改
利用 Claude Code 的探索能力

通过这些常见操作和技巧，你可以充分发挥 Claude Code 的能力，提高开发效率！