Claude 是什么

不是会写代码的聊天框，而是能读项目、动手改、跑命令验证的编码代理。这一节说清它和网页对话的差别、五种入口与第一单怎么写。

先给一个准确的说法

把 Claude Code 想成一个能读你项目、也能动手改的同事，比把它当成「会写代码的聊天框」更接近事实。它是 Anthropic 推出的编码代理，底层是通用语言模型；接上文件访问、命令执行和开发工具之后，才具备独立推进任务的能力。

你要提供的是目标与边界，不是一段贴来贴去的代码。

在网页里让 AI 帮忙改代码，流程通常是：复制片段，得到新片段，粘回编辑器，发现上下文缺了一段，再重来。它看不到你的目录，也不知道测试怎么跑。

编码代理换了顺序：它按需读取仓库文件，理解模块之间怎么调用，直接写入修改，再执行命令验证。你在差异视图里逐处确认，而不是搬运文本。

驱动这一差别的是循环：读文件、计划、修改、执行，再根据结果回到上一步。这个循环就是 Agent 的工作方式，区别只在于它的工具是文件和终端，背后是工具调用在起作用。也因此「能跑命令」比「能写代码」更关键——测试失败、类型报错、构建日志都是它下一轮的输入，没有这些反馈它只能猜。

这也是权限设置重要的原因：删除文件、推送代码、安装依赖，都应该先问你。把确认点设在你真正在意的地方，剩下的交给它跑。

同一套能力可以从不同地方进入：终端命令行、VS Code 扩展、独立桌面应用、浏览器页面、JetBrains 插件。界面不同，底层是同一套引擎，项目说明、配置和外部工具连接在几处通用。

怎么选？习惯命令行的用终端，它最适合批处理和自动化；需要看图形差异、同时开几个会话的，用桌面应用；不想装东西、临时试一次的，用网页版。换入口前先确认两件事：账号在该入口是否有权限，计费走个人订阅还是团队控制台。

安装方式和系统要求会变，别照抄旧教程，按官方文档当前的说明走。装好后在项目根目录启动，第一次会让你登录或配置凭据。多数入口需要订阅或控制台账户，部分入口还支持第三方云服务商，具体以官方当前说明为准。

按「交付物是否明确」来挑，成功率最高：给没有测试的模块补单元测试并跑通；按报错信息追根因、跨文件改完再验证；整理提交，分组暂存、写提交信息、开分支；批量迁移，把旧写法的调用统一换成新接口；读懂陌生仓库，先画结构再解释关键路径。

一个可以直接套用的写法：

这个模块没有测试。先读实现和调用方，列出你认为需要覆盖的三个行为。我确认后写测试，只加测试文件，不改实现。写完运行测试并贴出结果。

范围、禁区、验收三样都有，出来的 diff 才看得完。任务描述里缺哪样，返工就会出现在哪样上。需要连 Jira、云盘或内部系统时，通过 MCP 接外部工具，可看什么是 MCP。

反过来，需要看界面效果、需要和真人沟通、涉及未脱敏数据的事，不要整段交给它。放到合适的环节，比争论强弱更有意义。

第一次用，先做三件小事：确认命令能启动、确认在项目根目录、确认它知道项目规矩。项目说明文件值得第一天就写，一份够用的模板：

# 项目约定
- 技术栈：Node.js + TypeScript，包管理器用 pnpm
- 合并前必须通过：pnpm lint、pnpm test
- 不要修改 .env、数据库迁移和生成目录

# 常用命令
- 开发：pnpm dev
- 单测：pnpm test -- <路径>

第一单别挑大重构。选边界清楚的小任务，把三要素写全：

在 src/utils/date.ts 增加 formatRange 函数。
只改这个文件和它的测试，不要调整现有导出结构。
写完后运行 pnpm test -- src/utils，并把结果贴出来。

这样验收标准先于代码出现，改完你只需要看两处：diff 是否越界，测试是否通过。想先走一遍完整流程，可以看第一个 Claude Code 任务。

补全工具优化的是你打字的瞬间，编码代理优化的是任务完成的过程；你要决定的不是哪个更强，而是这件事该不该整段交出去。下一课展开具体差别：Claude 的核心优势。