让 Claude Code 开发一个“美观”的博客网站默认结果往往是蓝紫渐变加 emoji说不上好用。为了让这类任务跑 Agent Skills 时既不浪费上下文 token又不被官方额度卡住我把模型调用的 Key 换成了 TaoToken。先打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 创建 API Key再把 Base URL 填成 https://taotoken.net/api模型 ID 从该站模型广场选好。后面每次做网页、写样式Agent Skills 在本地按需找技能文件这个接口负责把调用请求发出去并记下用量。1. 从“蓝紫渐变”到技能文件Claude Code 的审美救不了但 Agent Skills 可以1.1 你给 Claude Code 提的 UI 要求本质上是一份技能清单默认审美大概就是这样能跑、能看但离能上线还差一截。你开始逐条提要求不要用蓝紫渐变图标改用 SVG顶部导航栏做磨玻璃半透明Hero 区域用图片背景文章卡片上半部分放封面图。改成这些之后页面确实能看了。但每一条要求都只存在于当前对话里换一个新项目同样的清单又得从头输入一遍少写一条审美就退回默认状态。这些 UI 约束本身就是技能。它们属于你不属于模型是长期的审美资产不是临时的聊天记录。Agent Skills 解决的第一个问题就是把这种“每次都要叮嘱”的内容变成 Claude Code 的长期资产并且只在需要时调用。1.2 Skill.md 的元数据只报目录不背全文Agent Skills 的做法很朴素把技能写成结构化的 Markdown 文件。文件最前面放元数据——一行写技能叫什么一行写什么时候该用元数据之后才是指令正文。以网站 UI 设计这个技能为例正文里写清楚“做科技风页面读《科技风.md》”“做简约风页面读《简约风.md》”然后是字体、色彩、间距的具体规范。整个技能是一个文件夹里面放一个主文件Skill.md以及若干子文件和脚本。Claude Code 启动时只会读取每个技能的元数据把名字和描述注入系统提示词相当于告诉模型我带了这些技能书需要哪本再问我要。这就是 Agent Skills 省 token 的起点。元数据很短常驻系统提示词也无所谓几百行指令正文则留在需要时再加载不会每个问题都背上几页纸的 UI 规范。2. 触发时加载省下的 token可能被模型入口的额度问题吃掉2.1 触发时加载 vs 按需加载先分清这两个阶段Agent Skills 的加载机制分两层。第一层是触发时加载模型从元数据清单里判断当前任务需要某个技能才把对应 Markdown 正文要过来。比如它发现用户要做网站就去读网站 UI 设计的Skill.md。第二层是按需加载技能正文已经在上下文里了但《科技风.md》这些子文件和 CSV 表格不会一股脑全塞进来模型边做边取用到科技风才去翻《科技风.md》用到按钮样式才去搜索对应的表。两层加起来避免的是“技能文件无论用不用都占满上下文窗口”的浪费。但这里容易忽略一点Agent Skills 省下的是信息加载这一侧的 tokenClaude Code 每一次和模型交互仍然是一次完整的模型调用。做页面时来回十几轮每一轮都有输入和输出 token技能文件只是输入的一部分模型生成的代码同样是开销。2.2 模型调用本身才是 token 大头入口统一才能看清开销于是你发现技能文件再精炼模型调用次数一多额度还是肉眼可见地往下掉。官方额度用完就得等重置或者另开账号续上Key 一多哪个项目在跑、这月消耗了多少全是糊涂账。更麻烦的是换一个 Key 往往意味着换一个计费身份同一个会话的历史记录不一定延续上下文对不上的情况时有发生。TaoToken 做的就是把 Key 收拢成一个统一的模型调用入口Claude Code 的请求全部走同一套地址、同一个计费视角。它和 Agent Skills 不冲突Agent Skills 决定“什么时候把技能文件发进去”TaoToken 决定“这次发送花了多少 token、对应哪次请求”。个人开发者的直接受益是上下文可以延续用量可以追溯不用靠猜。3. settings.json 里把 Claude Code 指到 TaoTokenBase URL 与模型 ID 怎么填3.1 env 字段三件套Base URL、Token、ModelClaude Code 启动时会读取~/.claude/settings.json其中env对象用来注入环境变量。这里只需要关心三个键{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: YOUR_API_KEY, ANTHROPIC_MODEL: YOUR_MODEL_ID } }第一个键是ANTHROPIC_BASE_URL填接口地址https://taotoken.net/api注意末尾不要加/v1。第二个键是ANTHROPIC_AUTH_TOKEN填从 TaoToken 创建的YOUR_API_KEY复制时小心别把空格带进来。第三个键是ANTHROPIC_MODEL模型 ID 以模型广场展示的名称为准同一款模型可能有不同版本 ID不要凭记忆填一个看着像的。改完配置后关掉当前终端重新在项目目录启动claude让配置生效。这个文件是全局的所有项目都会走同一个入口。如果你只想某个项目用可以在项目根目录再放一份.claude/settings.json覆盖全局值。3.2 环境变量临时覆盖验证请求是否走通不想改配置文件时也可以在当前会话里临时导出环境变量export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_AUTH_TOKENYOUR_API_KEY export ANTHROPIC_MODELYOUR_MODEL_ID这种写法只影响当前终端会话适合快速试验。代价是它容易和全局配置打架settings.json里填了一套值终端环境变量又是另一套环境变量优先但排错成本会变高。遇到问题先看看当前 shell 里有没有残留的ANTHROPIC_*变量再考虑是不是配置文件的锅。配置完成后进claude写一个最简单的 HTML 页面然后去官网控制台的用量记录刷新一下。如果刚才那次请求出现在列表里说明链路通了如果没出现优先检查 Base URL 是否多了/v1以及 Key 是否夹带空格。4. 渐进式加载与用量回看多风格 Skill 文件怎么和 TaoToken 控制台配合4.1 主文档只做索引风格拆进子文件技能用久了Skill.md一定会变长。好看的 UI 风格太多科技风、简约风、小清新全写进一个文件不仅维护困难还会带来误加载让 Claude Code 做个科技风落地页时简约风那几大段也一起进了上下文这部分 token 完全白花。正确的做法是把主文件变成索引。Skill.md里只写“做科技风网站就读《科技风.md》”“做简约风网站就读《简约风.md》”具体规范——字体、间距、配色、组件写法——各自放进子文件。Claude Code 接到任务后先加载Skill.md从索引里找到自己需要的子文件再继续深入。这就是按需渐进式加载不是一开始就全部加载而是沿着索引一层层取用。再往下细粒度的 UI 规则还能落进 CSV。按钮、段落、图标、配色、图表用表格管理比整段文字清晰得多Claude Code 按照Skill.md里写好的工作流调用本地 Python 脚本去 CSV 里搜索匹配项。脚本和 CSV 都在本地项目目录Claude Code 只负责生成脚本、解释搜索逻辑、把结果带回对话真正运行脚本的是你本人。搜索返回的只是匹配结果比完整 CSV 小得多加载成本自然可控。4.2 脚本检索结果也是 token看用量再决定精简谁容易忽略的是脚本搜索出的结果也会写回对话继续占用上下文。它比读取完整文件省但不是零成本。不同子文件的体积直接反映在调用消耗上——《科技风.md》如果写了三千字每次做科技风页面这三千字都会被算进模型输入。哪些技能被频繁触发哪些文件大而少用过去全凭感觉现在可以看数据。TaoToken 官网控制台会按时间列出每次调用的模型、请求时间和 token 数。跑完几个任务后按时间维度对比一下如果某个技能文件占了大量输入 token值得做减法如果某个子文件从没被触发过说明它的描述字段写得不够明确修改 description 往往比改正文更有效。用量记录不是流量报表而是技能文件优化的依据。5. 排障/v1、模型 ID、401 这三个配置错5.1 Base URL 末尾不要加 /v1习惯了 OpenAI 风格地址的人很容易把 Base URL 填成https://taotoken.net/api/v1。TaoToken 的接口地址是https://taotoken.net/api末尾不需要/v1。填错之后Claude Code 在请求拼接时会出现路径错误或 404。排查时先看配置里的 Base URL再看报错信息中的 URL 长什么样。5.2 模型 ID 以模型广场为准别凭记忆填另一种常见错误是把模型 ID 填成记忆里的名字比如看到讨论里提到某个带日期后缀的 ID 就直接抄进来。模型广场上的 ID 是精确匹配的复制时尽量选中完整字符串。如果报错提示模型不存在回到模型广场重新复制一次通常就好。5.3 401 时先查环境变量残留和复制空格401 最迷惑人因为 Key 看起来没问题。两个隐蔽点先检查第一创建 Key 后复制时带进了换行或空格粘贴到配置后看不出来但请求时会把它当作 Key 的一部分第二环境变量残留覆盖了配置里的正确值比如之前为其他项目导出过ANTHROPIC_AUTH_TOKEN现在还留在 shell 里。检查当前环境里的ANTHROPIC_*变量再对照官网控制台创建的 Key 是否完全一致。提示如果报错是 404 且你并没有写/v1检查一下是否把官网落地页地址和接口地址搞混了。落地页是给人注册、看用量用的接口地址才是填进ANTHROPIC_BASE_URL的。前者是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end后者是 https://taotoken.net/api。两处用途不同不要混填。6. Agent Skills 的三段式和配好之后要做的第一件事6.1 元数据、指令、资源代码三段各司其职把整个机制拆开看每个 Skill 都由三部分组成。元数据Meta Data在 Markdown 最前面只有名字和描述两个字段启动时被加载、常驻系统提示词因为内容短token 开销几乎可以忽略。指令Instructions是正文提示词指导模型完成具体任务只有 AI 判定要使用该技能时才加载官方叫触发时加载。资源与代码Resources Code是伴随技能的文件包括脚本、子文档、CSV 表格等真正需要处理那一项时再读取官方叫按需加载。这套思路和 MCP 很像把可复用的能力做成结构化定义再让模型在合适的时机调用。区别是 Agent Skills 更偏提示词工程它不直接操作外部数据而是指导模型按什么流程做、遇到哪种场景取哪份材料。想明白这一点前面配置的接口地址和排障过程就能串起来了。6.2 配好之后去控制台看一次用量记录如果你还没创建过 Key现在去 TaoToken 注册一个。创建之后先跑一个小任务验证把 Key 填进settings.json用claude说“帮我写一个带磨玻璃导航栏的落地页”让它触发网站 UI 这个技能加载《科技风.md》或《简约风.md》。任务结束后回到 TaoToken 控制台找到这次会话的请求列表看看每个请求的输入 token 数。这样既验证了链路也拿到了技能加载的第一份用量样本以后优化技能文件就有数据可以对照了。到这里Claude Code 的 Agent Skills 已经不只是“会写代码”它更像你的前端审美接口技能文件负责告诉模型你的标准API 通道负责让这些标准在调用时开销清晰可见。剩下的就是把常用技能一个个沉淀到 Markdown 里让它们越用越准。 
长河君 · 2026/9/14 4:18:13 · 阅读 1.2k Claude Code 跑 Agent Skills 按需加载：Key 用 TaoToken
让 Claude Code 开发一个“美观”的博客网站默认结果往往是蓝紫渐变加 emoji说不上好用。为了让这类任务跑 Agent Skills 时既不浪费上下文 token又不被官方额度卡住我把模型调用的 Key 换成了 TaoToken。先打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 创建 API Key再把 Base URL 填成 https://taotoken.net/api模型 ID 从该站模型广场选好。后面每次做网页、写样式Agent Skills 在本地按需找技能文件这个接口负责把调用请求发出去并记下用量。1. 从“蓝紫渐变”到技能文件Claude Code 的审美救不了但 Agent Skills 可以1.1 你给 Claude Code 提的 UI 要求本质上是一份技能清单默认审美大概就是这样能跑、能看但离能上线还差一截。你开始逐条提要求不要用蓝紫渐变图标改用 SVG顶部导航栏做磨玻璃半透明Hero 区域用图片背景文章卡片上半部分放封面图。改成这些之后页面确实能看了。但每一条要求都只存在于当前对话里换一个新项目同样的清单又得从头输入一遍少写一条审美就退回默认状态。这些 UI 约束本身就是技能。它们属于你不属于模型是长期的审美资产不是临时的聊天记录。Agent Skills 解决的第一个问题就是把这种“每次都要叮嘱”的内容变成 Claude Code 的长期资产并且只在需要时调用。1.2 Skill.md 的元数据只报目录不背全文Agent Skills 的做法很朴素把技能写成结构化的 Markdown 文件。文件最前面放元数据——一行写技能叫什么一行写什么时候该用元数据之后才是指令正文。以网站 UI 设计这个技能为例正文里写清楚“做科技风页面读《科技风.md》”“做简约风页面读《简约风.md》”然后是字体、色彩、间距的具体规范。整个技能是一个文件夹里面放一个主文件Skill.md以及若干子文件和脚本。Claude Code 启动时只会读取每个技能的元数据把名字和描述注入系统提示词相当于告诉模型我带了这些技能书需要哪本再问我要。这就是 Agent Skills 省 token 的起点。元数据很短常驻系统提示词也无所谓几百行指令正文则留在需要时再加载不会每个问题都背上几页纸的 UI 规范。2. 触发时加载省下的 token可能被模型入口的额度问题吃掉2.1 触发时加载 vs 按需加载先分清这两个阶段Agent Skills 的加载机制分两层。第一层是触发时加载模型从元数据清单里判断当前任务需要某个技能才把对应 Markdown 正文要过来。比如它发现用户要做网站就去读网站 UI 设计的Skill.md。第二层是按需加载技能正文已经在上下文里了但《科技风.md》这些子文件和 CSV 表格不会一股脑全塞进来模型边做边取用到科技风才去翻《科技风.md》用到按钮样式才去搜索对应的表。两层加起来避免的是“技能文件无论用不用都占满上下文窗口”的浪费。但这里容易忽略一点Agent Skills 省下的是信息加载这一侧的 tokenClaude Code 每一次和模型交互仍然是一次完整的模型调用。做页面时来回十几轮每一轮都有输入和输出 token技能文件只是输入的一部分模型生成的代码同样是开销。2.2 模型调用本身才是 token 大头入口统一才能看清开销于是你发现技能文件再精炼模型调用次数一多额度还是肉眼可见地往下掉。官方额度用完就得等重置或者另开账号续上Key 一多哪个项目在跑、这月消耗了多少全是糊涂账。更麻烦的是换一个 Key 往往意味着换一个计费身份同一个会话的历史记录不一定延续上下文对不上的情况时有发生。TaoToken 做的就是把 Key 收拢成一个统一的模型调用入口Claude Code 的请求全部走同一套地址、同一个计费视角。它和 Agent Skills 不冲突Agent Skills 决定“什么时候把技能文件发进去”TaoToken 决定“这次发送花了多少 token、对应哪次请求”。个人开发者的直接受益是上下文可以延续用量可以追溯不用靠猜。3. settings.json 里把 Claude Code 指到 TaoTokenBase URL 与模型 ID 怎么填3.1 env 字段三件套Base URL、Token、ModelClaude Code 启动时会读取~/.claude/settings.json其中env对象用来注入环境变量。这里只需要关心三个键{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: YOUR_API_KEY, ANTHROPIC_MODEL: YOUR_MODEL_ID } }第一个键是ANTHROPIC_BASE_URL填接口地址https://taotoken.net/api注意末尾不要加/v1。第二个键是ANTHROPIC_AUTH_TOKEN填从 TaoToken 创建的YOUR_API_KEY复制时小心别把空格带进来。第三个键是ANTHROPIC_MODEL模型 ID 以模型广场展示的名称为准同一款模型可能有不同版本 ID不要凭记忆填一个看着像的。改完配置后关掉当前终端重新在项目目录启动claude让配置生效。这个文件是全局的所有项目都会走同一个入口。如果你只想某个项目用可以在项目根目录再放一份.claude/settings.json覆盖全局值。3.2 环境变量临时覆盖验证请求是否走通不想改配置文件时也可以在当前会话里临时导出环境变量export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_AUTH_TOKENYOUR_API_KEY export ANTHROPIC_MODELYOUR_MODEL_ID这种写法只影响当前终端会话适合快速试验。代价是它容易和全局配置打架settings.json里填了一套值终端环境变量又是另一套环境变量优先但排错成本会变高。遇到问题先看看当前 shell 里有没有残留的ANTHROPIC_*变量再考虑是不是配置文件的锅。配置完成后进claude写一个最简单的 HTML 页面然后去官网控制台的用量记录刷新一下。如果刚才那次请求出现在列表里说明链路通了如果没出现优先检查 Base URL 是否多了/v1以及 Key 是否夹带空格。4. 渐进式加载与用量回看多风格 Skill 文件怎么和 TaoToken 控制台配合4.1 主文档只做索引风格拆进子文件技能用久了Skill.md一定会变长。好看的 UI 风格太多科技风、简约风、小清新全写进一个文件不仅维护困难还会带来误加载让 Claude Code 做个科技风落地页时简约风那几大段也一起进了上下文这部分 token 完全白花。正确的做法是把主文件变成索引。Skill.md里只写“做科技风网站就读《科技风.md》”“做简约风网站就读《简约风.md》”具体规范——字体、间距、配色、组件写法——各自放进子文件。Claude Code 接到任务后先加载Skill.md从索引里找到自己需要的子文件再继续深入。这就是按需渐进式加载不是一开始就全部加载而是沿着索引一层层取用。再往下细粒度的 UI 规则还能落进 CSV。按钮、段落、图标、配色、图表用表格管理比整段文字清晰得多Claude Code 按照Skill.md里写好的工作流调用本地 Python 脚本去 CSV 里搜索匹配项。脚本和 CSV 都在本地项目目录Claude Code 只负责生成脚本、解释搜索逻辑、把结果带回对话真正运行脚本的是你本人。搜索返回的只是匹配结果比完整 CSV 小得多加载成本自然可控。4.2 脚本检索结果也是 token看用量再决定精简谁容易忽略的是脚本搜索出的结果也会写回对话继续占用上下文。它比读取完整文件省但不是零成本。不同子文件的体积直接反映在调用消耗上——《科技风.md》如果写了三千字每次做科技风页面这三千字都会被算进模型输入。哪些技能被频繁触发哪些文件大而少用过去全凭感觉现在可以看数据。TaoToken 官网控制台会按时间列出每次调用的模型、请求时间和 token 数。跑完几个任务后按时间维度对比一下如果某个技能文件占了大量输入 token值得做减法如果某个子文件从没被触发过说明它的描述字段写得不够明确修改 description 往往比改正文更有效。用量记录不是流量报表而是技能文件优化的依据。5. 排障/v1、模型 ID、401 这三个配置错5.1 Base URL 末尾不要加 /v1习惯了 OpenAI 风格地址的人很容易把 Base URL 填成https://taotoken.net/api/v1。TaoToken 的接口地址是https://taotoken.net/api末尾不需要/v1。填错之后Claude Code 在请求拼接时会出现路径错误或 404。排查时先看配置里的 Base URL再看报错信息中的 URL 长什么样。5.2 模型 ID 以模型广场为准别凭记忆填另一种常见错误是把模型 ID 填成记忆里的名字比如看到讨论里提到某个带日期后缀的 ID 就直接抄进来。模型广场上的 ID 是精确匹配的复制时尽量选中完整字符串。如果报错提示模型不存在回到模型广场重新复制一次通常就好。5.3 401 时先查环境变量残留和复制空格401 最迷惑人因为 Key 看起来没问题。两个隐蔽点先检查第一创建 Key 后复制时带进了换行或空格粘贴到配置后看不出来但请求时会把它当作 Key 的一部分第二环境变量残留覆盖了配置里的正确值比如之前为其他项目导出过ANTHROPIC_AUTH_TOKEN现在还留在 shell 里。检查当前环境里的ANTHROPIC_*变量再对照官网控制台创建的 Key 是否完全一致。提示如果报错是 404 且你并没有写/v1检查一下是否把官网落地页地址和接口地址搞混了。落地页是给人注册、看用量用的接口地址才是填进ANTHROPIC_BASE_URL的。前者是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end后者是 https://taotoken.net/api。两处用途不同不要混填。6. Agent Skills 的三段式和配好之后要做的第一件事6.1 元数据、指令、资源代码三段各司其职把整个机制拆开看每个 Skill 都由三部分组成。元数据Meta Data在 Markdown 最前面只有名字和描述两个字段启动时被加载、常驻系统提示词因为内容短token 开销几乎可以忽略。指令Instructions是正文提示词指导模型完成具体任务只有 AI 判定要使用该技能时才加载官方叫触发时加载。资源与代码Resources Code是伴随技能的文件包括脚本、子文档、CSV 表格等真正需要处理那一项时再读取官方叫按需加载。这套思路和 MCP 很像把可复用的能力做成结构化定义再让模型在合适的时机调用。区别是 Agent Skills 更偏提示词工程它不直接操作外部数据而是指导模型按什么流程做、遇到哪种场景取哪份材料。想明白这一点前面配置的接口地址和排障过程就能串起来了。6.2 配好之后去控制台看一次用量记录如果你还没创建过 Key现在去 TaoToken 注册一个。创建之后先跑一个小任务验证把 Key 填进settings.json用claude说“帮我写一个带磨玻璃导航栏的落地页”让它触发网站 UI 这个技能加载《科技风.md》或《简约风.md》。任务结束后回到 TaoToken 控制台找到这次会话的请求列表看看每个请求的输入 token 数。这样既验证了链路也拿到了技能加载的第一份用量样本以后优化技能文件就有数据可以对照了。到这里Claude Code 的 Agent Skills 已经不只是“会写代码”它更像你的前端审美接口技能文件负责告诉模型你的标准API 通道负责让这些标准在调用时开销清晰可见。剩下的就是把常用技能一个个沉淀到 Markdown 里让它们越用越准。