企业官网建设流程全解析

1. 为什么要在本地用 npx skills 装 Skill，而不是手动拷目录

先说清楚 npx skills 是什么、能做什么、适合谁。npx skills 是一个基于 Node.js 生态的命令行工具，它把 GitHub 上的 Skill 仓库拉下来，然后按你选择的 Agent 类型，把 Skill 以软链接（symlink）的方式挂到对应目录里。Skill 本身可以理解成一段给 AI 编程助手看的「说明书 + 脚本」，比如 find-skills 这个 Skill 就是教 Agent 怎么去搜索和发现别的 Skill。适合谁？适合所有在本地用 Claude Code、Cline、Codex、CodeBuddy 这类工具做开发的人，尤其是你不想每次换工具都手动复制一遍 Skill 目录的时候。

我一开始是手动把 Skill 文件夹拷到.claude/skills下面的，结果装了三个工具之后发现同一个 Skill 存了三份，改一处另外两处就不同步了。后来换成 npx skills 的 symlink 模式，源文件只留一份在.agents/skills，其他 Agent 目录全是指向它的软链接，维护成本直接降下来。这也是为什么安装时那个Installation method要选Symlink (Recommended)，选 Copy 的话又会回到多份副本的老路。

但这里有个绕不开的问题：Skill 装好之后，Agent 真正跑起来还是要调模型。本地环境里模型通道怎么统一？如果每个工具各配一套 Key，换工具就要重新填一遍，很容易配错。我现在的做法是用 TaoToken 做统一 Key 和 API 通道，所有 Agent 的 Base URL 都指向同一个入口，Key 也只维护一份。这样 npx skills 负责把 Skill 铺到各个 Agent，TaoToken 负责把模型调用收敛到一个通道，两边各管一摊，本地环境一次就能跑通。

这篇就按这个思路走：先讲 npx skills 的完整安装流程（含交互选项怎么选），再讲 TaoToken 统一 Key 的前置准备，然后给出可复制的配置文件片段，接着跑一个示例 Skill 验证调用返回，最后把常见的报错挨个排一遍。你跟着做，重点盯住「项目范围」和「Symlink」这两个选项，以及配置文件里的 Base URL 和 Model ID 别写错。

2. npx skills 安装 Skill 到本地的完整流程与交互选项

这一节把安装动作拆开讲，命令都能直接复制。前提是你本地有 Node.js 环境（建议 18 以上），npx 会随 npm 一起装好。网络问题这里不展开，按你自己的环境处理即可。

第一步，搜索 Skill。命令是：

npx skills find [query]

这里有个小技巧值得单独说：用中文搜索时，结果里会同时包含中文和英文的 Skill；用英文搜索时，只返回英文 Skill。所以如果你想找的 Skill 可能是中文命名，用中文关键词搜命中率更高；如果确定是英文项目，用英文搜结果更干净。比如搜find和搜查找，返回的列表范围是不一样的。

第二步，安装指定 Skill。命令格式是：

npx skills add <package>

<package>可以是 GitHub 仓库地址，也可以是owner/repo这种简写。以 find-skills 为例：

npx skills add https://github.com/vercel-labs/skills --skill find-skills

执行后进入交互流程，会依次问你几个问题。第一个是选择要安装到哪些 Agent，界面长这样：

◆ Which agents do you want to install to? │ Search: │ ↑↓ move, space select, enter confirm │ │ ❯ ○ Amp (.agents/skills) │ ○ Antigravity (.agent/skills) │ ○ Augment (.augment/rules) │ ○ Claude Code (.claude/skills) │ ○ OpenClaw (skills) │ ○ Cline (.cline/skills) │ ○ CodeBuddy (.codebuddy/skills) │ ○ Codex (.codex/skills) │ ↓ 32 more │ │ Selected: (none)

用空格选中你要的 Agent，回车确认。我一般会勾 Claude Code、Cline、Codex、CodeBuddy 这几个常用的，剩下的按需加。

第二个关键选项是安装范围：

o Installation scope Project ← 这里需要是项目范围，否则不成功

这一点必须强调：scope 要选 Project，不要选 Global。选 Global 的时候，Skill 会被装到用户级目录，很多 Agent 在项目里读不到，表现就是「装完了但 Agent 说没有这个 Skill」。选 Project 才会落到当前项目的.agents/skills下，各 Agent 的软链接也才指向项目内路径。

第三个选项是安装方式：

o Installation method Symlink (Recommended) ← 方便统一管理维护

选 Symlink。源文件只存一份在.agents/skills，其他 Agent 目录都是软链接，改一处全同步。

确认后会出现安装摘要：

o Installation Summary -----------------------------------------------+ | | | .\.agents\skills\find-skills | | symlink → Claude Code, OpenClaw, Cline, | | CodeBuddy, Codex +8 more | | | +-----------------------------------------------+ o Proceed with installation? Yes

选 Yes，完成后提示：

o Installation complete o Installed 1 skill to 13 agents -------------------------------------+ | | | ✓ .\.agents\skills\find-skills | | symlink → Claude Code, OpenClaw, | | Cline, CodeBuddy, Codex | | +8 more | | | +-------------------------------------+ — Done!

到这里一个 Skill 就装好了。另外两个常用命令也一并记下：npx skills check检查技能更新（前提是通过 npx 安装的），npx skills update更新所有已安装技能。安装源可靠性要特别注意，优先选官方或知名组织的仓库。

如果你想一次装 Anthropic 官方的一批 Skill（当前有 17 个），可以用静默安装：

npx skills add anthropics/skills --yes

--yes会跳过交互，按默认选项装。装完可以在nodejs\.agents\skills目录下查看所有已安装的 Skill。想找更多 Skill，可以逛 https://skills.sh/ 和 https://skillsmp.com/ 这两个站点。

3. TaoToken 统一 Key 前置准备与可复制配置片段

Skill 装好了，接下来解决模型通道。TaoToken 在这里的角色是统一 Key 和 API 入口：你只维护一份 Key，所有 Agent 的 Base URL 都指向同一个地址，换工具不用重新配。官网入口是 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 地址是 https://taotoken.net/api （这个不加 UTM）。

先去控制台拿 Key，地址是 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite ，在 API Keys 页面创建，页面在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite 。拿到形如sk-xxxx的 Key 之后，下面按工具给配置片段。

Claude Code 的配置走 settings 文件。在项目根目录建.claude/settings.json：

{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_AUTH_TOKEN": "sk-你的Key", "ANTHROPIC_MODEL": "claude-sonnet-4-20250514" } }

Cline 的配置在 VS Code 设置里，对应 JSON 片段：

{ "cline.apiProvider": "openai", "cline.openAiBaseUrl": "https://taotoken.net/api", "cline.openAiApiKey": "sk-你的Key", "cline.openAiModelId": "claude-sonnet-4-20250514" }

Codex 的配置走auth.json，路径在~/.codex/auth.json：

{ "OPENAI_API_KEY": "sk-你的Key", "OPENAI_BASE_URL": "https://taotoken.net/api" }

CodeBuddy 的配置片段：

{ "models": { "provider": "openai-compatible", "baseUrl": "https://taotoken.net/api", "apiKey": "sk-你的Key", "model": "claude-sonnet-4-20250514" } }

三件套对照表，配的时候逐项核对：

注意：Base URL 结尾不要多加/v1或斜杠，按上面原样填。Model ID 写错是最常见的 401 和 404 来源，配完先核对一遍。

如果你用的是 CC Switch 这类多配置切换工具，把上面这套 Base URL + Key + Model ID 存成一个 profile，切工具时直接选这个 profile 就行，不用每个工具单独填。这样 npx skills 管 Skill 分发，TaoToken 管模型通道，两边解耦，本地环境就稳了。

4. 运行示例 Skill 并验证调用返回

配置写完，得实际跑一次才算通。这一节用 find-skills 做示例，验证 Skill 能被 Agent 读到，同时模型调用能正常返回。

先确认 Skill 装到位。在项目根目录执行：

ls .agents/skills

应该能看到find-skills目录。再看某个 Agent 的软链接是否生效，比如 Claude Code：

ls -la .claude/skills

输出里应该有一行指向.agents/skills/find-skills的软链接。如果这里是空的或者不是链接，说明安装时 scope 选错了，回第 2 节重装，scope 选 Project。

接着验证模型通道。用 curl 直接打一次 API，确认 Key 和 Base URL 没问题：

curl https://taotoken.net/api/v1/messages \ -H "x-api-key: sk-你的Key" \ -H "anthropic-version: 2023-06-01" \ -H "content-type: application/json" \ -d '{ "model": "claude-sonnet-4-20250514", "max_tokens": 64, "messages": [{"role": "user", "content": "回复 OK 两个字母"}] }'

正常返回是一段 JSON，content数组里有模型输出。如果这里就报 401，说明 Key 不对；报连接错误，说明 Base URL 写错。

通道通了之后，在 Agent 里跑 Skill。以 Claude Code 为例，进入项目目录启动，然后输入类似「用 find-skills 帮我找一下跟测试相关的 Skill」的指令。Agent 会读取.claude/skills/find-skills里的说明，按 Skill 定义的流程去执行搜索。观察返回：如果 Agent 能说出它调用了 find-skills 并给出搜索结果，说明 Skill 加载和模型调用都通了。

再验证一次更新检查：

npx skills check

它会列出通过 npx 安装的 Skill 是否有新版本。有更新就npx skills update一把梭。

实测下来，最容易出问题的不是 Skill 本身，而是模型通道的配置。所以验证顺序建议是：先 curl 通 API，再在 Agent 里跑 Skill。这样一旦出错，能立刻判断是通道问题还是 Skill 加载问题，不用两头猜。

5. 本篇常见报错排查：401、local proxy failed、reading choices、OAuth

把这几类报错对照着排，基本能覆盖 90% 的卡点。

401 Unauthorized。两种可能：Key 写错，或者 Base URL 不对导致请求打到了别的地方。先核对sk-开头的 Key 有没有多余空格，再确认 Base URL 是https://taotoken.net/api。如果用的是 Claude Code，检查.claude/settings.json里字段名是不是ANTHROPIC_AUTH_TOKEN，写成ANTHROPIC_API_KEY有些版本不认。

local proxy failed / connection refused。这类通常是本地网络或端口问题，不是配置字段错。先确认本机能不能访问外网，再确认没有别的进程占用了你配置里的端口。如果你之前配过本地转发，把那段配置清掉，直接用 TaoToken 的 Base URL，少一层转发少一个故障点。

Error reading choices / 返回体解析失败。这个多半是 Model ID 写错，或者请求打到了一个不返回标准 JSON 的地址。核对 Model ID 拼写，确认 Base URL 结尾没有多余的/v1/v1这种重复路径。还有一种情况是 Key 权限不够，换一个控制台里新建的 Key 再试。

OAuth 相关报错。有些工具默认走 OAuth 登录流程，你配了 API Key 但它还在尝试 OAuth。这时候要去工具设置里把认证方式从 OAuth 切成 API Key，或者把 OAuth 的配置项清空。Codex 的话检查~/.codex/auth.json是不是被旧的 OAuth 字段覆盖了。

Skill 装了但 Agent 读不到。回到第 2 节，确认 scope 选的是 Project，安装方式是 Symlink。然后ls -la看软链接是否真的建了。如果软链接指向的路径不存在（比如你挪动了项目目录），删掉重装。

npx skills check 报找不到已安装 Skill。这个命令只认通过 npx 安装的记录，手动拷进去的它不认。如果你之前是手动装的，先用 npx 重装一遍再 check。

排障的时候记住一个原则：先隔离变量。curl 能通说明通道没问题，那问题就在 Agent 配置或 Skill 加载；curl 不通就先修通道，别去动 Skill。这样排查路径最短。

6. 把 Skill 分发和模型通道分开维护

整套流程走下来，核心就两件事：npx skills 负责把 Skill 铺到各个 Agent，TaoToken 负责把模型调用收敛到一个 Key 和一个 Base URL。这两件事分开之后，你加一个新 Agent 只需要在 npx skills 里勾一下，模型配置复制同一套三件套就行，不用重新申请 Key。

几个实用习惯：装 Skill 时 scope 永远选 Project、方式永远选 Symlink；配置文件里的 Base URL 和 Model ID 存成一个模板，换工具直接粘贴；每次装完新 Skill 先npx skills check确认版本，再在 Agent 里跑一次确认能读到。想找更多 Skill 就去 https://skills.sh/ 和 https://skillsmp.com/ 逛，看到合适的用npx skills add装进来。

需要长期跑编码任务或者搭 Agent 的话，可以看下 Coding Plan：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite 。想先验证模型返回效果，用模型对话页面：https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=chat&utm_campaign=rewrite 。接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ，Claude Code 相关说明在 https://taotoken.net/claudecode?utm_source=taotoken_aicg_blog_end&utm_content=claudecode&utm_campaign=rewrite 。配完先 curl 一次，再进 Agent 跑 Skill，这个顺序能帮你省掉大半排查时间。