Skip to content

Claude Code 零基础终极教程 ​

从安装到实战,一次讲透 Claude Code 所有核心功能

参考视频:Claude Code 零基础终极教程


目录 ​

  1. 环境安装
  2. 切换模型
  3. 界面介绍
  4. 权限系统
  5. Tools 工具
  6. Hooks 钩子
  7. Skills 技能
  8. Plugin 插件
  9. Sub-agent 子智能体
  10. 自动化任务
  11. 实战项目
  12. CLAUDE.md 与 .claude 文件夹

1. 环境安装 ​

需要安装三个东西 ​

软件作用安装方式
Git代码版本管理(AI 的"后悔药")git-scm.com 下载安装包,或 macOS 通过 Homebrew:brew install git
VSCode图形化工作界面(文件树 + 代码查看 + 终端)code.visualstudio.com 下载安装
Claude CodeAI 编程助手npm install -g @anthropic-ai/claude-code

安装步骤 ​

  1. 安装 Git — 从官网下载安装包,或 macOS 使用 brew install git(需先安装 Homebrew)
  2. 安装 VSCode — 下载安装包后拖拽到 Applications
  3. 安装 Claude Code — 终端执行安装命令,看到 installation complete 即完成

提示:Git 只需安装,不需要学习命令——AI 会自动管理版本控制。


2. 切换模型 ​

Claude Code 不仅限于 Anthropic 的 Claude 模型,可以使用第三方模型。

方案:CC Switch ​

  1. 安装 CC Switch:从 GitHub 项目安装
  2. 打开 CC Switch APP
  3. 点击右上角 + 添加模型提供商
  4. 选择提供商(如 MiniMax)和模型
  5. 填入 API Key
  6. 点击 启用
  7. 回到 Claude Code,默认模型已切换

注意:自动化任务(云端运行)不支持第三方模型,只能使用 Claude 订阅。


3. 界面介绍 ​

VSCode 布局 ​

区域位置用途
左边栏左侧文件树、插件管理
下边栏底部终端(Claude Code 主入口)
主区域中央查看和编辑代码

终端状态栏信息 ​

信息含义
sonnet 4.6当前使用的模型
工作目录路径当前项目文件夹
0.0k当前对话累计消耗 Token
CTX 9%已使用上下文窗口百分比
5h 32%当前订阅 5 小时额度使用率
7D 28%一周额度使用率

VSCode Claude Code 插件 ​

  1. 在 VSCode 插件市场搜索 "Claude Code"(Anthropic 蓝标)
  2. 安装后,右上角出现 Claude Code 图标
  3. 推荐在右边栏使用 Claude Code(左边栏留给文件树)
  4. 支持斜杠命令、文件上传、@ 引用上下文

4. 权限系统 ​

Claude Code 有四种权限模式,从左到右权限递增:

模式行为
Plan Mode(计划模式)只做计划,不修改任何文件
Ask Before Edit(默认)每次修改文件前征求同意
Edit Automatically常见编辑命令自动执行,但敏感命令(如 open)仍会询问
Bypass Permissions全部权限放开,不询问

开启 Bypass Permissions ​

方式一(VSCode 插件):Code → Settings → Settings → 搜索 allow dangerous → 勾选

方式二(终端):

bash
claude dangerous-skip-permissions

5. Tools 工具 ​

概念 ​

大模型只能推理(告诉你答案),工具让它能改变环境(写文件、执行命令等)。

大模型(大脑:思考要做什么)
    ↓
Claude Code(解析:要调用哪个工具)
    ↓
工具(手:执行具体操作)
    ↓
环境被改变

内置工具 ​

工具用途
Bash执行终端命令
Read读取文件
Write写入文件
Edit编辑文件
WebSearch网络搜索
WebFetch网页抓取

工作流程示例 ​

用户说:"把主题颜色从红色改为绿色"

  1. 大模型思考 → 需要调用工具修改代码
  2. Claude Code 调用 Bash 查看项目文件
  3. 调用 Read 读取相关文件
  4. 调用 Edit 修改颜色代码
  5. 完成

6. Hooks 钩子 ​

概念 ​

Hooks 是在 Claude Code 运行到关键节点时插入自定义逻辑的机制,可以看作智能体的监督员。

常见 Hook 节点 ​

Hook 节点触发时机
stop主智能体结束任务前
sub_agent_stop子智能体结束任务前
pre_tool_use调用工具前
post_tool_use调用工具后
post_tool_use_failure调用工具失败后
compression_start/end上下文压缩前后
permission_request请求权限前

创建 Hook 示例 ​

用自然语言告诉 Claude Code:

"帮我创建一个 hook,在 Claude Code 准备结束前做交付验收。如果本轮改了代码但没测试,或有待办没完成,就不允许结束,继续工作。"

创建后,在 .claude/settings.json 中可以看到自动生成的 hook 配置。

Hook 类型 ​

  • command 类型:直接执行 shell 命令
  • prompt 类型:给 Claude Code 一段提示词让它自行判断

7. Skills 技能 ​

概念 ​

Skills 是完成特定任务的能力包——将提示词、流程、资源打包,让 Claude Code 自动调用。

Skill 结构 ​

skills/
└── 你的技能名/
    ├── skill.md          # 核心文件:定义何时用、怎么用
    ├── 其他.md           # 辅助说明文档
    └── scripts/          # 代码脚本

skill.md 核心内容 ​

  • name:技能名称
  • description:触发条件(什么情况下自动调用)
  • 步骤流程:完成任务的具体步骤
  • 最佳实践:风格指南、注意事项
  • 资源引用:调用同文件夹下的其他文档和脚本

创建自定义 Skill ​

一句话即可创建:

"创建一个 skill:用户给主题后,先去网上搜索,整理信息,然后调用 PPTX skill 生成 PPT。"

官方 Skills 仓库 ​

Anthropic 官方提供 Skills 仓库,例如 PPTX(生成/编辑 PPT),可以直接安装使用。


8. Plugin 插件 ​

概念 ​

Plugin = Skills + Hooks + MCP Server 打包在一起,是一整套工作能力。

示例:视频生成 Plugin ​

组件作用
Skills教 Claude Code 写视频脚本和分镜
Hooks渲染前检查文件是否完整
MCP Server连接视频渲染工具

安装 Plugin ​

方式一(在线安装): 在 Claude Code 中输入 _plugin → manage plugin → 浏览可用插件 → 安装

方式二(本地 zip 安装——网络慢时替代方案): 当 GitHub 网络连接缓慢或不可用时,可以手动下载 zip 压缩包通过本地路径安装:

bash
# 1. 从 GitHub 下载仓库 zip 并解压
# 2. 添加本地路径为 marketplace
/plugin marketplace add /path/to/ECC-main

# 3. 安装插件
/plugin install ecc@ecc
# → ✓ Installed ecc. Run /reload-plugins to apply.

# 4. 加载插件
/reload-plugins

适用场景: GitHub 网络受限的环境 / 需要离线安装 / 安装前审查或修改插件内容 / 临时使用本地修改版本

默认插件 ​

front end design 插件默认已安装,包含前端设计相关的 skill。


9. Sub-agent 子智能体 ​

概念 ​

  • Agent(智能体):能替你完成工作而不仅是回答的 AI
  • Sub-agent(子智能体):主智能体派出的专门助手,具有独立的上下文和独立的工作权限
    • 不污染主智能体的上下文
    • 可多个子智能体并行工作
    • 只汇报结果,思考过程不进入主对话

创建步骤 ​

  1. 打开终端 Claude Code
  2. 输入 _agents → 进入管理界面
  3. 选择 Library → Create new agent
  4. 选择作用范围:project(当前项目)或 personal(全局)
  5. 选择生成方式:generate with Claude(推荐)
  6. 描述 agent 的职责和要求
  7. 配置工具权限(只读/全部)
  8. 选择模型
  9. 选择颜色标识
  10. 配置记忆范围:项目级 / 无持久记忆 / 全局

生成的文件结构 ​

.claude/
├── agents/
│   └── agent-name.md    # 角色声明 + 系统提示词 + 工作流程
└── agent-memory/         # 持久记忆存储

10. 自动化任务 ​

创建定时任务 ​

使用 _schedule 命令创建:

"创建每天早 8 点的定时任务,使用 evidence researcher 子智能体搜索前一天 AI 新闻,交叉验证信息源,最后总结给我。"

自动化运行 ​

  • 任务在云端运行(需要 Claude 订阅)
  • 支持 cron 表达式设置时间
  • 可通过 Web 界面查看运行历史和结果
  • 限制:云端运行不支持第三方模型

11. 实战项目 ​

项目:AI Hook Club(爆款开头生成器) ​

功能: 用户输入主题 → 选择平台和内容类型 → AI 生成 10 个不同风格的爆款开头 → 支持复制、收藏、历史记录

开发流程 ​

  1. 安装 Superpowers 插件 — 提供开发最佳实践
  2. 头脑风暴 — Superpowers 自动提问细化需求(语言、模型、返回方式、风格差异化等)
  3. 生成 SPEC — 产品需求 + 技术架构文档
  4. 制定开发计划 — 分步骤执行计划
  5. 子智能体驱动开发 — 并行执行任务,主智能体负责 review
  6. 配置 API — 填入 API Key(.env.local 文件)
  7. 验收 — 本地运行测试所有功能

技术栈 ​

  • 前端 + 后端一体化 Web APP
  • 调用大模型 API 生成文案
  • 本地存储历史记录和收藏

12. CLAUDE.md 与 .claude 文件夹 ​

项目结构 ​

项目根目录/
├── CLAUDE.md              # 项目说明书(给 Claude Code 的指南)
└── .claude/
    ├── settings.json      # Hooks 配置等
    ├── agents/            # 子智能体定义
    ├── agent-memory/      # 子智能体记忆
    ├── skills/            # 技能包
    └── plugins/           # 插件(项目级安装时)

CLAUDE.md ​

  • 给 Claude Code 的项目说明书
  • 包含:技术栈、如何运行、功能限制、风格偏好
  • 软性规定:进入上下文但可被覆盖
  • 应尽量简短
  • 使用 _init 命令自动生成

.claude 文件夹 ​

  • 管理 Claude Code 所有拓展能力
  • 包含 skills、agents、hooks、plugins 等配置
  • 项目级(在项目目录下)vs 全局级(在用户根目录下)

规则对比 ​

机制性质说明
CLAUDE.md软性进入上下文,作为参考
Hooks硬性必须执行的检查

总结 ​

安装(Git + VSCode + Claude Code)
    → 换模型(CC Switch)
    → 理解界面和权限
    → 掌握核心概念:
       • Tools(手:执行操作)
       • Hooks(监督员:关键节点检查)
       • Skills(能力包:特定任务流程)
       • Plugin(组合包:Skills + Hooks + MCP)
       • Sub-agent(独立助手:并行工作)
    → 自动化(定时任务)
    → 实战(综合运用)