Claude Code 实践指南（一）：开始第一次对话

年初，我也搭上了 AI 时代的公交车。刚开始试用时，我的体验是： ”感觉 Claude Code 写出的代码就是一坨啊？AI agent 真的有用吗？”。

后来，又来一次在家做饭的时候突然想明白了——

一个人做饭，从洗菜、切菜、调味到掌勺，全靠自己。如果你家里请了一位米其林大厨，你只需要说”给我做个宫保鸡丁”，大厨自己就能做好了。Claude Code 就是这样一个大厨。

虽然它切菜很快，但它并不知道你的口味偏好，你家的厨房设施，这些还得你说了算。

嗯，我挺满意这个比喻。

这是我计划编写的 Claude Code 实践指南的第一篇文章，我想先简单介绍一些概念和用法。这种新的工作模式是否能提高工作效率暂且不提，了解他是什么，能干什么，依然很重要。

Claude、Claude Code 和其他工具到底有什么区别

先说 Claude。Claude 是 Anthropic 公司的大语言模型家族，包括 Claude Sonnet、Claude Opus 等等，它是一个”能听懂话的大厨”。

再说 Claude Code。Claude Code 是运行在终端里的 AI 编程助手，是一个 CLI（Command Line Interface，命令行界面）工具。它不光能听懂话，还能读取文件、编辑代码、执行命令、完成多步骤开发任务。相当于给大厨配齐了刀具、灶台和食材仓库的后厨系统，不光能听懂，还能动手。

打个比方：Claude 是那个你正在面试的大厨，你说”酸辣汤怎么做”，它能告诉你配方和步骤；而 Claude Code 是那个已经站在灶台前的大厨，你说”做一碗酸辣汤”，它直接走进厨房，把汤端出来。

除了 Claude Code，目前市面上 AI 编程工具不少，各有各的风格：

工具	模型	所属公司	关键特点	适合场景
Claude Code	Claude 系列	Anthropic	代码专用优化，Agent 自主性高	复杂代码库重构、多文件修改
Copilot	GPT / Claude	Microsoft	补全为主，对话辅助	日常编码补全
Cursor	多类模型	Cursor	基于 VS Code，内置 AI 的 IDE	喜欢独立 IDE 的用户
Zed	多类模型	Zed	极致性能，自研 GPUI，AI 原生集成	喜欢 IDE 但接受不了 VS Code 的速度的用户
Codex	o3 / codex-1	OpenAI	开源终端编程代理，Agent 自主性高	自动化脚本、代码生成与执行
Gemini	Gemini 系列	Google	上下文窗口大，多模态能力强	大型项目、长上下文分析
OpenCode	多类模型	Anomaly	代码搜索和理解能力强	代码检索、Bug 定位
Windsurf	多类模型	Codeium	注重协作体验，适合团队	团队协作、初学者友好

简单介绍一下这些新面孔：

Codex 是 OpenAI 推出的开源终端编程代理，基于 o3 和 codex-1 系列模型，定位和 Claude Code 类似，也是一个能直接在终端里读写代码、执行命令的 Agent。

Gemini 是 Google 的多模态大模型，上下文窗口可以做到 1M tokens 以上，理论上可以一次性读完一个中型代码库再分析，适合长上下文分析场景。

OpenCode 来自 Anomaly，是一个开源项目，在行业内非常火，可以接入各大模型商的大模型。

Windsurf 背后是 Codeium，就是那个早年免费替代 Copilot 的 Codeium。Windsurf 强调协作体验，定位更偏向团队使用和初学者。

系统要求与安装

安装 Claude Code 的前提如下：

操作系统 ：macOS、Linux、Windows WSL2 均可。

前置依赖 ：Node.js 18+ 和 npm。

主安装命令 很简单，一行搞定：

1 2	# macOS / Linux / WSL curl -fsSL https://claude.ai/install.sh \| bash

Windows 用户用 PowerShell：

1	irm https://claude.ai/install.ps1 \| iex

如果你更习惯 Homebrew，也可以：

1	brew install --cask claude-code

安装完成后，验证一下：

1	claude --version

如果能看到版本号输出，说明安装成功。如果提示”command not found”，大概率是 PATH 没配好，试试重新打开终端窗口。

认证与计费

大厨请来了，但干活得开工资。Claude Code 提供多种付费方式。

方式一：Subscription 登录

如果你已经有 Claude Pro、Max 或 Team 订阅，这是最省心的方式。直接在终端运行 claude，会自动打开浏览器要求登录 Anthropic 账号，登录后自动绑定订阅权益，不需要手动管理任何 API Key。

优点是简单，不需要记 Key，费用包含在月费中。缺点是重度使用可能触发速率限制。

方式二：API Key

如果你没有订阅，或者用量波动大，可以用 API Key 按量付费。步骤如下：

前往 http://console.anthropic.com 注册并登录（目前需要一个境外手机号，可以找接码平台代劳）
进入 API Keys 页面，点击 Create Key
将 Key 设置为环境变量：

1	export ANTHROPIC_API_KEY="sk-ant-..."

测试一下：

1	claude "用 Python 写一个计算斐波那契数列的函数"

如果 Claude 正常返回了一段代码，说明认证成功。

几个需要先知道的概念

在正式开始 cowork 之前，有几个概念值得先理清楚。

词元（Token） ：每次调用的计费单位。在 Claude Code 会话中，你可以用 /cost 命令查看当前会话消耗了多少 Token、花了多少钱。

上下文（Context） ：Claude Code 默认支持 200K tokens 的上下文窗口。Max 及以上订阅可以直接使用 1M 上下文窗口（仅限特定模型），Pro 订阅需要额外付费才能用。这意味着你可以在一次对话中给它相当多的代码和背景信息，它都能记住。

会话（Session） ：从 claude 启动到退出的一次连续对话。在同一个会话中，Claude 会保持对之前交流的记忆（未压缩上下文情况下）。退出后不用担心丢失，下次启动时可以用 claude --continue 恢复最近的会话，或者用 claude --resume 从历史会话中选择一个继续。

什么是 Agent

在 AI 圈子里，”Agent”这个词被用得太多了，每个人说的还不太一样，所以我们先把这个概念理清楚。

简单说：AI Agent = 会用工具的 AI。

普通的 AI 对话，比如你在网页端用 Claude 或 ChatGPT，你说”帮我写个函数”，它给你一段文字代码，仅此而已。你还得自己复制粘贴到编辑器里，自己跑测试，自己修报错。

而 Agent 模式的 AI，比如 Claude Code，不光能给你代码，还能帮你：

读取你现有的代码文件
编辑文件、创建新文件
执行 shell 命令（运行测试、编译项目）
搜索代码库、操作 Git

类比一下：普通 AI 就是个只能的对话助手，它可以告诉你详细的菜谱，但需要你自己照着做；Agent 模式的 AI 像是直接走进厨房，帮你把菜做出来。

Claude Code 就是一个 AI Agent。你说”帮我重构 auth 模块”，它会先分析现有代码结构，然后制定重构计划，接着逐个修改相关文件，最后运行测试验证。

整个过程中，它自己做决策，不需要你一步步指挥。当然，它做的决策不一定每次都对，所以最后你还是要验收。

什么是 Subagent

当任务太复杂时，Claude Code 还可以启动 Subagent（子代理）来并行处理多个独立子任务。

比如你让 Claude “同时处理这三个独立功能”，主 Agent 负责任务分解和协调，Subagent A 处理功能一，Subagent B 处理功能二，Subagent C 处理功能三，各自独立工作，完成后结果汇总给主 Agent。

其实 Subagent 是 Claude Code 的核心机制之一。很多时候你不需要主动调用，Claude 会自动根据任务类型启动合适的子代理，比如用 Explore 类型的子代理搜索代码，用 Plan 类型的子代理设计方案。你在不知不觉中就已经用到了。

Tool Use 是什么

Tool Use（工具调用） 是 Agent 实现能力的技术基础。简单说，就是给 AI 模型装上”手”，让它可以调用外部接口来完成任务。

Claude Code 中的 Tool Use 包括：

Read / Write / Edit：文件系统操作，相当于大厨的刀和锅
Bash：执行 shell 命令，相当于打开灶台的火
Grep / Glob：搜索代码内容和文件模式，相当于在食材仓库里找东西
WebFetch / WebSearch：获取网页内容和搜索互联网，相当于大厨去隔壁市场采购
Agent：启动子代理，相当于叫一个帮厨来搭手

这些工具让 Claude 从”能说会道”进化到”能说会做”。没有 Tool Use，大厨只能念菜谱给你听；有了 Tool Use，大厨才能真的走进厨房。

使用这些 Tool 依赖一个叫 MCP（Model Context Protocol，模型上下文协议）的东西，这个东西是 2024 年 Anthropic 开放的一个标准，现在不只有 Claude Code 在用，其他 AI Agent 也同样用。

实战：和 Claude Code 的第一次对话

概念讲完了，让我们动手试一下。

找任意一个项目目录，哪怕是空的也行，然后启动 Claude Code：

1 2	cd my-project claude

进入交互界面后，输入：

1	分析这个项目的目录结构，告诉我主要的模块有哪些

Claude 会自动调用 ls、cat 等工具去读取你的项目文件，然后输出分析结果。如果你在一个 Node.js 项目中，它可能会告诉你 src/ 是主代码目录、tests/ 是测试目录、package.json 管理依赖等等。

这个过程中你不需要指定它用什么命令，它自己会判断需要读取哪些文件，就像你不需要告诉大厨用哪把刀切洋葱一样。

常用命令速览

在 Claude Code 的交互界面中，斜杠命令是常用的操作入口：

/help：查看所有命令
/model：切换 Claude 模型（比如从 Sonnet 切到 Opus）
/init：在项目中初始化 CLAUDE.md 配置文件
/resume：恢复之前的历史会话
/clear：清空当前会话历史（硬重置，会丢失所有上下文）
/compact：压缩上下文（保留关键信息但释放 Token，不会完全丢失记忆）
/cost：显示当前会话的费用估算
/diff：查看当前未提交的代码变更
/exit：退出

其中 /compact 是个值得记住的命令，当会话变长、Token 消耗开始让人肉疼的时候，用它压缩一下，能省不少钱。Claude Code 自己也会自动压缩上下文。

大厨请进了厨房

大厨请进了厨房，也试了第一刀。

不过有一个问题：每次新会话，它都会忘记你家厨房的规矩，比如盐罐放哪、不吃香菜、大火爆炒别太干。下一篇文章，我们会给 Claude 写一份”厨房操作规范”，也就是 CLAUDE.md 配置文件。

封面图片来自豆包 AI，Prompt：构成主义、微观元素、自然景观、拼图艺术。

本文同步发布在知乎账号下：Claude Code 实践指南（一）：开始第一次对话