Claude Code 日常使用

常见工作流

4 分钟阅读

常见工作流

使用 Claude Code 探索代码库、修复 bug、重构、测试及其他日常任务的逐步指南。

本页汇集了日常开发的快捷方案。如需更高层次的提示与上下文管理指导，请参阅最佳实践。

本页涵盖：

探索代码、修复 bug、重构、测试、PR 和文档的提示模板
恢复之前的对话，让任务可以跨多个时段进行
使用 worktree 运行并行会话，避免并发编辑冲突
编辑前制定计划，在修改落盘前审阅变更
将研究委托给子代理，保持主上下文整洁
将 Claude 接入脚本，用于 CI 和批处理

提示模板

这些是日常任务的提示模式，例如探索陌生代码、调试、重构、编写测试和创建 PR。每个模板适用于任何 Claude Code 界面；根据你的项目调整措辞。

理解新代码库

关于在 monorepo 或大型代码库中配置 Claude Code，请参阅Monorepos 和大型仓库。

快速了解代码库概况

假设你刚加入一个新项目，需要快速了解其结构。

导航到项目根目录

cd /path/to/project

启动 Claude Code

claude

请求高层概览

give me an overview of this codebase

深入特定组件

explain the main architecture patterns used here

what are the key data models?

how is authentication handled?

提示：

从宽泛的问题开始，然后逐步缩小到特定领域
询问项目中使用的编码约定和模式
请求项目专属术语的词汇表

查找相关代码

假设你需要定位与特定功能相关的代码。

让 Claude 查找相关文件

find the files that handle user authentication

获取组件交互的上下文

how do these authentication files work together?

理解执行流程

trace the login process from front-end to database

提示：

明确说明你正在寻找什么
使用项目中的领域语言
为你的语言安装代码智能插件，让 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

提示：

告诉 Claude 重现问题的命令，以获取堆栈跟踪
提及重现错误的任何步骤
让 Claude 知道错误是间歇性的还是持续性的

重构代码

假设你需要将旧代码更新为现代模式和实践。

识别需要重构的遗留代码

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

提示：

让 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

Claude 可以生成遵循你项目现有模式和约定的测试。在请求测试时，请明确说明你要验证的行为。Claude 会检查你现有的测试文件，以匹配已使用的风格、框架和断言模式。

对于全面覆盖，让 Claude 识别你可能遗漏的边界情况。Claude 可以分析你的代码路径，并建议针对错误条件、边界值和容易被忽视的意外输入的测试。

创建 Pull Request

你可以直接让 Claude 创建 PR（"create a pr for my changes"），或者逐步引导 Claude 完成：

总结你的变更

summarize the changes I've made to the authentication module

生成 Pull Request

create a pr

审阅并完善

enhance the PR description with more context about the security improvements

当你使用 gh pr create 创建 PR 时，会话会自动关联到该 PR。稍后要继续处理，运行 claude --from-pr 123（将 123 替换为 PR 编号），或将 PR URL 粘贴到 /resume 选择器中搜索。

在提交前审阅 Claude 生成的 PR，并让 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

提示：

指定你想要的文档风格（JSDoc、docstrings 等）
要求在文档中包含示例
为公共 API、接口和复杂逻辑请求文档

在笔记和非代码文件夹中工作

Claude Code 可在任何目录中运行。在笔记库、文档文件夹或任何 Markdown 文件集合中运行它，像处理代码一样搜索、编辑和重组内容。

.claude/ 目录和 CLAUDE.md 与其他工具的配置目录并存，不会冲突。Claude 在每次工具调用时都会重新读取文件，因此它会在下次读取该文件时看到你在其他应用程序中所做的编辑。

处理图像

假设你需要处理代码库中的图像，并希望 Claude 帮助分析图像内容。

将图像添加到对话中

你可以使用以下任一方法：

将图像拖放到 Claude Code 窗口中
复制图像并使用 ctrl+v 粘贴到 CLI 中（请勿使用 cmd+v）
向 Claude 提供图像路径。例如："Analyze this image: /path/to/your/image.png"

让 Claude 分析图像

What does this image show?

Describe the UI elements in this screenshot

Are there any problematic elements in this diagram?

使用图像作为上下文

Here's a screenshot of the error. What's causing it?

This is our current database schema. How should we modify it for the new feature?

从视觉内容获取代码建议

Generate CSS to match this design mockup

What HTML structure would recreate this component?

提示：

当文本描述不清楚或繁琐时，使用图像
包含错误截图、UI 设计或图表以获得更好的上下文
你可以在对话中处理多个图像
图像分析适用于图表、截图、模型等
当 Claude 引用图像时（例如 [Image #1]），Cmd+Click（Mac）或 Ctrl+Click（Windows/Linux）链接以在默认查看器中打开图像

引用文件和目录

使用 @ 快速包含文件或目录，无需等待 Claude 读取它们。

引用单个文件

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

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

引用目录

What's the structure of @src/components?

这会提供目录列表及文件信息。

引用 MCP 资源

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

这使用 @server:resource 格式从已连接的 MCP 服务器获取数据。详情请参阅 MCP 资源。

提示：

文件路径可以是相对路径或绝对路径
@ 文件引用会将文件所在目录及父目录中的 CLAUDE.md 添加到上下文
目录引用显示文件列表，而非内容
你可以在单条消息中引用多个文件（例如 "@file1.js and @file2.js"）

定时运行 Claude

假设你希望 Claude 定期自动处理任务，例如每天早上审阅开放的 PR、每周审计依赖项，或夜间检查 CI 失败。

根据你希望任务运行的位置选择调度选项：

选项	运行位置	最适用于
Routines	Anthropic 托管的基础设施	即使你的电脑关闭也应运行的任务。还可以响应 API 调用或 GitHub 事件，而不仅限于定时调度。在 claude.ai/code/routines 配置。
Desktop scheduled tasks	你的机器，通过桌面应用	需要直接访问本地文件、工具或未提交变更的任务。
GitHub Actions	你的 CI 流水线	与仓库事件关联的任务，如打开的 PR，或应与工作流配置共存的 cron 调度。
`/loop`	当前 CLI 会话	会话打开时的快速轮询。当你开始新对话时任务停止；`--resume` 和 `--continue` 恢复未过期的任务。

为定时任务编写提示时，明确说明成功的标准以及如何处理结果。任务自主运行，因此无法提出澄清问题。例如："Review open PRs labeled needs-review, leave inline comments on any issues, and post a summary in the #eng-reviews Slack channel."

询问 Claude 的能力

Claude 内置访问其文档的能力，可以回答关于自身功能和限制的问题。

示例问题

can Claude Code create pull requests?

how does Claude Code handle permissions?

what skills are available?

how do I use MCP with Claude Code?

how do I configure Claude Code for Amazon Bedrock?

what are the limitations of Claude Code?

Claude 基于文档提供这些问题的答案。如需实践演示，请运行 /powerup 获取带有动画演示的交互式课程，或参考上面的特定工作流章节。

提示：

无论你使用哪个版本，Claude 始终可以访问最新的 Claude Code 文档
提出具体问题以获得详细答案
Claude 可以解释复杂功能，如 MCP 集成、企业配置和高级工作流

恢复之前的对话

当任务跨越多个时段时，从你离开的地方继续，而无需重新解释上下文。Claude Code 在本地保存每次对话。

claude --continue

这会恢复当前目录中最新的会话；如果还没有会话，它会打印 No conversation found to continue 并退出。使用 claude --resume 从列表中选择，或在运行中的会话内使用 /resume。有关命名、分支和完整选择器参考，请参阅管理会话。

使用 worktree 运行并行会话

在一个终端中处理功能，同时在另一个终端中让 Claude 修复 bug，而编辑不会冲突。每个 worktree 都是一个独立分支上的单独检出。

claude --worktree feature-auth

在第二个终端中使用不同的名称运行相同的命令，即可启动隔离的并行会话。有关清理、.worktreeinclude 和非 git VCS 支持，请参阅 Worktrees。要在一个屏幕中监控并行会话，而不是在单独的终端中，请参阅后台代理。

编辑前制定计划

对于希望在落盘前审阅的变更，切换到计划模式。Claude 读取文件并提出计划，但在你批准之前不做任何编辑。

claude --permission-mode plan

你也可以在会话中按 Shift+Tab 切换到计划模式。有关审批流程和在文本编辑器中编辑计划，请参阅计划模式。

将研究委托给子代理

探索大型代码库会用文件读取填满你的上下文。将探索委托出去，这样只有结果会返回。

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

子代理在自己的上下文窗口中读取文件并报告摘要。有关定义具有自定义工具和提示的代理，请参阅子代理。

将 Claude 接入脚本

以非交互方式运行 Claude，用于 CI、pre-commit 钩子或批处理。Stdin 和 stdout 像任何 Unix 工具一样工作。

git log --oneline -20 | claude -p "summarize these recent commits"

有关输出格式、权限标志和扇出模式，请参阅非交互模式。

下一步

最佳实践

充分发挥 Claude Code 潜力的模式

管理会话

恢复、命名和分支对话

Worktrees

运行隔离的并行会话

扩展 Claude Code

添加技能、钩子、MCP、子代理和插件