AionUI

AionUI 是跨平台 GUI 客户端，把 Claude Code / Codex / Gemini CLI / Qwen Code 等多个 CLI agent 统一在一个图形界面里，避免命令行。

适合谁

• 想用 Claude/Codex 但不喜欢终端的用户
• 需要多 agent 并行管理
• 需要文件预览（PDF/Excel/Word）等富功能
• 需要 WebUI 远程访问（手机/平板也能用）

核心特性

特性	说明
统一图形界面	自动识别本地 CLI 工具，可视化交互
多会话并行	同时开多个独立对话
本地数据	SQLite 本地存储，对话不上传
9+ 格式预览	PDF / Word / Excel / 代码 / Markdown 等
AI 文件管理	批量重命名、自动分类
图像生成	集成多个 image 模型
WebUI 远程访问	浏览器访问，手机端也能用
多模型切换	Gemini / Claude / OpenAI / Ollama 一键切
License	Apache-2.0（完全开源免费）

安装

Windows

# 去 GitHub Releases 下 .exe 安装包
# https://github.com/iOfficeAI/AionUi/releases/latest

macOS - Homebrew

brew install aionui

macOS - 手动

# 去 GitHub Releases 下 .dmg 文件
# Intel 和 Apple Silicon 都有

Linux (Debian/Ubuntu)

wget https://github.com/iOfficeAI/AionUi/releases/latest/download/AionUi-x.x.x-linux-amd64.deb
sudo dpkg -i AionUi-x.x.x-linux-amd64.deb
# 替换 x.x.x 为实际版本号

配置 Shuro

1. 启动 AionUI → 「设置」 → 「LLM 配置」 → 「添加模型」
2. 平台选「自定义」
3. 按下表填写（每种协议加一个）：

Claude（Anthropic 协议）

字段	值
API Key	<您的 API Key>
API 请求地址	https://shuro.vip
模型	claude-opus-4-7 / claude-sonnet-4-6 / claude-haiku-4-5-20251001

Codex（OpenAI 协议）

字段	值
API Key	<您的 API Key>
API 请求地址	https://shuro.vip/v1
模型	gpt-5.5 / gpt-5.4

Codex 要带 /v1

跟其他客户端的规律一致：Anthropic 协议不带 /v1，OpenAI 协议带。

同 key 多协议

Shuro 一把 key 同时支持两种协议（Anthropic + OpenAI），两种协议分别添加但用同一个 key 即可。

使用

启动新会话

侧边栏点「+」→ 选模型 → 开始对话。

切换 agent

在会话标题旁的下拉选择不同的 CLI agent（claude / codex）。

文件预览

拖文件到对话窗口，AionUI 内置预览：

格式	支持
代码（30+ 语言）	✅ 语法高亮
Markdown	✅ 渲染
PDF	✅ 翻页
Word (.docx)	✅
Excel (.xlsx)	✅ 表格
图片	✅
JSON / YAML	✅

WebUI 远程访问

启用后局域网内手机/平板可访问：

「设置」 → 「WebUI」 → 启用 → 默认端口 8765 → 访问 http://<电脑 IP>:8765

跟其他客户端对比

	AionUI	Claude Code (CLI)	Cursor
界面	桌面 GUI + WebUI	终端	IDE
多 agent 切换	✅ 一键	需多客户端	❌
文件预览	✅ 内置 9+	终端有限	IDE 自带
移动端访问	✅ WebUI	❌	❌
编程深度	中（依赖底层 CLI）	强	强
适合	非程序员 / 多 agent 用户	程序员	程序员（IDE 党）

资源

• AionUI GitHub
• 配置指南
• FAQ（中文）
• GitHub Releases

常见问题

启动后找不到 Claude/Codex

AionUI 需要底层 CLI 已安装：

# 装 Claude Code
npm install -g @anthropic-ai/claude-code

# 装 Codex CLI
npm install -g @openai/codex

装完重启 AionUI，自动识别。

模型下拉框是空的

检查「自定义」模型配置：

• API Key 是不是完整
• API 地址协议匹配（Claude 不带 /v1，OpenAI 带）
• 模型名拼写正确（参考 模型列表）

WebUI 局域网访问不了

• 检查电脑防火墙
• 确认 WebUI 在「设置」里启用
• 用电脑 IP（不是 localhost）访问

配套推荐

如果你也想要命令行版本，看：

• Claude Code - 终端原生
• CC Switch - 多 Provider 切换
• Codex CLI - GPT 系列