让 Claude Code 开发一个“美观”的博客网站，默认结果往往是蓝紫渐变加 emoji，说不上好用。为了让这类任务跑 Agent Skills 时既不浪费上下文 token，又不被官方额度卡住，我把模型调用的 Key 换成了 TaoToken。先打开 https://taotoken.net/?utm_source=taotoken_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 省下的是信息加载这一侧的 token，Claude Code 每一次和模型交互，仍然是一次完整的模型调用。做页面时来回十几轮，每一轮都有输入和输出 token；技能文件只是输入的一部分，模型生成的代码同样是开销。
2.2 模型调用本身才是 token 大头，入口统一才能看清开销
于是你发现，技能文件再精炼，模型调用次数一多，额度还是肉眼可见地往下掉。官方额度用完就得等重置，或者另开账号续上；Key 一多，哪个项目在跑、这月消耗了多少，全是糊涂账。更麻烦的是，换一个 Key 往往意味着换一个计费身份，同一个会话的历史记录不一定延续，上下文对不上的情况时有发生。
TaoToken 做的就是把 Key 收拢成一个统一的模型调用入口，Claude Code 的请求全部走同一套地址、同一个计费视角。它和 Agent Skills 不冲突：Agent Skills 决定“什么时候把技能文件发进去”，TaoToken 决定“这次发送花了多少 token、对应哪次请求”。个人开发者的直接受益是，上下文可以延续，用量可以追溯，不用靠猜。
3. settings.json 里把 Claude Code 指到 TaoToken：Base URL 与模型 ID 怎么填
3.1 env 字段三件套：Base URL、Token、Model
Claude 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_URL="https://taotoken.net/api" export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY" export ANTHROPIC_MODEL="YOUR_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_source=taotoken_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 里，让它们越用越准。
