01 它是干嘛的
Claude Code 是把 Claude 从「聊天窗口」搬进「真实项目」的工具。它不只是给建议，而是真的能打开你的代码库、修改文件、执行命令、跑测试，然后根据结果继续修。它解决的痛点是：过去所有 AI 代码助手都只能「说」，真正落笔还要人复制粘贴。
02 为什么会有它
在它出现之前：AI 只能给建议，动手全是你自己
早期的 AI 编程助手，本质是一个更好的搜索加自动补全。你问它「这个函数怎么写」，它给你一段代码；但复制到文件、改哪个位置、跑起来报不报错、报错之后怎么办——全都得你自己干。AI 给的答案对不对，你不跑一遍根本不知道。
真正折磨人的是「来回搬运」。你想让它帮忙改一个跨了好几个文件的功能，就得自己把相关代码一段段复制进聊天框，它改完再一段段复制回去。代码一多，聊天框里塞不下，它就开始胡猜，你越用越烦。
Claude Code 换了个姿势：AI 不再是坐在对面的顾问，而是可以上手干活的同事。它能自己读文件、自己搜索代码、自己改、自己跑测试，再把结果读回来继续修，直到把活干完或明确告诉你它卡在哪。你要做的是提需求、看它干了什么、点头或叫停，而不是搬运代码。
03 它怎么工作
Claude Code 的核心是一个循环：观察当前状态，决定下一步动作，执行动作，再观察结果，周而复始。它手上握着一组「工具」——读文件、写文件、执行命令，循环就是把工具一次次串起来用。
一个编程代理是怎样「读代码—改文件—跑测试—再改」闭环的
- 1① 读懂代码库
它先扫描项目结构、读取相关文件，搞清楚这个项目是干什么的、逻辑写在哪，而不是凭空想下笔。
- 2② 制定改动计划
根据你的需求拆出要改哪几个文件、分几步做，必要时先跟你确认方案再动手。
- 3③ 修改文件
它直接编辑真实的代码文件，而不是只把代码打印在屏幕上让你自己复制。
- 4④ 运行测试与命令
改完就跑测试、跑构建、跑类型检查，看这段代码到底能不能工作。
- 5⑤ 读取报错并自我修正
若测试失败，它把报错读回来，分析原因、再改一轮，如此循环直到通过。
- 6⑥ 汇报结果，交你审阅
最后它总结改了什么、验证到什么程度，由你来决定是否合并，人始终握着最终决定权。
04 谁在用它
描述需求后让它自己找相关代码、动手实现并补测试，你负责审阅。
重构、改命名、升级依赖这类牵一发动全身的活，让它一次性处理完。
把复现步骤和报错给它，让它定位、修复并跑测试验证，省去大量排查时间。
让它先读一遍项目并讲清楚结构、数据怎么流动，帮你快速上手。
让它为已有函数补齐测试用例、整理出说明，枯燥活儿交出去。
05 怎么用
面向开发者，需要在本机装好命令行工具；最好配合版本管理工具使用，方便随时回看它改了什么。
- 01确认本机已安装 Node.js，然后按官方文档执行安装命令。
- 02在项目根目录启动它，首次使用按提示登录并授权。
- 03用自然语言描述需求，例如「给登录接口加上失败次数限制，并补测试」。
- 04让它先出计划，确认方向没问题再让它动手，避免方向跑偏。
- 05它改完后看它跑测试的结果，再自己打开改动逐处复核。
- 06把满意的改动提交到版本库；不满意就回退，重新描述需求让它再来一遍。
# 1. 安装命令行工具（需要本机已装 Node.js）
npm install -g @anthropic-ai/claude-code
# 2. 进入你的项目目录
cd my-project
# 3. 启动，按提示登录授权
claude
# 4. 直接说需求，例如：
# 「为 utils 里的日期函数补上单元测试，并且跑通」
避坑提示
- !务必先提交一次代码再让它动手，出问题才能一键回退，这是最基本的保险。
- !先让它讲计划、你点头再执行；一上来就让它大改，很容易越改越乱。
- !涉及生产数据库、线上部署的命令要盯紧，授权前看清它到底要执行什么。
06 关键概念
- 代理（Agent）
- 能把「想—做—看结果」串成循环、自主多步完成任务，而不是只回答一句就结束的 AI。
- 工具调用
- 代理真正动手的方式：读文件、改文件、执行命令，都是通过调用一个个具体工具完成的。
- 闭环
- 做完一步就检查结果、再决定下一步，而不是一路猜到黑，这是它区别于普通补全的地方。
- 命令行（终端）
- 开发者输入命令的黑色窗口，Claude Code 就住在这里，能直接接触你的项目文件。