ITSI Claude Code 中文教程

Appearance

常见工作流程 ​

了解使用 Claude Code 的常见工作流程。 本文档中的每个任务都包含清晰的说明、示例命令和最佳实践，帮助您充分利用 Claude Code。

理解新代码库 ​

快速获取代码库概览 ​

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

  1. 导航到项目根目录bashcd /path/to/project
  2. 启动 Claude Codebashclaude
  3. 请求高层次概览> give me an overview of this codebase
  4. 深入了解特定组件> explain the main architecture patterns used here> what are the key data models?> how is authentication handled?

💡 提示：

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

查找相关代码 ​

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

  1. 让 Claude 查找相关文件> find the files that handle user authentication
  2. 了解组件如何交互的上下文> how do these authentication files work together?
  3. 理解执行流程> trace the login process from front-end to database

💡 提示：

  • 对您要查找的内容要具体
  • 使用项目中的领域语言

高效修复错误 ​

假设您遇到了错误消息，需要找到并修复其源头。

  1. 与 Claude 分享错误> I'm seeing an error when I run npm test
  2. 请求修复建议> suggest a few ways to fix the @ts-ignore in user.ts
  3. 应用修复> update user.ts to add the null check you suggested

💡 提示：

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

重构代码 ​

假设您需要更新旧代码以使用现代模式和实践。

  1. 识别需要重构的遗留代码> find deprecated API usage in our codebase
  2. 获取重构建议> suggest how to refactor utils.js to use modern JavaScript features
  3. 安全地应用更改> refactor utils.js to use ES2024 features while maintaining the same behavior
  4. 验证重构> run tests for the refactored code

💡 提示：

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

使用专门的子代理 ​

假设您想使用专门的 AI 子代理来更有效地处理特定任务。

  1. 查看可用的子代理> /agents这显示所有可用的子代理并让您创建新的子代理。
  2. 自动使用子代理Claude Code 将自动将适当的任务委托给专门的子代理：> review my recent code changes for security issues> run all tests and fix any failures
  3. 明确请求特定子代理> use the code-reviewer subagent to check the auth module> have the debugger subagent investigate why users can't log in
  4. 为您的工作流程创建自定义子代理> /agents然后选择"Create New subagent"并按照提示定义：子代理类型（例如，api-designer、performance-optimizer）何时使用它它可以访问哪些工具其专门的系统提示

💡 提示：

  • 在 .claude/agents/ 中创建项目特定的子代理以供团队共享
  • 使用描述性的 description 字段来启用自动委托
  • 将工具访问限制为每个子代理实际需要的内容
  • 查看子代理文档获取详细示例

处理测试 ​

假设您需要为未覆盖的代码添加测试。

  1. 识别未测试的代码> find functions in NotificationsService.swift that are not covered by tests
  2. 生成测试脚手架> add tests for the notification service
  3. 添加有意义的测试用例> add test cases for edge conditions in the notification service
  4. 运行并验证测试> run the new tests and fix any failures

💡 提示：

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

创建拉取请求 ​

假设您需要为您的更改创建一个文档完善的拉取请求。

  1. 总结您的更改> summarize the changes I've made to the authentication module
  2. 使用 Claude 生成 PR> create a pr
  3. 审查和完善> enhance the PR description with more context about the security improvements
  4. 添加测试详情> add information about how these changes were tested

💡 提示：

  • 直接让 Claude 为您创建 PR
  • 在提交之前审查 Claude 生成的 PR
  • 让 Claude 突出显示潜在的风险或考虑因素

处理文档 ​

假设您需要为您的代码添加或更新文档。

  1. 识别未文档化的代码> find functions without proper JSDoc comments in the auth module
  2. 生成文档> add JSDoc comments to the undocumented functions in auth.js
  3. 审查和增强> improve the generated documentation with more context and examples
  4. 验证文档> check if the documentation follows our project standards

💡 提示：

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

处理图像 ​

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

  1. 向对话添加图像您可以使用以下任何方法：将图像拖放到 Claude Code 窗口中复制图像并使用 ctrl+v 粘贴到 CLI 中（不要使用 cmd+v）向 Claude 提供图像路径。例如，"Analyze this image: /path/to/your/image.png"
  2. 让 Claude 分析图像> What does this image show?> Describe the UI elements in this screenshot> Are there any problematic elements in this diagram?
  3. 使用图像作为上下文> 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?
  4. 从视觉内容获取代码建议> Generate CSS to match this design mockup> What HTML structure would recreate this component?

💡 提示：

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

引用文件和目录 ​

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

  1. 引用单个文件> Explain the logic in @src/utils/auth.js这将文件的完整内容包含在对话中。
  2. 引用目录> What's the structure of @src/components?这提供带有文件信息的目录列表。
  3. 引用 MCP 资源> Show me the data from @github:repos/owner/repo/issues这使用格式 @server:resource 从连接的 MCP 服务器获取数据。详情请参见 MCP 资源。

💡 提示：

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

使用扩展思考 ​

假设您正在处理复杂的架构决策、具有挑战性的错误或需要深度推理的多步骤实现规划。

  1. 提供上下文并让 Claude 思考> I need to implement a new authentication system using OAuth2 for our API. Think deeply about the best approach for implementing this in our codebase.Claude 将从您的代码库收集相关信息并 使用扩展思考，这将在界面中可见。
  2. 通过后续提示完善思考> think about potential security vulnerabilities in this approach> think harder about edge cases we should handle

💡 提示： 从扩展思考中获得最大价值的提示： 扩展思考对复杂任务最有价值，例如：

  • 规划复杂的架构更改
  • 调试复杂问题
  • 为新功能创建实现计划
  • 理解复杂的代码库
  • 评估不同方法之间的权衡 您提示思考的方式会导致不同深度的思考：
  • "think" 触发基本扩展思考
  • 强化短语如 "think more"、"think a lot"、"think harder" 或 "think longer" 触发更深层的思考 有关更多扩展思考提示技巧，请参见上方说明。 ℹ️ 注意：Claude 将在响应上方以斜体灰色文本显示其思考过程。

恢复之前的对话 ​

假设您一直在使用 Claude Code 处理任务，需要在稍后的会话中继续之前的工作。 Claude Code 提供两个恢复之前对话的选项：

  • --continue 自动继续最近的对话
  • --resume 显示对话选择器
  1. 继续最近的对话bashclaude --continue这立即恢复您最近的对话，无需任何提示。
  2. 在非交互模式下继续bashclaude --continue --print "Continue with my task"使用 --print 与 --continue 在非交互模式下恢复最近的对话，非常适合脚本或自动化。
  3. 显示对话选择器bashclaude --resume这显示一个交互式对话选择器，显示：对话开始时间初始提示或对话摘要消息计数使用箭头键导航并按 Enter 选择对话。

💡 提示：

  • 对话历史存储在您的机器本地
  • 使用 --continue 快速访问您最近的对话
  • 当您需要选择特定的过去对话时使用 --resume
  • 恢复时，您将在继续之前看到整个对话历史
  • 恢复的对话以与原始对话相同的模型和配置开始 工作原理：
  1. 对话存储：所有对话都自动保存在本地，包含完整的消息历史
  2. 消息反序列化：恢复时，整个消息历史被恢复以保持上下文
  3. 工具状态：之前对话中的工具使用和结果得到保留
  4. 上下文恢复：对话恢复时保持所有之前的上下文完整 示例： bash
# 继续最近的对话
claude --continue
# 使用特定提示继续最近的对话
claude --continue --print "Show me our progress"
# 显示对话选择器
claude --resume
# 在非交互模式下继续最近的对话
claude --continue --print "Run the tests again"

使用 Git worktrees 运行并行 Claude Code 会话 ​

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

  1. 了解 Git worktreesGit worktrees 允许您将同一存储库的多个分支检出到单独的目录中。每个 worktree 都有自己的工作目录和隔离的文件，同时共享相同的 Git 历史。在官方 Git worktree 文档中了解更多。
  2. 创建新的 worktreebash# 使用新分支创建新的 worktree git worktree add ../project-feature-a -b feature-a

或使用现有分支创建 worktree ​

git worktree add ../project-bugfix bugfix-123这创建一个新目录，其中包含您存储库的单独工作副本。 3. 在每个 worktree 中运行 Claude Codebash# 导航到您的 worktree cd ../project-feature-a

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

claude 4. 在另一个 worktree 中运行 Claudebashcd ../project-bugfix claude 5. 管理您的 worktreesbash# 列出所有 worktrees git worktree list

完成后删除 worktree ​

git worktree remove ../project-feature-a

💡 提示：

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

将 Claude 用作 unix 风格的实用程序 ​

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

假设您想将 Claude Code 用作 linter 或代码审查器。 将 Claude 添加到您的构建脚本： json

// 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 管道数据： bash

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 集成到脚本或其他工具中时。

  1. 使用文本格式（默认）bashcat data.txt | claude -p 'summarize this data' --output-format text > summary.txt这只输出 Claude 的纯文本响应（默认行为）。
  2. 使用 JSON 格式bashcat code.py | claude -p 'analyze this code for bugs' --output-format json > analysis.json这输出包含成本和持续时间等元数据的消息 JSON 数组。
  3. 使用流式 JSON 格式bashcat 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 Code 支持自定义斜杠命令，您可以创建这些命令来快速执行特定的提示或任务。 有关更多详细信息，请参见斜杠命令参考页面。

创建项目特定命令 ​

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

  1. 在您的项目中创建命令目录bashmkdir -p .claude/commands
  2. 为每个命令创建 Markdown 文件bashecho "Analyze the performance of this code and suggest three specific optimizations:" > .claude/commands/optimize.md
  3. 在 Claude Code 中使用您的自定义命令> /optimize

💡 提示：

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

使用 $ARGUMENTS 添加命令参数 ​

假设您想创建可以接受用户额外输入的灵活斜杠命令。

  1. 使用 $ARGUMENTS 占位符创建命令文件bashecho 'Find and fix issue #$ARGUMENTS. Follow these steps: 1. Understand the issue described in the ticket 2. Locate the relevant code in our codebase 3. Implement a solution that addresses the root cause 4. Add appropriate tests 5. Prepare a concise PR description' > .claude/commands/fix-issue.md
  2. 使用带有问题编号的命令在您的 Claude 会话中，使用带有参数的命令。> /fix-issue 123这将在提示中用"123"替换 $ARGUMENTS。

💡 提示：

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

创建个人斜杠命令 ​

假设您想创建在所有项目中都有效的个人斜杠命令。

  1. 在您的主文件夹中创建命令目录bashmkdir -p ~/.claude/commands
  2. 为每个命令创建 Markdown 文件bashecho "Review this code for security vulnerabilities, focusing on:" > ~/.claude/commands/security-review.md
  3. 使用您的个人自定义命令> /security-review

💡 提示：

  • 个人命令在使用 /help 列出时在其描述中显示"(user)"
  • 个人命令只对您可用，不与您的团队共享
  • 个人命令在您的所有项目中都有效
  • 您可以将这些用于跨不同代码库的一致工作流程

询问 Claude 关于其功能 ​

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

示例问题 ​

> can Claude Code create pull requests?
> how does Claude Code handle permissions?
> what slash commands 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 参考实现 克隆我们的开发容器参考实现。

© 2026 娱信互动. 保留所有权利