使用 Claude Code 前，你需要了解的几个基本概念

原创于 2026-06-29 14:20:37 发布 · 189 阅读

3 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

标签

#claude-code #code #claude #AI编程 #AI工具

claude-code 专栏收录该内容

41 篇文章

订阅专栏

很多人装上 Claude Code 之后，打开终端敲了一个需求，看到输出就懵了——不是说好"聊天式编程"吗？怎么它自己在那读文件、执行命令、改代码了？

Claude Code 不是 ChatGPT 的终端皮肤。它是一个 Agent——有自己的工作循环、工具体系、权限边界。不理解这几个核心概念就上手，轻则效率低，重则踩坑。

这篇文章把最关键的五个概念讲清楚，看完再实操，事半功倍。

概念一：Agent 工作模式

Claude Code 不是"你问一句，我答一句"。它的工作方式是：你给目标，它自己规划步骤、调用工具、拿到结果、迭代修正，直到任务完成或你叫停。

这个自治循环长这样：

你描述一个任务（“帮我给这个函数加完整的类型注解和参数校验”）
Claude Code 开始在后台"思考"——它不急着回答，而是先分析：要改哪个文件、需要先读哪些依赖、改完后要不要跑 TypeScript 检查
它调用工具去执行——用 Read 读文件、Grep 搜索引用、Edit 修改代码、Bash 跑 tsc 编译检查
根据执行结果调整方案——如果编译报错，它分析错误原因，修正代码，再跑一次
循环到任务达到目标或你终止

和 ChatGPT 的本质区别：ChatGPT 是"我给你建议，你手动去操作"。Claude Code 是"你给目标，我直接操作，你看结果"。这个差异决定了使用体验完全不同——你从"操作者"变成了"审查者"。

你需要做什么：学会写清晰的任务描述。不要用"帮我看看这段代码"这种开放式提问，而要用"这个函数缺少边界条件处理，帮我加上参数非空检查和返回值兜底逻辑"这种具体指令。Agent 的自主性越强，你对任务描述的精准度要求就越高。

概念二：内置工具（Tools）

Claude Code 不是靠"阅读代码 + 生成建议"完成任务的，它靠的是一套内置工具。这几个工具构成了它的手脚：

Bash：在终端执行命令。安装依赖、跑测试、启服务、操作 Git，全通过它完成。这是 Claude Code 区别于 IDE 插件类工具的核心能力——它不只是"写代码"，它真的能"运行项目"。

Edit：直接修改文件内容。它不是"给出修改建议让你复制粘贴"，而是直接在源文件上做精确的字符串替换。你确认后，文件就被改好了。

Read：读取文件内容。一般是第一步操作——先理解现有代码，再决定改什么、怎么改。可以一次读整个文件或多个文件的指定段落。

Glob：按文件名模式搜索文件。比如 **/*.ts 找出所有 TypeScript 文件，src/components/**/*.tsx 找出组件目录下的所有 TSX 文件。作用是快速定位目标文件。

Grep：按内容正则搜索。查找某个函数在哪里被调用、某个变量在哪里被引用、某个配置项在哪里被设置。在大型项目中定位代码的必备能力。

WebFetch / WebSearch：联网获取信息或搜索。比如查第三方库的 API 文档、参考某个技术方案的最佳实践。

理解工具的意义：当你看到 Claude Code 说"让我先用 Grep 搜索一下这个函数在哪里被调用，然后用 Read 读调用处的上下文"，你不会觉得它在说废话——它在展示自己的思考链和操作逻辑。这种透明度让你能判断它的方向对不对，而不是盲目信任输出。

概念三：上下文窗口（Context Window）

Claude Code 的能力天花板由两个东西决定：模型本身的质量，以及它一次能"看到"多少信息。

上下文窗口就是 AI 单次处理的文本上限。Claude Code 底层用的是 Claude 系列模型，上下文窗口在 200K token 量级。换算成中文大概 10-15 万字，换算成代码大概是一个中型项目的核心模块。

但"能装下"不等于"该装进去"。上下文窗口有几个实际限制：

塞得越多，质量越低：当上下文接近上限时，模型对细节的注意力下降，容易遗漏约束条件或输出不准确的结果。不是"喂得越多越好"，而是"喂得越精准越好"。

文件不是自动加载的：Claude Code 不会自动把你整个项目都读进去。它会按需加载——你提到的文件、任务涉及的文件、通过工具搜索到的文件，才会被加入上下文。这是优点不是缺点：避免无关文件干扰注意力。

你需要做什么：

任务描述中明确指定关键文件路径，减少 Claude Code 自己搜索的成本
不要把整个项目 dump 进去，只给任务相关的文件
如果项目特别大，分模块对话，一个模块一个模块来
配置 CLAUDE.md 在项目根目录，把项目背景、技术栈、编码规范写进去，Claude Code 每次启动都会读这份文件作为基础上下文

概念四：权限边界与安全确认机制

Claude Code 能读你的文件、能改你的代码、能在你电脑上执行命令——听起来很吓人。但它有一层权限控制，三种确认模式：

读文件、搜索文件：不需要你的确认。这些操作不影响代码，Claude Code 自动执行。

改文件：每次修改前会展示 diff，你确认后才真正写入。你不会看到一堆莫名其妙的代码变更。

执行 Bash 命令：默认需要你批准。安装依赖、运行测试、执行脚本——这些操作每次都会弹出确认提示，你点"允许"才会执行。这防止了 Claude Code 在你的电脑上执行危险操作。

可以调成更宽松的模式吗？ 可以在设置中调整为"自动批准某些类型的操作"。比如你信任当前项目、且操作范围在项目目录内，可以允许自动执行 Bash。但不建议新手这样做——先用默认的确认模式用一两周，熟悉 Claude Code 的操作习惯后再考虑放宽。

一个关键认知：Claude Code 的权限控制不是"信任这个 AI"，而是"信任这个 AI 在你的审查下做事"。默认每次关键操作都让你确认，等于每个步骤都有你的签字。这不是碍事，是保护。

概念五：工作目录（Working Directory）

这是新手最容易忽略、但影响最大的概念。

工作目录就是你启动 Claude Code 时所在的那个文件夹。所有相对路径、所有文件操作、所有搜索范围——都以这个目录为根。

启动位置不同，Claude Code 的行为完全不同：

在项目根目录启动 → 能看到整个项目的结构，搜索范围覆盖所有模块
在某个子目录启动 → 它只能看到这个子目录下的文件，上面几层的配置和依赖它感知不到
在用户根目录启动 → 它能访问的东西太多了，不安全，也不精准

正确做法：每次启动前，先 cd 到项目根目录，确认 pwd 显示的是正确路径，再执行 claude 启动。养成这个习惯能避免一半以上的"它怎么找不到文件"类问题。

CLAUDE.md 的位置：如果你在项目根目录放一个 CLAUDE.md（项目背景、技术栈说明、编码规范），Claude Code 会自动加载。但注意——只有工作目录下的 CLAUDE.md 才会被读取。如果你在子目录启动，它可能看不到项目根目录的 CLAUDE.md。

五个概念串起来看

用一个真实流程来串联：

你在项目根目录启动 Claude Code（工作目录正确）
输入任务：“给 src/utils/request.ts 的 httpGet 函数补上超时处理和重试逻辑”（Agent 目标清晰）
Claude Code 先用 Glob 找到文件，用 Read 读当前代码（工具调用）
它发现 httpGet 依赖了一个叫 timeoutConfig 的配置，自动用 Grep 搜索这个配置在哪里定义，把相关代码加载进上下文，形成一个"做这件事需要知道的全部信息"（上下文管理）
用 Edit 修改代码，展示 diff 给你确认（权限确认）
改完后提议跑 npm test src/utils/__tests__/request.test.ts，你批准后执行（工具调用 + 权限确认）

整个过程你输入了一句话，剩下的 5 个步骤 Claude Code 自动完成——你在其中的角色是审查 diff 和批准 Bash 命令。