教程

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

​

目录

• 继续之前的对话
• 理解新代码库
• 高效修复bug
• 重构代码
• 处理测试
• 创建拉取请求
• 处理文档
• 处理图像
• 使用延伸思考
• 设置项目记忆
• 设置模型上下文协议(MCP)
• 将Claude用作类Unix工具
• 创建自定义斜杠命令
• 使用Git工作树运行并行Claude Code会话

​

继续之前的对话

​

无缝继续您的工作

何时使用： 您一直在使用Claude Code处理任务，需要在稍后的会话中继续之前的工作。

Claude Code提供两种继续之前对话的选项：

• --continue 自动继续最近的对话
• --resume 显示对话选择器

claude --continue

claude --continue --print "继续我的任务"

claude --resume

工作原理：

1. 对话存储：所有对话都会自动保存在本地，包含完整的消息历史
2. 消息反序列化：恢复时，整个消息历史都会被还原以保持上下文
3. 工具状态：之前对话中的工具使用和结果会被保留
4. 上下文恢复：对话会在保留所有先前上下文的情况下继续

提示：

• 对话历史存储在您的本地机器上
• 使用--continue快速访问您最近的对话
• 当您需要选择特定的过去对话时使用--resume
• 恢复时，您将看到整个对话历史记录，然后再继续
• 恢复的对话使用与原始对话相同的模型和配置开始

示例：

# 继续最近的对话
claude --continue

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

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

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

​

理解新代码库

​

快速了解代码库概况

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

cd /path/to/project 

claude 

> 给我这个代码库的概述 

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

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

> 身份验证是如何处理的？

提示：

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

​

查找相关代码

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

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

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

> 追踪从前端到数据库的登录过程 

提示：

• 明确说明您要查找的内容
• 使用项目中的领域语言

​

高效修复bug

​

诊断错误消息

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

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

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

> 更新user.ts以添加你建议的空值检查 

提示：

• 告诉Claude重现问题和获取堆栈跟踪的命令
• 提及重现错误的步骤
• 让Claude知道错误是间歇性的还是一致的

​

重构代码

​

现代化遗留代码

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

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

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

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

> 为重构的代码运行测试 

提示：

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

​

处理测试

​

增加测试覆盖率

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

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

> 为通知服务添加测试 

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

> 运行新测试并修复任何失败 

提示：

• 请求覆盖边缘情况和错误条件的测试
• 在适当时请求单元测试和集成测试
• 让Claude解释测试策略

​

创建拉取请求

​

生成全面的PR

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

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

> 创建一个pr 

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

> 添加有关这些更改如何被测试的信息 

提示：

• 直接请求Claude为您创建PR
• 在提交前审查Claude生成的PR
• 请Claude突出显示潜在风险或考虑事项

​

处理文档

​

生成代码文档

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

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

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

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

> 检查文档是否遵循我们的项目标准 

提示：

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

​

处理图像

​

分析图像和截图

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

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

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

> 生成CSS以匹配这个设计模型 
> 什么HTML结构可以重新创建这个组件？ 

提示：

• 当文本描述不清晰或繁琐时使用图像
• 包括错误、UI设计或图表的截图以提供更好的上下文
• 您可以在对话中处理多个图像
• 图像分析适用于图表、截图、模型等

​

使用延伸思考

​

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

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

> 我需要使用OAuth2为我们的API实现一个新的身份验证系统。深入思考在我们的代码库中实现这一点的最佳方法。 

> 思考这种方法中潜在的安全漏洞 
> 更深入地思考我们应该处理的边缘情况 

获取延伸思考最大价值的提示：

延伸思考对以下复杂任务最有价值：

• 规划复杂的架构变更
• 调试复杂问题
• 为新功能创建实施计划
• 理解复杂代码库
• 评估不同方法之间的权衡

您提示思考的方式会导致不同深度的思考：

• “思考”触发基本的延伸思考
• 强化短语如”多思考”、“思考很多”、“更深入思考”或”思考更久”会触发更深入的思考

有关更多延伸思考提示技巧，请参阅延伸思考提示。

​

设置项目记忆

​

创建有效的CLAUDE.md文件

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

> /init 

提示：

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

​

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

模型上下文协议(MCP)是一个开放协议，使LLM能够访问外部工具和数据源。有关更多详情，请参阅MCP文档。

​

配置MCP服务器

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

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

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

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

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

# 列出所有配置的服务器
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作用域如何工作以及如何与团队共享服务器。

# 添加本地作用域服务器（默认）
claude mcp add my-private-server /path/to/server

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

# 添加项目作用域服务器
claude mcp add shared-server -s project /path/to/server

{
  "mcpServers": {
    "shared-server": {
      "command": "/path/to/server",
      "args": [],
      "env": {}
    }
  }
}

# 添加用户服务器
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数据库以进行查询和架构检查。

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

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

> 描述我们用户表的架构
> 系统中最近的订单是什么？
> 显示客户和发票之间的关系

提示：

• Postgres MCP服务器为安全起见提供只读访问
• Claude可以帮助您探索数据库结构并运行分析查询
• 您可以使用此功能快速了解不熟悉项目中的数据库架构
• 确保您的连接字符串使用具有最低所需权限的适当凭据

​

从JSON配置添加MCP服务器

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

# 基本语法
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"}}'

claude mcp get weather-api

提示：

• 确保JSON在您的shell中正确转义
• JSON必须符合MCP服务器配置模式
• 您可以使用-s global将服务器添加到全局配置而不是项目特定配置

​

从Claude Desktop导入MCP服务器

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

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

claude mcp list 

提示：

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

​

将Claude Code用作MCP服务器

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

# 基本语法
claude mcp serve

{
  "command": "claude",
  "args": ["mcp", "serve"],
  "env": {}
}

提示：

• 服务器提供对Claude的工具的访问，如View、Edit、LS等
• 在Claude Desktop中，尝试让Claude读取目录中的文件、进行编辑等
• 请注意，此MCP服务器只是将Claude Code的工具暴露给您的MCP客户端，因此您自己的客户端负责为单个工具调用实现用户确认

​

将Claude用作类Unix工具

​

将Claude添加到您的验证过程

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

步骤：

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

​

管道输入，管道输出

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

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

​

控制输出格式

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

cat data.txt | claude -p '总结这些数据' --output-format text > summary.txt

cat code.py | claude -p '分析这段代码中的bug' --output-format json > analysis.json

cat log.txt | claude -p '解析这个日志文件中的错误' --output-format stream-json

提示：

• 当您只需要Claude的响应时，使用--output-format text进行简单集成
• 当您需要完整的对话日志时，使用--output-format json
• 当您需要每个对话轮次的实时输出时，使用--output-format stream-json

​

创建自定义斜杠命令

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

​

创建项目特定命令

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

mkdir -p .claude/commands

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

claude > /project:optimize 

提示：

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

​

使用$ARGUMENTS添加命令参数

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

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

claude > /project:fix-issue 123 

提示：

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

​

创建个人斜杠命令

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

mkdir -p ~/.claude/commands 

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

claude > /user:security-review 

提示：

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

​

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

​

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

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

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

# 或使用现有分支创建工作树
git worktree add ../project-bugfix bugfix-123

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

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

cd ../project-bugfix
claude

# 列出所有工作树
git worktree list

# 完成后移除工作树
git worktree remove ../project-feature-a

提示：

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

​

下一步