第 01 期 | 告别静态工具：什么是终端级 AI 编程代理 Claude Code？

更新于 2026/4/5

🎯 学习目标

学完本期你将理解：

  1. Claude Code 与传统 AI 聊天机器人的本质区别
  2. "Agentic Coding" 范式意味着什么
  3. Claude Code 在开发者工作流中的定位

📖 核心概念讲解

1.1 从"聊天"到"代理"的跨越

传统的 AI 编程辅助工具（如 ChatGPT 聊天窗口）是 一问一答 模式：你提问，它回答一段代码片段，然后你手动复制粘贴到项目中。

Claude Code 完全不同。它是一个 Agentic（代理式）编程工具，运行在你的终端里，能够：

能力 传统 AI 聊天 Claude Code
读取项目文件 ❌ 需要手动粘贴 ✅ 自动扫描整个代码库
写入/修改文件 ❌ 只输出文本 ✅ 直接编辑你的源码
执行终端命令 ❌ 无法运行 ✅ 运行测试、构建、Git 等
创建 Git 提交 ❌ ✅ 自动提交并写 commit message
多文件协同修改 ❌ ✅ 跨文件重构
连接外部工具 ❌ ✅ 通过 MCP 协议

1.2 Claude Code 的内置工具列表

Claude Code 拥有一套强大的 内置工具 (Tools)，这是它与普通聊天 AI 的根本区别：

📦 核心工具速查表
──────────────────────────────────────────────
Read          读取文件内容
Write         创建新文件
Edit          编辑已有文件的特定行
Bash          执行终端命令（如 npm test、git status）
Glob          按模式搜索文件名（如 **/*.tsx）
Grep          在文件内容中搜索关键词
WebFetch      抓取网页内容
WebSearch     网络搜索
EnterPlanMode 进入规划模式（只读分析）
ExitPlanMode  退出规划模式
EnterWorktree 创建 Git Worktree 并行开发
Skill         加载技能包
Agent         启动子代理
TaskCreate    创建异步后台任务
TodoWrite     写入待办状态（用于 headless 模式）

📚 官方文档参考: Tools Reference

1.3 Vibe Coding 的魅力与陷阱

"Vibe Coding" 是 AI 编程社区中广泛讨论的概念——你只需要"感觉"（vibe）到想要什么，用自然语言告诉 AI，它来写代码。

但正如微信公众号「新时代的老登」在一篇万字长文中所分析的：

"用 Claude Code 写了一下午，功能加了七八个，越写越嗨。突然上下文满了，清了一下继续聊。然后它问你：'请问这个项目是做什么的？'——前面三小时白干了吗？"

这就是 Vibe Coding 的致命弱点：没有工程纪律的随意编码，最终一定烂尾。本系列教程的目标，不仅是教你用 Claude Code，更是教你 用得好、用得工程化。

💻 模拟 Claude TUI 交互

让我们先感受一下 Claude Code 的终端界面 (TUI)：

╭──────────────────────────────────────────────────╮
│                                                  │
│  Claude Code v2.3.0                              │
│                                                  │
│  What can I help you with?                       │
│                                                  │
│  Tip: Press Shift+Tab to switch modes            │
│                                                  │
╰──────────────────────────────────────────────────╯

> 这个项目的整体架构是怎样的？

╭─ Claude ────────────────────────────────────────╮
│                                                  │
│  🔍 Using tool: Read (package.json)              │
│  🔍 Using tool: Glob (**/*.ts)                   │
│  🔍 Using tool: Read (src/index.ts)              │
│  🔍 Using tool: Read (src/routes/api.ts)         │
│                                                  │
│  ## 项目架构分析                                  │
│                                                  │
│  这是一个基于 Express.js 的 REST API 项目：       │
│                                                  │
│  📁 src/                                         │
│  ├── index.ts        → 应用入口，启动 HTTP 服务器  │
│  ├── routes/         → API 路由定义               │
│  │   ├── api.ts      → /api/v1/* 路由             │
│  │   └── auth.ts     → 认证相关路由               │
│  ├── models/         → 数据库模型 (Prisma)        │
│  ├── middleware/      → 中间件 (JWT 验证等)       │
│  └── utils/          → 工具函数                   │
│                                                  │
│  技术栈：TypeScript + Express + Prisma + JWT      │
│                                                  │
╰──────────────────────────────────────────────────╯

注意 Claude 是如何通过 Read、Glob 等工具 主动 阅读你的项目的——它不需要你手动粘贴任何代码。

🔧 涉及的 Tools / Skills

工具名 作用 权限要求
Read 读取文件内容 无需确认
Glob 按模式搜索文件 无需确认
Grep 搜索文件内容 无需确认
Bash 运行终端命令 需用户确认
Write 写入新文件 需用户确认
Edit 编辑已有文件 需用户确认

📝 本期要点回顾

  1. Claude Code 是一个 终端原生的 AI 编程代理，不是聊天机器人
  2. 它拥有 30+ 内置工具，可以读写文件、执行命令、搜索代码
  3. "Vibe Coding" 很爽但容易烂尾，需要配合工程化方法论
  4. 学会使用 Claude Code 的关键是理解它的 工具调用机制

🔗 参考资料