本指南提供了使用Claude Code进行常见工作流程的分步教程。每个教程包括清晰的指导、示例命令和最佳实践，帮助您充分利用Claude Code。

​
目录

​
继续之前的对话

​
无缝继续您的工作

何时使用： 您一直在使用Claude Code处理任务，需要在稍后的会话中继续之前的工作。 Claude Code提供两种继续之前对话的选项：
  • --continue 自动继续最近的对话
  • --resume 显示对话选择器
1

继续最近的对话

claude --continue
这会立即恢复您最近的对话，无需任何提示。
2

在非交互模式下继续

claude --continue --print "继续我的任务"
将--print与--continue一起使用可以在非交互模式下恢复最近的对话，非常适合脚本或自动化。
3

显示对话选择器

claude --resume
这会显示一个交互式对话选择器，显示：
  • 对话开始时间
  • 初始提示或对话摘要
  • 消息数量
使用箭头键导航并按Enter选择对话。
工作原理：
  1. 对话存储：所有对话都会自动保存在本地，包含完整的消息历史
  2. 消息反序列化：恢复时，整个消息历史都会被还原以保持上下文
  3. 工具状态：之前对话中的工具使用和结果会被保留
  4. 上下文恢复：对话会在保留所有先前上下文的情况下继续
提示：
  • 对话历史存储在您的本地机器上
  • 使用--continue快速访问您最近的对话
  • 当您需要选择特定的过去对话时使用--resume
  • 恢复时，您将看到整个对话历史记录，然后再继续
  • 恢复的对话使用与原始对话相同的模型和配置开始
示例： 
# 继续最近的对话
claude --continue

# 继续最近的对话并指定提示
claude --continue --print "显示我们的进度"

# 显示对话选择器
claude --resume

# 在非交互模式下继续最近的对话
claude --continue --print "再次运行测试"

​
理解新代码库

​
快速了解代码库概况

何时使用： 您刚刚加入一个新项目，需要快速了解其结构。
1

导航到项目根目录

cd /path/to/project
2

启动Claude Code

claude
3

请求高级概述

> 给我这个代码库的概述
4

深入了解特定组件

> 解释这里使用的主要架构模式 

> 主要的数据模型有哪些？

> 身份验证是如何处理的？
提示：
  • 从广泛的问题开始，然后缩小到特定领域
  • 询问项目中使用的编码约定和模式
  • 请求项目特定术语的词汇表

​
查找相关代码

何时使用： 您需要找到与特定功能相关的代码。
1

请Claude查找相关文件

> 找到处理用户身份验证的文件
2

了解组件如何交互

> 这些身份验证文件如何协同工作？
3

理解执行流程

> 追踪从前端到数据库的登录过程
提示：
  • 明确说明您要查找的内容
  • 使用项目中的领域语言

​
高效修复bug

​
诊断错误消息

何时使用： 您遇到了错误消息，需要找到并修复其源头。
1

与Claude分享错误

> 当我运行npm test时出现错误
2

请求修复建议

> 建议几种方法来修复user.ts中的@ts-ignore
3

应用修复

> 更新user.ts以添加你建议的空值检查
提示：
  • 告诉Claude重现问题和获取堆栈跟踪的命令
  • 提及重现错误的步骤
  • 让Claude知道错误是间歇性的还是一致的

​
重构代码

​
现代化遗留代码

何时使用： 您需要更新旧代码以使用现代模式和实践。
1

识别需要重构的遗留代码

> 在我们的代码库中查找已弃用的API用法
2

获取重构建议

> 建议如何重构utils.js以使用现代JavaScript特性
3

安全地应用更改

> 重构utils.js以使用ES2024特性，同时保持相同的行为
4

验证重构

> 为重构的代码运行测试
提示：
  • 请Claude解释现代方法的好处
  • 在需要时请求更改保持向后兼容性
  • 以小的、可测试的增量进行重构

​
处理测试

​
增加测试覆盖率

何时使用： 您需要为未覆盖的代码添加测试。
1

识别未测试的代码

> 查找NotificationsService.swift中没有测试覆盖的函数
2

生成测试脚手架

> 为通知服务添加测试
3

添加有意义的测试用例

> 为通知服务中的边缘条件添加测试用例
4

运行并验证测试

> 运行新测试并修复任何失败
提示：
  • 请求覆盖边缘情况和错误条件的测试
  • 在适当时请求单元测试和集成测试
  • 让Claude解释测试策略

​
创建拉取请求

​
生成全面的PR

何时使用： 您需要为您的更改创建一个文档完善的拉取请求。
1

总结您的更改

> 总结我对身份验证模块所做的更改
2

使用Claude生成PR

> 创建一个pr
3

审查和完善

> 用更多关于安全改进的上下文来增强PR描述
4

添加测试详情

> 添加有关这些更改如何被测试的信息
提示：
  • 直接请求Claude为您创建PR
  • 在提交前审查Claude生成的PR
  • 请Claude突出显示潜在风险或考虑事项

​
处理文档

​
生成代码文档

何时使用： 您需要为您的代码添加或更新文档。
1

识别未文档化的代码

> 在auth模块中查找没有适当JSDoc注释的函数
2

生成文档

> 为auth.js中未文档化的函数添加JSDoc注释
3

审查和增强

> 用更多上下文和示例改进生成的文档
4

验证文档

> 检查文档是否遵循我们的项目标准
提示：
  • 指定您想要的文档风格（JSDoc、docstrings等）
  • 在文档中请求示例
  • 为公共API、接口和复杂逻辑请求文档

​
处理图像

​
分析图像和截图

何时使用： 您需要处理代码库中的图像或获取Claude帮助分析图像内容。
1

将图像添加到对话中

您可以使用以下任何方法：
  1. 将图像拖放到Claude Code窗口中
  2. 复制图像并使用cmd+v（在Mac上）粘贴到CLI中
  3. 提供图像路径 claude “分析这个图像：/path/to/your/image.png”
2

请Claude分析图像

> 这个图像显示了什么？ 
> 描述这个截图中的UI元素 
> 这个图表中有任何问题元素吗？
3

使用图像作为上下文

> 这是错误的截图。是什么导致了它？ 
> 这是我们当前的数据库架构。我们应该如何修改它以适应新功能？
4

从视觉内容获取代码建议

> 生成CSS以匹配这个设计模型 
> 什么HTML结构可以重新创建这个组件？
提示：
  • 当文本描述不清晰或繁琐时使用图像
  • 包括错误、UI设计或图表的截图以提供更好的上下文
  • 您可以在对话中处理多个图像
  • 图像分析适用于图表、截图、模型等

​
使用延伸思考

​
利用Claude的延伸思考处理复杂任务

何时使用： 当处理复杂的架构决策、具有挑战性的bug或规划需要深度推理的多步骤实现时。
1

提供上下文并请Claude思考

> 我需要使用OAuth2为我们的API实现一个新的身份验证系统。深入思考在我们的代码库中实现这一点的最佳方法。
Claude将从您的代码库收集相关信息并 使用延伸思考，这将在界面中可见。
2

通过后续提示完善思考

> 思考这种方法中潜在的安全漏洞 
> 更深入地思考我们应该处理的边缘情况
获取延伸思考最大价值的提示： 延伸思考对以下复杂任务最有价值：
  • 规划复杂的架构变更
  • 调试复杂问题
  • 为新功能创建实施计划
  • 理解复杂代码库
  • 评估不同方法之间的权衡
您提示思考的方式会导致不同深度的思考：
  • “思考”触发基本的延伸思考
  • 强化短语如”多思考”、“思考很多”、“更深入思考”或”思考更久”会触发更深入的思考
有关更多延伸思考提示技巧，请参阅延伸思考提示。
Claude将在响应上方以斜体灰色文本显示其思考过程。

​
设置项目记忆

​
创建有效的CLAUDE.md文件

何时使用： 您想设置一个CLAUDE.md文件来存储重要的项目信息、约定和常用命令。
1

为您的代码库引导CLAUDE.md

> /init
提示：
  • 包括常用命令（构建、测试、lint）以避免重复搜索
  • 记录代码风格偏好和命名约定
  • 添加特定于您项目的重要架构模式
  • CLAUDE.md记忆可用于与团队共享的指令和您的个人偏好。有关更多详情，请参阅管理Claude的记忆。

​
设置模型上下文协议(MCP)

模型上下文协议(MCP)是一个开放协议，使LLM能够访问外部工具和数据源。有关更多详情，请参阅MCP文档。
使用第三方MCP服务器风险自负。确保您信任MCP服务器，并在使用与互联网通信的MCP服务器时特别小心，因为这些可能会使您面临提示注入风险。

​
配置MCP服务器

何时使用： 您想通过使用模型上下文协议连接到专门工具和外部服务器来增强Claude的能力。
1

添加MCP Stdio服务器

# 基本语法
claude mcp add <name> <command> [args...]

# 示例：添加本地服务器
claude mcp add my-server -e API_KEY=123 -- /path/to/server arg1 arg2
2

添加MCP SSE服务器

# 基本语法
claude mcp add --transport sse <name> <url>

# 示例：添加SSE服务器
claude mcp add --transport sse sse-server https://example.com/sse-endpoint
3

管理您的MCP服务器

# 列出所有配置的服务器
claude mcp list

# 获取特定服务器的详细信息
claude mcp get my-server

# 移除服务器
claude mcp remove my-server
提示：
  • 使用-s或--scope标志指定配置存储位置：
    • local（默认）：仅在当前项目中对您可用（在旧版本中称为project）
    • project：通过.mcp.json文件与项目中的所有人共享
    • user：对您在所有项目中可用（在旧版本中称为global）
  • 使用-e或--env标志设置环境变量（例如，-e KEY=value）
  • 使用MCP_TIMEOUT环境变量配置MCP服务器启动超时（例如，MCP_TIMEOUT=10000 claude设置10秒超时）
  • 使用Claude Code中的/mcp命令随时检查MCP服务器状态
  • MCP遵循客户端-服务器架构，其中Claude Code（客户端）可以连接到多个专门服务器

​
理解MCP服务器作用域

何时使用： 您想了解不同MCP作用域如何工作以及如何与团队共享服务器。
1

本地作用域MCP服务器

默认作用域（local）将MCP服务器配置存储在您的项目特定用户设置中。这些服务器仅在您在当前项目工作时对您可用。
# 添加本地作用域服务器（默认）
claude mcp add my-private-server /path/to/server

# 明确指定本地作用域
claude mcp add my-private-server -s local /path/to/server
2

项目作用域MCP服务器（.mcp.json）

项目作用域服务器存储在项目根目录的.mcp.json文件中。此文件应检入版本控制以与团队共享服务器。
# 添加项目作用域服务器
claude mcp add shared-server -s project /path/to/server
这会创建或更新具有以下结构的.mcp.json文件：
{
  "mcpServers": {
    "shared-server": {
      "command": "/path/to/server",
      "args": [],
      "env": {}
    }
  }
}
3

用户作用域MCP服务器

用户作用域服务器在您机器上的所有项目中对您可用，并且对您是私有的。
# 添加用户服务器
claude mcp add my-user-server -s user /path/to/server
提示：
  • 同名的本地作用域服务器优先于项目作用域和用户作用域服务器
  • 同名的项目作用域服务器（在.mcp.json中）优先于用户作用域服务器
  • 在使用.mcp.json中的项目作用域服务器之前，Claude Code会提示您出于安全原因批准它们
  • .mcp.json文件旨在检入版本控制以与团队共享MCP服务器
  • 项目作用域服务器使团队中的每个人都能轻松访问相同的MCP工具
  • 如果您需要重置对启用或禁用哪些项目作用域服务器的选择，请使用claude mcp reset-project-choices命令

​
连接到Postgres MCP服务器

何时使用： 您想给Claude只读访问PostgreSQL数据库以进行查询和架构检查。
1

添加Postgres MCP服务器

claude mcp add postgres-server /path/to/postgres-mcp-server --connection-string "postgresql://user:pass@localhost:5432/my db"
2

使用Claude查询您的数据库

# 在您的Claude会话中，您可以询问有关数据库的问题

> 描述我们用户表的架构
> 系统中最近的订单是什么？
> 显示客户和发票之间的关系
提示：
  • Postgres MCP服务器为安全起见提供只读访问
  • Claude可以帮助您探索数据库结构并运行分析查询
  • 您可以使用此功能快速了解不熟悉项目中的数据库架构
  • 确保您的连接字符串使用具有最低所需权限的适当凭据

​
从JSON配置添加MCP服务器

何时使用： 您有单个MCP服务器的JSON配置，想要将其添加到Claude Code中。
1

从JSON添加MCP服务器

# 基本语法
claude mcp add-json <name> '<json>'

# 示例：使用JSON配置添加stdio服务器
claude mcp add-json weather-api '{"type":"stdio","command":"/path/to/weather-cli","args":["--api-key","abc123"],"env":{"CACHE_DIR":"/tmp"}}'
2

验证服务器已添加

claude mcp get weather-api
提示：
  • 确保JSON在您的shell中正确转义
  • JSON必须符合MCP服务器配置模式
  • 您可以使用-s user将服务器添加到用户配置而不是项目特定配置

​
从Claude Desktop导入MCP服务器

何时使用： 您已经在Claude Desktop中配置了MCP服务器，想要在Claude Code中使用相同的服务器而无需手动重新配置。
1

从Claude Desktop导入服务器

# 基本语法 
claude mcp add-from-claude-desktop
2

选择要导入的服务器

运行命令后，您将看到一个交互式对话框，允许您选择要导入的服务器。
3

验证服务器已导入

claude mcp list
提示：
  • 此功能仅适用于macOS和Windows Subsystem for Linux (WSL)
  • 它从这些平台上的标准位置读取Claude Desktop配置文件
  • 使用-s user标志将服务器添加到用户配置
  • 导入的服务器将与Claude Desktop中的名称相同
  • 如果已存在同名服务器，它们将获得数字后缀（例如，server_1）

​
将Claude Code用作MCP服务器

何时使用： 您想将Claude Code本身用作MCP服务器，其他应用程序可以连接到它，为它们提供Claude的工具和功能。
1

将Claude启动为MCP服务器

# 基本语法
claude mcp serve
2

从另一个应用程序连接

您可以从任何MCP客户端连接到Claude Code MCP服务器，例如Claude Desktop。如果您使用的是Claude Desktop，可以使用此配置添加Claude Code MCP服务器：
{
  "command": "claude",
  "args": ["mcp", "serve"],
  "env": {}
}
提示：
  • 服务器提供对Claude的工具的访问，如View、Edit、LS等
  • 在Claude Desktop中，尝试让Claude读取目录中的文件、进行编辑等
  • 请注意，此MCP服务器只是将Claude Code的工具暴露给您的MCP客户端，因此您自己的客户端负责为单个工具调用实现用户确认

​
将Claude用作类Unix工具

​
将Claude添加到您的验证过程

何时使用： 您想将Claude Code用作linter或代码审查工具。 步骤：
1

将Claude添加到您的构建脚本

// package.json
{
    ...
    "scripts": {
        ...
        "lint:claude": "claude -p '你是一个linter。请查看与main分支相比的变更并报告任何与拼写错误相关的问题。在一行上报告文件名和行号，在第二行上描述问题。不要返回任何其他文本。'"
    }
}

​
管道输入，管道输出

何时使用： 您想将数据管道输入到Claude，并以结构化格式获取数据。
1

通过Claude管道传输数据

cat build-error.txt | claude -p '简明扼要地解释这个构建错误的根本原因' > output.txt

​
控制输出格式

何时使用： 您需要特定格式的Claude输出，特别是在将Claude Code集成到脚本或其他工具中时。
1

使用文本格式（默认）

cat data.txt | claude -p '总结这些数据' --output-format text > summary.txt
这只输出Claude的纯文本响应（默认行为）。
2

使用JSON格式

cat code.py | claude -p '分析这段代码中的bug' --output-format json > analysis.json
这输出一个包含元数据（包括成本和持续时间）的JSON消息数组。
3

使用流式JSON格式

cat log.txt | claude -p '解析这个日志文件中的错误' --output-format stream-json
这在Claude处理请求时实时输出一系列JSON对象。每条消息都是有效的JSON对象，但如果连接起来，整个输出不是有效的JSON。
提示：
  • 当您只需要Claude的响应时，使用--output-format text进行简单集成
  • 当您需要完整的对话日志时，使用--output-format json
  • 当您需要每个对话轮次的实时输出时，使用--output-format stream-json

​
创建自定义斜杠命令

Claude Code支持自定义斜杠命令，您可以创建这些命令来快速执行特定提示或任务。

​
创建项目特定命令

何时使用： 您想为项目创建可重用的斜杠命令，所有团队成员都可以使用。
1

在项目中创建命令目录

mkdir -p .claude/commands
2

为每个命令创建Markdown文件

echo "分析这段代码的性能并建议三个具体的优化：" > .claude/commands/optimize.md
3

在Claude Code中使用您的自定义命令

claude > /project:optimize
提示：
  • 命令名称源自文件名（例如，optimize.md变为/project:optimize）
  • 您可以在子目录中组织命令（例如，.claude/commands/frontend/component.md变为/project:frontend:component）
  • 项目命令对克隆存储库的每个人都可用
  • Markdown文件内容成为调用命令时发送给Claude的提示

​
使用$ARGUMENTS添加命令参数

何时使用： 您想创建可以接受用户额外输入的灵活斜杠命令。
1

创建带有$ARGUMENTS占位符的命令文件

echo "查找并修复问题#$ARGUMENTS。按照以下步骤操作：1. 理解票据中描述的问题 2. 在我们的代码库中找到相关代码 3. 实现解决根本原因的解决方案 4. 添加适当的测试 5. 准备简洁的PR描述" > .claude/commands/fix-issue.md
2

使用带有问题编号的命令

claude > /project:fix-issue 123
这将在提示中将$ARGUMENTS替换为”123”。
提示：
  • $ARGUMENTS占位符会被命令后面的任何文本替换
  • 您可以在命令模板中的任何位置放置$ARGUMENTS
  • 其他有用的应用：为特定函数生成测试用例、为组件创建文档、审查特定文件中的代码或将内容翻译成指定语言

​
创建个人斜杠命令

何时使用： 您想创建在所有项目中都能使用的个人斜杠命令。
1

在您的主文件夹中创建命令目录

mkdir -p ~/.claude/commands
2

为每个命令创建Markdown文件

echo "审查此代码的安全漏洞，重点关注：" > ~/.claude/commands/security-review.md
3

使用您的个人自定义命令

claude > /user:security-review
提示：
  • 个人命令以/user:为前缀，而不是/project:
  • 个人命令只对您可用，不与团队共享
  • 个人命令在所有项目中都有效
  • 您可以使用这些命令在不同代码库之间保持一致的工作流程

​
使用Git工作树运行并行Claude Code会话

​
使用工作树创建隔离的编码环境

何时使用： 您需要同时处理多个任务，并在Claude Code实例之间完全隔离代码。
1

了解Git工作树

Git工作树允许您从同一存储库中检出多个分支到单独的目录。每个工作树都有自己的工作目录，文件是隔离的，同时共享相同的Git历史。在官方Git工作树文档中了解更多。
2

创建新工作树

# 创建带有新分支的工作树 
git worktree add ../project-feature-a -b feature-a

# 或使用现有分支创建工作树
git worktree add ../project-bugfix bugfix-123
这会创建一个包含存储库单独工作副本的新目录。
3

在每个工作树中运行Claude Code

# 导航到您的工作树 
cd ../project-feature-a

# 在这个隔离环境中运行Claude Code
claude
4

在另一个终端中：
cd ../project-bugfix
claude
5

管理您的工作树

# 列出所有工作树
git worktree list

# 完成后移除工作树
git worktree remove ../project-feature-a
提示：
  • 每个工作树都有自己独立的文件状态，非常适合并行Claude Code会话
  • 在一个工作树中所做的更改不会影响其他工作树，防止Claude实例相互干扰
  • 所有工作树共享相同的Git历史和远程连接
  • 对于长时间运行的任务，您可以让Claude在一个工作树中工作，同时您在另一个工作树中继续开发
  • 使用描述性目录名称，以便轻松识别每个工作树的任务
  • 记得根据项目的设置在每个新工作树中初始化开发环境。根据您的技术栈，这可能包括：
    • JavaScript项目：运行依赖安装（npm install、yarn）
    • Python项目：设置虚拟环境或使用包管理器安装
    • 其他语言：遵循项目的标准设置流程

​
下一步

Claude Code参考实现

克隆我们的开发容器参考实现。