前言
很多刚接触 AI 编程的新手小白,总会遇到这样的痛点:
想用 Claude 的 Skills 技能库提升效率,却在网页版里反复上传文件、调整格式,频繁切换窗口打断思路;想实现沉浸式的 Vibe Coding 氛围编程,却要在代码编辑器、浏览器、文档工具之间来回跳转,刚理清的思路瞬间就断了。
而 Claude Code,正是解决这些痛点的最佳方案------它是 Anthropic 官方专为开发者打造的 AI 原生终端 IDE,能让你在一个窗口里完成代码编写、文档处理、技能调用、Debug 排障的全流程操作,无需切换任何工具,完美适配 Vibe Coding 的心流式编程状态。
很多新手会觉得"终端工具、代码 IDE 听起来很难,我学不会",但这篇教程会彻底打消你的顾虑。我们完全从 0 基础小白的视角出发,全程无跳步、无晦涩术语,手把手带你完成 Claude Code 的下载、安装、账号登录、基础配置、Skills 技能加载的全流程,哪怕你是第一次接触终端、第一次用 Claude,也能跟着教程一步步完成,5 分钟就能上手使用。
一、新手先搞懂:Claude Code 到底是什么?和 Claude 网页版有啥区别?
在安装之前,我们先用 3 句话给纯小白讲清楚核心概念,避免概念混淆:
- Claude Code 是运行在终端里的 AI 原生 IDE:它不是带图形界面的桌面软件,而是在电脑终端(命令行窗口)里运行的开发工具,所有操作都可以通过自然语言完成,不用记复杂的代码命令。
- 它是 Claude Skills 技能库的最佳运行载体:和 Claude 网页版相比,Claude Code 对 Skills 技能的兼容性更好、触发更精准、运行更稳定,支持一键安装海量技能,还能实现项目级的技能隔离,是玩转 Claude Skills 的必备工具。
- 它能帮你实现真正的 Vibe Coding 沉浸式编程:你不用再在浏览器、代码编辑器、PDF 工具、Excel 之间来回切换,在 Claude Code 一个窗口里,就能完成需求拆解、代码编写、文档处理、数据提取、技能调用的全流程,全程不打断思路,守住心流状态。
我们用一张表给新手讲清它和 Claude 网页版的核心区别,一目了然:
| 对比维度 | Claude Code | Claude.ai 网页版 |
|---|---|---|
| 核心定位 | 专为开发者打造的 AI 原生 IDE,主打沉浸式开发 | 通用型 AI 对话网页工具,全场景通用 |
| Skills 支持 | 完美兼容,一键安装,支持全局/项目级隔离,触发精准 | 支持基础技能,需手动上传安装,兼容性一般 |
| 开发体验 | 一个窗口完成全流程操作,无需切换工具,不打断思路 | 需频繁切换浏览器和开发工具,容易打断编程节奏 |
| 项目适配 | 可直接读取本地项目文件,深度关联项目上下文,代码适配度更高 | 需手动上传项目文件,大项目支持有限 |
| 上手门槛 | 新手跟着教程 5 分钟就能上手,全程自然语言操作 | 零门槛,打开网页就能用 |
二. Claude Code 的工作逻辑
1. 核心工作机制:代理循环
Claude Code 的核心是一个 代理循环。当你给它一个任务时,它不会只给出一段代码建议,而是会像人类程序员一样,自主地、循环地执行以下步骤,直到任务完成:
- 收集上下文:读取你的项目文件、代码、错误日志等,全面理解当前状况。
- 采取行动:根据理解,规划并执行具体操作,如编辑文件、运行终端命令、搜索信息等。
- 验证结果:检查上一步行动的结果,判断任务是否成功,或哪里还需要调整。
这个"思考 → 行动 → 验证"的循环会不断重复,形成一个自主规划和执行的闭环,使其能够处理复杂的多步骤任务。
这个循环由两个关键部分驱动:模型 和工具。
1.1. 模型:Claude 的大脑
1.2. 工具:Claude 的双手
工具赋予了 Claude Code 实际操作的能力,让它不再仅仅是"纸上谈兵"。主要内置工具包括:
一个典型的修复 Bug 的流程就是这些工具的协同工作:运行测试 → 阅读错误日志 → 搜索相关文件 → 理解代码逻辑 → 修改代码 → 再次运行测试验证。
进阶扩展:可以用 skills(技能)、MCP(外部服务)、hooks(自动化)、subagents(子助手)等能力。
1.3. Claude 的能力

2. 灵活的会话操作
Claude Code 提供了三种会话管理方式,让你能灵活地继续工作或尝试新方案:
- 恢复会话 :使用
claude --continue或claude --resume命令,可以从上次中断的地方无缝继续,完整恢复聊天历史。 - 分叉会话 :使用
claude --continue --fork-session命令,可以基于当前对话历史创建一个全新的、独立的会话。这在你想尝试另一种实现方案,又不想影响原有对话时非常有用。 - 多终端共享会话:可以在多个终端窗口中同时使用同一个会话,但需谨慎操作以避免冲突。
三、安装步骤:全平台通用,0 基础也能一次成功
我们分 一键命令行安装(新手首选,最简单) 和 手动安装包安装 两种方式,你可以根据自己的电脑系统选择对应的步骤,全程复制粘贴就能完成,不用自己敲任何复杂代码。
第一步:打开电脑的终端工具
很多新手不知道终端是什么,也不知道怎么打开,我们分系统给你讲得明明白白,跟着做就行:
打开终端后,你会看到一个黑色(或白色)的命令行窗口,这就是我们后续安装和运行 Claude Code 的地方,不用怕,全程只需要复制粘贴命令就行。
第二步:一键命令行安装(新手首选,99% 的人都用这个)
这是官方推荐的安装方式,全平台通用,一条命令就能完成全部安装操作,不用手动配置任何东西,新手直接选这个。
-
复制下面的官方一键安装命令:
bashcurl -fsSL https://claude.ai/install.sh | bash -
把复制的命令,粘贴到你刚刚打开的终端窗口里(Mac 粘贴快捷键
Command + V,Windows 粘贴快捷键Ctrl + V); -
按下回车键,终端就会自动开始下载、安装 Claude Code,全程不用你做任何操作;
-
等待终端出现
Installation complete!的提示,就说明安装成功了!
补充:手动安装包安装方式(命令行安装失败时备用)
如果因为网络问题,命令行安装失败,你可以用手动安装包的方式安装,步骤同样简单:
- 打开 Claude Code 官方下载页面:https://claude.ai/download
- 根据你的电脑系统,下载对应的安装包(Mac 选 DMG 文件,Windows 选 MSI 文件,Linux 选 DEB/RPM 文件);
- 双击下载好的安装包,跟着安装向导的提示,一步步点击「下一步」「安装」,就能完成安装;
- 安装完成后,重启终端,就能使用 Claude Code 了。
第三步:验证安装是否成功
安装完成后,我们先验证一下有没有装成功,避免后续操作出问题:
-
在终端里输入下面的命令,按下回车:
bashclaude --version -
如果终端输出了类似
claude x.y.z的版本号(比如claude 0.15.0),就说明安装完全成功了! -
如果提示「命令未找到」,也不用慌,看本文最后的「新手高频踩坑全解」,里面有对应的解决方案。
四、账号登录与使用
安装成功后,我们就可以启动 Claude Code,完成账号登录了,全程跟着步骤走,1 分钟就能完成。
1. 启动 Claude Code
在终端里直接输入 claude,按下回车键,就能启动 Claude Code。
启动成功后,你会看到 Claude 的欢迎界面,同时会出现登录提示,大概是这样的:
To use Claude Code, you need to log in to your Claude account.
Please visit this URL in your browser: https://claude.ai/activate
And enter this code: XXXX-XXXX
2. 完成账号授权登录
- 复制终端里显示的授权链接
https://claude.ai/activate,用浏览器打开; - 在打开的网页里,登录你的 Claude 付费账号(一定要用付费账号,免费账号登录了也用不了);
- 登录成功后,网页会让你输入终端里显示的 6-8 位激活码(就是上面例子里的
XXXX-XXXX); - 输入激活码,点击「授权」,网页会提示「授权成功」;
- 回到终端窗口,你会看到终端已经自动完成登录,出现了 Claude 的对话输入框,开头是
claude >,这就说明登录完全成功了!
划重点:授权页面的激活码有效期只有 5 分钟,如果超时了,在终端里按下 Ctrl + C 退出,重新输入 claude 启动,就能获取新的激活码。
3. 配置模型
配置 Claude Code
配置文件路径 :~/.claude/settings.json
json
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "您的 Coding Plan API Key",
"ANTHROPIC_BASE_URL": "https://maas-coding-api.cn-huabei-1.xf-yun.com/anthropic",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": 1,
"API_TIMEOUT_MS": 600000,
"ANTHROPIC_MODEL": "astron-code-latest",
"ANTHROPIC_SMALL_FAST_MODEL": "astron-code-latest"
},
"permissions": {
"allow": [],
"deny": []
}
}
重新打开一个新的终端使环境变量配置生效。

通过上面步骤,就完成了 Claude Code 的配置。接下来就开始练习如何使用。
3.3. 在各种工具中安装 Claude Code 插件
如果不习惯 Claude Code 的命令行模型,可以在 VS Code 编辑器中安装 Claude Code。在 VS Code 中安装 Claude Code 插件。


上面就是在 VS Code 安装好了 Claude Code 插件。下面是三种权限模式:

其他一些小功能:
关于其执行环境与界面
五. 使用教程
1. 基础命令
| 命令 | 描述 | 其他 |
|---|---|---|
esc 键 |
执行退出 | |
/resume |
恢复刚才的对话 | |
/ |
列出所有命令 | |
/clear |
清除会话 | |
/cost |
查看当前会话消耗,防止无意识烧 Token | |
/compact |
压缩上下文 | |
/reset |
切换任务时非常重要 | |
/review |
检查 Git 暂存区改动 |
2. 键盘快捷键
| 分类 | 快捷键/操作 | 核心功能 |
|---|---|---|
| 常规控制 | Ctrl+C |
取消当前输入/生成 |
Ctrl+D |
退出会话 | |
Ctrl+L |
清屏(保留历史) | |
Ctrl+O |
切换详细输出(显示工具执行日志) | |
Ctrl+R |
反向搜索命令历史 | |
Option+P / Alt+P |
切换模型(不清空提示) | |
| 文本编辑 | Ctrl+K / Ctrl+U |
删除到行尾/删除整行(删除内容可粘贴) |
Ctrl+Y |
粘贴 Ctrl+K / Ctrl+U 删除的内容 |
|
Alt+B / Alt+F |
光标按单词前后移动(需 Meta 键配置) | |
| 主题显示 | Ctrl+T |
切换代码块语法高亮(仅 /theme 菜单内有效) |
| 多行输入 | \ + Enter / Shift+Enter |
换行输入(Shift+Enter 在 iTerm2/WezTerm 等终端免配置) |
Ctrl+J |
多行换行符 | |
| 快速命令 | / 开头 |
触发斜杠命令(详见斜杠命令文档) |
! 开头 |
直接运行 Bash 命令(输出计入会话) | |
@ |
触发文件路径自动补全 |
六、新手必做的基础配置:含 Skills 技能库加载核心教程
登录成功后,我们只需要做几个简单的基础配置,就能让 Claude Code 更好用,重点是新手最关心的 Skills 技能库加载配置,跟着步骤做,一键就能完成。
1. 新手基础设置:3 个必改的基础配置
Claude Code 的所有设置都可以通过自然语言完成,不用记复杂命令,你直接在 claude > 后面输入对应的指令,按下回车就能完成配置。
① 设置中文为默认语言
输入下面的指令,按下回车,就能让 Claude Code 全程用中文和你沟通,避免出现中英文混杂的情况:
请把你的默认交互语言设置为简体中文,所有输出、提示、报错都用简体中文,不要用英文
② 开启自动技能触发
输入下面的指令,开启自动技能触发,Claude 会自动识别你的需求,调用对应的 Skills 技能,不用你每次手动指定,完美适配 Vibe Coding 的无打断诉求:
请开启自动技能触发功能,自动识别我的需求,匹配并调用对应的已安装技能,无需我每次手动指定
③ 设置默认文件路径
新手经常找不到 Claude Code 读取的文件在哪里,输入下面的指令,就能把默认路径设置为你的桌面,方便你管理文件:
2. 核心教程:Skills 技能库一键安装与加载
这是本系列教程的核心,也是新手最关心的部分,我们用最简单的方式,带你完成官方 Skills 技能库的一键安装、加载与验证,全程复制粘贴就能完成。
① 新手首选:官方技能库一键安装
Anthropic 官方提供了打包好的技能包,一条命令就能完成安装,不用手动下载、上传,新手直接复制下面的命令,粘贴到 claude > 后面,按下回车就行。
-
安装生产级文档处理全量技能包(包含 pdf、docx、pptx、xlsx 4 个新手最高频使用的技能,必装):
bash/plugin install document-skills@anthropic-agent-skills -
安装开发类全量技能包(包含前端设计、组件构建、自动化测试等开发技能,写代码的新手必装):
bash/plugin install example-skills@anthropic-agent-skills
按下回车后,Claude Code 会自动完成技能的下载、安装、加载,出现 Installed successfully 的提示,就说明安装成功了。
② 验证技能是否加载成功
安装完成后,输入下面的指令,按下回车,就能看到所有已安装、已加载的技能列表:
列出我当前所有已安装的技能,包括技能名称、核心功能和触发方式
如果能看到你刚刚安装的 pdf、docx、frontend-design 等技能,就说明技能已经成功加载,可以正常使用了。
③ 新手必懂:全局技能 vs 项目级技能
给新手讲清楚两个核心概念,避免后续使用混乱:
- 全局技能:我们上面用命令安装的,就是全局技能,安装后,不管你在哪个文件夹、哪个项目里使用Claude Code,都能调用这些技能,适合新手安装通用型的高频技能。
- 项目级技能:如果你只想让某个技能在当前项目里使用,只需要在项目根目录创建一个.claude/skills/文件夹,把技能文件放进去,Claude Code启动时会自动加载这个文件夹里的技能,仅当前项目可用,不会影响其他项目,适合有专属项目规范的场景。
七. 项目应用
1. 项目初始化 init
/init 命令的核心作用是为当前项目创建一个名为 CLAUDE.md 的持久化配置文件。这个文件相当于给 Claude Code 提供了一份专属的"项目说明书"或"长期记忆",确保它在每次会话中都能理解项目的背景、结构和规范。

CLAUDE.md 文件详解
当你在项目根目录下执行 /init 命令后,Claude Code 会自动分析你的代码库,并生成一个 CLAUDE.md 文件。这个文件通常包含以下内容:

主要优势
使用建议
2. 项目结构
一个典型的 Claude Code 项目目录结构如下






3. Claude Code 交互模式
三大核心交互模式(Ask、Plan、Edit),***Ask 是搞清楚问题,Plan 是避免走弯路,Edit 是谨慎执行。***Claude 很强,但依然可能产生错误或幻觉。
Claude Code 根据任务性质引入了三种思维模式,开发者需在 Prompt 中明确意图,系统会自动或手动切换模式
Claude Code 根据任务性质引入了三种思维模式,开发者需在 Prompt 中明确意图,系统会自动或手动切换模式。
6.3.1. Ask 模式:只看不动(只读分析)
6.3.2. Plan 模式:谋定后动(只规划)
Plan 模式用得越多,返工概率就越低。
6.3.3. Edit 模式:直接执行(可写代码)
八. 操作应用
1. / 执行内置操作
比如 **/cost**

2. @ 引用具体文件、代码或目录

3. ! -- Bash 命令
通过在输入前加上 ! 直接运行 bash 命令,无需通过 Claude

九. 用法
不要把它当成简单的聊天机器人,而要把它视为一位执行力极强、但需要明确约束的工程师 。
原则:提问越模糊,回答越泛泛;提问越具体(背景、目标、约束),产出越精准
1. 场景一:学代码 (像导师一样请教)
Claude Code 擅长把复杂概念讲清楚,关键在于设定"受众"和"深度"。
新手视角的解释
错误问法 :"这段代码什么意思?"(容易得到跳过细节的总结)
正确问法 :"假设我是刚学 Python 的新手,请用通俗易懂的方式,逐行解释这个函数的执行流程。"(强制其减少术语,使用类比)
方案对比与审美培养
用法 :当你觉得代码"能跑但不够好"时,要求它提供 2-3 种实现方式进行对比(如:当前写法 vs 函数式写法)。
收益 :从可读性、性能、扩展性三个维度建立代码审美。
逐行拆解复杂逻辑
用法 :针对复杂的 if/else 或状态机,要求"逐行解释输入、输出和副作用",并指出潜在的 Bug 点。
2. ️ 场景二:写代码 (像架构师一样描述)
写代码时,切忌直接追求完美,应从小而确定的需求开始,明确输入、输出和约束。
高质量的需求描述
公式 :输入是什么 + 输出是什么 + 约束条件(如:不依赖第三方库)。
示例 :"写一个 Python 函数,输入邮箱字符串,输出布尔值。要求不依赖第三方库,仅使用正则。"
边界控制
明确告诉它模块的职责边界(例如:"只负责数据转换,不处理 IO"),防止过度设计。
生成测试用例
强烈推荐:让 Claude 参考项目现有的测试风格,补充单元测试(覆盖正常情况和边界情况)。这是初学者养成的最好习惯之一。
3. ️ 场景三:改代码 (像资深同事一样审查)
修改代码比写新代码更难,核心原则是**"控制变量"**,即明确什么能改,什么绝对不能动。
安全重构
关键指令 :"在不改变现有逻辑/行为的前提下 ,重构这个函数。"
目标 :重命名变量、拆分逻辑块、消除重复代码。
提升可读性
指令 :"哪些地方可以加注释或拆成小函数?请帮我把这个长函数拆分成职责清晰的模块。"
统一风格
指令:"按照当前项目的风格规范,统一这几个文件的格式、命名和结构,不要改动逻辑。"
4. 终极提问模板 (建议收藏)
为了限制 Claude 的"自由发挥"(如自动补全功能或过度重构),请养成使用结构化提问的习惯:
背景 :我现在在做什么(上下文)
目标 :我希望达到什么效果
约束 :不能做什么 / 必须遵守什么(例如:不要引入新库、不要改变函数签名)
输出要求:代码 / 解释 / 步骤
十. Claude Code MCP 能力
MCP(Model Context Protocol)是 Claude Code 连接本地环境与外部世界的桥梁。如果说基础版 Claude 是一个被隔离的"代码顾问",那么配置了 MCP 的 Claude 则进化为拥有"手和脚"的全能工程师------它能直接读写你的本地文件、操作数据库、甚至控制浏览器。
MCP 本质上是一个标准化的通信协议。它允许 Claude Code 安全地连接到本地服务器或远程 API,从而获取上下文信息并执行操作。
1. 核心价值

2. 场景描述
场景一、浏览器自动化
利用 Puppeteer 让 Claude 具备"眼睛",能进行网页测试或数据抓取。

场景二、数据库直连
让 Claude 直接查询数据,无需通过中间层。
3. 管理MCP
MCP 的配置通常存储在 ~/.claude.json 或项目级的 .claude/mcp.json 中。
常用管理命令
MCP 是 Claude Code 从"玩具"走向"生产力"的关键一步。通过简单的配置,你可以将 Claude 嵌入到你的开发工作流中,让它不仅能"写代码",还能"跑代码"、"测代码"和"管代码"
十一. 记忆系统
Claude Code 的记忆系统并非简单的"聊天记录保存",而是一套精密的分层记忆架构。它让 Claude 从一个每次重启都"归零"的聊天机器人,进化为能够随着时间推移、不断积累项目知识与用户偏好的"长期结对编程伙伴"
1. CLAUDE.md:你给 Claude 的"家规"
- 性质:由用户手动编写的指令文件。
- 用途:定义项目规范、代码风格、构建命令等"硬性规则"。
- 位置:通常位于项目根目录或用户全局配置目录。
- 示例内容:"本项目使用 pnpm 而非 npm"、"所有组件必须使用 TypeScript 编写"。
2. MEMORY.md:Claude 自己的"工作笔记"
- 性质:由 Claude 自动创建并维护的笔记本。
- 用途:记录跨会话的动态知识,如调试经验、架构决策背后的原因、用户临时表达的偏好。
- 机制:Claude 会在工作中自动判断哪些信息值得保存,并写入该文件。
- 示例内容:"上次修复 Bug #123 时发现,数据库连接池需配置为 10"、"用户喜欢用简短的英文提交信息"。
核心区别
3. 上下文即资源
上下文窗口是稀缺资源,Claude Code 采用了精细化管理策略。
子智能体记忆隔离
当 Claude 调用子智能体处理复杂任务时,子智能体拥有独立的记忆目录(~/.claude/agent-memory/)。这确保了子任务的调研过程不会污染主会话的记忆,任务结束后仅回传摘要与结论。
4. 最佳实践
- 各司其职:将团队共识写入 CLAUDE.md,让 Claude 自动积累经验到 MEMORY.md。
- 保持精简:定期检查 MEMORY.md,删除错误或过时的记录,避免"噪音"干扰。
- 隐私保护:使用 CLAUDE.local.md 存储私有的本地配置(如测试数据路径),并将其加入 .gitignore。
- 适度原则:记忆并非越多越好。精准、清晰的记忆比海量的堆砌更能提升 Claude 的表现
.材料参考
菜鸟教程:https://www.runoob.com/claude-code/claude-code-intro.html
官方文档:https://code.claude.com/docs/en/overview
中文文档:https://code.claude.com/docs/zh-CN/overview
Github 开源:https://github.com/anthropics/claude-code
新手进阶路线:装完之后,你可以这样学
完成了基础的安装、配置、技能安装,你已经入门了Claude Code,接下来可以沿着这个路线,一步步玩转Claude Code,打造专属的Vibe Coding沉浸式编程环境:
- 第一步:熟练使用高频基础技能:先把pdf、docx、xlsx这些高频办公技能用熟,解决日常工作里的文档处理需求,培养使用习惯;
- 第二步:安装更多优质技能仓库:去看我们之前的《全网爆火的10个Claude Skills开源仓库》文章,根据自己的使用场景,安装对应的优质技能,拓展Claude的能力边界;
- 第三步:结合系统提示词,打造专属AI搭档:用我们之前讲过的AI编程系统提示词构建方法,给Claude Code设置专属的系统提示词,让它完全适配你的工作习惯、开发规范,成为你的专属搭档;
- 第四步:学习制作自定义技能:用官方的skill-creator技能,根据自己的高频需求,制作专属的自定义技能,把重复的工作流程固化成技能,彻底解放双手;
- 第五步:打造沉浸式Vibe Coding环境:把Claude Code和你的开发项目深度结合,设置项目级技能、专属系统提示词,实现一个窗口完成全流程开发,全程不切换工具,不打断思路,真正实现心流式编程。
总结
很多新手会觉得,AI编程、终端IDE是程序员才会用的东西,自己学不会。但实际上,Claude Code的设计初衷,就是让所有人都能通过自然语言,轻松使用AI的全部能力,不用记复杂的命令,不用懂专业的代码知识。
这篇教程从0基础小白的视角出发,带你完成了从下载、安装、登录、配置到技能加载的全流程,哪怕你是第一次接触终端,第一次用Claude,也能跟着教程一步步完成,成功上手Claude Code。
而Claude Code真正的魅力,在于它能帮你彻底摆脱多工具切换的繁琐,守住编程和创作的心流状态,实现真正的Vibe Coding氛围编程。不用再被琐碎的操作打断思路,不用再在多个工具之间来回跳转,你只需要专注于你的需求和创意,剩下的全部交给Claude Code和Skills技能库来完成。