资讯动态

2.4K 星 Skills Manager:把 AI Skills 目录改到 TaoToken 统一管理

发布时间:2026/10/2 12:24:52 来源:尧图企业网站定制
1. 多工具 Skills 目录分散改一处要复制五遍如果你同时用 Claude Code、Cursor、Codex 三个工具写代码大概率经历过这种场面在 GitHub 上看到一个好用的 Skill下载下来先塞进~/.claude/skills/过两天想在 Cursor 里也用又得手动复制到~/.cursor/skills/再后来 Codex 也要于是~/.codex/skills/再来一份。复制到第三遍的时候你已经记不清哪份是最新的哪份改过 SKILL.md哪份还停留在旧版本。这就是 Skills Manager 这类工具想解决的问题。它本身是一个开源的跨平台桌面应用基于 Tauri 2 React 19 Rust 构建安装包只有几 MB核心思路是建立一个中央技能仓库一处管理、一键同步到所有 AI 编程工具。但很多人在实际用的时候会卡在另一个环节Skills 目录统一了可每个工具背后的 API 入口还是散的——Claude Code 一套 Key、Cursor 一套、Codex 又一套切换工具时还得重新配环境变量。这篇就聚焦这个组合场景用 Skills Manager 把本地 Skills 目录收敛到统一位置再把各工具的 API 入口统一改到 TaoToken让「技能目录」和「模型入口」两件事都不用手动复制。适合同时用两个以上 AI 编程工具、Skills 数量已经超过十个、经常换电脑或重装系统的开发者。我试过把 Claude Code、Cursor、Codex 三边的 Skills 目录和 API 配置全部对齐整个过程大概二十分钟之后新增一个 Skill 只需要在 Skills Manager 里点一次同步。下面把可复制的配置和验证步骤拆开讲。2. TaoToken 前置准备Key、Base URL 与工具入口在动 Skills 目录之前先把 API 入口这层理清楚。TaoToken 提供的是兼容 OpenAI 与 Anthropic 协议的统一入口也就是说 Claude Code、Cursor、Codex 这些工具都能指向同一个 Base URL只是各自读取配置的文件位置不同。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 注意 API 地址后面不加任何查询参数。你需要先拿到一个可用的 Key。登录后进入控制台在 API Keys 页面创建一个新 Key建议按工具命名比如claude-code-key、cursor-key、codex-key这样后面排查 401 报错时能快速定位是哪个工具用错了 Key。创建入口在 https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 创建后立刻复制保存页面刷新后就不再完整显示。模型 ID 这块要注意区分协议。Claude Code 走 Anthropic 协议模型 ID 形如claude-sonnet-4-5-20250929这类Cursor 和 Codex 多数走 OpenAI 兼容协议模型 ID 形如gpt-5、gpt-5-codex这类。具体可用列表以控制台或接入文档为准文档地址在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。不要凭记忆写模型 ID写错会直接报model not found。三个工具需要记住的核心三件套是统一的配置项值说明Base URLhttps://taotoken.net/api不加 UTM不加斜杠后缀API Key控制台创建的 Key按工具分别命名Model ID控制台可用列表按协议区分如果你用的是 Claude Code还需要注意它读取的是 Anthropic 风格的配置环境变量名和 OpenAI 那套不一样。下面第三节会给出每个工具的具体配置文件片段。3. 可复制配置目录映射与三工具 settings 片段这一节是全文最需要照着做的部分。先处理 Skills 目录再处理 API 配置。Skills Manager 安装后默认中央库在~/.skills-manager你可以在设置里改成自己习惯的路径比如~/ai-skills。改完之后把三个工具的 Skills 目录都指向这个中央库。推荐用软链接方式所有工具共享同一份文件改一处全局生效。Skills Manager 界面里对每个工具都有「同步方式」选项选 Symlink 即可Windows 上如果链接权限受限它会自动兜底。手动建立软链接的命令如下macOS / Linux 下# 先备份原有目录避免误删 mv ~/.claude/skills ~/.claude/skills.bak mv ~/.cursor/skills ~/.cursor/skills.bak mv ~/.codex/skills ~/.codex/skills.bak # 建立指向中央库的软链接 ln -s ~/ai-skills ~/.claude/skills ln -s ~/ai-skills ~/.cursor/skills ln -s ~/ai-skills ~/.codex/skills # 验证链接是否生效 ls -la ~/.claude/skills ~/.cursor/skills ~/.codex/skillsWindows 下用管理员权限的 PowerShellNew-Item -ItemType SymbolicLink -Path $env:USERPROFILE\.claude\skills -Target $env:USERPROFILE\ai-skills New-Item -ItemType SymbolicLink -Path $env:USERPROFILE\.cursor\skills -Target $env:USERPROFILE\ai-skills New-Item -ItemType SymbolicLink -Path $env:USERPROFILE\.codex\skills -Target $env:USERPROFILE\ai-skills接下来是 API 配置。Claude Code 的配置在~/.claude/settings.json写入以下内容{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的Key, ANTHROPIC_MODEL: claude-sonnet-4-5-20250929 } }Cursor 的配置在设置界面里打开 Settings → Models → OpenAI API Key填入 Key然后在 Override OpenAI Base URL 里填https://taotoken.net/api。如果你用的是 Cursor 的 Anthropic 模式则在 Anthropic API Key 处填同一个 KeyBase URL 同样填https://taotoken.net/api。Codex 的配置在~/.codex/auth.json和~/.codex/config.toml两个文件。auth.json写入{ OPENAI_API_KEY: sk-你的Key }config.toml写入model gpt-5-codex model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api wire_api chat三件套在这里体现得很清楚Base URL 统一是https://taotoken.net/apiKey 是控制台创建的那个Model ID 按工具协议选。Codex 的wire_api如果填错会报unexpected response format这类错误注意区分chat和responses。配置完成后Skills Manager 里每个工具的页面应该能看到中央库的全部 Skills而 API 入口也都指向了同一个地址。这一步做完才算真正把「目录」和「入口」两件事都统一了。4. 验证请求用一次 Skills 调用检查是否生效配置写完不代表生效必须做一次真实调用验证。分两步先验证 API 入口通不通再验证 Skills 目录读不读得到。先验证 API。在终端里用 curl 直接打一次 TaoToken 的接口确认 Key 和 Base URL 没问题curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的Key \ -H Content-Type: application/json \ -d { model: gpt-5, messages: [{role: user, content: reply with ok}] }如果返回里有choices字段且内容正常说明 Key 和 Base URL 都对。如果返回 401说明 Key 错了或没带上如果返回model not found说明模型 ID 写错了。再验证 Skills 目录。在 Claude Code 里输入/skills或者直接问它「列出你当前能看到的 skills」看输出里有没有你放在中央库里的 Skill 名称。Cursor 里可以在对话中让它读取某个 Skill 的 SKILL.md比如「读一下 ~/.cursor/skills/xxx/SKILL.md 并总结」。Codex 同理。更直接的验证方式是改一个 Skill 的内容看三个工具是否同时看到变化。比如在中央库~/ai-skills/test-skill/SKILL.md里加一行注释然后分别在三个工具里让它读取这个文件。如果三边读到的都是新内容说明软链接生效目录统一成功。验证模型对话是否走的是 TaoToken可以在 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 查看调用记录或者在控制台的用量页面看是否有对应请求。这一步能确认请求确实打到了 TaoToken而不是本地缓存或别的入口。如果验证通过之后新增 Skill 的流程就变成在 Skills Manager 里安装或导入 → 点同步 → 三个工具同时可用。不再需要手动复制到三个目录。5. 常见报错排查401、local proxy failed 与 choices 为空配置过程中最容易撞上的几类报错这里逐个对照。401 Unauthorized。最常见的原因是 Key 没填对或者填到了错误的字段。Claude Code 里要填ANTHROPIC_AUTH_TOKEN而不是ANTHROPIC_API_KEY这两个字段名不一样填错会直接 401。Cursor 里如果同时填了 OpenAI 和 Anthropic 两个 Key注意当前用的是哪个模式。Codex 的auth.json里字段名是OPENAI_API_KEY不要写成api_key。排查方法是用第 4 节的 curl 命令单独测 Key能通说明 Key 没问题问题在工具配置字段。local proxy failed。这个报错通常出现在 Cursor 或 Claude Code 走本地代理时。如果你之前配过本地代理端口现在改成了 TaoToken 直连需要把代理配置清掉。检查~/.claude/settings.json里有没有残留的HTTP_PROXY、HTTPS_PROXY环境变量有就删掉。Cursor 里检查 Settings → Network 的代理设置改成 No Proxy 或 System Proxy。另外确认 Base URL 没有多写斜杠https://taotoken.net/api/和https://taotoken.net/api在某些工具里行为不同建议不带尾斜杠。reading choices 报错或 choices 为空。这类错误说明请求发出去了但返回结构不符合工具预期。常见原因是wire_api配错Codex 里如果填了responses但实际走的是 chat 协议就会解析失败。改成chat再试。另一个原因是模型 ID 和协议不匹配比如用 Anthropic 协议的工具填了 OpenAI 的模型 ID返回结构自然对不上。对照控制台的模型列表确认协议和模型 ID 对应。OAuth 相关报错。如果你之前用 Claude Code 登录过官方账号配置里可能残留 OAuth token和新的ANTHROPIC_AUTH_TOKEN冲突。解决方法是清掉~/.claude/下的凭据缓存文件重新用 Key 方式配置。Codex 同理如果之前登录过官方账号auth.json里可能有旧的 token 字段全部替换成新的 Key。Skills 目录读不到。如果工具里看不到中央库的 Skill先检查软链接是否真的建成了用ls -la看链接指向。Windows 上如果软链接创建失败改用 Skills Manager 的 Copy 模式兜底。另外注意有些工具会缓存 Skills 列表改完目录后重启工具再试。排查顺序建议是先 curl 测 Key再检查工具配置文件字段名最后看目录链接。大部分问题出在字段名和协议匹配上而不是 Key 本身。6. 统一管理之后Skills 与 API 入口的长期维护把 Skills 目录和 API 入口都统一到一处之后日常维护会轻很多。新增 Skill 只需要在 Skills Manager 里操作一次三个工具同时可见换电脑时把中央库目录同步过去软链接重建一遍即可团队协作时把中央库放进 Git 仓库成员拉取后各自建链接Skills 规范就对齐了。API 这层同理Key 统一在 TaoToken 控制台管理需要轮换时只改一处三个工具的配置文件同步更新。如果你长期在多个工具之间做编码和 Agent 任务可以考虑用 Coding Plan 这类按周期计费的方式入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 适合调用量稳定、不想每次单独充值的情况。有一个细节值得注意Skills Manager 的中央库路径改完之后记得在它的设置里把「默认同步方式」设成 Symlink这样新加的工具也会自动用软链接不会退化成复制。另外 Git 备份功能建议开起来中央库推到私有仓库换机器时一键拉取比手动拷贝可靠。最后提醒一句第三方 Skill 来源复杂安装前看一眼 SKILL.md 的内容确认它会让 AI 做什么、有没有附带脚本。目录统一解决的是「复制麻烦」不解决「Skill 本身是否安全」这两件事要分开对待。

读完文章,也想定制专属网站?

尧图设计师 24 小时内与您沟通定制方案

免费获取报价 →
↑