7. 常见工作流

本节目标：掌握 Claude Code 在日常开发中的典型用法模式，知道每种任务该怎么提问、怎么引导 Claude 高效完成。

探索代码库

刚接手一个新项目，最快的方式是让 Claude 帮你建立全局认知。

快速获取概览

give me an overview of this codebase

Claude 会扫描项目结构，给你一个摘要：用了什么技术栈、目录怎么组织的、主要模块负责什么。

深入了解特定组件

有了全局印象后，逐步缩小范围：

explain the main architecture patterns used here

what are the key data models?

how is authentication handled?

查找相关代码

当你需要定位某个功能的代码：

find the files that handle user authentication

how do these authentication files work together?

trace the login process from front-end to database

Tip

从宽泛的问题开始，然后缩小到特定领域。用项目中的领域语言提问，Claude 匹配得更准。

写新功能

让 Claude 实现一个新功能，关键是把需求描述清楚。

基本流程

# 第一步：让 Claude 了解现状
分析一下现有的用户注册流程

# 第二步：描述你要什么
向用户注册表单添加输入验证

# 第三步：更具体的要求
确保邮箱格式校验、密码至少 8 位、两次密码一致

Claude 会定位相关代码、理解上下文、实现解决方案，如果有测试还会跑一下。

分步说明复杂任务

复杂功能拆成步骤，效果比一次性丢一个大需求好：

1. 为用户配置文件创建新的数据库表
2. 创建 API 端点以获取和更新用户配置文件
3. 构建允许用户查看和编辑其信息的网页

Note

描述越具体，Claude 改得越安全。不要说”修复错误”，要说”修复登录错误，用户输入错误凭证后看到空白屏幕”。

修 Bug

Claude 在调试方面很擅长。关键是把错误信息给它。

分享错误

I'm seeing an error when I run npm test

把终端报错贴给它，或者让它自己跑命令看报错。

请求修复

suggest a few ways to fix the @ts-ignore in user.ts

有一个错误，用户可以提交空表单 - 修复它

应用修复

update user.ts to add the null check you suggested

Tip

告诉 Claude 重现问题的命令，提及错误是间歇性还是持续的。这些信息能帮它更快定位根因。

写测试

Claude 可以生成遵循你项目现有模式的测试。

识别未测试的代码

find functions in NotificationsService.swift that are not covered by tests

生成测试

add tests for the notification service

添加边界用例

add test cases for edge conditions in the notification service

运行验证

run the new tests and fix any failures

Note

Claude 会检查你现有的测试文件，匹配已在使用的样式、框架和断言模式。你不用告诉它用 Jest 还是 Mocha，它自己会找。

创建 Pull Request

你可以直接让 Claude 创建 PR，也可以逐步指导。

一步到位

create a pr for my changes

逐步来

# 先总结改了什么
summarize the changes I've made to the authentication module

# 再创建 PR
create a pr

# 细化描述
enhance the PR description with more context about the security improvements

Warning

提交前一定要审查 Claude 生成的 PR。让 Claude 突出显示潜在的风险或注意事项。

从 PR 恢复会话

当你用 gh pr create 创建 PR 时，会话会自动链接到该 PR。之后可以用以下命令回到这个会话：

claude --from-pr 123

重构代码

让旧代码用上现代模式。

# 识别需要重构的代码
find deprecated API usage in our codebase

# 获取建议
suggest how to refactor utils.js to use modern JavaScript features

# 安全地应用
refactor utils.js to use ES2024 features while maintaining the same behavior

# 验证
run tests for the refactored code

Tip

要求 Claude 解释现代方法的优势。需要时请求保持向后兼容性。以小的、可测试的增量进行重构。

处理文档

# 找到缺少文档的代码
find functions without proper JSDoc comments in the auth module

# 生成文档
add JSDoc comments to the undocumented functions in auth.js

# 增强文档
improve the generated documentation with more context and examples

# 验证
check if the documentation follows our project standards

引用文件和目录

用 @ 符号可以快速把文件内容加入对话，不用等 Claude 慢慢去找。

引用单个文件

Explain the logic in @src/utils/auth.js

这会在对话中包含文件的完整内容。

引用目录

What's the structure of @src/components?

这会给出目录下的文件列表（不是内容）。

引用多个文件

对比 @file1.js 和 @file2.js 的实现差异

引用 MCP 资源

Show me the data from @github:repos/owner/repo/issues

Note

@ 文件引用还会把该文件所在目录和父目录的 CLAUDE.md 加入上下文。路径可以是相对的或绝对的。

使用图像

Claude Code 支持图像输入，对 UI 调试、截图分析很实用。

添加图像的方式

拖放：把图像拖到 Claude Code 窗口
粘贴：复制图像后按 Ctrl+V（macOS 上 iTerm2 用 Cmd+V）
路径引用：Analyze this image: /path/to/image.png

分析图像

What does this image show?

Describe the UI elements in this screenshot

# 用截图获取上下文
Here's a screenshot of the error. What's causing it?

# 用设计稿生成代码
Generate CSS to match this design mockup

恢复和继续对话

任务跨多个会话时，不用从头解释。

# 继续当前目录最近的对话
claude --continue

# 从列表中选择
claude --resume

# 在运行中的会话里
/resume

并行会话

用 worktree 可以同时在多个分支上工作，互不干扰：

# 在终端 A
claude --worktree feature-auth

# 在终端 B
claude --worktree fix-bug-123

每个 worktree 是自己分支上的独立检出，编辑不会冲突。

Tip

要从一个屏幕监视多个并行会话，参考后台代理（Agent View）功能。

编辑前先规划

对于想先审查再落盘的改动，用 Plan 模式：

claude --permission-mode plan

或者在会话中按 Shift+Tab 切换到 Plan 模式。Claude 会读文件、提计划，但不做任何编辑，直到你批准。

委派研究给子代理

探索大型代码库会消耗大量上下文。用子代理（Subagent）去做探索，只把发现结果带回来：

use a subagent to investigate how our auth system handles token refresh

子代理在自己的上下文窗口里读文件，返回摘要。你的主对话保持干净。

Note

子代理有完整工具但从空上下文开始；/btw 看到完整对话但没有工具。两者互补。

管道和批处理

Claude Code 可以像 Unix 工具一样使用 stdin/stdout：

# 分析最近的提交
git log --oneline -20 | claude -p "summarize these recent commits"

# 在 CI 里检查代码
claude -p "review this pull request for security issues" < diff.txt

Tip

非交互模式（-p 标志）适合 CI、预提交钩子或批处理。输出是纯文本，方便脚本解析。

按计划运行

想让 Claude 定期处理任务？有几种调度方式：

方式	运行位置	适合场景
Routines	Anthropic 云端	计算机关机也要跑的任务
桌面计划任务	你的机器	需要本地文件访问的任务
GitHub Actions	CI 管道	与仓库事件相关的任务
`/loop`	当前会话	会话内的快速轮询

询问 Claude 自身能力

Claude 内置访问自己的文档，可以回答关于自身功能的问题：

can Claude Code create pull requests?

how does Claude Code handle permissions?

how do I configure Claude Code for Amazon Bedrock?

Note

Claude 始终能访问最新的 Claude Code 文档，不管你用的什么版本。问得越具体，答得越详细。

提示技巧总结

几个让 Claude 发挥更好的通用技巧：

要具体：不说”修复错误”，说”修复登录错误，用户输入错误凭证后看到空白屏幕”。

先探索再动手：让 Claude 先理解代码再改。分析数据库架构 比直接说 改数据库 效果好。

使用快捷方式：/ 看所有命令和技能，Tab 补全，Up 看历史，Shift+Tab 切换权限模式。

像跟同事说话一样：描述你想实现的目标，而不是一步步的指令。Claude 会自己找路。

小结

这一章覆盖了日常开发中最常见的工作流模式。核心思路是：像与有帮助的同事交谈一样与 Claude 交谈。描述目标，给上下文，让 Claude 帮你实现。下一章我们看看斜杠命令的完整参考。