夜雨聆风第二部分：AI编程工具生态
学习目标
深入掌握主流 AI 编程工具，重点精通 Claude Code 的使用
完成标志
能熟练使用 Claude Code 完成完整的编程任务，能根据场景选择合适工具
这是本教程最核心的一部分。如果说前面是 "认知准备"，这里就是 "真刀真枪"。我们将深入学习 Claude Code 的每一个细节，让你从安装配置到日常使用都游刃有余。
2.1 AI编程工具全景图
2.1.1 按交互模式分类
类型
代表工具
特点
适合场景
比喻
对话式
ChatGPT、Claude.ai
对话界面，问答式编程
学习、问题解答
编程百科全书
IDE 集成型
Cursor、Windsurf、GitHub Copilot、cline
嵌入编辑器中，实时辅助
日常编码、代码补全
坐在你旁边的搭档
Agent 工具（终端 / 桌面 / IDE）
Claude Code、Codex
能读写文件、运行命令、自主推进任务
后端开发、全栈项目、自动化
随叫随到的远程程序员
平台型 Agent
Qoder、Devin、Bolt.new
Web / 桌面平台，多 Agent 协同
复杂项目管理
一个 AI 开发团队
2.1.2 按能力层级分类
L5 自主工程 —— 端到端自主完成项目（探索中）↑L4 项目管理 —— 多Agent协同、任务分解（Qoder）↑L3 任务执行 —— 自主修改文件、运行命令（Claude Code、Cursor Agent）【本课程重点学习】↑L2 代码生成 —— 生成完整代码块（ChatGPT、Claude.ai）↑L1 代码补全 —— 行级/函数级补全（Copilot、TabNine）2.1.3 如何评估一个AI编程工具
维度
说明
为什么重要
上下文能力
能理解多大范围的代码库
项目越大，需要理解的代码越多
工具使用
能否操作终端、文件系统
决定 AI 能不能真正 "动手"
自主性
能否自主规划和执行
越自主，你需要干预的越少
准确性
生成代码的正确率
直接影响你的工作效率
速度
响应和完成任务的速度
太慢会严重影响体验
成本
订阅费 + API 费用
影响长期可持续性
扩展性
插件 / 技能 / 自定义能力
能否适应你的特殊需求
中文支持
中文理解和生成质量
对中文用户尤为重要
1、维度优先级分层（工程选型排序）
核心硬性指标（必看，一票否决）
工具使用能力：能否读写本地文件、执行终端命令，是区分「代码问答工具」和「工程开发工具」的分水岭，Claude Code、Cursor Agent 具备该能力，纯网页对话 GPT/Claude 做不到本地工程落地。
上下文能力：大项目多文件重构、全局架构梳理必备，上下文窗口不足会出现跨文件变量、接口识别错乱。
自主性：自主拆解任务、迭代调试，大幅减少人工来回指令沟通。
2、工具对照落地举例
Claude Code：8 个维度全部达标，具备文件 + 终端操作、大上下文、高自主执行能力，工程化开发首选；
GitHub Copilot：仅支持代码补全，无终端 / 文件操作能力，只能做辅助编码，无法独立承接完整项目；
网页端 ChatGPT：无本地文件访问权限，只能片段代码问答，不适合完整工程迭代。
2.2 各 AI 编程工具概述
在深入了解具体工具之前，先快速认识一下目前最主流的几款 AI 编程工具 —— 了解它们各自是什么、核心特点是什么，形成全局认知。
2.2.1 Claude Code
本节是全教程的核心重点，将从安装到进阶全方位讲解 Claude Code 的使用。
Claude Code 是 Anthropic 公司推出的 AI 编程智能体。它最经典的入口是终端 CLI，现在也提供 IDE、Desktop、Web 等形态。它能够读取项目代码、修改文件、运行命令、安装依赖 —— 就像你雇了一个 24 小时在线的远程程序员，你用自然语言告诉它做什么，它自己动手干活。
Claude Code 是什么？
形象比喻（交通工具类比）
如果把 AI 编程工具比作不同的交通工具：
· ChatGPT/Claude.ai 就像公交车 —— 你问路，它告诉你怎么走，但你得自己走· Cursor 就像共享单车 —— 你骑着它走，它帮你指路和加速· Claude Code 就像出租车 —— 你说目的地，它自己开到Claude Code 核心特点
特点
说明
多入口使用
支持终端、IDE、Desktop / Web 等入口，终端仍是开发者最常用形态
全自主执行
能自己读文件、写文件、运行命令
项目级理解
能理解整个项目的代码结构和逻辑
200K-1M 上下文
一次能 “记住” 大量项目背景，具体上限取决于模型
权限确认
执行危险操作前会先征求你同意
Claude Code vs Claude.ai 核心区别
维度
Claude.ai（网页版）
Claude Code（命令行版）
界面
浏览器对话框
终端 / IDE / Desktop / Web 多入口
能力
仅文字回复代码片段
可直接操作本机电脑（读写文件、运行命令）
项目理解
需要手动粘贴代码片段
自动读取完整项目目录
代码应用
手动复制代码粘贴到项目
直接修改本地项目真实源码
适合场景
编程答疑、生成零散代码片段
完整项目开发、迭代修改真实业务代码
提示：Claude Code 和 Claude.ai 都使用 Claude 系列模型，核心区别在于 “交互方式” 和 “工具权限”。Claude Code 给了 AI “手”—— 让它能在你授权后直接触碰项目文件和开发工具。
2.2.1.1 LLM Loop：cc 凭什么是「Agent」而不是「聊天框」
要理解 Claude Code 与你以前用过的 ChatGPT、Claude.ai 的本质差别，必须先弄懂一个机制 —— LLM Loop（大模型循环）。
对话式 AI（ChatGPT/Claude.ai）工作模式：
你问一句 → 它答一句 → 单次交互结束。如果答案不满意，需要你重新发起提问。主动权始终掌握在使用者手中，AI 仅仅是一个高级问答回复机器。
Claude Code 工作模式：
你下达完整目标 → CC 自主拆解执行步骤 → 自动调用工具执行操作 → 观测运行结果 → 自行判断下一步动作 → 再次调用工具……持续循环往复，直至完整任务全部完成。主动权交由 AI 掌握。这套「思考 - 行动 - 观察 - 再思考」的闭环迭代流程，就称作 LLM Loop（大模型循环）。
这就是为什么我们把 cc 称为 Agent（智能体）而不是 Chatbot（聊天机器人）。也正因为如此：
你可以给 cc 一个模糊的高层目标（如 "帮我做一个番茄钟"），它会自己一步步推进 cc 在执行过程中会自我纠错 —— 某条命令报错了，它会读错误信息，调整方案再试 注意：cc 不一定每一步都向你确认询问，所以在它自主执行之前，要提前提供完整上下文（CLAUDE.md、Skills、执行计划等） 关键认知
cc 是一整套「程序 + 模型」的组合，底层接入的大模型支持替换；因此可以接入 DeepSeek、千问、GLM 等国产模型驱动 cc 运行。
模型可以替换，本质都是再通过LLM Loop 循环机制 + Harness 工程封装，让 cc 的能力远远超越普通对话式 AI。
2.2.1.2 Claude Code 是如何 “读懂” 你的代码库的（Agentic Search）
很多人对 Claude Code 存在一个常见误解：以为它会和其他 AI 工具一样，需要先把项目代码上传至服务端预先构建向量索引。
事实上，Claude Code 不需要任何预先的代码库索引。
官方将这套代码理解机制命名为 Agentic Search（智能体式检索），它的工作逻辑和人类工程师初次接手新项目、冷启动梳理代码的方式完全一致。
与传统 RAG / 向量检索的本质区别
维度
传统 RAG 检索
Claude Code 的 Agentic Search
工作方式
预先嵌入整个代码库为向量，查询时按相似度拼凑
现场读文件、grep、追引用
需要服务器索引
需要，且需持续维护
不需要
代码变动处理
索引过期，可能返回已删除或重命名的代码
始终读取实时代码
代码上传
通常需要预先上传或建立索引
不需要预先上传 / 索引整个代码库；但被读取进上下文的片段仍会发送给模型服务
适合场景
老项目、不变代码库
活跃开发中的项目、百万行 monorepo
这意味着 Claude Code 天生适合活跃代码库 —— 它不依赖一份可能过期的预建索引，也不需要 IT 部门部署向量数据库。
2.2.1.3 “脚手架” 比 “模型” 更重要：Harness 体系
官方反复强调一个观点：决定 Claude Code 表现的，不只是背后的模型，还有围绕模型搭建的 “脚手架 Harness”。
理解方式：模型能力决定下限，项目上下文、工具权限、规则文件和工作流决定上限。实际生产中，围绕模型搭建的工具生态会显著影响最终表现。
本教程把 Claude Code 的工程化能力抽象成 7 个扩展点，建议按 “从底到顶” 的顺序理解 —— 先打好上下文和规则基础，再接入更复杂的外部工具：
底层根基（地板）
模型本身：决定能力下限，换模型不改动上层整套框架
自上而下 7 层扩展（好记口诀）
1.CLAUDE.md 项目说明书：定项目规则、约束边界
定规矩，不乱改代码，不乱读文件，不乱删文件
2.Hooks 生命周期钩子：会话启停自动执行固定动作
每次启停都执行的操作，有点像切面编程，如每次执行删除操作都进行确认，每次编写完代码都要进行测试。
3.Skills 专业技能包：给 AI 加专属业务能力
本地的技能，包含自定义，使用他人的skills
4.Plugins 插件打包：把钩子 + 技能封装好一键分发复用
5.LSP 语言服务：让 AI 拥有 IDE 代码跳转、查定义能力
6.MCP Servers 外部接入：连第三方工具、数据库、接口
对接接口、数据库、云服务，打通外部系统
7.Subagents（子代理） 独立上下文窗口的 Claude 实例，只返回结论
层序号
组件
作用
加载时机
①
CLAUDE.md
项目上下文文件（项目背景、约定、禁区）
每次会话自动加载
②
Hooks
会话生命周期钩子（启动 / 结束 / 文件写入等事件）
事件触发
③
Skills
可复用的任务方法论（如 “代码审查”“部署”）
按需加载
④
Plugins
打包一整套 Skills + Hooks + MCP 配置
装上后始终生效
⑤
LSP（语言服务器）
给 AI 装上 “跳到定义 / 查找引用” 等 IDE 级导航
始终生效
⑥
MCP 服务器
打通 Claude 与外部工具（数据库、文档、票务系统）
始终生效
⑦
Subagents（子代理）
独立上下文窗口的 Claude 实例，只返回结论
任务发出时创建
顺序重要！初学者不要在基础还没搭好时就急着上 MCP 或 Subagents。先把 CLAUDE.md、Hooks、Skills 这三层基本功做扎实再说。
2.2.1OpenAI Codex
Codex 是 OpenAI 推出的 AI 编程 Agent，是 Claude Code 最主要的竞争对手之一。其中 Codex CLI 是开源项目，Codex App / Desktop / IDE 插件则更偏向产品化入口。
形态
说明
适合人群
Codex Desktop
图形界面桌面客户端，体验最好
新手、喜欢 GUI 操作
Codex CLI
命令行终端，灵活轻量
终端爱好者
VSCode 插件
在 VSCode 侧边栏直接调用使用
VSCode 常驻使用者
CLI 会使用本地 ~/.codex/ 配置目录；桌面端和 IDE 插件共享 OpenAI 账号体系，具体配置项、插件能力、界面入口会随版本迭代变动，以客户端实际展示为准。
2.2.1.1核心亮点
CLI 开源透明（Apache 2.0 协议）：可阅读源码，完整掌握工具底层实现原理
沙箱 + 审批机制：依靠 sandbox、approval mode 管控文件修改、终端命令执行风险
AGENTS.md 项目说明文件：记录项目规则、上下文、协作约定，Agent 新会话可快速接手项目
多模型兼容：原生支持 GPT 全系模型，同时可接入 DeepSeek、Ollama、Mistral 等所有兼容 OpenAI API 格式的模型服务
三档自主执行等级：suggest（每一步人工确认）→ auto-edit（自动改代码，命令需确认）→ full-auto（完全自主运行），自主程度灵活可调
推理强度三档可控：low /medium/high，可根据任务复杂度权衡运行速度与代码输出质量
维度 | Codex | Claude Code |
开源 | CLI 开源（Apache 2.0） | 否（闭源） |
安全模型 | sandbox + approval mode | 权限规则与模式配置 |
指令文件 | AGENTS.md（开放标准） | CLAUDE.md（专用） |
配置文件格式 | TOML | JSON |
模型生态 | GPT 系列 + 任意 OpenAI 兼容接口(升级后没那么方便) | Claude 系列 + Anthropic 兼容接口 |
国内 Coding Plan | 需自行配置中转 | 国内厂商原生支持 |
何时选择 Codex
看重开源透明、需要阅读源码审计，Codex CLI 支持源码查看 已有 ChatGPT 账号或 OpenAI API，可零配置开箱即用 需要精细化管控命令、文件修改风险，依赖 sandbox /approval 安全机制 希望使用 GPT 系列代码能力，Codex 是其原生编程入口 多工具统一规范落地，AGENTS.md 属于开放通用标准
Codex 优势场景
前端开发：截浏览器页面、UI 设计图，直接生成 / 修正 CSS、布局；
报错截图直接粘贴，不用手动复制日志文本；
架构草图、手绘流程图转代码结构。
Claude Code 互补优势
一次性投喂几十上百个代码文件、超长工程文档，多模态长上下文承载更强；
百万行 monorepo 仓库全域梳理，不会因为图文附带大量代码上下文溢出。
建议：
1.重度前端、UI 调试、看图写代码、经常截图排错 → 优先 Codex+GPT-4o；2.2.3 Cursor
如果说 Claude Code 是命令行中的 "远程程序员"，那 Cursor 就是坐在你旁边、和你共用一个屏幕的 "编程搭档"。
2.2.3.1 Cursor 概述与定位
Cursor 是一个基于 VS Code 改造的 AI 原生 IDE（集成开发环境）。它把 AI 能力直接嵌入到了代码编辑器中，让你在写代码的同时随时获得 AI 辅助。
维度 | Claude Code | Cursor |
界面 | 终端命令行 | 图形化编辑器 |
交互方式 | 纯文字对话 | 鼠标 + 键盘 + 对话 |
核心优势 | 全自主执行、项目级理解 | 实时补全、可视化编辑 |
适合场景 | 后端开发、全栈架构 | 前端开发、日常编码 |
学习曲线 | 需要熟悉终端 | 和 VS Code 几乎一样 |
Claude Code 和 Cursor 不是竞争关系，而是互补关系。很多开发者的工作流是：用 Claude Code 搭建项目骨架和实现后端逻辑，用 Cursor 精调前端细节和日常编码。
2.2.4 其他 AI 编程工具
2.2.4.1 Qoder（阿里）
Qoder 是阿里推出的 AI 编程工具，主打更强的任务拆解、上下文检索和 Agent 化开发体验。由于这类工具迭代很快，具体功能入口和角色命名请以官网当前版本为准。
能力方向 | 说明 |
需求理解 | 把自然语言需求拆成可执行任务 |
代码检索 | 在项目中查找相关文件、调用关系和上下文 |
编码执行 | 自动修改文件、生成代码、处理错误 |
验证反馈 | 运行命令或测试，基于结果继续调整 |
代码审查 | 检查潜在问题并给出修复建议 |
2.2.4.2 CodeBuddy（腾讯云 AI 代码助手）
腾讯推出的 AI 编程助手，以 IDE 插件形式提供。特点是中文优化好、国内直接可用、企业级功能完善。
适合在腾讯云生态中开发的团队。
2.2.4.3 Trae（字节跳动）
字节跳动推出的 AI IDE，类似 Cursor，但深度集成了豆包大模型。国内直接可用，中文支持好。
2.2.4.4 在线快速原型工具
工具 | 特点 | 适合场景 |
Bolt.new | 在浏览器中一键生成全栈应用 | 快速验证想法 |
Lovable | AI 生成 + 可视化编辑 | 非技术人员做原型 |
v0 (Vercel) | 专注 UI 组件生成 | 前端设计原型 |
2.2.5 工具对比与选型指南
2.2.5.1 全维度对比矩阵
维度 | Claude Code | Codex CLI | Cursor | Qoder | Copilot | Trae |
类型 | CLI Agent | CLI Agent | AI IDE | 多 Agent 平台 | IDE 插件 | AI IDE |
开源 | 否 | 是（Apache 2.0） | 否 | 否 | 否 | 否 |
自主性 | 极高 | 高 | 中 | 极高 | 低 | 中 |
上下文窗口 | 200K~1M | 取决于所选 GPT 模型 | 大 | 取决于版本 | 中 | 大 |
安全模型 | 权限规则 | sandbox + approval | IDE 内置 | 权限规则 | 受限 | IDE 内置 |
国内直连 | 需配置 | 需配置 | 需配置 | 需配置 | 需配置 | 可直连 |
免费额度 | 有限 | 有限 | 有限 | 有限 | 有限 | 有 |
学习曲线 | 中 | 中 | 低 | 中 | 低 | 低 |
中文支持 | 好 | 好 | 好 | 好 | 一般 | 好 |
2.2.5.2 场景化选型建议
你的情况 | 推荐工具 | 理由 |
零基础，想快速上手 | Cursor 或 Trae | 可视化强、上手快 |
想深入学习 AI 编程 | Claude Code（本教程核心） | 对 AI 工作原理理解更深 |
个人全栈项目 | Claude Code + Cursor 组合 | Claude Code 做后端，Cursor 做前端 |
只想做个简单网页 | Bolt.new / v0 | 不用安装，浏览器里直接做 |
企业级复杂项目 | Qoder / Claude Code | 多 Agent 协同、任务管理 |
国内用户、追求开箱即用 | Trae / CodeBuddy | 无需翻墙、中文优化 |
2.2.5.3 工具 + 模型组合推荐
组合方案 | 工具 | 模型 | 月成本 | 适合人群 |
性能组 | Claude Code | Claude Sonnet/Opus | 按量 / API 或订阅 | 追求极致体验、有国际支付能力 |
免费组 | Codex CLI | ChatGPT/Codex 账号额度 | 免费或订阅内 | 想低成本体验高质量 AI 编程 |
性价比组 | Claude Code | GLM Coding Plan | 固定套餐（以官网为准） | 国内用户、追求省心 |
极客组 | Claude Code | DeepSeek V4 Pro (API) | ¥0-30 | 动手能力强、追求性价比 |
选型建议：新手推荐从性价比组（GLM Coding Plan）或免费组（Codex CLI）开始，零风险体验，等熟悉再升级到性能组。
2.2.5.4 工具组合（进阶玩法）
1. 双工具流（社区推荐最佳实践）
组合：Claude Code（后端 / 架构 / 数据库） + Cursor（前端 / UI 细节）
Claude Code 优势：从零搭建项目骨架、编写 Prisma 数据表结构、批量设计后端接口；
Cursor 优势：对照设计稿像素级还原页面、调整 Tailwind 样式类名、前端精细化迭代；
效果：二者能力互补，整体开发效率最大化。
2. 轻量组合（无需学习命令行）
组合：Cursor + Claude.ai 网页版辅助适用人群：不想接触终端命令行的开发者。主力在 Cursor 里日常编写代码，遇到复杂架构、算法、疑难问题时，打开 Claude 网页版单独提问拆解。
3. 国内友好组合（无代理直达）
组合：Trae + DeepSeek API
无需配置海外代理，Trae 编辑器操作体验对标 Cursor；
DeepSeek API 提供高性价比模型推理能力，完整适配国内开发环境。
2.3 Claude code安装与配置
2.3.1 安装
2.3.2 API配置
2.3.3 接入DeepSeek
claude code傻瓜式安装在之前的文章中有详细说明：
2.3.4 多模型并存管理：CC-switch可视化切换工具
偶尔还要用 GLM Coding Plan 套餐。手动改环境变量太麻烦，这时就需要一个专门的多模型管理器。
cc-switch 工具介绍
cc-switch 是社区开源桌面小工具，实现多套 Claude Code 配置一键切换。
项目地址：https://github.com/farion1231/cc-switch
下载：进入 Releases 页面，下载 Windows /macOS/ Linux 对应安装包
使用步骤：打开 cc-switch → 点击「新增」→ 填入对应 API Key、BaseURL → 自定义命名（如 Anthropic - 官方、DeepSeek、GLM-CodingPlan）并保存 → 后续点击对应配置即可一键切换
工作原理
cc-switch 持久存储多组 API Key、BaseURL 配置；选中某一套配置后自动更新系统环境变量，重启终端后执行 claude 命令即可生效。
