AionUi 高级设置 3 步上手：多模型接入、自定义主题与多 Agent 管理-迪斯科星球

AionUi 高级设置 3 步上手：多模型接入、自定义主题与多 Agent 管理

【免费下载链接】AionUiOpen-source 24/7 Cowork app for OpenClaw, Hermes, Claude Code, Codex, OpenCode and 20+ more CLI Agent | Customize your assistants | Team them up｜Star if you like it!项目地址: https://gitcode.com/GitHub_Trending/ai/AionUi

AionUi 是一个本地运行的开源 GUI 应用，把 Claude Code、Codex、Gemini CLI、OpenCode 等 20 多种命令行 AI 工具装进同一个窗口里管理，适合需要同时使用多个 AI 模型、想让助手外观随自己改的个人用户和开发者。这篇文章只讲三件事：在设置页的哪里配多模型、在哪里改主题和自定义 CSS、怎么管理已安装的 Agent。

设置入口在哪里：10 个标签页一张表看懂

设置入口在应用左侧导航栏的 Settings 选项，点进去后不是一个大杂烩页面，而是左侧一排标签页，每个标签页管一块独立的事情。内置标签页共 10 个，按出现顺序是：

标签页	管什么	什么时候去点它
Model	模型平台与 API 密钥	接入一个新模型服务商
Agent	已安装 Agent 的检测、环境变量	新装了 CLI 工具没被识别
Skills	技能导入与管理	给助手加可复用的能力
Tools	MCP 服务器管理	给 Agent 接外部工具
Appearance	主题、字体缩放	换配色、调字号
WebUI	网页版访问设置	想在浏览器里打开 AionUi
Pet	桌面宠物	纯娱乐
System	系统级选项	排查启动问题
Archived	归档数据	清理旧会话
About	版本信息	查版本号

标签页清单定义在 SettingsSider.tsx 里，另外还支持扩展通过contributes/settings-tabs.json往这个侧栏里塞自己的设置页。

怎么一次接入多个模型，API 密钥放在哪

场景：你同时有 OpenAI 的 Key 和某个中转服务的 Key，想让 AionUi 里几个不同的 Agent 各用各的，互不干扰。

操作路径：Settings → Model 标签页 → 添加模型平台。这里可以逐个平台填写 API 地址和密钥，同一平台支持填入多个密钥，调用时自动轮转（一个被限流了就切到下一个）。密钥管理逻辑在 ApiKeyManager.ts，配套的轮换调用在RotatingApiClient.ts。

效果：模型在同一个下拉列表里，不同 Agent、不同会话可以绑定不同平台，密钥轮换对使用过程完全透明，你只会在某个 Key 失效后看到调用自动切走。

主题入口在哪里，自定义主题 CSS 怎么写

场景：默认深浅色用久了想换个风格，或者想精确控制某几个颜色。

操作路径：Settings → Appearance。这个页面能做的事比"选个颜色"多：

切换内置 Light / Dark，或选择已添加的主题；
调节字体缩放，以及分区域设置字号、字体族、字重；
点Add a custom theme新建自定义主题：填名字、选基于浅色还是深色、粘贴一段 CSS，右侧实时预览，保存后直接出现在主题列表里可点击激活。

自定义主题的机制很简单：界面所有颜色都读语义化的 CSS 变量（如--primary主色、--bg-base主背景），你的 CSS 只覆盖想改的变量，没写的保持基线值。完整变量清单和写法见自定义主题指南，变量权威列表在 tokens.md。主题的统一管理入口是 ThemeContext.tsx。

AionUi 自定义主题换肤效果

效果：一段十几行的 CSS 就能让整站配色换风格，且所有窗口同步生效，随时可以删掉恢复默认。

怎么管理多个 Agent 和助手，让它们并行干活

场景：机器上装了 Claude Code 和 Codex，但设置页里没看到其中一个，或者想让多个 Agent 并行处理不同任务。

操作路径：

Settings → Agent 标签页，查看已检测到的本地 Agent，未识别的可以用检测修复入口（AgentRepairPanel）重新扫；
每个 Agent 卡片下可以单独设置环境变量，不用改系统级配置；
需要"固定人设 + 固定模型"的组合，去 Settings → Assistants 里建助手，把模型、提示词、权限绑定在一起，会话里直接选助手而不是每次挑 Agent；
多个 Agent 同时跑、互相分派任务，用项目里的 Team（团队）功能。

效果：一个窗口里各 Agent 用各自的 Key、各自的人设并行工作，会话之间互不串线。

常见设置问题速查

问题	去哪里解决
新装的 CLI 工具列表里不显示	Agent 标签页点检测修复
某个平台的 Key 被限流	Model 标签页给该平台多加一个密钥，自动轮转
主题只改了浅色，深色下没变	自定义 CSS 里用`[data-theme='dark']`选择器单独覆盖
扩展自带的设置页在哪	和内置标签混排在 Settings 左侧栏，由扩展的 settings-tabs 贡献注入
想在浏览器里打开 AionUi	WebUI 标签页开启，配合 webui 指南

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

企业官网建设流程全解析