BrainBank
AI 课堂/分步指南Claude Code Deep Dive

Claude Code 快速上手

2026/7/12 21:14:47 · 更新于 2026/7/12 21:16:23

#claude-code#anthropic#cli#ai-coding#agent#step-by-step

本文详细介绍了 Anthropic 本地 AI 编程助手 Claude Code 的安装、初始化、项目新建及核心协作工作流，帮助开发者通过「先方案后执行」的节奏高效开展 AI 辅助开发。

第 1 段，共 103 段

它最适合什么人

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

它尤其适合下面几类人：

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

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

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

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

一张图看快速上手流程

image.png

最基本的使用步骤

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 项目。
先告诉我你准备怎么初始化项目、会生成哪些核心文件、依赖怎么安装。
先不要开始执行。

推荐的新建项目节奏

从零建项目时，最稳妥的顺序是：

  1. 先明确项目类型和技术栈
  2. 让 Claude Code 给出初始化方案
  3. 再让它执行项目创建
  4. 创建后让它帮你检查项目是否能跑起来
  5. 最后再开始做具体功能

也就是说，不要把“创建项目”和“开发完整功能”一次性混在一个指令里。

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

我现在在一个空目录里，想从零创建一个 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 通常会开始：

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

第 5 步：你只看三件事

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

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

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

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

第 6 步：继续小步迭代

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

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

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

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

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

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

这类任务有几个优点：

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

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

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

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

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

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

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

  • 理解
  • 规划
  • 执行
  • 验证

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

启动之后怎么提问

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

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

例如：

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

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

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

新手最容易犯的几个错

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

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

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

最稳妥的起步姿势

image.png

小结

快速上手的关键，不是会多少命令，而是先掌握一个节奏：

  • 先进项目
  • 先理解再执行
  • 改完要验证
  • 从小任务开始建立协作手感

只要你按这个节奏走，Claude Code 很快就会从“新玩具”变成“常用开发搭档”。

学习地图

阶段 1：基础环境与安装

  • 安装与授权：在本地配置好 Node.js 环境后，使用 npm 全局安装并登录 Claude 账号。这是后续一切操作的前提。
  • 目录上下文感知：理解 Claude Code 是直接运行在项目目录内的，它需要读取本地文件和 package.json，所以确保在正确的目录下启动非常关键。

阶段 2：建立协作节奏（黄金四步法）

  • 理解项目：先让 AI 解释项目结构，不盲目改代码，确保上下文无误。
  • 先方案后执行：先让 AI 提供修改思路和涉及的文件，确认无误后再授权其修改代码，防止大范围误改。
  • 自动化验证：修改完成后，要求 AI 运行构建（build）或测试命令，闭环验证修改结果。

阶段 3：工程化进阶

  • 配置 CLAUDE.md：在项目根目录创建约束文件，让 Claude 每次运行都自动遵循技术栈规范、代码风格和测试指令，无需重复输入提示词。

动手实践——分步指南

步骤 1：全局安装 Claude Code

打开终端，运行以下命令安装官方 CLI 工具：

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

安装完成后，运行 claude --version 确认安装成功。

步骤 2：完成账号授权登录

在终端输入：

claude

首次运行会弹出一个授权链接，在浏览器中打开并登录你的 Anthropic 账号，完成终端的绑定授权。

步骤 3：准备测试目录

新建一个纯净的空文件夹作为测试项目，并进入该目录：

mkdir claude-demo-project && cd claude-demo-project

步骤 4：以「先规划再执行」方式初始化项目

在当前目录启动 claude，并发送以下指令：

我想从零创建一个 Next.js + TypeScript 项目。请先告诉我你建议的初始化方式和会生成的文件，先不要执行修改。

待 Claude 给出清晰方案后，再输入“同意，请开始执行”，并观察其自动创建文件的过程。

步骤 5：运行并闭环验证

项目创建完成后，在 Claude 交互界面中输入：

请帮我运行项目并检查是否能正常启动。如果有任何报错，请直接帮我定位并修复。

体验 Claude Code 自动运行本地命令和修复依赖的完整闭环。

三大推荐资源

  1. 1
    Anthropic Official Claude Code Guide

    官方权威指南，详细介绍了 Claude Code CLI 的命令参数、安全策略以及本地权限控制。

    https://docs.anthropic.com/en/docs/about-claude/claude-code

  2. 2
    NPM @anthropic-ai/claude-code

    官方 NPM 托管页面，可查看最新发布版本、依赖项信息以及更新日志。

    https://www.npmjs.com/package/@anthropic-ai/claude-code

  3. 3
    Anthropic Developer Discord

    官方开发者社区，设有专门的 Claude Code 讨论区，适合交流复杂项目配置与使用心得。

    https://discord.gg/anthropic

链接由 AI 推荐——使用前建议快速核实。