1. Claude Code 是什么

本节目标：搞清楚 Claude Code 到底是什么、有哪几种入口、能干什么不能干什么，学完心里有一张认知地图。

Claude Code 是 Anthropic 的编码智能体

先给一句结论：Claude Code 是 Anthropic 官方出品的 AI 编码智能体（Agent）。你给它一个目标，它能读你的项目、直接改文件、跑命令、跑测试，把活儿干完交给你验收。

这跟你在 claude.ai 聊天窗口里写代码有什么区别？打个比方。你平时用聊天窗口写代码，像是查菜谱—它告诉你放盐放糖翻炒三分钟，但锅还得你自己掂。复制代码、切回编辑器、粘贴、改报错，全是手工活。

Claude Code 不一样，它像个直接进了你厨房的厨子。你说「我想吃这个」，它自己翻冰箱（读文件）、开火（跑命令）、炒完端上桌（改完代码跑过测试），你只管尝一口验收。

这个差别落到实际体验，是天壤之别。

Anthropic 你应该不陌生，就是做 Claude 那家公司。Claude Code 是它专门为「写代码」这个场景做的工具。官方对它的定义是：能读、能改、能跑代码的代理式编码工具（agentic coding tool）。

它干的主要是这几类活：

写代码：你描述要什么，它顺着项目已有的结构和风格生成代码，不是甩给你一段孤立片段
读懂陌生代码库：接手一个没文档的老项目，让它先讲讲架构，比自己啃半天快得多
审查代码：帮你找潜在 bug、漏掉的边界条件、逻辑错误
调试修复：把报错甩给它，它顺着代码追根因、定位、给修复补丁
自动化杂活：重构、补测试、做迁移这类重复劳动，一句话委托出去

Note

本教程版本基准是 Claude Code v2.1.220（2026-07-26）。默认模型为 Claude Opus 5（v2.1.219 起，支持 100 万 token 上下文）。它是闭源工具，通过 npm 和原生安装器分发，不是开源代码。

四种产品形态

Claude Code 最容易把新手绕晕的地方在于：它不是「一个软件」，而是同一个智能体的四副面孔。搞不清这点，你会在「该装哪个」上卡半天。

入口	长啥样	跑在哪	适合谁
CLI（命令行）	终端里敲 `claude` 的命令行工具	你本机	习惯终端、要写脚本做自动化的人
桌面应用	独立图形界面 App，能可视化看 diff	你本机	不想碰命令行、喜欢点界面的人
IDE 扩展	VS Code / Cursor / JetBrains 里的侧边栏插件	你本机	平时泡在编辑器里写代码的人
Web（网页版）	浏览器打开 `claude.ai/code`	Anthropic 云端	起长任务挂后台、并行跑多个的人

前三个入口都在你自己电脑上干活—读的是你本机的文件，跑的是你本机的命令。只有 Web 版不一样：你在浏览器里下个单，Anthropic 在它的云端起一个隔离环境，把你的 GitHub 仓库拉过去改，改完给你交一份 diff，甚至直接帮你提一个 PR。

这四个入口背后是同一套 Claude Code，配置很大程度上能打通。你写的 CLAUDE.md（项目指令文件）、定义的 Skills（可复用指令模板），都能在 CLI、桌面应用、IDE 扩展之间复用。调教一次，多处能用。

Tip

新手别纠结「先学哪个」。怕命令行就从桌面应用起步，本来就爱泡终端的直接上 CLI。本教程以 CLI 为主线展开，因为它的功能最全，其他入口的操作逻辑也相通。

CLI：终端中的编码智能体

Claude Code CLI 是功能最全的入口，三大平台（macOS / Windows / Linux）全支持。在终端里敲一行 claude 回车，会进入一个全屏交互界面，有对话区、有输入框、有状态栏。

它还能用 claude -p "你的问题" 做非交互式运行，一句话跑完就退出，适合写脚本和接 CI。这是其他入口做不到的。

桌面应用：图形界面的编码智能体

桌面应用是官方力推的图形界面入口，目前支持 macOS、Windows 和 Linux（beta）。

它最大的优势是可视化—你能用图形面板一行行看 diff、多任务并排跑、在界面里直接暂存和提交。对不碰命令行的人来说，这是最友好的入口。需要付费订阅。

IDE 扩展：编辑器里的侧边栏

IDE 扩展支持 VS Code、Cursor 和 JetBrains 全家桶（IntelliJ IDEA / WebStorm / PyCharm 等）。装好后编辑器侧边栏多一个 Claude Code 面板，你不用离开编辑器就能跟它对话、看 diff。

适合那种「我整天泡在 VS Code 里」的开发者，改动直接在编辑器里看，不用切窗口。

Web 版：浏览器里的云端智能体

Web 版跑在 Anthropic 的云端。你在浏览器里描述任务，它在一个隔离的云环境里拉取你的 GitHub 仓库、改代码、跑测试，完事后给你一份 diff 或直接提 PR。

好处是不占你本地资源，能挂长任务、并行跑多个。适合那种「这活儿要跑半小时，我先去干别的」场景。

智能体循环：它到底怎么干活

Claude Code 之所以叫「智能体」而不叫「聊天机器人」，核心在于它有一个代理循环（Agentic Loop）。

你给它一个任务后，它会反复执行三个阶段：

收集上下文：读文件、搜索代码、看 git 状态，搞清楚现状
采取行动：编辑文件、运行命令、跑测试，动手改
验证结果：看输出对不对、测试过没过，不对就回头再改

这个循环会转好几圈。比如你说「修复失败的测试」，Claude 可能会：先跑测试看哪个挂了，读报错信息，搜相关源文件，读代码理解逻辑，改文件，再跑一遍验证。每一步都根据上一步的结果决定下一步干什么。

你也是这个循环的一部分。任何时候你都能打断它，给新指示、补上下文、让它换个方向。它自主工作，但不是撒手不管。

Note

这个循环是 Claude Code 能跨多文件工作的根本原因。普通代码补全只看当前文件，Claude Code 看的是整个项目—你让它「修认证 bug」，它会自己找到认证相关的文件、读、改、测，全链路搞定。

能干什么，不能干什么

能干的

跨文件改代码：不是改一个文件，是顺着依赖链改一片
运行命令并看结果：跑构建、跑测试、跑 git，看输出决定下一步
搜索整个代码库：按文件名、按内容、按符号，比你自己 grep 快
联网查资料：搜文档、查报错、找 API 用法
提交代码：帮你写 commit message、提 PR
跑长任务：Web 版和后台会话能挂着跑，你先去干别的

不能干的（或者要小心的）

不能访问它没被授权的东西：默认只能看你当前目录及子目录的文件
不能做需要人工判断的产品决策：它能写代码，但「该不该加这个功能」是你的事
不是万能的：复杂架构设计、模糊需求，仍然需要你给清晰的指引
不能保证零 bug：它写的代码你需要 review，别盲目信任

Warning

Claude Code 会真的改你的文件、跑你的命令。虽然是可控的（每次操作可以审批），但别在没 git 提交的脏目录里直接让它大刀阔斧改。先 git stash 或 commit，给自己留退路。

和 ChatGPT、Codex 有什么区别

很多人会问：这跟 ChatGPT 写代码、跟 OpenAI 的 Codex 有啥不一样？

对比项	Claude Code	ChatGPT 写代码	Codex
定位	编码智能体，能读改跑	通用助手，有 Agent 沙箱	编码智能体，能读改跑
交互方式	终端/IDE/桌面/Web	聊天窗口/Agent 沙箱	终端/IDE/桌面/Cloud
项目理解	能读整个本地代码库	沙箱内文件，非本地项目	能读整个代码库
直接改文件	能（本地）	不能改本地文件	能
跑命令	能（本地）	沙箱内能	能
背后模型	Claude（Opus 5 / Sonnet）	GPT 系列	OpenAI o3 微调版（codex-1）
开源与否	闭源	闭源	CLI 开源（Apache-2.0），云端闭源

一句话总结：Claude Code 和 Codex 直接在你的本地代码库里动手，ChatGPT 在云端沙箱里干活，够不到你本地的项目文件。前者直接改你的代码，后者要么聊天给建议，要么在隔离沙箱里跑，想同步回本地还得你自己动手。

至于 Claude Code 和 Codex 之间怎么选，核心看你用哪家的模型、习惯哪家的交互。两者定位高度重合，差异在细节和生态。本教程专注 Claude Code，不展开横向评测。

这套教程怎么读

这是「Claude Code 入门教程」的第一章。整套教程面向 0 基础，只讲干货知识点，不含实战项目。

建议按顺序读：先搞清是什么（本章），再装上（第 3 章），登录（第 4 章），跑通第一次（第 5 章），然后按需跳读。每章都能独立看，但前后有递进关系。

教程以 CLI 为主线，桌面应用和 IDE 扩展的操作逻辑相通，学会 CLI 基本都会用。