目录

前言

一、准备工作与基础环境搭建

1.1 系统与软件要求

1.2 安装 Claude Code VS Code 扩展

1.3 验证安装与登录

二、理解 Skills：从概念到价值

2.1 什么是 Skill？

2.2 Skills 的核心价值：渐进披露架构

2.3 Agent Skill vs Claude Code Skill：理解层级关系

三、在 VS Code 中使用官方 Skills

3.1 安装官方 Skills

3.2 实战：用 Skill 处理 PDF 文件

3.3 社区与第三方 Skills

四、创建和自定义自己的 Skill

4.1 从提示词到 Skill 的思想转变

4.2 手动创建自定义 Skill

4.3 进阶：Skills + MCP + Agent 的组合使用

4.4 利用官方 skill-creator 快速生成 Skill

五、进阶技巧与常见问题

5.1 用 CLAUDE.md 管理项目上下文

5.2 调试与测试 Skills

5.3 权限管理与安全考量

六、结语：迈向系统化 AI 工作流

---

前言

        在 AI 辅助编程日益普及的今天，Claude Code 凭借其强大的代码理解和执行能力，已经成为众多开发者不可或缺的工具。而 Skills 的推出，则让 Claude Code 的能力又上了一个台阶。Skill 是一套模块化的能力封装机制——把“如何完成某类任务”的指令、脚本和模板打包成一个包含 SKILL.md 文件的独立目录，当 Claude 判断任务匹配时，它会自动加载并执行这套预定义的流程。简单来说，Skill 让 Claude 从“临时起意的对话式助手”升级为“能够忠实执行标准化流程的真正员工”。

        本文将带你从零开始，一步步完成在 VS Code 中配置 Claude Code 并使用 Skills 的全部流程。无论你是刚刚接触 AI 编程的新手，还是希望让 AI 工作流更加规范化的资深开发者，这篇文章都能帮到你。

一、准备工作与基础环境搭建

1.1 系统与软件要求

在开始安装 Claude Code 之前，请确保你的环境满足以下要求：

• VS Code 版本在 1.85.0 以上（推荐 1.98.0 以上版本以获得最佳体验）。

• Node.js 版本在 18 及以上（Skills 操作依赖 npx，而 npx 随 Node.js 自带，无需额外安装）。

• 有效的 Anthropic 账户，可通过 API Key 或 Claude Pro/Claude Max 订阅访问 Claude Code。

1.2 安装 Claude Code VS Code 扩展

完成环境准备后，首先安装 Claude Code 的 VS Code 插件。

打开 VS Code，点击左侧的扩展图标（或按快捷键 Ctrl+Shift+X），在搜索框中输入 Claude Code，找到由 Anthropic 官方发布的插件，点击安装。安装完成后，侧边栏会出现一个标志性的 Claude 图标。

该官方扩展于 2025 年底正式发布，经过一年多迭代，目前已非常成熟。除了原生 VS Code 外，它也完美兼容 Cursor、Windsurf 等 VS Code 系 IDE。

1.3 验证安装与登录

扩展安装完成后，需要完成身份验证。你可以在 VS Code 的内置终端中运行 claude 命令，按照提示完成 OAuth 登录，或者通过 Anthropic Console 配置 API Key。登录后建议在终端中输入 /ide 命令验证 IDE 连接状态，如果显示绿色的 IDE connected 字样，说明安装配置已经成功。

二、理解 Skills：从概念到价值

2.1 什么是 Skill？

Skill 本质上是一个格式化的文件夹，核心文件是 SKILL.md。它的文件头采用 YAML frontmatter 格式，定义 Skill 的名称、版本和描述信息，后面则是 Markdown 格式的详细执行指令。

一个典型的 Skill 目录结构如下：

my-custom-skill/
├── SKILL.md          # 核心配置文件（必需）
├── helpers.py        # 辅助脚本（可选）
└── resources/        # 参考文件、模板等（可选）

SKILL.md 文件的示例结构如下：

---
name: my-custom-skill
version: 1.0
description: 这是一个自定义 Skill 示例
tags:
  - report
  - markdown
---

# 详细说明
- 输入格式要求：纯文本或 JSON
- 输出格式要求：Markdown
- 执行步骤：
  1. 分析输入内容
  2. 输出最终文档
  3. 生成符合规范的代码

2.2 Skills 的核心价值：渐进披露架构

Skills 之所以强大，关键在于其精巧的 渐进披露（Progressive Disclosure） 架构设计。

传统的做法是把所有指令塞进提示词里，token 消耗巨大且维护困难。而 Claude Skills 采用分层加载策略：Claude 首先扫描所有 Skill 的简短元数据（约 100 tokens）快速判断相关性；确认匹配后才加载完整的 SKILL.md 文件（约 5k tokens）；只有当实际需要时才读取关联的脚本和资源文件。

这种设计意味着你可以安装数十个甚至上百个 Skills，却不会在每次对话开始时就被 token 限制拖垮。Claude 只会翻阅它认为有用的那本“操作手册”。

2.3 Agent Skill vs Claude Code Skill：理解层级关系

新手常见的误区是混淆 Agent Skill 和 Claude Code Skill。它们的逻辑关系非常清晰：

Agent Skill 是通用的能力包标准，适用于所有支持该标准的 AI 编程助手。Claude Code Skill 则是被安装到 Claude Code 专属目录（.claude/skills）、能被 Claude Code 直接识别和调用的 Agent Skill。核心区别在于安装路径——只有放到正确的目录下，Claude Code 才能“看见”和使用它。

三、在 VS Code 中使用官方 Skills

3.1 安装官方 Skills

Anthropic 官方维护了一个技能仓库 anthropics/skills，Github 上的 stars 已达到 137k，是最受开发者欢迎的技能集合。官方 Skills 主要集中在文档处理领域，包括 xlsx（电子表格）、docx（专业文档）、pdf（PDF 处理）、pptx（演示文档）等核心功能，开箱即用，零配置。

在 VS Code 中安装官方 Skill 的最快方式是通过命令行：

# 在 Claude Code 命令行中执行
/plugin install document-skills@anthropic-agent-skills

你也可以手动下载 skill 文件并导入到 ~/.claude/skills/ 目录下，重启 Claude Code 后即可自动识别。

如果需要更便捷的安装体验，可以在 Claude 桌面端或 Web 端的 Customize → Skills 界面中直接浏览官方技能目录并一键安装。

3.2 实战：用 Skill 处理 PDF 文件

以官方提供的 PDF 处理 Skill 为例，可以快速体验其强大功能。步骤如下：

1. 确保 PDF Skill 已安装并在 Claude Code 的“可用 Skills”列表中出现。

2. 在 VS Code 中打开 Claude Code 对话面板。

3. 输入类似下面的指令：

   “请帮我读取当前目录下的 report.pdf，提取表格数据并生成一份总结性的 Markdown 文档。”

4. Claude 会自动匹配 PDF Skill 并调用相关的处理流程，完成从 PDF 读取、数据提取到 Markdown 生成的全过程。

整个过程无需手动编写任何解析代码，是 Skills 让“重复性工作自动化”的典型体现。

3.3 社区与第三方 Skills

截至 2026 年 5 月，GitHub 上 claude-skills 话题已聚集超过 1000 个公开 Skill 仓库，大致分为五类：

官方文档处理类：以 anthropics/skills 为代表，适合所有需要自动化生成文档、表格、幻灯片的职场人士，新手最值得首先安装。开发工程类：代表仓库 baoyu-skills 收录了大量框架和云服务的实战模板。科研专业类：K-Dense-AI/scientific-agent-skills 收录了 135 个跨 10 个学科的科研 Skill，对博士生和研究人员来说就像把一位交叉学科助教“永久绑在终端里”。企业团队类：各 SaaS 厂商维护的产品手册型 Skill，确保 AI 写出的代码严格遵循官方最佳实践。社区聚合类：索引和共享技能的元工具项目。

程序员/独立开发者的推荐选择是：官方文档处理类 + baoyu-skills 开发工程类，已经能满足绝大多数日常需求。

四、创建和自定义自己的 Skill

4.1 从提示词到 Skill 的思想转变

在传统的 AI 使用方式中，开发者往往反复输入相似的指令，每次切换对话窗口就丢失所有“最佳实践”积累。Skill 正是为了解决这个问题而生，它将“临时起意的提示词”升级为“可以积累的技能资产”。

就像 36 氪的一篇文章所说的那样，2026 年 AI 的使用思维要从“提示词工程”转向“系统化执行”，从“提示词库”转向“可重复工作流的 Skills”。创建 Skill，本质上是把你在某个领域积累的经验和工作流程固化下来。

4.2 手动创建自定义 Skill

创建自定义 Skill 只需要三步：

第一步：创建 Skill 目录

mkdir -p .claude/skills/frontend-design

第二步：编写 SKILL.md

---
name: frontend-design
version: 1.0
description: 遵循 Modern UI 设计原则生成前端组件代码
tags:
  - frontend
  - design
---

# 设计原则
- 使用 Flexbox/Grid 布局，优先考虑移动端响应式
- 色彩风格：浅色背景 + 适当的品牌强调色
- 组件交互：Hover 状态必须完整，点击触感反馈
- 字体方案：优先使用系统字体，fallback 链完整

# 输出格式
直接输出可运行的 Vue/React 组件代码，附带简要的设计说明。

第三步：验证安装

在 Claude Code 中输入“有哪些可用的 skills”，查看列表中是否包含你刚刚创建的 Skill 名称。如果能识别到，恭喜——你的第一个自定义 Skill 已经就位了。

4.3 进阶：Skills + MCP + Agent 的组合使用

单个 Skill 的价值已经不容小觑，但 Skills 的真正潜力在于组合使用。Anthropic 官方文档将 Skills 定位为“便携式知识层”，而 Agent 负责在适当的时间和方式调用它们。Skill 负责能力层（“怎么做”），Agent 负责调度层（“何时做”），MCP 负责工具层（“用什么做”）。

一个典型的组合工作流是：先由数据获取 Skill 拉取数据，再由数据分析 Skill 处理分析，最后由报告生成 Skill 制作成 PPT 或 Word 文档。这种 Skill 链式编排（Skill Chaining） 正在成为企业级 AI 工作流的标配。

在 VS Code 中，你只需要在工作流的不同阶段提出相应的需求，Claude 会自动匹配并执行合适的 Skill。如果想进一步控制编排逻辑，可以在项目根目录创建 CLAUDE.md 文件，定义项目级的指令和约束条件，让 Claude Code 的执行更加可预测。

4.4 利用官方 skill-creator 快速生成 Skill

如果你觉得从头编写 SKILL.md 有些繁琐，Anthropic 官方内置了 skill-creator 工具。使用路径如下：

在 Claude 桌面端或 Web 端进入 Customize → Skills，启动 skill-creator 后开启新对话，直接告诉 Claude“我想创建一个什么类型的 Skill”，它就会以引导式对话的方式帮助你生成完整的 Skill 文件。这个方式尤其适合初次尝试创建 Skill 的新手，能大幅降低学习成本。

五、进阶技巧与常见问题

5.1 用 CLAUDE.md 管理项目上下文

在项目根目录创建 CLAUDE.md 文件，可以看作给 Claude Code 的“项目说明书”，用于统一编码规范、项目约束和常用命令。

一个示例 CLAUDE.md：

# 项目编码规范
- 所有 TypeScript 代码必须包含完整 JSDoc
- 禁止使用 any 类型，必须显式定义接口
- 提交前必须运行 ESLint 和单元测试
- API 调用统一使用项目封装的 request 工具

# 常用命令
- 启动开发服务器：npm run dev
- 运行单元测试：npm test
- 代码 lint：npm run lint

通过 CLAUDE.md，你可以让 Claude Code 在所有对话中始终保持一致的行为模式，极大提升团队协作效率和代码可维护性。

5.2 调试与测试 Skills

在实际使用中，Skill 未被正确加载是最常见的问题。排查步骤建议如下：

1. 确认 SKILL.md 文件名和格式是否正确（YAML frontmatter 必须包含 name 和 description 字段）。

2. 检查 Skill 目录是否位于 Claude Code 能够识别的路径下（推荐使用项目本地的 .claude/skills 路径，便于版本控制和团队协作）。

3. 确认 YAML 部分前后是否以 --- 正确分隔。

4. 在 Claude Code 中输入“列出所有 skills”验证加载情况。

5. 如果修改了 Skill 内容但没有生效，重启 Claude Code 会话通常可以解决问题。

对于更复杂的测试场景，建议将测试脚本纳入 CI 流程，确保每次 Skill 更新后都能够自动验证其功能完整性。

5.3 权限管理与安全考量

Claude Code 提供了细粒度的权限控制系统。在 Skills 中执行涉及文件写入、命令执行等操作时，Claude 会要求用户确认。建议采用最小权限原则，从只读访问开始，确认技能行为符合预期后再逐步开放必要权限。

在企业环境中部署 Skills 时，建议建立内部的技能注册中心，对第三方 Skill 进行审查和版本控制，以确保安全性和可控性。

六、结语：迈向系统化 AI 工作流

从临时提示词到可复用的 Skills，Claude Code 正在推动 AI 使用方式的一次深刻变革。这不只是一次功能更新，它标志着大模型能力正在进入结构化的新阶段：AI 的能力可以被设计、沉淀和追踪。

通过在 VS Code 中配置 Claude Code 并使用 Skills，我们已经站在了这场变革的前沿。本文介绍了从环境配置、技能安装到技能创建的全部流程。对于希望进一步深入探索的开发者，推荐关注官方 GitHub 仓库 anthropics/skills 的最新更新，并尝试将日常工作中最常见的任务转化为自己的技能资产。正如很多人所说，真正的差距不在模型参数，而在能力结构设计。