用npx skills add把treg技能装进任意Agent:MiniMax、Claude、Codex配置对比
【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/treg
treg 是一个面向 AI Agent 的"工具目录 + 凭证代理"(号称 agent 工具的 OpenRouter),一条命令npx skills add就能把它的技能装进 MiniMax、Claude Code、Codex 等任意 Agent,让 Agent 免注册、按次计费地调用 3700+ 个外部 API 端点(SEO 数据、邮件查找、竞品广告、图像视频生成等)。本文对比三条安装路径的差异与坑点,帮你一次配通。
一、装的是什么:treg 技能
先说清楚"技能"(skill)在这个项目里的含义:一个SKILL.md配方文件 + 配套的工具和密钥。Agent 读到它后就知道如何按任务搜索目录、查看价格、发起调用,而API 密钥始终由服务端注入,不落在你的机器上。
技能内容覆盖两类工具:
- 目录(Catalog):treg 托管的外部端点,按次计费,最低一分起;
- 团队自有工具:队友注册的 API 账号、OAuth 连接和自己的技能,同一 token 即可调用,且自己的 key 永远优先于 treg 的 key。
技能的唯一源头是 src/treg/web/skill.md,再由 scripts/build_plugin.py 渲染进各个平台目录(如 skills/treg/SKILL.md),所以你在不同 Agent 里看到的技能内容是同一份。
二、一条命令安装:npx skills add 通用路径
对没有专属插件市场的 Agent(以及想快速上手的场景),通用入口是:
npx skills add superdesigndev/treg -s treg⚠️-s treg参数不能省——不写它,仓库里其他的内部开发技能也会被一并装上。
安装后,技能会引导 Agent 完成一次性初始化(顺序固定,不能颠倒):
curl -fsSL https://treg.to/install.sh | sh # 1. 安装 CLI treg login # 2. 浏览器登录(首次登录即注册) treg mcp install # 3. 把 treg 工具注册进当前 Agent登录界面支持 GitHub 一键登录、邮箱验证码,或直接粘贴团队 token(适合 CI 环境):
登录成功后的团队面板长这样,新团队还有$1.00 免费额度,首次调用不用先付费:
💡 如果你只想要一个不依赖安装脚本的入口,还有 npm 启动器 @superdesign/treg,
npx @superdesign/treg login即可,它会通过uv/pipx/pip3自动补齐 Python CLI。
三、三大平台配置对比
对比总览
| 项目 | MiniMax Code/Agent | Claude Code | Codex / ChatGPT |
|---|---|---|---|
| 安装方式 | 官方插件市场(skills-only) | /plugin marketplace add+/plugin install,或npx skills add | 插件市场 +codex plugin add |
| 引导步骤 | 2 步(CLI + 登录) | 3 步(CLI + 登录 +treg mcp install) | 3 步,随技能加载 |
| MCP 工具 | 不提供 | 提供(重启后生效) | 提供 |
| 技能加载名 | treg:treg | treg:treg | treg:tools-registry |
| 技能源文件 | plugins/minimax/ | skills/treg/ | plugin/skills/treg/ |
1️⃣ MiniMax:为什么只有 2 步
MiniMax 插件是纯技能包(skills-only),原因很硬:MiniMax 市场拒绝任何携带凭证的插件包,而 treg 的 MCP 是每用户 bearer 认证,要原生接入需走其 App/Connector 审核流程。
因此 plugins/minimax/skills/treg/SKILL.md 的引导明确写着:不要执行treg mcp install——该命令只为 Claude Code、Cursor、opencode 写配置,对 MiniMax 是静默空操作。在 MiniMax 上,所有操作都走 CLI 完成。详见 docs/MINIMAX-PLUGIN.md。
2️⃣ Claude Code:三步引导,MCP 工具齐活
Claude 插件以本仓库自己的市场形式分发,零 token、零配置安装:
/plugin marketplace add superdesigndev/treg /plugin install treg@treg顺序是关键:第 3 步treg mcp install会读取第 2 步登录得到的 token,没有 token 时直接退出、不写任何配置。乱序执行的话,Agent 会以为工具已存在而跳过重试。MCP 注册后需重启 Agent,catalog_search、call、balance等工具才可用。完整机制见 docs/CLAUDE-PLUGIN.md。
3️⃣ Codex / ChatGPT:插件目录路线
Codex 插件是一个"分发外壳"(plugin/README.md),技能内容与 CLI 版完全一致,只是多了一段前置引导,保证在没有 treg 的机器上首次运行也不会报command not found。本地验证流程:
codex plugin list codex plugin add treg@superdesign-local # @市场名后缀必须写 codex exec --skip-git-repo-check "List the names of every skill you have available."技能成功加载后会以treg:tools-registry出现。
四、安装后必知的 4 个细节
- 技能会重复一份。
install.sh每次都会把技能再写进 Agent 自己的 skills 目录(如~/.claude/skills/treg/),与插件版本重复但无害,可自行删除。 - 余额不足返回 HTTP 402,响应体自带
topup_url,Agent 可直接处理;调用失败(4xx/5xx)不计费。 - 同类能力多家供应商并列显示,价格、成功率、速度都在
treg catalog get <id>里,由你选择——treg 不会替你自动切换供应商。 - 技能分类信息在 skills.sh.json 中声明(treg 归入 Developer Tools 分类),供 skills.sh 等技能市场检索。
五、验证安装成功
装好后跑两条命令即可确认链路通了:
treg catalog search "backlinks for a domain" # 能搜到端点说明技能已生效 treg balance # 查看余额(新团队 $1.00 起步)能搜、能看价、能调用,treg 技能就算在你的 Agent 里安家了。后续想让自己的 Agent 用团队已注册的 API,用treg tool ls查看清单即可——密钥全程不离开服务端。
【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/treg
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考