学习 Claude Code 使用

Claude Code 快速上手

它最适合什么人

如果你已经有一点点终端基础，想把 AI 真正带进本地项目开发里，Claude Code 是非常值得上手的工具。

它尤其适合下面几类人：

已经会一点命令行，想提升开发效率
在本地维护个人项目或公司项目
希望 AI 不只是“写几行代码”，而是真的帮你推进任务
想让 AI 读项目、改代码、跑命令、帮你验证结果

开始使用前，你至少要知道这几个概念

终端：Claude Code 运行的地方
项目目录：你要先进入对应代码仓库
依赖安装：很多项目第一次都要先 npm install
构建与运行：修改之后往往要 build 或 start

如果这些概念完全陌生，建议先回到你网站原本 AI 编程课程里的计算机基础部分补一下。

一张图看快速上手流程

加载图表中...

最基本的使用步骤

1. 安装

npm install -g @anthropic-ai/claude-code

安装完成后，先确认命令已经可用：

claude --version

如果这里能正常输出版本号，说明 CLI 已经装好了。
如果提示找不到命令，通常是全局 npm 路径没有加进环境变量。

1.5 第一次登录

第一次使用前，通常还需要登录你的 Claude 账号：

claude

首次启动时，Claude Code 会引导你完成登录或授权流程。
这一步做完之后，后面进入项目目录就可以直接开始用了。

2. 进入项目目录

cd your-project

这里非常关键。Claude Code 不是一个“脱离项目上下文的聊天框”，它会直接读取你当前目录下的代码、配置和文件结构。

所以你要先确认两件事：

当前目录就是你真正要改的项目根目录
这个项目已经能在本机正常安装依赖和运行

比如前端项目，你通常至少要先做一次：

npm install

如果项目本身都还没法运行，Claude Code 后面也很难帮你稳定推进任务。

如果你现在还没有项目，怎么让 Claude Code 帮你从零开始

很多新手第一次用 Claude Code，不是接手一个现成仓库，而是想直接让它帮自己创建一个新项目。
这种情况当然也可以，只是工作顺序要稍微换一下。

先准备一个空目录

比如你想做一个新的 React 项目，可以先手动建一个文件夹：

mkdir my-new-app
cd my-new-app
claude

这里的重点是：
即使你还没有代码，也最好先进入一个明确的空目录，再让 Claude Code 开始工作。
不要在桌面、下载目录或者一个很杂乱的总目录里直接开干。

第一句不要说“帮我做个项目”，而要说清楚技术栈

如果你只说：

帮我创建一个项目

Claude Code 很难判断你到底要：

React 还是 Vue
Next.js 还是 Vite
TypeScript 还是 JavaScript
要不要路由、数据库、鉴权、部署配置

所以更好的说法是：

我想从零创建一个 Next.js + TypeScript 项目。
先告诉我你准备怎么初始化项目、会生成哪些核心文件、依赖怎么安装。
先不要开始执行。

一个更稳的从零建站提示词

我现在在一个空目录里，想从零创建一个 Next.js + TypeScript 项目。

先告诉我你建议的初始化方式：
- 准备使用什么脚手架
- 会安装哪些依赖
- 会生成哪些关键目录

先不要执行。
确认后，再开始创建项目。
创建完成后，请启动项目并告诉我是否运行成功。

这样 Claude Code 的行为会清晰很多：

先规划
再生成
再验证

而不是一上来就创建一堆文件，最后你自己都不知道它做了什么。

新建工程时最常见的 3 个坑

1. 没有说清楚技术栈

“帮我做个博客”这种说法太模糊。
最好至少说清楚：

用什么框架
用什么语言
要不要 UI 库
是否要数据库

2. 在错误目录里初始化

如果你当前目录本来就有别的文件，Claude Code 可能会把新项目初始化在一个不干净的地方。
新建工程时，最好保证目录是空的，或者至少是专门为这个项目创建的。

3. 创建完不验证

项目创建结束，不代表真的可用。
你还需要让它继续做这一步：

请运行项目并检查是否能正常启动。
如果失败，继续帮我定位问题并修好。

最推荐的新手用法：先搭脚手架，再逐步加功能

如果你是第一次这样做，建议把流程拆成两段：

第一段：先把项目创建并跑起来
第二段：再让 Claude Code 继续帮你做页面、接口和功能

例如：

先帮我把 Next.js 项目创建好，并确认能启动。
完成之后，我们再继续做首页和登录功能。

这样成功率会明显高很多，也更容易定位问题到底出在“初始化”还是“功能开发”。

3. 启动 Claude Code

claude

进入之后，不要着急直接丢一个很大的需求。
最稳妥的起步方式，是先让它理解项目，再让它提出方案，最后再执行。

10 分钟完整上手流程

如果你是第一次真正用 Claude Code，可以直接照着下面这套流程走一遍。

第 1 步：确认你在正确项目里

先在终端里确认当前目录没错：

pwd
ls

你应该能看到熟悉的项目文件，比如 package.json、src、app、README.md 之类。

第 2 步：先让它理解项目，而不是立刻改代码

启动 claude 之后，第一句建议这样问：

先帮我看看这个项目的整体结构。
告诉我主要目录是做什么的，首页相关代码大概在哪些文件里。
先不要改代码。

这样做的好处是：

你先验证 Claude Code 有没有读对项目
它会先建立上下文，而不是盲改
你也能顺便知道后面改动大概率会落在哪些文件

第 3 步：让它先出方案

当它已经理解项目后，再继续：

我要给首页加一个简单的轮播图。
先给我一个实现方案，告诉我准备修改哪些文件、怎么改。
先不要执行。

这里的重点是“先方案、后执行”。
对于新手来说，这一步非常值钱，因为你可以先判断：

它理解的问题是不是你真正想做的
改动范围会不会太大
它有没有准备动到不该动的地方

第 4 步：确认之后再让它执行

如果方案没问题，再下执行指令：

可以开始改。
改完以后请运行构建检查，并告诉我改了哪些文件。

这时候 Claude Code 通常会开始：

读取相关文件
修改代码
运行构建、测试或 lint
汇报结果

第 5 步：你只看三件事

第一次使用，不需要把它每一步都盯死。
你只需要重点看这三件事：

它改了哪些文件
它有没有真的跑验证命令
构建或测试是否通过

如果它说“已完成”，但没提验证结果，你可以继续追问：

把你刚才运行的验证命令和结果总结一下。

第 6 步：继续小步迭代

第一次上手，不建议一口气让它做一整个复杂功能。
更好的方式是继续拆成一小步一小步：

接下来再帮我把这个轮播图加上自动播放和左右切换按钮。
先说说你准备怎么改。

这样你会更快建立起一种稳定协作节奏，而不是把 Claude Code 当成“一次性全包工具”。

一个最推荐的新手演练任务

如果你还没有真实任务，最适合拿来练手的是这种小需求：

给首页加一个 banner
修改一个按钮文案和颜色
找出某个报错来自哪个文件
给某个页面加一个简单模块
让它帮你解释一个目录结构

这类任务有几个优点：

改动范围小
容易验证
出错成本低
很适合建立你和 Claude Code 的协作习惯

第一次使用时，推荐直接复制的提示词

你可以把下面这段几乎原样拿去用：

先帮我理解这个项目结构。
告诉我这个项目的主要目录分别负责什么，以及我要修改的功能大概在哪些文件里。

然后给我一个实现方案，先不要改代码。

确认方案后，再开始修改。
改完请运行构建或测试检查，并告诉我最终改了哪些文件、验证是否通过。

这段提示词的好处是，它天然把一次协作拆成了：

理解
规划
执行
验证

这也是 Claude Code 最适合的工作节奏。

启动之后怎么提问

最推荐的方式不是一句话把所有需求糊上去，而是按这个节奏来：

先让它理解项目
再让它提出方案
然后再让它执行

例如：

先看看这个项目的整体结构，告诉我首页相关代码在哪些文件里。

然后给我一个给首页增加轮播图的实现方案，先别改代码。

确认方案后，再开始修改，并在最后运行构建检查。

新手最容易犯的几个错

没进入正确目录就启动 Claude Code
没装依赖就让它直接跑项目
一上来就给一个很大的模糊需求
修改完不让它验证构建和测试
不写 CLAUDE.md，每次都重复讲项目约束

再补两个经常被忽略的问题：

明明是想“先分析”，却没有明确说“先不要改代码”
Claude Code 已经报构建失败了，但自己没去看失败信息，只看“它有没有改完”

最稳妥的起步姿势