Quickstart guide
两分钟，让 Aria 上桌
Aria 是一个 Claude Code 插件 + 一个 macOS 桌面程序的组合。下面三步走完，她就会站在你的桌面上跟你聊。
Step 0
先确认环境
Aria 站在 Claude Code 之上，需要你已经装好它的 CLI。
- macOS 13 或更新— Apple Silicon 和 Intel 都可以
- Claude Code CLI— 没装的看 claude.com/claude-code，需要 Claude Pro 或 Max 订阅。
- Python 3.12+ / Node 18+— brew install python@3.12 node 一键搞定
Step 1
装 Claude Code 插件
在你任意一个 Claude Code 会话里，把下面三行命令依次贴进去。
step 01在 Claude Code 里跑
$ /plugin marketplace add LucasLawliet/aria-coder-buddystep 02安装 aria-cc-plugin
$ /plugin install aria-cc-plugin@aria-coder-buddystep 03Aria 起飞 / 自动下载
$ /aria-cc-plugin:aria-awake最后一行 /aria-cc-plugin:aria-awake 会唤醒 Aria 桌面 app —— 如果你**还没安装** aria.app，这条命令会自动在浏览器打开下载链接。下载后接下一步。
Step 2
首次启动 aria.app
macOS 第一次会拦截，操作只多一步。
必读：⌘+右键打开
Aria 暂时没做苹果开发者公证（避免每年 99 美金 + 公证流程开销，也是现在用户付费意愿不明朗时的工程取舍）。 macOS 第一次双击会拦下来。**不是**闪退，按下面操作即可：
- 1在 Finder 找到下载的
aria.app， 把它**拖到**/Applications。 - 2按住 Control 键点击 aria.app（或者鼠标右键），从弹出菜单里选 **打开**。
- 3系统弹窗再次问"是否打开"时，确认。之后每次启动直接双击就行。
Tips：第一次进入 app 可能会下载 ~1.5GB Unity 资源（首启 only）。后续每次升级是几十 MB 增量。
Step 3
跟 Aria 聊天
装好 + 起飞之后，回到你的 Claude Code 会话。
跟 CC 对话
你正常跟 Claude Code 聊代码 / 问问题，Aria 在桌面上以你的视角默默看着，每次 agent 回复时她会做出反应。
点她有反应
鼠标点击 Aria 角色身体不同部位（头 / 手 / 脚），她会播不同的反应动作 + 表情。