Claude Code 实战方法论

文章目录

[Claude Code 实战方法论](#Claude Code 实战方法论)
- [一、Claude Code 是什么？](#一、Claude Code 是什么？)
- - [1.1 一句话定位](#1.1 一句话定位)
  - [1.2 Claude Code 能做什么？](#1.2 Claude Code 能做什么？)
- 二、核心工作流
- - [2.1 日常对话模式](#2.1 日常对话模式)
  - [2.2 任务执行模式](#2.2 任务执行模式)
  - [2.3 三种启动方式](#2.3 三种启动方式)
- 三、高效使用技巧
- - [3.1 任务描述法（核心技巧）](#3.1 任务描述法（核心技巧）)
  - [3.2 拆解大任务](#3.2 拆解大任务)
  - [3.3 指定角色/背景](#3.3 指定角色/背景)
- 四、工具使用指南
- - [4.1 Claude Code 内置工具](#4.1 Claude Code 内置工具)
  - [4.2 工具调用示例](#4.2 工具调用示例)
  - [4.3 工具链组合](#4.3 工具链组合)
- [五、Claude Code 的"思考"机制](#五、Claude Code 的"思考"机制)
- - [5.1 它会自己规划](#5.1 它会自己规划)
  - [5.2 它的自我纠错](#5.2 它的自我纠错)
  - [5.3 你可以强制它思考](#5.3 你可以强制它思考)
- 六、上下文管理
- - [6.1 上下文窗口](#6.1 上下文窗口)
  - [6.2 保持上下文清晰](#6.2 保持上下文清晰)
  - [6.3 上下文恢复](#6.3 上下文恢复)
- 七、实战场景
- - 场景1：接手新项目
  - 场景2：写新功能
  - 场景3：代码审查
  - 场景4：调试问题
- 八、常见问题
- - [Q1：Claude Code 和普通对话有什么区别？](#Q1：Claude Code 和普通对话有什么区别？)
  - Q2：它会不会改错我的代码？
  - Q3：上下文满了怎么办？
  - Q4：运行危险命令会怎样？
- 九、黄金法则
- - 法则1：说清楚，不要让它猜
  - 法则2：给背景，别当搜索引擎用
  - 法则3：大任务拆开说
  - 法则4：重要信息让它记住
- 十、你的下一步
- 附录：常用命令
- 附录：工具速查

把 Claude Code 用出价值，榨干它的能力 ------ Claude Code 学习方法论·第二篇

一、Claude Code 是什么？

1.1 一句话定位

Claude Code = 会思考的超级程序员 + 能执行命令的打工仔

复制代码

Claude Code = Claude（大脑）+ 工具集（手脚）
              ↓
      能读代码 → 能写代码 → 能跑代码 → 能改代码

1.2 Claude Code 能做什么？

能力	说明
📖 读代码	理解项目结构、读懂代码逻辑
✍️ 写代码	生成新代码、补充注释
🔧 改代码	重构、修复bug、优化性能
🎯 做任务	拆解需求、自动执行多步骤任务
🔍 搜索	在项目中搜索关键词、定位文件
💬 解释	用人话解释代码在干什么

二、核心工作流

2.1 日常对话模式

最基础的用法：直接说你想干什么

复制代码

你：帮我看看这个login函数有什么问题
Claude：读取文件 → 分析 → 给出结论

你：帮我写一个用户注册接口
Claude：生成代码 → 等待确认 → 写入文件

你：帮我解释这段代码
Claude：读取 → 理解 → 用人话解释

2.2 任务执行模式

Claude Code 最强大的地方：自动拆解并执行多步骤任务

复制代码

你：帮我把项目从 Java 8 升级到 Java 17

Claude 自动执行：
  1. 📋 分析项目结构（pom.xml / build.gradle）
  2. 🔍 检查依赖兼容性
  3. 📝 列出需要修改的地方
  4. ✏️ 逐个修改文件
  5. ✅ 验证修改

2.3 三种启动方式

方式1：直接运行（当前你的模式）

bash 复制代码

claude

启动后直接对话，当前Session会话

方式2：对指定文件/文件夹启动

bash 复制代码

claude [文件路径]
claude [文件夹路径]

直接带着上下文启动

方式3：后台模式

bash 复制代码

claude &

在后台运行，不阻塞终端

三、高效使用技巧

3.1 任务描述法（核心技巧）

❌ 低效说法：

复制代码

帮我看看这个代码

✅ 高效说法：

复制代码

帮我看看 /Users/xx/project/src/main/java/UserService.java
这个方法主要做什么？有没有潜在的线程安全问题？

好任务的公式：

复制代码

目标 + 文件路径 + 具体要求

3.2 拆解大任务

❌ 一次说太多：

复制代码

帮我重构整个项目

Claude 可能漏掉细节，或者上下文爆炸

✅ 分步骤说：

复制代码

第一步：先帮我了解项目结构
第二步：帮我找到所有用到 JDBC 的地方
第三步：把这些地方改成用 MyBatis
第四步：逐个文件帮我修改

3.3 指定角色/背景

复制代码

❌：帮我写个接口

✅：你是一个有10年经验的Java后端工程师，
    帮我写一个用户登录接口：
    - 使用 Spring Boot
    - 返回 JWT token
    - 要考虑安全性（密码加密、防SQL注入）

四、工具使用指南

4.1 Claude Code 内置工具

工具	能做什么
Read	读取文件内容
Edit	修改文件（精确替换）
Write	创建新文件或覆盖
Bash	执行终端命令
Glob	按模式搜索文件
Grep	在文件中搜索关键词
WebFetch	获取网页内容

4.2 工具调用示例

让 Claude 读取文件：

复制代码

帮我看看这个文件的内容：src/main/java/Controller.java

让 Claude 执行命令：

复制代码

帮我运行 mvn test 看看测试是否通过

让 Claude 搜索：

复制代码

帮我找到所有包含 "TODO" 的文件

4.3 工具链组合

复制代码

写代码 → 运行测试 → 看结果 → 修bug → 再运行 → ...
        ↑ 循环直到完成

示例：修复bug的完整流程

复制代码

1. 你：帮我修一下登录bug，用户名admin登录失败
2. Claude：读取登录相关代码
3. Claude：运行程序复现问题
4. Claude：找到原因
5. Claude：Edit修改代码
6. Claude：再次运行验证

五、Claude Code 的"思考"机制

5.1 它会自己规划

当你给一个大任务时，Claude Code 会：

复制代码

1. 分析任务目标
2. 拆解成小步骤
3. 判断需要调用哪些工具
4. 按顺序执行
5. 检查结果
6. 如有问题自己纠正

5.2 它的自我纠错

复制代码

你：运行一下这个Python脚本

Claude：执行 python main.py
        ↓
        报错：缺少 requests 库
        ↓
        自动安装：pip install requests
        ↓
        再次运行
        ↓
        成功！返回结果

5.3 你可以强制它思考

复制代码

你：一步步思考，帮我分析这个算法的时间复杂度
     ↓
Claude 会输出它的推理过程，而不是直接给答案

六、上下文管理

6.1 上下文窗口

复制代码

Claude Code 有上下文上限（类似人的记忆容量）
- 短时间大量对话可能"忘记"之前的
- 重要信息要主动提醒它

6.2 保持上下文清晰

❌ 混乱的对话：

复制代码

你：帮我看看A文件
它：...
你：再看看B文件
它：...
你：刚才A文件那个问题怎么解决来着？

✅ 清晰的对话：

复制代码

你：帮我看看 /src/A.java 和 /src/B.java
     分析这两个文件的依赖关系，列出问题
它：分析完成...

6.3 上下文恢复

如果 Claude "忘记"了之前的内容：

复制代码

接着之前说的...
（重新描述背景）

七、实战场景

场景1：接手新项目

复制代码

你：帮我了解一下这个项目的结构，
    重点关注：
    1. 用的什么技术栈
    2. 核心业务逻辑在哪
    3. 有没有文档

Claude 会自动：

扫描项目结构
读取配置文件
分析代码组织
给你一份项目概览

场景2：写新功能

复制代码

你：我需要新增一个"用户头像上传"功能
    技术栈：Spring Boot + OSS
    要求：
    1. 图片大小限制5M
    2. 只允许 jpg/png
    3. 生成缩略图
    4. 返回URL
    帮我设计接口，然后写代码

Claude 会：

先设计接口
等你确认
再写代码
写入文件

场景3：代码审查

复制代码

你：帮我 review 一下这个 PR 的改动
    重点检查：
    1. 是否有潜在bug
    2. 是否有安全隐患
    3. 代码风格是否一致

场景4：调试问题

复制代码

你：用户反馈支付接口偶发性超时
    日志在 /var/logs/payment.log
    帮我分析可能的原因

八、常见问题

Q1：Claude Code 和普通对话有什么区别？

复制代码

普通对话：只返回文字
Claude Code：能实际操作文件、运行代码

Q2：它会不会改错我的代码？

复制代码

不会自动修改，会先问你
你可以设置让它：
- 自动修改（信任模式）
- 先确认再修改（默认）

Q3：上下文满了怎么办？

复制代码

Claude 会自动压缩历史
如果很重要，主动总结关键信息让它记住

Q4：运行危险命令会怎样？

复制代码

比如 rm -rf /
Claude 会：
1. 警告你这是危险操作
2. 询问确认
3. 你明确同意才会执行

九、黄金法则

法则1：说清楚，不要让它猜

复制代码

❌：帮我优化一下
✅：帮我优化这个排序算法的性能，目标是从O(n²)降到O(n log n)

法则2：给背景，别当搜索引擎用

复制代码

❌：这个错误是什么意思
✅：在 Spring Boot 项目中，用 Maven 构建，出现这个错误...

法则3：大任务拆开说

复制代码

❌：帮我重构整个登录模块
✅：先帮我看看登录模块有哪些文件 → 分析依赖 → 逐个重构

法则4：重要信息让它记住

复制代码

记住：我们的项目使用 Java 11 + Spring Boot 2.7 + MySQL 8.0

十、你的下一步

复制代码

当前位置：会用了 ✓

下一步（文档3）：
  把 Claude Code 整合到 IDE
  - 安装 Claude for IDE 插件
  - 在 IntelliJ IDEA 中直接用
  - 代码补全、代码解释、代码审查

附录：常用命令

命令	说明
`/help`	查看帮助
`/clear`	清除对话历史
`exit`	退出 Claude Code
`Ctrl+C`	取消当前操作

附录：工具速查

你说	Claude 实际做
"看看这个文件"	Read 工具读取
"帮我写..."	Write 工具创建
"帮我修改..."	Edit 工具替换
"运行一下..."	Bash 执行命令
"搜索xxx"	Grep 全文搜索
"有哪些文件"	Glob 模式匹配

记住这句话

Claude Code 不是搜索引擎，是一个能读、能想、能做 的智能助手

把它当成一个24小时不睡觉的程序员搭档

（文档2·完）后续更新文档3：Claude Code 整合到 IDE