普通视图

Claude Code 进阶秘籍:手把手教你创建专属 Skills,效率翻倍!

2026年1月23日 10:44

Claude Code 进阶秘籍:手把手教你创建专属 Skills,效率翻倍!

大家好,我是斌仔。

如果你已经在用 Claude Code(简称 CC,还没用上的小伙伴可以看斌仔之前写的教程:《Claude Code 入门指南:看这一篇就够了!(保姆级教程)》+ 《GLM-4.7 可以平替 Claude Code 的国产编码大模型》,国内也能轻松用上 CC)帮你看代码、写脚本,那你一定遇到过这种烦恼:

每次开新对话,都得跟它重复一遍你的代码规范项目架构,或者是那套万年不变的 Commit 格式

其实,CC 官方早就准备好了一个大招:Skills

这玩意儿就像是给 Claude 配备了一本本“专业工作手册”。一旦配置好,它就能在需要的时候自动“翻书”,按照你的规矩办事。

今天这篇教程,斌仔带你把 Skills 彻底玩透。

Claude Code 进阶秘籍:手把手教你创建专属 Skills,效率翻倍!
Claude Code 进阶秘籍:手把手教你创建专属 Skills,效率翻倍!


1. 什么是 Skills?(为什么你一定要学会它)

简单来说,Skills 是 CC 的模块化知识系统

没有 Skills 时

  • 每次都要贴一大段 Prompt 告诉它怎么写代码。
  • 上下文窗口很快就被这些重复信息占满。
  • 团队协作时,每个人的代码风格都不一样。

有了 Skills 后

  • 一次编写,重复使用:写好一次,全项目(甚至全系统)生效。
  • 智能触发:你不用手动喊它,它看到关键词会自己“对号入座”。
  • 节省空间:只有在用到的时候才会加载,不占用多余的上下文。

 什么是 Skills?
什么是 Skills?


2. 快速上手:创建你的第一个 Skill

Skills 的核心是一个名为 SKILL.md 的 Markdown 文件。

2.1 放在哪里?

你可以根据需求,把 Skill 放在不同的地方:

  • 个人全局使用(在任何文件夹下都能用):
    • MacOS、Linux 用户:~/.claude/skills/你的技能名/SKILL.md
    • Windows 用户:C:\Users\用户名\.claude\skills\你的技能名\SKILL.md
  • 项目团队共享(只在该项目下生效):
    • MacOS、Linux 用户:.claude/skills/你的技能名/SKILL.md
    • Windows 用户:.claude\skills\你的技能名\SKILL.md

2.2 SKILL.md 长啥样?

一个标准的 Skill 文件由两部分组成:

第一部分:YAML 元数据(这是触发的关键!)

---
name: commit-master
description: 当用户请求创建 commit、生成提交信息或询问 commit 规范时,使用此技能。
version: 1.0.0
---

图片以 skill-creator 为例
图片以 skill-creator 为例

第二部分:Markdown 正文(具体的规矩)

这里写你对 Claude 的具体要求。比如:

# Commit 规范

所有提交必须遵循 Conventional Commits:
- feat: 新功能
- fix: 修复 Bug
- docs: 文档更新

格式:`type(scope): description`

图片以 skill-creator 为例:红框为正文内容
图片以 skill-creator 为例:红框为正文内容


3. 进阶玩法:Skills 的“全家桶”结构

如果你觉得一个 SKILL.md 不够用,CC 还支持更复杂的目录结构:

my-skill/
├── SKILL.md             # 核心说明(必选)
├── references/          # 参考文档(如详细的 API 文档)
├── examples/            # 示例代码(如最佳实践 demo)
└── scripts/             # 自动化脚本(如代码校验工具)

斌仔亲测小技巧
SKILL.md 里引用这些文件时,Claude 会在需要的时候才去读它们。这样能极大节省上下文空间,这就是所谓的“渐进式加载”。

Skill Creator:让 Claude 帮你写 Skill

觉得手写 SKILL.md 麻烦?斌仔告诉你一个官方“外挂”:Skill Creator

这其实是一个官方内置的“元技能”,专门用来帮你通过对话的方式,快速生成其他的 Skills。

操作步骤很简单:

  1. 安装 Skill Creator
  2. 一句话召唤
    在 CC 终端里直接输入:
    Help me create a skill for [你想实现的功能]
    例如:Help me create a skill for Python code review
  3. 交互式引导
    Claude 会像面试官一样问你几个问题:
    • 目标:你想让这个技能达成什么效果?
    • 规范:有哪些必须要遵守的死理(比如 PEP8)?
    • 示例:能不能给两个“正面教材”和“反面教材”?
  4. 自动生成与测试
    聊完之后,Claude 会自动在你的 .claude/skills/ 目录下创建好文件夹和 SKILL.md。它甚至还会邀请你当场跑一个测试用例,看看好不好使。

斌仔提示
如果你输入指令后 Claude 没反应,或者说“我无法帮你创建”,记得在本地先安装再检查一下。

斌仔建议
新手一定要从 Skill Creator 入手。先让 Claude 帮你把复杂的 YAML 元数据和基础架构搭好,你再去手动微调正文里的规则,这才是最高效的姿势。

Skill Creator:让 Claude 帮你写 Skill
Skill Creator:让 Claude 帮你写 Skill


4. 避坑指南:如何写好“触发描述”?

很多小伙伴说:“我写了 Skill,但 Claude 不理我啊!”

大概率是你的 description 写得太模糊了。

  • 错误示范description: 帮我写代码。(太泛了,它不知道什么时候该用)
  • 正确示范description: 当用户提到“重构代码”、“提取函数”或“优化逻辑”时,请调用此技能提供重构建议。

核心原则:多放关键词,使用第三人称,描述具体的应用场景。


5. 常见问题 FAQ

Q:怎么看我安装了哪些 Skills?
在 CC 界面输入 /skills 即可一键查看。

Q:Skill 里的脚本跑不起来怎么办?
记得给脚本加上执行权限:chmod +x scripts/your-script.sh,并且要在文件开头写上 Shebang(如 #!/bin/bash)。

Q:Skill 文件写太长了会怎样?
建议 SKILL.md 保持在 1500-2000 字以内。如果真的有很多资料,记得利用 references/ 文件夹外移。


6. 斌仔的建议

Skills 不只是程序员的专利。

如果你是文案策划,可以写一个“品牌语气 Skill”;如果你是数据分析师,可以写一个“SQL 优化规范 Skill”。

“把重复的事情自动化,把自动化的事情模块化。”

这就是 Skills 存在的意义。

如果你在配置过程中遇到什么坑,或者有什么神仙 Skill 想分享,欢迎在评论区留言,我们一起折腾!


7. 推荐阅读

  1. 价值 $300 的 Google AI Pro,0 元白嫖12个月 Google Gemini 学生优惠完全指南(截止到 2026年1月31日)
  2. Google 羊毛:免费领 1 个月 Gemini 3、Nano Banana Pro 和 Veo 3 会员
  3. 12个免费白嫖 Nano Banana Pro 的方法,亲测有用
  4. 网盘拉新项目:打造没有天花板的被动收入(附资源+教程)

8. Agent Skills Marketplace 导航

  1. The Agent Skills Directory:官方范儿十足的 Skills 目录,收录了大量符合 SKILL.md 标准的高质量技能,是寻找标准生产力工具的首选。
  2. SkillHub - Claude Skills & Agent Skills Marketplace:体验极佳的 Skills 社区,支持 AI 语义搜索和独家的 AI 评分系统(S 级神器一眼便知),还支持一键 CLI 安装,非常省心。
  3. Agent Skills Marketplace - SkillsMP:目前规模最大的 Skills 聚合站,从 GitHub 自动抓取了数万个技能,分类极细,想“挖宝”个性化插件的必看。

如果觉得不错,随手 「点个赞、在看、转发」三连吧,如果想第一时间收到推送,也可以给我个「星标⭐」~

谢谢你看我的文章,我们,下次再见啦~。

获取更多 AI 工具实测,记得关注 「文武科技社」!

开源版Claude Code:OpenCode!我实测一周发现:这个坑,90%的人都会踩

2026年1月15日 20:27

上周五的时候,斌仔在折腾OpenCode

你可能没听说过这个工具,但如果你用过Claude Code,你一定对它的价格有印象——每个月$20。

而OpenCode,是一个100%开源的Claude Code替代品。

完全免费。

斌仔实测了一周,还看了两篇深度评测,今天就把真实体验分享给大家。

重点是避坑指南,斌仔和其他人踩过的坑,你千万别再踩。

开源版Claude Code:OpenCode
开源版Claude Code:OpenCode


OpenCode是什么

简单说,OpenCode = 开源版Claude Code

它(OpenCode官网:https://opencode.ai/)是一个在终端运行的AI编程代理工具,能帮你写代码、调试、重构,基本上Claude Code能做的,它都能做。

核心特点

  • 100%开源:MIT许可,代码全在GitHub上
  • 模型无关:支持GLM-4、Grok、MiniMax等多种模型,不绑定单一模型
  • 完全免费:如果你用免费模型(GLM-4.7、MiniMax M2.1),一分钱都不用花
  • 多平台:终端、桌面应用、IDE插件都支持

GitHub上现在有5万多Star,最近一周特别火。

但是要注意,OpenCode和Claude Code还是有区别的。

最大的区别:模型能力。

Claude Code用的是Claude Sonnet 4.5或Opus 4.5,这是顶级模型。

OpenCode你可以接入各种模型,但免费的GLM-4.7、MiniMax M2.1肯定比不上Claude Opus。

斌仔的理解:OpenCode更像是一个"容器",它提供了工具和框架,但模型好不好,取决于你接入什么模型。


为什么要用OpenCode

斌仔看了几篇深度评测,也自己测试了一周,发现了一个关键洞察:

OpenCode对不同模型的提升差异很大

  • 顶级模型(GPT-5.2-Codex、Claude Opus 4.5):提升很小,甚至几乎没有
  • 中档模型(Gemini 3 Flash、Claude Sonnet 4.5):整体能力提升大
  • 弱模型:还不如不要用OpenCode

所以,如果你用的是中档模型,OpenCode很适合你

如果你本身就订阅了Claude Max或GPT-5.2,OpenCode的价值就不大了。

OpenCode的6大优势

斌仔整理了这些评测中提到的6个核心优势:

  1. AI像团队协作,不是串行工作
    以前AI工具是一个接一个地干活。

    OpenCode会把复杂任务拆成几块,让多个AI一起干,速度快不少。

  2. 新手免配置
    内置了skill、subagent、MCP工具集,装好就能用,不用自己折腾配置。

  3. 所有AI订阅不浪费
    你订阅了ChatGPT Pro、Gemini、Claude?OpenCode可以同时用多个模型,不浪费。

  4. 并发执行任务
    OpenCode支持异步处理,编码速度比串行执行快不少。

  5. 自己找缺失资料
    OpenCode会自动去找需要的依赖、文档,而不是啥都问你。

  6. LSP能力
    OpenCode集成了LSP(Language Server Protocol),能像IDE一样看清代码结构。

斌仔觉得最有价值的是第3点:如果你订阅了多个AI但用不完,OpenCode能让你"回本"。

为什么要用OpenCode
为什么要用OpenCode


手把手安装OpenCode

斌仔实测了两种安装方式,都很简单。

方式1:npm安装(推荐)

如果你电脑上已经装了Node.js,用这种方式最快。

# 安装
npm install -g opencode-ai

# 验证安装
opencode --version

OpenCode npm 安装
OpenCode npm 安装

斌仔用的就是这种方式,3分钟搞定。

如果你看到版本号输出,说明装好了。

opencode 验证安装成功测试
opencode 验证安装成功测试

方式2:一键脚本

如果你不想折腾npm,可以用官方的一键脚本。

curl -fsSL https://opencode.ai/install | bash

这个更简单,但是国内可能有网络问题。

如果curl失败,建议还是用npm安装。

方式3:客户端安装(可选)

OpenCode也提供桌面客户端,支持Windows、macOS、Linux。

下载地址:OpenCode官网下载页

OpenCode 客户端安装
OpenCode 客户端安装

斌仔个人更喜欢用终端,但如果你不习惯命令行,客户端也是个不错的选择。

配置GLM-4.7(免费)⭐

装好OpenCode后,需要配置AI模型。

斌仔用的是智谱AI的GLM-4.7,完全免费,配置也简单。

8步配置流程(斌仔实测):

  1. 在终端输入:opencode

启用 OpenCode
启用 OpenCode

  1. 按快捷键:Ctrl + p,打开菜单页面

OpenCode 菜单
OpenCode 菜单

  1. 选择 Switch model,按回车

  2. 如果选项中没有你想要的模型,按快捷键:Ctrl + a(显示所有模型)

OpenCode 选择AI大模型
OpenCode 选择AI大模型

  1. 下键选择 Zhipu AI Coding Plan,回车

OpenCode Zhipu AI Coding Plan
OpenCode Zhipu AI Coding Plan

  1. 输入API Key(如果没有,继续往下看)

OpenCode 输入 API key
OpenCode 输入 API key

  1. 访问智谱开放平台,点击右上角「注册/登录」

  2. 登录后,在个人中心点击API Keys,创建一个新的API Key并复制,粘贴到终端,回车

智谱创建并获取 API Key
智谱创建并获取 API Key

配置完成!

如果你看到OpenCode的TUI界面(终端交互界面),说明一切正常。

斌仔的建议:如果你只是想免费试试OpenCode,GLM-4.7够用了。

如果你想要更强的能力,可以考虑订阅GLM Coding Plan(跨年特惠有优惠)。


避坑指南(重要!)⭐⭐⭐

这部分是斌仔和其他人踩过的坑,你千万别踩

坑1:oh-my-opencode插件风险(最大的坑)

问题
OpenCode有一个增强插件叫oh-my-opencode,功能很强大,但有两个巨大的风险。

第一个风险:违反用户协议,有封号风险

oh-my-opencode可以"搞"OpenAI和Anthropic的Auth,让你用Claude Code和ChatGPT的额度。

听起来很爽,但这是违反两家用户协议的

有人在评测中明确警告:

"在OpenCode里使用Claude Code的credentials,违规,会被封号。"

第二个风险:影响网络

斌仔自己也踩了这个坑(来自@歸藏的AI工具箱):

"我装了oh-my-opencode后,Antigravity直接没法选模型了。
最后卸载掉oh-my-opencode的配置才变好。"

本身我们的网络环境就相当复杂,再加个Auth层,问题更多。

斌仔的建议

  • 如果你只是想用OpenCode,不要装oh-my-opencode
  • 如果你真的想装,千万别用Claude Code或ChatGPT的账号Auth
  • 用了就有封号风险,别说斌仔没提醒你

坑2:配置推荐的坑

斌仔总结了三种配置方案:

王者配置:ChatGPT Pro + Claude Max Pro + Google AI Ultra(每月$60+)
推荐配置:ChatGPT Pro + Google AI Ultra(每月$40)
基础配置:只用免费模型(GLM-4.7、MiniMax M2.1)

为什么不推荐订阅Claude Code?

因为Google的Antigravity已经包含了Claude Opus 4.5和Gemini 3 Pro。

如果你在OpenCode里用Claude Code的账号,违反ToS(用户协议),可能被封号。

斌仔的建议

  • 预算有限:用基础配置,完全免费
  • 有预算:订阅ChatGPT Pro + Google AI Ultra
  • 不要:单独订阅Claude Code再用OpenCode

坑3:Windows安装Bun依赖

如果你用Windows,想装oh-my-opencode(虽然斌仔不推荐),会遇到Bun依赖问题。

解决方法

# 打开PowerShell(Win + X → I)
powershell -c "irm bun.sh/install.ps1 | iex"

装好Bun后,再运行:

npx oh-my-opencode install

但是说实话,斌仔觉得基础版OpenCode就够用了,别折腾oh-my-opencode。

坑4:免费模型的限制

GLM-4.7、MiniMax M2.1虽然免费,但能力确实比Claude Opus弱。

斌仔的实测

  • 简单任务(生成CRUD代码、写注释):免费模型够用
  • 复杂任务(重构大型项目、复杂算法):还是顶级模型靠谱

建议
先用免费模型试试,如果觉得不够用,再考虑付费模型。

但是别一上来就花大钱,不值得。


实际使用效果

斌仔用OpenCode + GLM-4.7写了一个简单的Express服务器。

实测效果

  • 代码生成速度:30秒左右
  • 代码质量:可以直接运行,稍微改几个地方就OK
  • 与Claude Code对比:简单任务差距不大,复杂任务Claude Code更稳

斌仔的感受

对于简单的、标准化的代码任务,OpenCode + 免费模型完全够用。

但是如果你要做复杂项目,还是Claude Code或Cursor更靠谱。

OpenCode的真正价值
不是替代Claude Code,而是让你的多个AI订阅不浪费,同时用多个模型。

如果你订阅了ChatGPT Pro和Gemini,用OpenCode可以让它们并发工作,效率更高。


总结

OpenCode适合谁?

预算有限,但想用AI编程的学生/个人
GLM-4.7免费,OpenCode也免费,0成本体验AI编程。

订阅了多个AI但想同时用的开发者
OpenCode让你的ChatGPT Pro、Gemini、Claude同时工作,不浪费订阅。

喜欢开源、想自己定制的终端党
OpenCode是MIT许可,想怎么改就怎么改。

追求极致效率,不在乎成本的专业开发者
直接用Claude Code或Cursor,体验更好。

复杂企业级项目,需要稳定性的团队
OpenCode还在快速迭代,稳定性不如商业产品。

斌仔的建议

  1. 先用免费模型试试
    GLM-4.7、MiniMax M2.1都免费,先试试合不合适。

  2. 基础版就够用
    不要装oh-my-opencode,风险大,收益小。

  3. 不要违反ToS
    用Claude Code账号在OpenCode里是违规的,别冒这个险。

  4. 合理期待
    OpenCode不是神器,它只是让你的工作更高效,但核心还是你的编程能力。

最后,工具是手段,人才是目的。

OpenCode只是让你的工作更高效,但真正决定你能不能写出好代码的,还是你的编程思维和经验。

OpenCode适合谁与建议总结
OpenCode适合谁与建议总结


参考资料

GLM-4.7 可以平替 Claude Code 的国产编码大模型

2026年1月1日 21:08

GLM-4.7 是什么

GLM-4.7API官方文档) 是智谱最新旗舰模型,GLM-4.7 面向 Agentic Coding 场景强化了编码能力、长程任务规划与工具协同,并在多个公开基准的当期榜单中取得开源模型中的领先表现。通用能力提升,回复更简洁自然,写作更具沉浸感。在执行复杂智能体任务,在工具调用时指令遵循更强,Artifacts 与 Agentic Coding 的前端美感和长程任务完成效率进一步提升。

  • 支持文本输入模态
  • 支持文本输出模态
  • 上下文窗口 200K
  • 最大输出Tokens 128K

GLM-4.7 可以平替 Claude Code 的国产编码大模型
GLM-4.7 可以平替 Claude Code 的国产编码大模型

模型能力

  • 思考模式:提供多种思考模式,覆盖不同任务需求。
  • 流式输出:支持实时流式响应,提升用户交互体验。
  • Function Call:强大的工具调用能力,支持多种外部工具集成。
  • 上下文缓存:智能缓存机制,优化长对话性能。
  • 结构化输出:支持 JSON 等结构化格式输出,便于系统集成。
  • MCP:可灵活调用外部 MCP 工具与数据源,扩展应用场景。

LMARENA GLM-4.7排名
LMARENA GLM-4.7排名

推荐使用场景

  • Agentic Coding:面向任务完成,能够从目标描述出发,自主完成需求理解、方案拆解与多技术栈整合。
  • 多模态交互与实时应用开发:在需要摄像头、实时输入与交互控制的场景中,展现出更强的系统级理解能力。
  • 前端视觉审美优化:对视觉代码与 UI 规范的理解显著增强,能够生成更具美感且一致的默认方案。
  • 高质量对话与复杂问题协作:在多轮对话中更稳定地保持上下文与约束条件,对复杂问题能够持续澄清目标并推进解决路径。
  • 沉浸式写作与角色驱动创作:文字表达更细腻、更具画面感,能够通过感官细节构建氛围。
  • 专业级 PPT / 海报生成:在办公创作中,版式遵循与审美稳定性明显提升,生成结果更接近“即用级”。
  • 智能搜索与 Deep Research:强化用户意图理解、信息检索与结果融合能力,在复杂问题与研究型任务中,能够进行结构化整理与跨来源整合。

编程能力提升

  • 更强的编程能力:在多语言编码和终端智能体中表现更稳定。
  • 前端审美提升:生成的网页、PPT、海报等视觉效果更佳。
  • 更强的工具调用能力:在网页任务评测和交互式工具调用评测中表现优异。
  • 推理能力提升:在数学和推理能力上显著提升,超过 GPT-5.1。
  • 通用能力增强:对话更简洁智能,写作与角色扮演更具文采与沉浸感。

在哪里可以使用GLM-4.7

  1. GLM Coding Plan·跨年特惠Claude Code、Cline 等 20+ 大编程工具无缝支持,「GLM Coding Plan 」惊喜赠送香甜奶茶为你满血续航!
    • 20元起包月畅享 GLM-4.7,Claude Code 1/7价格,3倍用量
    • 活动时间:12.08 - 01.15:50% 首购立减 + 额外节日限定优惠!
    • 官方教程)订阅用户在指定编程工具中接入 GLM Coding Plan,并配置MCP,并输入口令:阿姨助我,即可获得一张沪上阿姨新品奶茶兑换券,并通过沪上阿姨官方小程序完成兑换。(活动时间:2025 年 12 月 26 日至 2026 年 1 月 9 日
      • 复制券码 -> 微信打开链接 t.hsay.com/qf7TZX 进入「沪上阿姨」小程序 -> 兑换后点单
    • 含图像视频理解、联网搜索、网页读取、开源仓库 MCP,助力完成更广泛的开发任务
    • 面向处理轻量级工作负载的个人开发者
    • 由智谱最新旗舰 GLM-4.7 驱动
    • 适用于 Claude Code 等 20+ 编程工具
    • 赠「智谱AI输入法」,畅享 Voice Coding
    • 订阅期内,享受同等级最新模型更新
  2. Z.ai
  3. Trae:字节跳动推出的国产AI编程工具
    • 不仅支持 GLM-4.7 还支持 MiniMax-M2.1
  4. 智谱清言 是基于 GLM-4.7 的全能 AI 助手,支持精通对话、写作与编程。为你答疑解惑,激发创意,更能理解图片与文档,提升学习与工作效率。
❌