UniRoute 配置工具与 Skill

UniRoute 提供配置 CLI、Claude Code 插件和通用 Skill，帮助您将官方客户端接入 UniRoute。配置工具查询当前 API Key 可访问的模型目录，按客户端的原生协议写入配置，并在修改前备份文件。

直接使用配置工具

需要 Node.js 22 或更新版本，以及UniRoute API Key。Windows 在 PowerShell 执行，macOS / Linux 在终端执行：

终端Copy

1npx --yes --package=https://uniroute.app/community/uniroute-setup-0.1.2.tgz uniroute-setup models

Key 在终端中隐藏输入。目录查询不证明模型已完成真实调用。复制返回结果中的完整模型 ID，再执行配置；下例以 Codex 为例，请替换 MODEL_ID：

终端Copy

1npx --yes --package=https://uniroute.app/community/uniroute-setup-0.1.2.tgz uniroute-setup configure codex --model MODEL_ID --dry-run

检查预览后写入：

终端Copy

1npx --yes --package=https://uniroute.app/community/uniroute-setup-0.1.2.tgz uniroute-setup configure codex --model MODEL_ID

configure 支持 claude、codex、gemini、opencode、openclaw、hermes。请选择与客户端协议匹配的模型。需要隔离试用时添加 --home /path/to/test-home；默认修改当前用户的配置，有变更的文件会先备份。

以上命令直接使用本站发布的版本包，不依赖同名 npm 包是否存在。工具源代码见UniRoute 社区组件仓库。

Claude Code 插件市场

先安装 Claude Code，在 Claude Code 会话中执行：

添加 UniRoute 插件市场Copy

1/plugin marketplace add emptylower/uniroute-community

安装配置 SkillCopy

1/plugin install uniroute-setup@uniroute-marketplace

按客户端提示重新加载插件或重启会话，然后可以说：

• “用 UniRoute 配置 Skill 帮我配置 Codex，先预览修改。”
• “查询 UniRoute 当前模型目录，我在自己的终端输入 Key。”
• “将 OpenCode 接入 UniRoute，保留原有配置和其他插件。”

插件提供操作指导，通过同一配置 CLI 完成接入。它不会替代 Claude Code、OpenCode 或 OpenClaw 等客户端的官方安装。

通用 Skill

下载 UniRoute 配置 Skill ZIP，解压后将 uniroute-setup 文件夹放到客户端支持的技能目录：

目录中需要包含 SKILL.md。重新打开项目或会话后，在 Codex 中使用 $uniroute-setup，在 Claude Code 中请求使用 UniRoute 配置 Skill。其他客户端请按其官方技能目录说明安装。

API Key 与测试

不要把 API Key 发到 AI 对话中，或作为命令行参数填写。工具支持终端隐藏输入、已有的 UNIROUTE_API_KEY 环境变量和 --key-file /path/to/private-key-file。Key 文件请限制为本人可读。

配置预览、写配置和查询目录不会自动发起付费模型请求。配置完成后，您可以自行打开客户端测试，并到控制台核对调用记录。

相关教程