跳转到主要内容
AionUi 是一款开源桌面“协作”应用，可编排多个编程智能体（Claude Code、Codex、OpenCode 等），并包含自己的内置智能体。将 Tokios 添加为 Custom OpenAI 兼容模型——将其指向 https://api.tokios.com/v1 并使用您的 sk-tok-… 密钥——即可让 AionUi 的内置智能体在您自己硬件上的模型上运行。
本页介绍 AionUi 自身的模型配置。AionUi 启动的外部 CLI 智能体（Claude Code、OpenAI Codex、Hermes Agent 等）各自读取自己的设置——请使用专用指南将这些智能体指向 Tokios，例如 Claude Code 和 OpenAI Codex。

​
前提条件

连接器已配对

在您希望 AionUi 访问的模型旁边安装并配对 tokios-connector。

模型已注册

为该模型注册一个部署（公共名称）。

API 密钥已创建

创建一个 sk-tok-… 密钥，可选择将其范围限定为该部署。

支持的后端

确认您的本地后端（Ollama、llama.cpp、vLLM、LM Studio）正在运行。

​
将 Tokios 添加为自定义模型

1

打开模型设置

在 AionUi 中，打开 Settings → Model Settings，然后选择 Add Model。
2

选择 Custom 平台

从平台列表中选择 Custom——这是适用于任何提供 OpenAI 兼容接口的服务的选项。
3

设置基础 URL 和 API 密钥

输入 Tokios 端点和您的密钥：
将 /v1 包含在 Base URL 中。
4

将您的部署添加为模型名称

在 Model Names 中，输入您注册的公共部署名称（可在 Models 选项卡中查看）——例如，gemma-tunnel。这是 AionUi 在 model 字段中发送的值，而不是您后端的本地模型 ID。
将 gemma-tunnel 替换为您注册的部署名称，将 sk-tok-YOUR_KEY 替换为您自己的密钥。切勿将两者提交到共享配置文件中。

​
一个 GUI，背后是您的模型

AionUi 旨在运行可读取文件、编写代码和自动执行任务的智能体。将其内置模型指向 Tokios 后，这些工作流会在您控制的模型上运行——该模型旁边的连接器向 Tokios 发起出站连接，AionUi 通过 https://api.tokios.com/v1 使用您的密钥访问它，无需入站端口或 VPN。

​
故障排除

AionUi 发送的 API 密钥缺失、格式错误或已被撤销。确认您粘贴了完整的 sk-tok-… 密钥且没有多余的空格，并在 Keys 选项卡上检查其状态。
模型值与已注册的部署不匹配，或者基础 URL 缺少 /v1。确认模型名称与 Models 选项卡上的公共名称匹配，并且基础 URL 为 https://api.tokios.com/v1。
该部署的连接器离线或已达到并发上限。检查 Connectors 选项卡——连接器需要显示为 Online，并且运行它的机器需要仍然在线且可访问。

​
后续步骤

兼容客户端

查看其他 OpenAI 和 Anthropic 兼容客户端的基础 URL 和密钥设置。

使用 Claude Code

将 AionUi 运行的 Claude Code 智能体指向您的 Tokios 端点。