Claude Code 常见工作流教程指南

Claude Code 是 Anthropic 推出的专为终端设计的 AI 命令行工具，它允许开发者直接在本地开发环境中通过自然语言与代码库进行深度交互。

与基于网页的聊天界面不同，Claude Code 拥有对本地文件系统、git 操作、终端命令执行以及工具调用的完整权限。通过将 AI 能力直接嵌入命令行工作流，开发者可以实现从代码理解、漏洞修复到自动化测试、PR 提交的全流程操作。

基础环境与代码库理解

在任何项目开始之前，快速熟悉代码库的结构和设计模式是首要任务。进入项目根目录后，通过执行简单的启动命令即可激活交互环境。

claude

启动后，Claude 会自动索引项目文件。对于初次接触的代码库，可以请求一个高层级的概览。Claude 会分析目录结构、核心配置文件和文档，给出一个关于项目用途、技术栈以及模块划分的总结。这种理解不仅仅停留在文件列表上，还可以进一步询问特定的架构模式，例如项目中如何处理身份验证、核心数据模型定义在哪里，或者某些特定业务逻辑的执行流是怎样的。

在寻找特定功能相关的代码时，Claude 的定位能力非常精准。不需要手动在编辑器中全局搜索关键词，直接描述想要寻找的功能即可。例如寻找处理用户认证的文件，Claude 会提供相关文件列表并解释它们之间的协作关系。对于复杂的调用链路，可以要求它追踪从前端输入到数据库持久化的完整执行流，这对于理解遗留系统或复杂的微服务交互非常有帮助。

缺陷修复与代码重构

利用 Claude Code 处理 Bug 的核心在于提供充分的上下文。当遇到测试失败或运行报错时，直接将错误信息同步给 Claude。

claude -p "I'm seeing an error when I run npm test, please help me fix it"

Claude 不仅会分析报错信息，还会主动运行相关的诊断命令来获取堆栈追踪。在定位问题后，它会提供多种修复方案供选择。

对于代码中的临时规避方案（如 @ts-ignore），可以要求它提供更规范的类型定义建议。在确认方案后，Claude 能直接修改文件并应用这些更改。这种“诊断-建议-应用”的闭环极大地缩短了调试周期。

代码重构是另一个高频使用场景。Claude 擅长识别陈旧的 API 调用或不再推荐的编程范式。通过搜索代码库中的过时用法，它可以生成详细的重构计划。

例如将旧的 JavaScript 工具类升级为符合 ES2024 标准的语法，同时利用其内置的测试工具确保重构后的逻辑与原行为保持一致。建议在进行此类操作时，要求 Claude 解释新方案的优势，并以可测试的小步骤逐步实施，确保每一步更改都是安全的。

计划模式与安全操作

在进行涉及多个文件的大规模重构或复杂功能实现前，直接修改代码存在风险。Claude Code 提供了计划模式（Plan Mode），这是一种只读的分析状态，非常适合用于探索代码库和制定实施方案。

权限模式对比

在会话过程中，可以使用 Shift+Tab 快捷键在这些模式间循环切换。如果希望从一开始就以计划模式运行，可以使用特定的启动参数。

claude --permission-mode plan

在计划模式下，Claude 会详细分析现有实现并创建一个全面的迁移或修改计划。开发者可以针对计划中的向后兼容性、数据库迁移等细节进行反复追问和完善。只有当方案在逻辑上完全自洽后，再切换回正常模式执行具体操作。

自动化测试与质量保障

Claude Code 在测试驱动开发中表现出色。它不仅能根据现有模式生成测试脚手架，还能敏锐地发现未覆盖的代码路径。

在识别出缺少测试的函数后，可以要求 Claude 为其补充测试用例。它会检查现有的测试框架、断言风格和模拟（Mock）习惯，确保生成的代码与项目既有风格融为一体。为了追求更高的覆盖率，应当要求 Claude 寻找边界条件和异常路径，例如网络超时、非法的用户输入或并发冲突等开发者容易忽略的场景。

claude -p "find functions in NotificationsService.swift that are not covered by tests and add test cases for edge conditions"

完成测试编写后，直接让 Claude 运行测试并修复发现的任何失败项。这种即时的反馈循环保证了新增代码的健壮性。

任务委派与专用子代理

为了提高复杂任务的处理效率，Claude Code 引入了子代理（Subagents）概念。这些是针对特定领域优化的 AI 实例，能够处理如安全审计、API 设计或深度调试等任务。

通过 /agents 命令可以查看或创建新的子代理。在日常工作中，Claude 会根据任务需求自动委派。例如当请求审查代码中的安全漏洞时，它可能会启动一个专门的安全代理。开发者也可以显式地调用特定代理来执行任务，比如使用 code-reviewer 代理来检查认证模块。

对于团队特定的工作流，可以在 .claude/agents/ 目录下创建自定义代理。定义时需要指定其唯一的标识符、工具访问权限以及系统提示词。这种方式可以将团队的最佳实践硬编码到 AI 的行为逻辑中，实现高度定制化的辅助开发。

视觉交互与文件引用

Claude Code 支持多模态交互，这意味着它可以理解图片内容。在终端中，可以通过拖拽、粘贴或提供路径的方式将图片引入对话。

当遇到难以用文字描述的 UI 布局问题或复杂的架构图时，视觉能力非常有用。可以直接询问 Claude 某个屏幕截图中的 UI 元素描述，或者让它根据设计稿生成对应的 CSS 代码。对于数据库建模，将现有的架构图发给 Claude，它可以据此提出新功能的表结构调整建议。

claude -p "Analyze this database schema image and suggest how to modify it for the new feature: @docs/schema.png"

在对话中，使用 @ 符号可以快速引用本地文件或目录。引用单个文件会将其完整内容加入上下文，而引用目录则会提供文件列表。这种方式比让 Claude 自己去搜索要高效得多，特别是在已知问题源头的情况下。

深度思考与 Token 预算

对于复杂的架构决策或深层次的 Bug 分析，Claude Code 支持扩展思考模式（Extended Thinking）。这种模式允许模型在输出最终答案前进行多步骤的内部推理。

思考模式配置与预算

开启思考模式后，Claude 最多可以使用 31,999 个 Token 进行内部推理。这些推理过程在详细模式下（通过 Ctrl+O 开启）是可见的，通常以灰色斜体字显示。这种模式虽然会消耗更多 Token 并增加成本，但它为 Claude 提供了探索多个方案、自我修正错误和评估权衡利弊的空间，极大地提升了处理高难度问题的成功率。

会话持久化与环境管理

Claude Code 会自动保存所有的对话历史，这使得跨任务切换变得非常自然。使用 /resume 命令可以打开交互式会话选择器。

为了更好地管理长期任务，建议使用 /rename 给会话赋予具有辨识度的名称。在会话选择器中，可以看到每个会话的最后活动时间、消息数量以及相关的 Git 分支。通过 claude --continue 可以快速回到当前目录下的最近一次对话，这在处理中断后的恢复时非常高效。

在处理完全独立的任务时，结合 Git worktrees 使用 Claude Code 是一个高级技巧。通过 git worktree add 创建独立的开发环境，可以在不同的终端窗口中运行多个 Claude 实例。由于每个 worktree 都有独立的文件状态，不同的 Claude 实例之间不会产生干扰，非常适合同时进行的并行开发。

Unix 风格的系统集成

Claude Code 不仅仅是一个交互式 Shell，它还可以作为类 Unix 工具集成到现有流水线中。通过管道符（pipe），可以将数据输入 Claude，并获取结构化的输出。

cat build-error.txt | claude -p 'concisely explain the root cause' > explanation.txt

通过指定 --output-format 参数，可以控制输出为纯文本、JSON 或流式 JSON。JSON 格式尤其适合于自动化脚本，因为它包含了对话日志、成本和持续时间等元数据。此外，还可以通过自定义 Slash 命令来封装常用的 Prompt。

在 .claude/commands/ 目录下创建 Markdown 文件，文件名即为命令名。如果 Prompt 中包含 $ARGUMENTS 占位符，执行命令时传入的参数会自动替换该位置，实现灵活的命令复用。

开发必备：API 全流程管理神器 Apifox

介绍完上文的内容，我想额外介绍一个对开发者同样重要的效率工具 —— Apifox。作为一个集 API 文档、API 调试、API 设计、API 测试、API Mock、自动化测试等功能于一体的 API 管理工具，Apifox 可以说是开发者提升效率的必备工具之一。

 
如果你正在开发项目需要进行接口调试，不妨试试 Apifox。注册过程非常简单，你可以直接在这里注册使用。

注册成功后可以先看看官方提供的示例项目，这些案例都是经过精心设计的，能帮助你快速了解 Apifox 的主要功能。

 
使用 Apifox 的一大优势是它完全兼容 Postman 和 Swagger 数据格式，如果你之前使用过这些工具，数据导入会非常方便。而且它的界面设计非常友好，即使是第一次接触的新手也能很快上手，快去试试吧！