05 · 在 API / Claude Code / Agent SDK 中用 Skills
04-创建自定义Skill ｜ 返回 00-课程总览
同一个 Skill，四种环境复用
写好的 Skill 文件夹不用改，可以在多个环境里挂载使用。这是 Skill「一次写好、到处能用」的兑现。
| 环境 | 怎么用 | 适合 |
|---|---|---|
| Claude.ai | 在设置里上传/启用 Skill | 非技术用户、日常对话 |
| Claude Code | 放进 .claude/skills/，对话中自动触发 |
开发者、项目内工作流 |
| Claude API | 请求里挂载 Skill，模型按需加载 | 自建应用、后端服务 |
| Claude Agent SDK | 在 SDK 里配置 Skill 目录 | 自建智能体产品 |
1) Claude Code 里用
project/
└── .claude/
└── skills/
└── weekly-report/
├── SKILL.md
└── templates/weekly.md
- 放好后，你说「写周报」，Claude Code 读到
description匹配 → 自动触发。 - 个人级放
~/.claude/skills/，项目级放项目内.claude/skills/。
2) Claude API 里用
- 通过 API 把 Skill 一并提供给模型；模型按渐进式披露只在需要时加载内容。
- 适合你做一个对外产品，让后端的 Claude 自带某些专门能力。
- 配合 code execution / 文件能力，Skill 里的脚本可被执行。
# 概念示意（具体以官方 SDK 文档为准）
import anthropic
client = anthropic.Anthropic()
resp = client.messages.create(
model="claude-opus-4-8",
max_tokens=2048,
# 挂载 skill（按官方最新参数）
messages=[{"role": "user", "content": "帮我写本周周报"}],
)
⚠️ Skills 在 API 的具体挂载参数会演进，以 docs.claude.com 最新文档为准。
3) Claude Agent SDK 里用
- Agent SDK 用来搭自己的智能体（带工具、记忆、循环）。
- 指定 Skill 目录后，你的智能体就拥有这些专门能力。
- 适合做垂直智能体产品：法务助手、运营助手、数据分析助手……
选型小结
只是自己日常用 → Claude.ai 启用
在项目里写代码 → Claude Code 的 .claude/skills/
做后端/产品 API → Claude API 挂载
做完整智能体产品 → Agent SDK 配 Skill 目录
全课收束
Skill = 可移植的「领域能力包」。配合 Claude Code 的工程能力 + MCP 的外部接入，就能把「一次性教 AI」变成「沉淀成组织资产」。
本节实操
- 把你写的 Skill 放进 Claude Code 的
.claude/skills/ - 用一句自然语言触发它，验证
description写得够准 - 想一个把它接进 API/Agent SDK 的产品点子