技术笔记

主题

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（独立助手：并行工作）
    → 自动化（定时任务）
    → 实战（综合运用）