本页涵盖日常开发的实用工作流程：探索陌生代码、调试、重构、编写测试、创建 PR 和管理会话。每个部分都包含示例提示，您可以根据自己的项目进行调整。有关更高级的模式和提示，请参阅最佳实践 。
理解新的代码库 快速获取代码库概览 假设您刚加入一个新项目，需要快速了解其结构。
请求高级概览
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 能够精确地进行”转到定义”和”查找引用”导航
高效修复错误 假设您遇到了错误消息，需要找到并修复其来源。
与 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 解释现代方法的优势
在需要时请求更改保持向后兼容性
以小的、可测试的增量进行重构
使用专门的 subagents 假设您想使用专门的 AI subagents 来更有效地处理特定任务。
查看可用的 subagents
这显示所有可用的 subagents 并让您创建新的。
自动使用 subagents
Claude Code 自动将适当的任务委派给专门的 subagents： review my recent code changes for security issues
run all tests and fix any failures
明确请求特定的 subagents
use the code-reviewer subagent to check the auth module
have the debugger subagent investigate why users can't log in
为您的工作流程创建自定义 subagents
然后选择”Create New subagent”并按照提示定义：
描述 subagent 目的的唯一标识符（例如，code-reviewer、api-designer）。
Claude 何时应该使用此代理
它可以访问哪些工具
描述代理角色和行为的系统提示
提示：
在 .claude/agents/ 中创建项目特定的 subagents 以供团队共享
使用描述性的 description 字段来启用自动委派
限制工具访问权限为每个 subagent 实际需要的内容
查看subagents 文档 了解详细示例
使用 Plan Mode 进行安全的代码分析 Plan Mode 指示 Claude 通过使用只读操作分析代码库来创建计划，非常适合探索代码库、规划复杂更改或安全地审查代码。在 Plan Mode 中，Claude 使用 AskUserQuestion
何时使用 Plan Mode
多步骤实现 ：当您的功能需要对许多文件进行编辑时代码探索 ：当您想在更改任何内容之前彻底研究代码库时交互式开发 ：当您想与 Claude 迭代方向时
如何使用 Plan Mode 在会话期间打开 Plan Mode 您可以在会话期间使用 Shift+Tab 循环切换权限模式来切换到 Plan Mode。
如果您处于 Normal Mode，Shift+Tab 首先切换到 Auto-Accept Mode，在终端底部显示 ⏵⏵ accept edits on。随后的 Shift+Tab 将切换到 Plan Mode，显示 ⏸ plan mode on。
在 Plan Mode 中启动新会话 要在 Plan Mode 中启动新会话，请使用 --permission-mode plan 标志：
claude --permission-mode plan
在 Plan Mode 中运行”无头”查询 您也可以使用 -p 直接在 Plan Mode 中运行查询（即在”无头模式” 中）：
claude --permission-mode plan -p "Analyze the authentication system and suggest improvements"
示例：规划复杂的重构 claude --permission-mode plan
I need to refactor our authentication system to use OAuth2. Create a detailed migration plan.
Claude 分析当前实现并创建全面的计划。通过后续问题进行细化：
What about backward compatibility?
How should we handle database migration?
按 Ctrl+G 在默认文本编辑器中打开计划，您可以在 Claude 继续之前直接编辑它。
当您接受计划时，Claude 会自动从计划内容为会话命名。该名称显示在提示栏和会话选择器中。如果您已经使用 --name 或 /rename 设置了名称，接受计划不会覆盖它。
将 Plan Mode 配置为默认值 // .claude/settings.json { "permissions" : { "defaultMode" : "plan" } }
有关更多配置选项，请参阅设置文档 。
使用测试 假设您需要为未覆盖的代码添加测试。
识别未测试的代码
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 可以分析您的代码路径并建议测试错误条件、边界值和容易被忽视的意外输入。
创建拉取请求 您可以通过直接要求 Claude 创建拉取请求（“create a pr for my changes”），或逐步指导 Claude：
总结您的更改
summarize the changes I've made to the authentication module
审查和细化
enhance the PR description with more context about the security improvements
当您使用 gh pr create 创建 PR 时，会话会自动链接到该 PR。您可以稍后使用 claude --from-pr <number> 恢复它。
在提交前审查 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 帮助分析图像内容。
将图像添加到对话中
您可以使用以下任何方法：
将图像拖放到 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”）
使用扩展思考（Thinking Mode） 扩展思考 默认启用，为 Claude 提供空间在响应前逐步推理复杂问题。此推理在详细模式中可见，您可以使用 Ctrl+O 切换。此外，Opus 4.6 和 Sonnet 4.6 支持自适应推理：不是固定的思考令牌预算，而是模型根据您的努力级别 设置动态分配思考。扩展思考和自适应推理一起工作，让您能够控制 Claude 在响应前的推理深度。
扩展思考对于复杂的架构决策、具有挑战性的错误、多步骤实现规划和评估不同方法之间的权衡特别有价值。
“think”、“think hard” 和 “think more” 等短语被解释为常规提示指令，不分配思考令牌。
配置 Thinking Mode 思考默认启用，但您可以调整或禁用它。
范围 如何配置 详细信息 努力级别 运行 /effort，在 /model 中调整，或设置 CLAUDE_CODE_EFFORT_LEVEL 控制 Opus 4.6 和 Sonnet 4.6 的思考深度。请参阅调整努力级别 ultrathink 关键字在提示中的任何地方包含 “ultrathink” 在 Opus 4.6 和 Sonnet 4.6 上为该轮设置努力为高。对于需要深度推理的一次性任务很有用，无需永久更改您的努力设置 切换快捷键 按 Option+T（macOS）或 Alt+T（Windows/Linux） 为当前会话切换思考开/关（所有模型）。可能需要终端配置 来启用 Option 键快捷键 全局默认值 使用 /config 切换 Thinking Mode 在所有项目中设置默认值（所有模型）。~/.claude/settings.json 中的 alwaysThinkingEnabled 限制令牌预算 设置 MAX_THINKING_TOKENS 将思考预算限制为特定数量的令牌。在 Opus 4.6 和 Sonnet 4.6 上，仅当设置为 0 时才适用，除非禁用自适应推理。示例：export MAX_THINKING_TOKENS=10000
要查看 Claude 的思考过程，按 Ctrl+O 切换详细模式，并查看显示为灰色斜体文本的内部推理。
扩展思考如何工作 扩展思考控制 Claude 在响应前执行多少内部推理。更多思考提供更多空间来探索解决方案、分析边界情况和自我纠正错误。
使用 Opus 4.6 和 Sonnet 4.6 ，思考使用自适应推理：模型根据您选择的努力级别 动态分配思考令牌。这是调整速度和推理深度之间权衡的推荐方式。使用较旧的模型 ，思考使用从您的输出分配中提取的固定令牌预算。预算因模型而异；有关详细信息，请参阅 MAX_THINKING_TOKENS/config 或 Option+T/Alt+T 切换完全禁用思考。在 Opus 4.6 和 Sonnet 4.6 上，自适应推理 控制思考深度，因此 MAX_THINKING_TOKENS 仅在设置为 0 以禁用思考时适用，或当 CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING=1 将这些模型恢复为固定预算时。请参阅环境变量 。
您需要为所有使用的思考令牌付费，即使思考摘要被编辑。在交互模式中，思考默认显示为折叠的存根。在 settings.json 中设置 showThinkingSummaries: true 以显示完整摘要。
恢复以前的对话 启动 Claude Code 时，您可以恢复以前的会话：
claude --continue 继续当前目录中最近的对话claude --resume 打开对话选择器或按名称恢复claude --from-pr 123 恢复链接到特定拉取请求的会话
从活跃会话内，使用 /resume 切换到不同的对话。
会话按项目目录存储。/resume 选择器显示来自同一 git 存储库的会话，包括 worktrees。由 claude -p 或 SDK 调用创建的会话不会出现在选择器中，但您仍然可以通过将其会话 ID 直接传递给 claude --resume <session-id> 来恢复它。
命名您的会话 给会话起描述性名称以便稍后找到它们。这是在处理多个任务或功能时的最佳实践。
命名会话
在启动时使用 -n 命名会话： 或在会话期间使用 /rename，这也会在提示栏上显示名称： 您也可以从选择器重命名任何会话：运行 /resume，导航到会话，然后按 R。
稍后按名称恢复
从命令行： claude --resume auth-refactor
或从活跃会话内： 使用会话选择器 /resume 命令（或 claude --resume 不带参数）打开具有以下功能的交互式会话选择器：选择器中的键盘快捷键： 快捷键 操作 ↑ / ↓在会话之间导航 → / ←展开或折叠分组的会话 Enter选择并恢复突出显示的会话 P预览会话内容 R重命名突出显示的会话 /搜索以过滤会话 A在当前目录和所有项目之间切换 B过滤到来自当前 git 分支的会话 Esc退出选择器或搜索模式
会话组织： 选择器显示带有有用元数据的会话：
会话名称或初始提示
自上次活动以来经过的时间
消息计数
Git 分支（如果适用）
分叉的会话（使用 /branch、/rewind 或 --fork-session 创建）在其根会话下分组，使查找相关对话更容易。
提示：
尽早命名会话 ：在开始处理不同任务时使用 /rename——稍后找到”payment-integration”比”explain this function”容易得多使用 --continue 快速访问当前目录中最近的对话
当您知道需要哪个会话时使用 --resume session-name
当您需要浏览和选择时使用 --resume（不带名称）
对于脚本，使用 claude --continue --print "prompt" 以非交互模式恢复
在选择器中按 P 在恢复前预览会话
恢复的对话以与原始对话相同的模型和配置开始
工作原理：
对话存储 ：所有对话都自动保存在本地，包含完整的消息历史消息反序列化 ：恢复时，整个消息历史被恢复以保持上下文工具状态 ：来自以前对话的工具使用和结果被保留上下文恢复 ：对话以所有以前的上下文完整恢复 使用 Git worktrees 运行并行 Claude Code 会话 当同时处理多个任务时，您需要每个 Claude 会话都有自己的代码库副本，以便更改不会冲突。Git worktrees 通过创建单独的工作目录来解决这个问题，每个目录都有自己的文件和分支，同时共享相同的存储库历史和远程连接。这意味着您可以让 Claude 在一个 worktree 中处理功能，同时在另一个 worktree 中修复错误，而不会相互干扰。
使用 --worktree（-w）标志创建隔离的 worktree 并在其中启动 Claude。您传递的值成为 worktree 目录名称和分支名称：
# 在名为 "feature-auth" 的 worktree 中启动 Claude # 创建 .claude/worktrees/feature-auth/ 和新分支 claude --worktree feature-auth # 在单独的 worktree 中启动另一个会话 claude --worktree bugfix-123
如果您省略名称，Claude 会自动生成一个随机名称：
# 自动生成名称如 "bright-running-fox" claude --worktree
Worktrees 在 <repo>/.claude/worktrees/<name> 创建，并从默认远程分支分支。worktree 分支命名为 worktree-<name>。
基础分支不能通过 Claude Code 标志或设置进行配置。origin/HEAD 是存储在您本地 .git 目录中的引用，Git 在您克隆时设置一次。如果存储库的默认分支稍后在 GitHub 或 GitLab 上更改，您的本地 origin/HEAD 会继续指向旧的，worktrees 将从那里分支。要重新同步您的本地引用与远程当前认为的默认值：
git remote set-head origin -a
这是一个标准的 Git 命令，仅更新您的本地 .git 目录。远程服务器上没有任何更改。如果您希望 worktrees 基于特定分支而不是远程的默认值，请使用 git remote set-head origin your-branch-name 显式设置它。
为了完全控制 worktrees 的创建方式，包括为每次调用选择不同的基础，配置 WorktreeCreate hook 。该 hook 完全替换 Claude Code 的默认 git worktree 逻辑，因此您可以从您需要的任何 ref 获取和分支。
您也可以在会话期间要求 Claude “work in a worktree” 或 “start a worktree”，它会自动创建一个。
Subagent worktrees Subagents 也可以使用 worktree 隔离来并行工作而不会冲突。要求 Claude “use worktrees for your agents” 或在自定义 subagent 中通过在代理的 frontmatter 中添加 isolation: worktree 来配置它。每个 subagent 获得自己的 worktree，当 subagent 完成而没有更改时自动清理。
Worktree 清理 当您退出 worktree 会话时，Claude 根据您是否进行了更改来处理清理：
无更改 ：worktree 及其分支自动删除存在更改或提交 ：Claude 提示您保留或删除 worktree。保留会保留目录和分支，以便您稍后可以返回。删除会删除 worktree 目录及其分支，丢弃所有未提交的更改和提交
要在 Claude 会话外清理 worktrees，请使用手动 worktree 管理 。
将 .claude/worktrees/ 添加到您的 .gitignore 以防止 worktree 内容在主存储库中显示为未跟踪的文件。
复制 gitignored 文件到 worktrees Git worktrees 是新鲜检出，所以它们不包括来自主存储库的未跟踪文件，如 .env 或 .env.local。要在 Claude 创建 worktree 时自动复制这些文件，请将 .worktreeinclude 文件添加到项目根目录。
该文件使用 .gitignore 语法列出要复制的文件。只有匹配模式且也被 gitignored 的文件才会被复制，因此跟踪的文件永远不会被复制。
.env .env.local config/secrets.json
这适用于使用 --worktree 创建的 worktrees、subagent worktrees 和桌面应用 中的并行会话。
手动管理 worktrees 为了更好地控制 worktree 位置和分支配置，直接使用 Git 创建 worktrees。当您需要检出特定的现有分支或将 worktree 放在存储库外时，这很有用。
# 使用新分支创建 worktree git worktree add ../project-feature-a -b feature-a # 使用现有分支创建 worktree git worktree add ../project-bugfix bugfix-123 # 在 worktree 中启动 Claude cd ../project-feature-a && claude # 完成时清理 git worktree list git worktree remove ../project-feature-a
在官方 Git worktree 文档 中了解更多。
记住根据您的项目设置在每个新 worktree 中初始化您的开发环境。根据您的堆栈，这可能包括运行依赖项安装（npm install、yarn）、设置虚拟环境或遵循您的项目标准设置过程。
非 git 版本控制 Worktree 隔离默认使用 git。对于其他版本控制系统如 SVN、Perforce 或 Mercurial，配置 WorktreeCreate 和 WorktreeRemove hooks 以提供自定义 worktree 创建和清理逻辑。配置后，这些 hooks 在您使用 --worktree 时替换默认的 git 行为，因此.worktreeinclude
对于具有共享任务和消息的并行会话的自动协调，请参阅代理团队 。
在 Claude 需要您的注意时获得通知 当您启动长时间运行的任务并切换到另一个窗口时，您可以设置桌面通知，以便在 Claude 完成或需要您的输入时了解。这使用 Notification hook 事件 ，每当 Claude 等待权限、空闲并准备好新提示或完成身份验证时触发。
将 hook 添加到您的设置
打开 ~/.claude/settings.json 并添加一个 Notification hook，该 hook 调用您的平台的本机通知命令： { "hooks" : { "Notification" : [ { "matcher" : "" , "hooks" : [ { "type" : "command" , "command" : "osascript -e 'display notification \" Claude Code needs your attention \" with title \" Claude Code \" '" } ] } ] } }
{ "hooks" : { "Notification" : [ { "matcher" : "" , "hooks" : [ { "type" : "command" , "command" : "notify-send 'Claude Code' 'Claude Code needs your attention'" } ] } ] } }
{ "hooks" : { "Notification" : [ { "matcher" : "" , "hooks" : [ { "type" : "command" , "command" : "powershell.exe -Command \" [System.Reflection.Assembly]::LoadWithPartialName('System.Windows.Forms'); [System.Windows.Forms.MessageBox]::Show('Claude Code needs your attention', 'Claude Code') \" " } ] } ] } }
如果您的设置文件已经有 hooks 键，请将 Notification 条目合并到其中，而不是覆盖。您也可以通过在 CLI 中描述您想要的内容来要求 Claude 为您编写 hook。
可选地缩小匹配器范围
默认情况下，hook 在所有通知类型上触发。要仅针对特定事件触发，请将 matcher 字段设置为以下值之一： 匹配器 触发时机 permission_promptClaude 需要您批准工具使用 idle_promptClaude 完成并等待您的下一个提示 auth_success身份验证完成 elicitation_dialogClaude 在问您一个问题
验证 hook
输入 /hooks 并选择 Notification 以确认 hook 出现。选择它显示将运行的命令。要端到端测试它，要求 Claude 运行需要权限的命令并切换离开终端，或要求 Claude 直接触发通知。
有关完整的事件架构和通知类型，请参阅通知参考 。
将 Claude 用作 unix 风格的实用程序 将 Claude 添加到您的验证过程 假设您想将 Claude Code 用作 linter 或代码审查工具。
将 Claude 添加到您的构建脚本： // package.json { ... "scripts" : { ... "lint:claude" : "claude -p 'you are a linter. please look at the changes vs. main and report any issues related to typos. report the filename and line number on one line, and a description of the issue on the second line. do not return any other text.'" } }
提示：
在您的 CI/CD 管道中使用 Claude 进行自动代码审查
自定义提示以检查与您的项目相关的特定问题
考虑为不同类型的验证创建多个脚本
管道进入、管道输出 假设您想将数据管道输入 Claude，并获得结构化格式的数据。
通过 Claude 管道数据： cat build-error.txt | claude -p 'concisely explain the root cause of this build error' > output.txt
提示：
使用管道将 Claude 集成到现有的 shell 脚本中
与其他 Unix 工具结合以实现强大的工作流程
考虑使用 --output-format 获得结构化输出
控制输出格式 假设您需要 Claude 的输出采用特定格式，特别是在将 Claude Code 集成到脚本或其他工具时。
使用文本格式（默认）
cat data.txt | claude -p 'summarize this data' --output-format text > summary.txt
这仅输出 Claude 的纯文本响应（默认行为）。
使用 JSON 格式
cat code.py | claude -p 'analyze this code for bugs' --output-format json > analysis.json
这输出包含元数据（包括成本和持续时间）的消息的 JSON 数组。
使用流式 JSON 格式
cat log.txt | claude -p 'parse this log file for errors' --output-format stream-json
这在 Claude 处理请求时实时输出一系列 JSON 对象。每条消息都是有效的 JSON 对象，但如果连接，整个输出不是有效的 JSON。 提示：
对于简单集成（您只需要 Claude 的响应），使用 --output-format text
当您需要完整的对话日志时使用 --output-format json
对于每个对话轮次的实时输出，使用 --output-format stream-json
按计划运行 Claude 假设您想让 Claude 自动定期处理任务，如每天早上审查开放的 PR、每周审计依赖项或在夜间检查 CI 失败。
根据您希望任务运行的位置选择调度选项：
选项 运行位置 最适合 云计划任务 Anthropic 管理的基础设施 即使您的计算机关闭也应该运行的任务。在 claude.ai/code 配置。 桌面计划任务 您的机器，通过桌面应用 需要直接访问本地文件、工具或未提交更改的任务。 GitHub Actions 您的 CI 管道 与存储库事件（如打开的 PR）相关的任务，或应该与工作流配置一起存在的 cron 计划。 /loop当前 CLI 会话 会话打开时的快速轮询。任务在您退出时被取消。
为计划任务编写提示时，明确说明成功是什么样的以及如何处理结果。任务自主运行，所以它不能提出澄清问题。例如：“审查标记为 needs-review 的开放 PR，对任何问题留下内联评论，并在 #eng-reviews Slack 频道中发布摘要。“
询问 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 基于文档提供对这些问题的答案。有关可执行示例和实际演示，请参阅上面的特定工作流程部分。
提示：
Claude 始终可以访问最新的 Claude Code 文档，无论您使用的版本如何
提出具体问题以获得详细答案
Claude 可以解释复杂的功能，如 MCP 集成、企业配置和高级工作流程
后续步骤
Claude Code 如何工作 理解代理循环和上下文管理
扩展 Claude Code 添加 skills、hooks、MCP、subagents 和插件
