Claude Code 常见工作流简介

深入解析 Claude Code 命令行工具，涵盖代码理解、Bug 修复、计划模式、子代理及 Unix 集成等核心工作流，助你打造 AI 驱动的高效终端开发体验。

概述

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

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

1. 基础环境与代码库理解

在项目开始前，快速熟悉代码库结构和设计模式是首要任务，核心操作流程如下：

1.1 启动交互环境

进入项目根目录，执行启动命令激活 Claude Code 交互环境：

claude

启动后，Claude 会自动索引项目文件，终端将显示如下界面：

1.2 代码库快速认知

• 初次接触代码库时，可直接请求高层级概览，Claude 会分析目录结构、核心配置文件和文档，总结项目用途、技术栈及模块划分；

• 可进一步询问特定架构模式，例如身份验证处理方式、核心数据模型位置、业务逻辑执行流等；

• 寻找特定功能相关代码时，直接描述功能即可，Claude 会提供相关文件列表及协作关系，复杂调用链路可要求追踪从前端输入到数据库持久化的完整流程。

2. 缺陷修复与代码重构

2.1 Bug 修复流程

核心在于提供充分上下文，高效定位并解决问题：

# 同步错误信息并请求修复
claude -p "I'm seeing an error when I run npm test, please help me fix it"

• Claude 会分析报错信息，主动运行诊断命令获取堆栈追踪；

• 定位问题后提供多种修复方案，可选择最优方案；

• 针对临时规避方案（如 @ts-ignore），可要求提供规范的类型定义建议；

• 确认方案后，Claude 能直接修改文件并应用更改，形成“诊断-建议-应用”闭环。

2.2 代码重构技巧

• Claude 擅长识别陈旧 API 调用或过时编程范式，可搜索代码库中的过时用法并生成详细重构计划；

• 示例场景：将旧 JavaScript 工具类升级为 ES2024 标准语法；

• 重构时要求 Claude 解释新方案优势，以可测试的小步骤逐步实施，确保每一步更改安全；

• 利用内置测试工具验证重构后逻辑与原行为一致。

3. 计划模式与安全操作

3.1 计划模式（Plan Mode）

大规模重构或复杂功能实现前，可启用计划模式降低风险，该模式为只读分析状态，仅探索代码库、设计方案，不修改文件。

3.1.1 启动方式

# 启动时直接指定计划模式
claude --permission-mode plan

启动后终端提示：

3.1.2 核心价值

• 详细分析现有实现，创建全面的迁移或修改计划；

• 可针对向后兼容性、数据库迁移等细节反复追问完善；

• 方案逻辑自洽后，再切换回正常模式执行操作。

3.2 权限模式对比

模式	标识符	行为特征	适用场景
Normal	normal	每次修改文件或执行命令需手动确认	日常开发与精准控制
Auto-Accept	accept edits on	自动应用文件更改，无需逐一确认	批量处理、已知安全的重构
Plan Mode	plan mode on	只读模式，仅分析不修改文件	架构分析、方案设计、安全审计

模式切换

会话过程中，可通过 Shift+Tab 快捷键在三种模式间循环切换。

4. 自动化测试与质量保障

Claude Code 在测试驱动开发中表现出色，核心能力如下：

4.1 测试用例生成

# 为未覆盖测试的函数补充边界条件测试用例
claude -p "find functions in NotificationsService.swift that are not covered by tests and add test cases for edge conditions"

• 自动适配项目现有测试框架、断言风格和模拟（Mock）习惯；

• 主动识别未覆盖的代码路径，聚焦边界条件和异常场景（网络超时、非法输入、并发冲突等）。

4.2 测试执行与修复

• 完成测试编写后，可直接让 Claude 运行测试；

• 自动修复测试过程中发现的失败项，形成即时反馈循环，保证新增代码健壮性。

5. 任务委派与专用子代理

5.1 子代理（Subagents）核心概念

子代理是针对特定领域优化的 AI 实例，可处理安全审计、API 设计、深度调试等专项任务，提升复杂任务处理效率。

5.2 子代理管理操作

# 查看或创建新的子代理
/agents

• 日常工作中，Claude 会根据任务需求自动委派子代理（如安全漏洞审查时启动安全代理）；

• 可显式调用特定代理（如 code-reviewer 代理审查认证模块）。

5.3 自定义子代理

团队可创建符合自身工作流的自定义代理，配置目录：/.claude/agents/，配置需包含：

• 唯一标识符；

• 工具访问权限；

• 系统提示词。

通过自定义代理可将团队最佳实践硬编码到 AI 行为逻辑，实现高度定制化辅助开发。

6. 视觉交互与文件引用

6.1 多模态交互（图片支持）

Claude Code 支持图片解析，可通过拖拽、粘贴或路径引用方式引入图片：

# 分析数据库架构图并提供修改建议
claude -p "Analyze this database schema image and suggest how to modify it for the new feature: @docs/schema.png"

适用场景：

• 描述 UI 截图中的元素；

• 根据设计稿生成 CSS 代码；

• 基于架构图提出表结构调整建议。

6.2 本地文件快速引用

• 使用 @ 符号可快速引用本地文件或目录；

• 引用单个文件：完整内容加入上下文；

• 引用目录：提供文件列表；

• 优势：比 Claude 自动搜索更高效，尤其已知问题源头时。

7. 深度思考与 Token 预算

7.1 扩展思考模式（Extended Thinking）

针对复杂架构决策或深层次 Bug 分析，可启用扩展思考模式，允许模型在输出最终答案前进行多步骤内部推理。

7.2 思考模式配置方式

配置方式	操作命令或变量	效果说明
全局默认开启	会话中使用 /config 切换	所有请求默认分配思考预算
单次请求开启	关键词 ultrathink:	仅为当前任务分配思考预算
环境变量覆盖	export MAX_THINKING_TOKENS=1024	强制限制所有请求的思考 Token 数

7.3 模式特点

• 开启后最多可使用 31,999 个 Token 进行内部推理；

• 详细模式下（Ctrl+O 开启）可查看推理过程（灰色斜体字）；

• 优势：提升高难度问题处理成功率，支持探索多方案、自我修正错误、评估权衡利弊；

• 注意：消耗更多 Token 并增加成本。

8. 会话持久化与环境管理

8.1 会话历史管理

• 自动保存所有对话历史，使用 /resume 命令打开交互式会话选择器；

• 建议使用 /rename 为会话赋予辨识度名称，便于查找；

• 会话选择器显示：最后活动时间、消息数量、相关 Git 分支；

• 快速恢复最近对话：claude --continue。

8.2 并行开发环境配置

结合 Git worktrees 实现多任务并行开发：

1. 通过 git worktree add 创建独立开发环境；

2. 在不同终端窗口运行多个 Claude 实例；

3. 优势：每个 worktree 有独立文件状态，实例间无干扰，适配并行开发场景。

9. Unix 风格的系统集成

Claude Code 可作为类 Unix 工具集成到现有流水线，支持管道符、结构化输出等特性。

9.1 管道符使用示例

# 分析构建错误并输出原因到文件
cat build-error.txt | claude -p 'concisely explain the root cause' > explanation.txt

9.2 输出格式控制

通过 --output-format 参数指定输出格式：

• 纯文本；

• JSON（含对话日志、成本、持续时间等元数据，适配自动化脚本）；

• 流式 JSON。

9.3 自定义 Slash 命令

封装常用 Prompt 为自定义命令，配置目录：/.claude/commands/，规则如下：

1. 创建 Markdown 文件，文件名即为命令名；

2. Prompt 中可包含 $ARGUMENTS 占位符，执行时传入参数自动替换；

3. 优势：实现常用操作复用，提升效率。