使用指南

本页适合第一次使用 DevRouter 的用户。按下面顺序完成后，你就可以用 DevRouter 的站点 URL、API Key 和模型名，在常见客户端里调用模型。

1. 注册并登录

1. 打开 DevRouter 控制台。
2. 按页面提示注册账号或直接登录。
3. 登录后进入控制台首页，确认可以看到 API密钥、模型广场 等菜单。

如果无法登录，先检查邮箱、验证码或浏览器网络环境。

2. 创建 API Key

API Key 是客户端调用 DevRouter 的凭证。没有 API Key，客户端无法完成认证。

1. 在控制台进入 API密钥 页面。
2. 点击创建 API Key，分组选择需要使用的平台。

建议按平台或用途命名分组。例如你准备在 Windows 上使用 OpenAI 兼容客户端，可以命名为 OpenAI-Windows，后续查看用量和统计费用会更清楚。 API Key 以 sk- 开头。不要把完整 Key 发到公开群、截图或 Git 仓库里。

3. 检查NodeJS的环境

可跳过条件这一步只针对 Codex、Claude Code、Gemini CLI 这类写代码用的 CLI 终端工具。如果你只准备使用 Cherry Studio 客户端，或使用 OpenClaw / Hermes 这类 Agent 工具，可以跳过本步骤，直接进入下一步选择工具。

按你的操作系统先执行检查命令。能看到版本号就说明环境可用，可以直接进入下一步；如果提示命令不存在，再按当前系统安装 Node.js 和 npm。建议使用 Node.js 20 或更高版本。

WindowsmacOSLinux

先打开 PowerShell，执行检查命令：

PowerShell

PS> node -v
PS> npm -v

返回结果示意

v20.18.1
10.8.2

如果能看到版本号，直接进入下一步。如果提示 node 或 npm 不是可识别命令，再按下面步骤安装：

1. 打开 Node.js 官方下载页。
2. 下载 Windows 安装包。
3. 双击安装包，安装时保持默认选项，确保 npm 一起安装。
4. 安装完成后，关闭旧的 PowerShell 或命令提示符窗口。
5. 重新打开 PowerShell，再执行上面的检查命令。

安装后仍不生效时，检查 Node.js 是否已加入系统 PATH。

先打开 macOS 终端，执行检查命令：

Terminal

$ node -v
$ npm -v

返回结果示意

v20.18.1
10.8.2

如果能看到版本号，直接进入下一步。如果提示命令不存在，并且你已经安装 Homebrew，执行安装命令：

Terminal

$ brew install node

安装完成后重新打开终端，再执行上面的检查命令。如果没有 Homebrew，也可以从 Node.js 官方下载页 下载 macOS 安装包。

先打开 Linux 终端，执行检查命令：

Terminal

$ node -v
$ npm -v

返回结果示意

v20.18.1
10.8.2

如果能看到版本号，直接进入下一步。如果提示命令不存在，Ubuntu / Debian 可以执行安装命令：

Terminal

$ sudo apt update
$ sudo apt install -y nodejs npm

安装完成后重新打开终端，再执行上面的检查命令。如果系统包里的 Node.js 版本太旧，建议改用 nvm 或 fnm 这类版本管理工具安装 Node.js 20 或更高版本。

4. 选择终端、客户端或 Agent

环境检查完成后，先决定你要在哪个工具里使用 DevRouter。不同工具的形态不同，但都需要填写 DevRouter 的 Base URL、API Key 和模型名。

工具名称	本质	适合谁	可以用来干嘛	配置入口
Cherry Studio	AI 聊天客户端	普通用户 / AI 重度用户	用图形界面对话、验证模型、做日常问答	Cherry Studio 配置
Codex	AI 编程终端	开发者	在代码仓库里读写代码、执行命令、处理长任务	Codex 配置
OpenClaw	AI Agent 平台	想做 AI 自动化的人	配置自定义 Provider，搭建和运行 Agent 工作流	OpenClaw / Hermes 配置
Hermes	自学习 AI Agent	高阶 Agent 玩家	接入模型后运行更复杂的 Agent 任务	OpenClaw / Hermes 配置