跳至主要內容

Claude Code 常见工作流

2026/5/4大约 8 分钟

Claude Code 常见工作流

Claude Code 覆盖开发全流程，以下流程图展示了核心工作流及其应用场景：

一、新代码库快速理解与探索

快速上手陌生项目是开发日常，Claude Code 可通过结构化指令，快速完成代码库概览、架构解析与核心模块梳理，降低新项目上手成本。

  1. 进入项目根目录并启动工具
cd /path/to/project
claude
  1. 发起全局概览请求，掌握项目整体结构
> give me an overview of this codebase
  1. 深度拆解核心架构与组件
> explain the main architecture patterns used here
> what are the key data models?
> how is authentication handled?

使用技巧：先宽泛提问建立整体认知，再聚焦具体模块；主动询问项目编码规范与专属术语，快速对齐团队协作标准。

二、高效定位与修复代码错误

遇到程序报错时，Claude Code 可快速定位问题根源、给出修复方案并直接完成代码修改，形成闭环排障流程。

  1. 向 Claude 同步错误信息与复现条件
> I'm seeing an error when I run npm test
  1. 请求针对性修复建议
> suggest a few ways to fix the @ts-ignore in user.ts
  1. 直接执行修复操作
> update user.ts to add the null check you suggested

使用技巧：提供完整报错堆栈、复现步骤，标注错误是否间歇性出现，提升问题定位准确率。

三、安全代码重构与优化

针对遗留代码、废弃API、老旧语法的重构任务，Claude Code 可在保证功能不变的前提下，完成现代化改造并验证兼容性。

  1. 识别待重构的老旧代码
> find deprecated API usage in our codebase
  1. 获取重构方案与优化思路
> suggest how to refactor utils.js to use modern JavaScript features
  1. 执行安全重构，保留原有行为
> refactor utils.js to use ES2024 features while maintaining the same behavior
  1. 验证重构结果，运行测试用例
> run tests for the refactored code

使用技巧：要求重构保持向后兼容，分小增量完成修改，避免大规模代码变更带来风险。

四、专项子代理使用工作流

子代理是 Claude Code 的专业化任务单元，可自动或手动委派专项任务，提升复杂场景处理效率。

  1. 查看可用子代理列表
> /agents
  1. 自动委派专项任务
> review my recent code changes for security issues
> run all tests and fix any failures
  1. 手动指定子代理处理任务
> use the code-reviewer subagent to check the auth module
> have the debugger subagent investigate why users can't log in
  1. 创建团队共享的自定义子代理
    执行 /agents 选择创建新子代理，配置标识、触发场景、可用工具与角色提示，配置文件存放于 .claude/agents/ 目录。
    使用技巧：限定子代理可用工具范围，用清晰描述字段实现自动委派，提升任务匹配精度。

五、计划模式：安全前置分析与规划

计划模式为只读权限，仅分析、调研并输出方案，不修改任何代码，适合复杂任务前置规划。

  1. 切换至计划模式
  • 会话内切换：按 Shift+Tab 循环至计划模式
  • 启动时指定：
claude --permission-mode plan
  1. 发起复杂任务规划请求
> I need to refactor our authentication system to use OAuth2. Create a detailed migration plan.
  1. 迭代细化方案
> What about backward compatibility?
> How should we handle database migration?
  1. 设置计划模式为默认
// .claude/settings.json
{
  "permissions": {
    "defaultMode": "plan"
  }
}

适用场景：多文件跨模块开发、代码库深度探索、架构调整规划等需要先设计后动手的场景。

六、自动化测试覆盖与验证

Claude Code 可匹配项目现有测试风格，自动生成测试用例、补充测试覆盖并完成测试执行。

  1. 定位未覆盖测试的代码
> find functions in NotificationsService.swift that are not covered by tests
  1. 生成基础测试框架
> add tests for the notification service
  1. 补充边界场景测试用例
> add test cases for edge conditions in the notification service
  1. 运行测试并修复失败用例
> run the new tests and fix any failures

使用技巧：明确指定测试框架与断言风格，要求覆盖异常场景、边界值，提升测试有效性。

七、拉取请求（PR）创建与完善

代码修改完成后，Claude Code 可自动生成规范PR描述，补充变更说明、测试信息与风险提示。

  1. 总结代码变更内容
> summarize the changes I've made to the authentication module
  1. 一键生成PR
> create a pr
  1. 完善PR描述与安全说明
> enhance the PR description with more context about the security improvements
> add information about how these changes were tested

使用技巧：提交前审查PR内容，要求标注潜在风险与兼容事项，符合团队代码合并规范。

八、代码文档生成与维护

自动为未注释代码生成规范文档，对齐项目文档标准，补充示例与上下文说明。

  1. 查找缺少文档的函数/模块
> find functions without proper JSDoc comments in the auth module
  1. 生成标准化文档注释
> add JSDoc comments to the undocumented functions in auth.js
  1. 优化文档内容与可读性
> improve the generated documentation with more context and examples
  1. 校验文档合规性
> check if the documentation follows our project standards

使用技巧：指定文档格式（JSDoc、docstrings），重点为公共API、复杂逻辑补充文档。

九、图像辅助开发工作流

支持图像输入与分析，可基于UI截图、架构图、报错截图生成代码或定位问题。

  1. 导入图像：拖拽、粘贴（Ctrl+V）或指定路径
> Analyze this image: /path/to/your/image.png
  1. 解析图像内容与UI元素
> Describe the UI elements in this screenshot
> What does this image show?
  1. 基于视觉内容生成代码
> Generate CSS to match this design mockup
> What HTML structure would recreate this component?

使用技巧：多图像配合使用，点击图像引用可快速查看原图，适合文本难以描述的视觉类需求。

十、高效文件引用与上下文注入

通过 @ 符号快速引入文件/目录，无需等待 Claude 主动读取，提升上下文传递效率。

  1. 引用单个文件，加载完整内容
> Explain the logic in @src/utils/auth.js
  1. 引用目录，查看结构清单
> What's the structure of @src/components?
  1. 引用MCP资源，获取外部数据
> Show me the data from @github:repos/owner/repo/issues

使用技巧：支持多文件同时引用，路径支持相对/绝对格式，自动加载 CLAUDE.md 补充上下文。

十一、扩展思考（思考模式）深度推理

思考模式为复杂任务分配专属推理令牌，支持分步推理、方案权衡与自我纠错，适合架构决策、疑难Bug排查。

  1. 快捷启用/关闭
  • macOS：Option+T；Windows/Linux：Alt+T
  • 单请求启用：
> ultrathink: design a caching layer for our API
  1. 查看思考过程：按 Ctrl+O 切换详细模式
  2. 全局默认配置：执行 /config 开启，保存至 ~/.claude/settings.json
  3. 自定义令牌预算：
export MAX_THINKING_TOKENS=1024

适用场景：复杂架构设计、多方案选型、边界场景分析、高难度故障定位。

十二、会话管理：恢复、命名与隔离

支持会话恢复、命名、分支隔离，适配多任务并行开发场景。

  1. 恢复最近会话
claude --continue
  1. 按名称恢复会话
claude --resume auth-refactor
  1. 命名当前会话
> /rename auth-refactor
  1. Git工作树隔离并行任务
# 创建独立工作树
git worktree add ../project-feature-a -b feature-a
# 隔离环境启动Claude Code
cd ../project-feature-a && claude

使用技巧：尽早命名会话，用工作树隔离不同任务，避免代码与上下文相互干扰。

十三、Unix风格集成与自定义命令

可集成至Shell脚本、CI/CD流水线，支持自定义斜杠命令，实现标准化自动化流程。

  1. 管道输入输出集成
cat build-error.txt | claude -p 'concisely explain the root cause' > output.txt
  1. 自定义输出格式
# 纯文本
cat code.py | claude -p 'analyze bugs' --output-format text
# JSON格式
cat code.py | claude -p 'analyze bugs' --output-format json
  1. 创建项目级自定义命令
mkdir -p .claude/commands
echo "Analyze performance and suggest optimizations:" > .claude/commands/optimize.md
  1. 使用自定义命令
> /optimize

使用技巧：将Claude Code集成至构建脚本做自动化审查，用参数占位符$ARGUMENTS提升命令灵活性。

十四、工作流通用最佳实践

  1. 权限匹配：敏感操作使用计划模式/默认询问模式，批量任务使用自动接受编辑模式
  2. 上下文精简：用@精准引用文件，避免冗余上下文加载
  3. 任务拆分：复杂工作分步骤执行，单次请求聚焦单一目标
  4. 安全合规：生产环境禁用无检查权限模式，关键操作保留人工审核
  5. 团队协同：共享子代理、自定义命令与CLAUDE.md规范，统一团队工作流

Claude Code的工作流覆盖代码理解、开发、调试、优化、交付全流程，通过标准化操作与灵活配置，可大幅提升AI辅助开发的效率与安全性，适配个人开发与团队协作的各类场景。