★ FEATURED ARTICLE 1. 为什么你的 Claude 总是“记不住”你的偏好很多人用 Claude 写代码、改文档、做方案用着用着就会冒出一个疑问明明上次已经交代过“注释用中文、变量名别用拼音、改代码前先读一遍项目里已有的写法”怎么这次它又忘了于是每次开新会话都要重新贴一遍背景、重新讲一遍规范时间全耗在“重复交代”上。这个问题的根源不在模型笨而在于你给它的“偏好”没有被固化下来。普通对话里的上下文是临时的会话一关就散了。而 Claude Skills 解决的正是这件事它把你的常用工作流程、写作规范、模板、参考资料甚至脚本封装成一个可复用的“技能包”。当 Claude 判断当前任务需要某个技能时会自动加载对应的 Skill按你提前设定好的方式干活。一句话概括Claude Skills 是给 Claude 装“扩展插件”的机制让 Claude 从“每次都要重新教一遍的新手”变成“真正懂你工作习惯的助手”。它适合谁适合那些有固定工作流、经常重复输入同一段要求、希望 Claude 稳定理解个人偏好的开发者也适合内容创作者和经常处理办公文件的知识工作者。但这里有个容易被忽略的前提Skills 要稳定触发、稳定加载底层得有一个稳定的模型接入通道。如果你用的是零散、随时可能失效的 KeySkill 调用到一半报个 401体验会非常割裂。所以这篇教程分两条线走一条是把 Claude Skills 的目录结构、settings 配置、安装方式讲清楚另一条是用 TaoToken 统一 Key让 Claude Code 的接入地址和密钥固定下来Skill 才能真正“稳定懂你”。下面从目录结构开始一步步给到可复制的配置。2. Claude Skills 目录结构与 settings 配置详解先把 Skills 的“物理形态”搞清楚后面配置才不会乱。一个 Skill 本质上就是一个独立文件夹最核心的是里面的SKILL.md文件。这个文件相当于技能的“说明书”告诉 Claude 三件事这个 Skill 叫什么、适合在什么场景下使用、具体按什么流程完成任务。除了SKILL.md文件夹里还可以放模板、参考资料和脚本比如文章写作模板、项目规范文档、数据处理脚本。Claude 的工作方式是先根据SKILL.md里的 description 判断是否需要调用这个技能真正需要更详细信息时再去读取文件夹里的其他内容。也就是说Skills 不是把所有内容一次性塞给模型而是按需加载这也是它比“把一堆规则全写进系统提示词”更高效的原因。一个典型的 Skill 目录结构长这样.claude/ └── skills/ └── my-writing-style/ ├── SKILL.md # 技能说明书必须有 ├── templates/ │ └── article.md # 写作模板 ├── references/ │ └── style-guide.md # 风格参考 └── scripts/ └── check.py # 可选脚本SKILL.md的内部结构通常包含 frontmatter 和正文两部分。frontmatter 用 YAML 写最关键的是name和descriptiondescription 直接决定 Claude 会不会在合适的时候触发它--- name: my-writing-style description: 当用户要求撰写或润色中文技术文章时使用保持口语化、少套话、多用具体案例的风格。 --- # 我的写作风格 ## 适用场景 用户要求写公众号文章、技术博客、产品介绍文案时。 ## 执行步骤 1. 先确认文章主题和目标读者。 2. 按 templates/article.md 的结构搭骨架。 3. 正文避免“综上所述”“随着技术发展”这类套话。 4. 每段控制在 4 到 6 行多用具体例子。这里要强调一个细节description写得越具体触发越准。如果你只写“用于写作”Claude 很难判断什么时候该用写成“当用户要求撰写或润色中文技术文章时使用”命中率会明显提升。接下来是 settings 配置。Claude Code 的配置一般放在用户目录下的.claude/settings.json或者项目根目录的.claude/settings.json。如果你想让所有项目共用一套 Skills 和统一的接入地址建议放在用户级配置里。下面是一份可复制的 settings 片段把 Base URL、Key 和模型都固定下来{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: 你的TaoToken_API_Key, ANTHROPIC_MODEL: claude-sonnet-4-20250514 }, skills: { directory: ~/.claude/skills, autoLoad: true } }这里三件套要记牢Base URL 填https://taotoken.net/apiKey 填你在 TaoToken 控制台生成的 API KeyModel ID 填你要用的具体模型名。三者缺一不可少一个就会出现连不上或者模型找不到的情况。Skills 的directory指向你存放技能文件夹的路径autoLoad打开后 Claude Code 启动时会自动扫描并加载。如果你用的是项目级配置路径就是项目根目录下的.claude/settings.json内容结构一样只是作用范围限定在当前项目。我一般建议通用写作类、办公类的 Skill 放用户级项目专属的规范类 Skill 放项目级这样既不会互相污染又能保证每个项目加载自己需要的能力。配置改完之后重启一次 Claude Code 让 settings 生效。这一步别偷懒很多人改完配置发现没反应就是因为没重启。下一节讲怎么把 Skill 真正装进去以及怎么用统一 Key 完成一次可验证的调用。3. 可复制配置安装 Skill 并接入统一 Key这一节给到能直接复制粘贴的操作。安装 Skill 有两种方式一种是命令行安装一种是手动复制文件夹两种都讲。先说命令行安装。打开终端Windows 用 cmd 或 PowerShellmacOS/Linux 用自带终端输入下面这种格式的指令npx skills add {github用户名/仓库名} -g -a claude-code --skill {Skill名称} -y举个例子安装 Anthropic 官方仓库里的 xlsx 技能npx skills add anthropics/skills -g -a claude-code --skill xlsx -y参数含义拆开看-g表示全局安装装到用户级目录-a claude-code指定目标应用是 Claude Code--skill xlsx指定要装的具体技能名-y表示跳过确认直接安装。执行过程中终端会拉取仓库、复制文件到.claude/skills/下看到完成提示就说明装好了。手动安装也不复杂。去 GitHub 找到想要的 Skill 仓库下载压缩包解压后把整个 Skill 文件夹复制到.claude/skills/目录下。比如 Windows 下路径通常是C:\Users\你的用户名\.claude\skills\macOS/Linux 是~/.claude/skills/。复制完重启 Claude Code输入/skills就能看到已加载的技能列表。装好 Skill 只是第一步真正让它稳定跑起来的是统一 Key 的接入。前面 settings.json 里的三件套再强调一遍这里给一份更完整的配置包含超时和重试参数适合网络波动时用{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的TaoToken密钥, ANTHROPIC_MODEL: claude-sonnet-4-20250514, ANTHROPIC_TIMEOUT: 60000, ANTHROPIC_MAX_RETRIES: 3 }, skills: { directory: ~/.claude/skills, autoLoad: true } }如果你用的是 Codex 这类工具配置写在auth.json里结构类似把 Base URL 和 Key 对应填进去即可。Cline 这类插件则是在 MCP 或模型设置里填 Base URL、Key、Model ID 三件套。不管哪个工具核心都是这三样别只填 Key 忘了 Base URL那是最常见的连不上原因。配置完成后建议先做一次最小验证在 Claude Code 里输入/skills确认技能已加载然后随便问一句需要触发某个 Skill 的话。比如你装了写作类 Skill就说“帮我把这段文字改得更自然一点”看它是否自动调用。如果没触发先别急着改 Skill多半是 description 不够具体或者 settings 没重启生效。Key 的获取在 TaoToken 控制台的 API Keys 页面生成后复制保存好别泄露。如果你还没生成可以去控制台建一个然后回到 settings.json 填进去。整个链路是控制台拿 Key → 填进 settings → 重启 Claude Code →/skills验证 → 发一句话触发 Skill。下一节用一个完整例子走一遍验证请求确认 Skill 真的生效。4. 验证请求调用一次自定义 Skill 确认生效配置写完不验证等于没配。这一节用一个完整的自定义 Skill 走一遍从创建到触发确认它真的生效。先创建一个最简单的 Skill用来验证“Claude 是否按我的偏好输出”。在.claude/skills/下新建文件夹my-preference/里面建SKILL.md--- name: my-preference description: 当用户要求写代码注释或解释代码时使用注释必须用中文且先说明这段代码解决什么问题再逐行解释。 --- # 我的代码注释偏好 ## 适用场景 用户要求给代码加注释、解释某段代码、或写代码说明文档时。 ## 执行步骤 1. 先用一句话说明这段代码解决什么问题。 2. 再用中文逐行或逐块解释关键逻辑。 3. 不要用英文注释不要只写“初始化变量”这种废话。保存后重启 Claude Code输入/skills应该能在列表里看到my-preference。如果没看到检查文件夹名和SKILL.md是否拼写正确以及 settings 里的directory路径是否指向了正确位置。接下来发一条能触发它的请求。在 Claude Code 对话框里输入帮我给下面这段 Python 代码加注释 def calc(items): total 0 for i in items: total i return total如果 Skill 生效Claude 的输出应该先说明“这段代码解决的是对列表求和的问题”然后用中文逐行解释而不是甩一段英文注释或者只写“循环累加”。这就是验证成功的标志输出风格符合你在SKILL.md里定义的偏好。如果你想更明确地指定使用某个 Skill可以用斜杠命令的形式/my-preference 帮我给这段代码加注释这种写法会强制 Claude 调用指定 Skill适合自动触发不稳定、或者你想精确控制的时候用。实测下来自动触发在 description 写得好的情况下命中率很高但涉及多个 Skill 可能冲突时明确指定更稳妥。再验证一个稍微复杂点的场景比如你装了 pptx 技能想确认它能生成文件。输入/pptx 生成一个两页的 PPT介绍 Claude Skills 的作用正常情况下 Claude 会调用 pptx 技能按它的流程搭结构、生成页面最后产出一个可下载的 pptx 文件。如果这一步报错先看报错信息下一节专门讲常见错误怎么排查。验证通过后说明你的 Skills 目录、settings 配置、统一 Key 接入这条链路是通的。接下来就可以按自己的工作场景把重复交代的规则一个个沉淀成 Skill。记住一个原则先跑通一个再批量加别一上来装十几个出了问题都不知道是哪个环节的。5. 本篇常见错误排查401、local proxy failed 与 OAuth 报错配置过程中最容易卡住的就那几个报错这一节按真实报错逐条对照给到排查方向。401 Unauthorized。这是最常见的一个意思是 Key 没通过验证。排查顺序第一确认ANTHROPIC_AUTH_TOKEN填的是完整的 Key没有多余空格或换行第二确认 Key 没有过期或在控制台被删除第三确认 Base URL 填的是https://taotoken.net/api而不是别的地址。很多人 401 是因为 Base URL 和 Key 不匹配比如 Key 是 A 平台的地址填了 B 平台的自然过不了。改完记得重启 Claude Code。local proxy failed / connection refused。这个报错通常出现在本地有代理设置、或者网络环境拦截了请求的时候。排查方向检查系统环境变量里有没有HTTP_PROXY、HTTPS_PROXY这类设置如果有且指向了一个不可用的地址请求就会失败。另外确认ANTHROPIC_BASE_URL没有写成localhost或某个本地端口。如果你之前配过别的工具残留了代理配置建议清掉再试。这个报错和网络环境强相关逐项排除即可。reading choices of undefined。这个报错一般出现在返回结构不符合预期的时候常见原因是 Model ID 填错了或者 Base URL 指向的接口不兼容当前请求格式。排查确认ANTHROPIC_MODEL填的是有效模型名别自己拼一个不存在的确认 Base URL 是标准的 API 地址没有多加路径。改完重启验证。OAuth 相关报错。如果你看到提示需要 OAuth 登录、或者 token 刷新失败通常是因为工具走了默认的登录流程而没有用你配置的 Key。排查确认 settings.json 里的ANTHROPIC_AUTH_TOKEN已经填好并且工具读取的是这份配置。有些工具会优先读环境变量那就把ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN也写进系统环境变量里双保险。Skill 不触发。这个不算报错但很常见。原因基本是SKILL.md的 description 太笼统。解决办法是把 description 写具体包含“当用户要求……时使用”这种触发条件。另外确认autoLoad是 true以及 Skill 文件夹直接放在skills/下而不是多套了一层目录。/skills列表为空。检查directory路径是否正确Windows 下注意反斜杠和用户目录写法。如果路径里有中文或空格建议换成纯英文路径。改完重启。排查的核心思路就一条先确认 Key 和 Base URL 三件套对不对再看 Skill 目录和 description最后看网络环境。大部分问题都出在前两步。把这几条对照一遍基本能解决九成以上的配置故障。6. 让 Claude 稳定懂你的下一步Skills 配好之后真正的价值在于持续沉淀。你可以从今天开始做一件事每次发现自己又在重复交代同一段要求时就把它记下来攒够三五条用 skill-creator 这类工具把它变成一个 Skill。时间久了你的.claude/skills/目录就是你个人工作习惯的“外脑”。如果你想让这套流程长期稳定跑统一 Key 的接入是基础。TaoToken 的 API Key 可以在控制台统一管理配合https://taotoken.net/api这个 Base URLClaude Code、Codex、Cline 这些工具都能共用一套配置不用每个工具单独折腾。需要生成或管理 Key 的话去控制台的 API Keys 页面操作就行想先试试模型对话效果也可以直接用模型对话页面验证如果你长期做编码和 Agent 类任务Coding Plan 会更划算。接入文档里有各工具的详细配置示例照着填三件套即可。最后留一个实用建议Skill 不是越多越好命中率比数量重要。一个真正好用的 Skill应该对应你经常重复做的事、能明确改变 Claude 的工作方式、并且减少你反复交代背景的成本。按这个标准筛选你的 Claude 才会越来越懂你。
阅读完成 · 觉得有帮助？
