{
  "slug": "claude-code-guide",
  "url": "https://kelewrites.com/posts/claude-code-guide/",
  "title": "Claude Code 上手指南：把它当员工，而不是当插件",
  "subtitle": "从「会聊天的 AI」到「会动手的 Agent」，决定上手快慢的不是命令，是认知",
  "summary": "Claude Code 的本质不是代码补全插件，而是住在终端里、能自己读项目、改文件、调工具的 Agent。真正用好它，靠的不是记命令，而是三件事：把它当一个会动手的助手来理解、按场景类型派活、用拆解与版本控制约束它的不确定性。",
  "date": "2026-06-10",
  "updated": "",
  "tags": [
    "AI",
    "Agent",
    "工程方法"
  ],
  "series": "",
  "source": {
    "title": "Claude Code 保姆级教程：从入门到精通",
    "url": "https://www.bilibili.com/video/BV1bLEE6SEyE/"
  },
  "ai": {
    "summary": "Claude Code 的本质不是代码补全插件，而是住在终端里、能自己读项目、改文件、调工具的 Agent。真正用好它，靠的不是记命令，而是三件事：把它当一个会动手的助手来理解、按场景类型派活、用拆解与版本控制约束它的不确定性。",
    "takeaways": [
      "Claude Code 的本质不是代码补全插件，而是住在终端里、能自己读项目、改文件、调工具的 Agent。真正用好它，靠的不是记命令，而是三件事：把它当一个会动手的助手来理解、按场景类型派活、用拆解与版本控制约束它的不确定性。",
      "一、是什么：它不是补全插件，是终端里会动手的助手",
      "二、能干什么：五个企业案例，提炼成四类能力模式",
      "三、怎么用好：从十一条技巧里，提炼四条心法"
    ],
    "audience": [
      "正在做 AI Agent / 工程实践的工程师",
      "关心工程落地与系统设计的人"
    ],
    "quote": "一句话总结：Claude Code 不是「会补全的插件」，而是住在终端里、能自己读项目、改文件、调外部工具的 Agent——用好它的关键不在记命令，而在把它当一个会动手的助手来理解、派活和约束。",
    "questions": [
      "这篇文章的核心结论是什么？",
      "它不是补全插件，是终端里会动手的助手是什么意思？",
      "能干什么：五个企业案例，提炼成四类能力模式到底讲了什么？",
      "怎么用好：从十一条技巧里，提炼四条心法？"
    ],
    "citation": {
      "title": "Claude Code 上手指南：把它当员工，而不是当插件",
      "conclusion": "Claude Code 的本质不是代码补全插件，而是住在终端里、能自己读项目、改文件、调工具的 Agent。真正用好它，靠的不是记命令，而是三件事：把它当一个会动手的助手来理解、按场景类型派活、用拆解与版本控制约束它的不确定性。",
      "points": [
        "一、是什么：它不是补全插件，是终端里会动手的助手",
        "二、能干什么：五个企业案例，提炼成四类能力模式",
        "三、怎么用好：从十一条技巧里，提炼四条心法"
      ],
      "quote": "一句话总结：Claude Code 不是「会补全的插件」，而是住在终端里、能自己读项目、改文件、调外部工具的 Agent——用好它的关键不在记命令，而在把它当一个会动手的助手来理解、派活和约束。",
      "url": "https://kelewrites.com/posts/claude-code-guide/",
      "attribution": "kele · Article Share"
    }
  },
  "headings": [
    {
      "depth": 2,
      "text": "开场"
    },
    {
      "depth": 2,
      "text": "金字塔总览"
    },
    {
      "depth": 2,
      "text": "一、是什么：它不是补全插件，是终端里会动手的助手"
    },
    {
      "depth": 3,
      "text": "1.1 和普通 AI 对话的根本差别：会动手"
    },
    {
      "depth": 3,
      "text": "1.2 三种模式：本质是「你给它多少控制权」的旋钮"
    },
    {
      "depth": 2,
      "text": "二、能干什么：五个企业案例，提炼成四类能力模式"
    },
    {
      "depth": 3,
      "text": "2.1 端到端改代码：从读懂到改完，不只是给片段"
    },
    {
      "depth": 3,
      "text": "2.2 异步并行：开多个会话，让低产出时间变高产出"
    },
    {
      "depth": 3,
      "text": "2.3 外接工具闭环：用 MCP 把「眼睛」和「手」接上"
    },
    {
      "depth": 3,
      "text": "2.4 啃陌生项目：拿到开源代码，先扫安全再画架构"
    },
    {
      "depth": 2,
      "text": "三、怎么用好：从十一条技巧里，提炼四条心法"
    },
    {
      "depth": 3,
      "text": "3.1 拆小 + 版本控制：这是生命线"
    },
    {
      "depth": 3,
      "text": "3.2 上下文卫生：及时 clean，别让它「越想越乱」"
    },
    {
      "depth": 3,
      "text": "3.3 需求文档 + 记忆文件：把规则一次性喂给它"
    },
    {
      "depth": 3,
      "text": "3.4 人机分工与审查：别指望它写出 100% 完美的代码"
    },
    {
      "depth": 2,
      "text": "一页速览"
    },
    {
      "depth": 2,
      "text": "一句话收束"
    }
  ],
  "text": "> **一句话总结**：Claude Code 不是「会补全的插件」，而是住在终端里、能自己读项目、改文件、调外部工具的 **Agent**——用好它的关键不在记命令，而在把它当一个会动手的助手来理解、派活和约束。\n\n---\n\n## 开场\n\n最近 Claude Code 很火。很多人冲着「写代码效率翻三倍、少加一半班」来，结果第一关就被劝退：官网全是英文，命令一长串，跟着零散教程装了半天，还是不知道它到底比平时用的 ChatGPT、DeepSeek 强在哪。\n\n于是大多数人把它当成了「一个新的代码补全工具」——和 IDE 里的自动补全、网页版 AI 对话归成一类。**这恰恰是用不好它的根源**。把一个能自己干活的 Agent 当成补全插件来使，就像请了个能进厨房的厨师，却只让他在门口报菜名。\n\n那么 Claude Code 到底是什么？它能替你干哪些活？以及——怎么用才不会把它用废？\n\n答案是一句话：**Claude Code 是终端里的一个 Agent（能自主调用工具、改文件、完成多步任务的智能体），用好它靠的是认知，不是命令**。下面分三层展开。\n\n---\n\n## 金字塔总览\n\n---\n\n## 一、是什么：它不是补全插件，是终端里会动手的助手\n\n### 1.1 和普通 AI 对话的根本差别：会动手\n\n网页版的 ChatGPT、DeepSeek 再聪明，本质都是「隔着电话的远程顾问」——你描述问题，它给建议，代码要你自己复制粘贴回项目。Claude Code 不一样，它是「坐在你旁边的助手」：能自己翻你的文件夹、读整个项目、动手改代码、跑命令。\n\n差别可以从五个维度看清楚：\n\n| 维度 | 普通 AI 对话 | Claude Code |\n\n| 交互 | 复制粘贴来回搬运 | 直接在项目里操作 |\n| 上下文 | 你说什么它才知道什么 | 自动读取整个项目代码 |\n| 执行力 | 只给代码片段 | 创建文件、改代码、跑测试 |\n| 记忆 | 关掉就忘 | 靠配置文件记住项目规则与你的偏好 |\n| 工具 | 基本调不动外部工具 | 通过 MCP 接浏览器、数据库、GitHub |\n\n这里出现了两个术语，先点透：**终端（Terminal）** 就是那个敲命令的黑框，Claude Code 主要活在这里；**MCP（Model Context Protocol）** 是一套让 AI 标准化地接外部工具/服务的协议，有了它，AI 才能去开浏览器、查数据库，而不只是「嘴上说说」。\n\n### 1.2 三种模式：本质是「你给它多少控制权」的旋钮\n\nClaude Code 有三种工作模式（用 `Shift+Tab` 切换），别被名字绕住，它们其实是同一根旋钮的三档——**你愿意放多少权给它**：\n\n| 模式 | 行为 | 适合场景 |\n\n| 默认模式 | 每次改文件都先问你 | 重要代码、需要逐步把关 |\n| 自动模式 | 一次授权，后续自动改 | 信得过的小任务、追求流畅 |\n| 计划模式 | 只讨论、不碰文件 | 复杂需求，先聊清楚再动手 |\n\n复杂业务一上来就让它写，十有八九跑偏。正确姿势是先用**计划模式**把方案聊到位，确认方向无误，再切到能动手的模式去执行。\n\n> **金句**：把 Claude Code 当**会动手的助手**，而不是会补全的插件——认知一变，用法全变。\n\n---\n\n## 二、能干什么：五个企业案例，提炼成四类能力模式\n\n教程里演示了五个企业实战案例。但逐个复述案例没意义——重要的是看穿它们背后是**四类可复用的能力模式**。看懂了类型，你就知道手上的活该不该派给它。\n\n### 2.1 端到端改代码：从读懂到改完，不只是给片段\n\n在一个二十万行规模的前后端项目里，给某个类批量加中文注释、给「操作日志」加一个导入功能——它会先**读一遍相关代码**（像人一样先理解再动手），定位到 Controller，再顺藤摸瓜把关联的 Service、Mapper 一起补上。\n\n更有意思的是它会**带着业务判断**干活：加导入功能时发现日志「只增不改」的特性，它主动建议去掉更新逻辑，而不是机械照办。原本预估三到五天的改造，核心编码几小时就能完成大半，人只补最后那 10% 的边缘情况。\n\n### 2.2 异步并行：开多个会话，让低产出时间变高产出\n\n它能在后台持续干活，你只需偶尔瞄一眼进度、给个方向性指导。教程里的场景是开会——开一个会话整理需求文档、记录讨论纪要，同时另开一个会话照着需求文档把页面 demo 做出来。会一散，demo 也好了。**把原本零产出的开会时间，折叠成了开发时间**。\n\n### 2.3 外接工具闭环：用 MCP 把「眼睛」和「手」接上\n\n接上 Playwright（一个浏览器自动化测试框架）的 MCP 后，Claude Code 能真的打开浏览器、对页面截图、抓取内容、做分析。这就把它从「只会写」升级成「能看、能测、能改、能验证」的闭环：复现问题 → 收集日志 → 分析原因 → 修复 → 回归验证，一气呵成。MCP 在这里的角色，就是给 Agent 装上了眼睛和手。\n\n### 2.4 啃陌生项目：拿到开源代码，先扫安全再画架构\n\n面对一个不熟的开源项目，它能先做**安全扫描**（揪出硬编码密钥、弱密码、依赖漏洞，出一份分高/中/低风险的报告），再做**架构分析**（画模块图、标关键路径、识别扩展点），最后才在看懂的基础上加新功能。陌生代码库最贵的是「读懂」这一步，而这正是它的强项。\n\n把四类模式归在一起，它能干的活有了清晰边界：\n\n| 能力模式 | 本质 | 一句话场景 |\n\n| 端到端改代码 | 读懂 → 改完 → 自我修正 | 中大型项目的功能改造 |\n| 异步并行 | 多会话后台干活 | 开会/等待时间里顺手出活 |\n| 外接工具闭环 | MCP 接眼睛和手 | 自动化测试、网页抓取 |\n| 啃陌生项目 | 先理解再下手 | 开源项目二次开发 |\n\n> **金句**：别按案例记用法，**按能力类型派活**——看清它擅长「读懂和动手」，你就知道哪些活该交给它。\n\n---\n\n## 三、怎么用好：从十一条技巧里，提炼四条心法\n\n教程给了十一个技巧，但流水账记不住。它们其实指向同一件事——**Agent 强但不稳，你的工作就是给它的不确定性套上缰绳**。压成四条心法：\n\n### 3.1 拆小 + 版本控制：这是生命线\n\n最容易翻车的动作，就是「一次让它干太多」——任务一大，token 超限、网络丢包、思路跑偏全来了，多开几个并行会话时尤其明显。所以：**任务拆细，每完成一个小功能就提交一次**，为每个功能开独立分支、给重要版本打标签。\n\n版本控制不是洁癖，是安全网：AI 一旦把代码改坏，你能一键回滚到上一个稳定版本，而不是和它在一个死胡同里耗到天黑。\n\n### 3.2 上下文卫生：及时 clean，别让它「越想越乱」\n\n**上下文**就是 AI 当前对话里记着的所有信息。窗口越塞越满，它就越容易混淆概念、答非所问。所以一旦完成一个独立任务、要切换到不相关的新任务、或者发现它开始「胡说八道」，就果断 `clean` 清掉当前会话。\n\n这也是治「AI 幻觉」的良方：当它对同一个问题给出的方案越来越复杂、怎么试都报错时，往往是它陷进了死循环——清空重来，比硬掰快得多。\n\n### 3.3 需求文档 + 记忆文件：把规则一次性喂给它\n\n两份文件能显著提升成功率：\n**需求文档**：动手前先让它写一份产品规格说明书（功能描述、输入输出、技术架构、实施步骤），编码时让它对照着做。好文档是成功的一半。\n**记忆文件**（`CLAUDE.md`）：把代码规范、Git 工作流、命名约定、个人偏好、甚至「全程用中文」都写进去。它每次加载都会读，生成的代码自然贴合你的风格——这就是 1.1 里说的「记忆」靠什么实现。\n\n### 3.4 人机分工与审查：别指望它写出 100% 完美的代码\n\n合理的期望换来更好的体验。它擅长样板代码、CRUD、测试用例、文档、重构；不擅长复杂业务逻辑、像素级 UI 调整、架构级决策——这些仍需人来定夺。\n\n落到流程上，做一个三层审查：**功能验证（跑起来对不对）→ AI 自审（让它挑性能与重复）→ 人工审核（把关业务正确性、安全性、架构合理性）**，人工那一层占的精力最多，也最不能省。\n\n至于「免授权模式」（`--dangerously-skip-permissions`）虽然爽、接近全自动，但它可能在你没预期的文件里乱改——**只在个人项目、且有 Git 备份时用**，重要项目老老实实手动确认。\n\n> **金句**：Agent 强但不稳，你的活就是**拆小、留痕、定规矩、做审查**——给不确定性套上缰绳。\n\n---\n\n## 一页速览\n\n| 层级 | 内容 | 一句话核心 |\n\n| **核心结论** | Claude Code = 终端里的 Agent | 不是补全插件，是会动手的助手 |\n| **主论点一** | 是什么 | 会自己读项目、改文件、调工具 |\n| 1.1 | 与普通 AI 的差别 | 顾问 vs 坐你旁边的助手 |\n| 1.2 | 三种模式 | 控制权旋钮：默认/自动/计划 |\n| **主论点二** | 能干什么 | 五案例提炼成四类能力模式 |\n| 2.1 | 端到端改代码 | 读懂→改完→自我修正 |\n| 2.2 | 异步并行 | 多开会话，折叠低产出时间 |\n| 2.3 | 外接工具闭环 | MCP 接上眼睛和手 |\n| 2.4 | 啃陌生项目 | 先扫安全再画架构 |\n| **主论点三** | 怎么用好 | 给不确定性套缰绳 |\n| 3.1 | 拆小+版本控制 | 小步提交，可回滚 |\n| 3.2 | 上下文卫生 | 及时 clean，治幻觉 |\n| 3.3 | 需求文档+记忆文件 | 规则一次性喂给它 |\n| 3.4 | 人机分工与审查 | 别指望 100% 完美 |\n\n---\n\n## 一句话收束\n\n> **把 AI 当员工，而不是当插件——你越懂得派活和约束，它就越像个能扛事的人。**"
}