写给小白的 Claude Code 实操指南：从安装到实战

发表于 2026-03-12 更新于 2026-04-13 分类于阅读阅读次数：本文字数： 4k 阅读时长 ≈ 4 分钟

cover

上周五下午三点，我盯着一个 TypeError 看了四十分钟，注释翻了三遍，Stack Overflow 开了七个标签，问题还是没解决。最后我把报错信息丢给 Claude Code，它用两分钟找到了根因——一个我完全没想到的地方。

那一刻我意识到，这东西和我之前用过的所有 AI 工具都不一样。

什么是 Claude Code？为什么值得学

Claude Code 不是一个简单的代码补全工具。

GitHub Copilot 你可能听说过，它能在你打字的时候自动补全代码。但 Claude Code 做的事情完全不同——它更像一个会思考的编程助手，能够理解你的整个项目，帮你规划实现方案，甚至能跨多个文件进行修改。

举个例子。

你想给网站添加一个用户注册功能。用传统方式，你需要自己创建表单、写验证逻辑、连接数据库、处理错误。但用 Claude Code，你只需要说一句：”帮我添加用户注册功能，包括邮箱验证和密码强度检查”，它就会自动帮你完成所有步骤。

更重要的是，它会告诉你为什么要这样做，让你在使用的过程中不断学习。

46% 对 19% 对 9%——这是 2025 年开发者满意度调查里，Claude Code、Cursor、GitHub Copilot 的”最受喜爱”评分。Claude Code 在 2025 年 5 月正式发布，到 11 月就帮助 Anthropic 实现了超过 10 亿美元的年化收入。

这不是炒作，而是真实的生产力提升。

Claude Code 和其他工具有什么不同

在开始之前，我们先搞清楚 Claude Code 和其他 AI 编程工具的区别。

GitHub Copilot 就像一个快速的打字员。你写代码的时候，它会预测你接下来要写什么，自动补全。它很快，很方便，但它不会”思考”。

ChatGPT 更像一个聊天伙伴。你可以问它问题，它会给你答案和代码示例。但你需要自己把代码复制粘贴到项目里，它看不到你的完整代码库。

Cursor 是一个完整的代码编辑器，内置了 AI 功能。它可以理解你的项目，进行多文件修改。但它是一个独立的编辑器，你需要放弃你熟悉的 VS Code 或其他工具。

Claude Code 的特别之处在于：

它运行在你的终端里，可以直接访问你的代码库。它能读取所有文件，理解项目结构，执行命令，运行测试。它有 20 万 token 的上下文窗口（Opus 4.6 甚至支持 100 万 token），这意味着它可以”记住”你整个项目的内容。

最关键的是，它有”计划模式”（Plan Mode）。在动手之前，它会先告诉你打算怎么做，为什么这样做，让你确认后再执行。这种工作方式特别适合学习和复杂任务。

5 分钟快速上手

好了，理论说够了，我们开始实操。

第一步：安装 Claude Code

打开你的终端（Mac 用户打开 Terminal，Windows 用户打开 PowerShell 或 CMD）。

Mac 和 Linux 用户：

1	curl -fsSL https://claude.ai/install.sh \| bash

Windows 用户（PowerShell）：

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

安装完成后，输入这个命令验证：

1	claude --version

如果看到版本号，说明安装成功了。

第二步：登录账号

Claude Code 需要订阅才能使用。最基础的 Claude Pro 套餐是每月 20 美元。

在终端输入：

claude

第一次运行会提示你登录。按照提示操作，用浏览器完成登录就可以了。

登录信息会保存在本地，下次就不用再登录了。

第三步：开始你的第一次对话

进入你的项目目录：

1 2	cd /path/to/your/project claude

Claude Code 会扫描你的项目，然后你就可以开始对话了。

试试这个：

1	这个项目是做什么的？用了哪些技术？

Claude 会分析你的代码，给你一个清晰的项目概览。

再试试这个：

1	帮我在主页添加一个"Hello World"的标题

Claude 会找到对应的文件，告诉你它打算怎么改，然后等你确认。确认后，它就会自动修改文件。

就是这么简单。

让 Claude Code 更懂你：CLAUDE.md 文件

这是一个很多新手不知道的技巧。

在你的项目根目录创建一个叫 CLAUDE.md 的文件。这个文件就像是给 Claude 的”项目说明书”，告诉它你的项目用了什么技术，有什么编码规范，怎么运行测试。

一个简单的例子：

# 项目：我的博客网站

## 技术栈
- React 18
- TypeScript
- Tailwind CSS
- Node.js + Express

## 编码规范
- 使用函数式组件，不用 class 组件
- 所有函数必须有 TypeScript 类型标注
- 使用命名导出，不用默认导出

## 测试
- 运行测试：npm test
- 测试文件放在 __tests__ 目录

## Git 规范
- 提交信息格式：feat(模块): 描述
- 每个功能都要创建新分支

有了这个文件，Claude 就会按照你的规范来工作。它不会给你写 class 组件，不会忘记类型标注，提交代码的时候也会遵循你的格式。

这个文件不是必需的，但强烈建议创建。它能让 Claude 从第一次对话就理解你的项目风格。

计划模式：让 AI 先思考再动手

这是 Claude Code 最强大的功能之一。

当你要做一个复杂的修改时，比如重构一个模块，或者添加一个涉及多个文件的功能，你可以先进入”计划模式”。

在对话中输入：

/plan

然后告诉 Claude 你想做什么：

1	把用户认证模块从 Session 改成 JWT Token

Claude 会先分析你的代码，然后给你一个详细的计划：

我的计划如下：

修改 auth/middleware.js，把 Session 验证改成 JWT 验证

更新 auth/login.js，登录成功后返回 JWT Token

修改 auth/logout.js，处理 Token 失效

更新前端 API 客户端，在请求头中发送 Token

修改 3 个测试文件，使用 JWT 测试数据

是否继续执行？

你可以看到它打算改哪些文件，为什么要这样改。如果你觉得有问题，可以提出来，让它调整计划。确认后，它才会开始执行。

这种方式特别适合学习。你不仅能完成任务，还能理解背后的逻辑。

实战场景：Claude Code 能帮你做什么

场景一：调试 Bug

1	用户反馈说注册页面提交后没反应，帮我找找问题

Claude 会检查表单提交逻辑，查看网络请求，检查错误处理，然后告诉你问题在哪里，怎么修复。

场景二：添加新功能

1	给网站添加深色模式，用户的选择要保存在 localStorage 里

Claude 会创建主题切换组件，添加 localStorage 逻辑，处理页面加载时的闪烁问题，一步到位。

场景三：代码重构

1 2	/plan 这个文件用的是回调函数，帮我改成 async/await

Claude 会先规划重构步骤，确保不破坏现有功能，然后执行修改。

场景四：Git 操作

1	创建一个新分支叫 feature/dark-mode，提交刚才的修改，并创建 Pull Request

Claude 会帮你完成所有 Git 操作，甚至能写出规范的提交信息。

选择合适的模型：Sonnet 还是 Opus

Claude Code 提供两个模型：Sonnet 4.6 和 Opus 4.6。

我自己的用法是：日常写代码、改 Bug、加功能，全用 Sonnet。它够快，价格是 $3/$15 每百万 token，处理 90% 的任务没有压力。只有碰到那种”整个模块要重构、涉及十几个文件、逻辑关系很复杂”的情况，才切到 Opus——它支持 100 万 token 上下文（beta），推理能力更强，但 $15/$75 的价格也确实贵。

一开始我以为 Opus 会明显更好，实际用下来发现 Sonnet 在大多数场景里已经够用，没必要为了”更强”多花五倍的钱。

常用命令速查

这些是你会经常用到的命令：

命令	作用
`claude`	启动 Claude Code
`/help`	查看所有可用命令
`/plan`	进入计划模式
`/clear`	清空对话历史
`/cost`	查看本次会话的 token 使用量
`exit` 或 Ctrl+C	退出 Claude Code

大多数时候，你不需要记住这些命令。直接用自然语言告诉 Claude 你想做什么就行了。

给新手的 5 个实用建议

1. 具体描述你的需求

不要说”优化这个函数”，而是说”这个函数处理大数据时很慢，帮我优化性能”。越具体，Claude 的回答越准确。我踩过的坑：描述太模糊，Claude 给了一个”优化”但方向完全不对，来回确认反而浪费了更多时间。

2. 善用计划模式

对于不熟悉的代码或复杂任务，先用 /plan 让 Claude 规划。我第一次用这个功能是重构一个认证模块，看到它列出的修改清单，才发现自己漏掉了两个关联文件。

3. 创建 CLAUDE.md 文件

这个文件能让 Claude 从一开始就理解你的项目规范，节省大量解释时间。没有它之前，我每次开新会话都要重新说一遍”用函数式组件、不要 class”。

4. 不要害怕提问

如果 Claude 的回答你看不懂，直接问”为什么要这样做？”或者”能解释一下这段代码吗？”

5. 把 Claude 当成学习工具

不要只是让它写代码，要理解它为什么这样写。这样你的编程能力才会真正提升。

写在最后

回到那个周五下午的 TypeError。

Claude Code 找到问题之后，我问了一句”为什么会这样”，它解释了 JavaScript 的原型链在这个场景下的行为。我当时就想，如果我只是让它修好，我还是不懂这个坑；但因为我多问了一句，这个知识点就真的进脑子了。

Claude Code 能帮你处理重复性工作，能在你卡壳的时候给你思路。但它替代不了你对产品的判断，替代不了你对用户需求的理解，也替代不了你在技术方案上的取舍。

这些需要判断力的事情，才是你真正的价值所在。工具再强，最终做决策的还是你。

我现在最好奇的是：有没有人用 Claude Code 做过一些”超出预期”的事——不是写代码，而是用它解决了一个完全不像编程问题的问题？