安装桌面客户端
Onevium 为三大主流平台提供原生桌面应用。请前往 GitHub Releases 页面下载安装包。
- macOS：打开 .dmg 文件，将 Onevium 拖入 Applications。Apple Silicon (arm64) 与 Intel (x64) 版本均可下载。
- Windows：运行 .exe 安装程序 (NSIS)，或解压 .zip 使用便携版。支持 x64 与 arm64。
- Linux：可选择 .AppImage（便携版）、.deb (Debian/Ubuntu) 或 .rpm (Fedora/RHEL)。支持 x64 与 arm64。
登录并连接 API 密钥
首次启动时，Onevium 会要求你填写邮箱地址。验证码将发送到你的收件箱，输入验证码即可完成身份验证。如果你有许可证密钥，可在设置中激活。
Onevium 使用你自己的密钥直接连接 Anthropic API。进入设置 > API 提供商，添加 Anthropic API 密钥。所有请求都会直达 API，不经过代理或中间服务。
选择项目并开始会话
每个聊天会话都对应一个工作目录。选择项目文件夹后，Claude 就能获得代码库的完整上下文；读取与编辑文件、执行终端命令以及发现 Skill/Agent 都会在该目录中进行。
三个界面区域
Onevium 的界面主要分为三个区域：
- 侧边栏（左侧）：切换项目、查看会话历史，以及进入自动化、渠道和设置。
- 会话面板（中间）：与 Claude 对话、实时查看工具执行、批准或拒绝操作，并在不同模型（Opus、Sonnet、Haiku）之间切换。
- 上下文面板（右侧）：浏览项目文件树，并将文件固定到上下文篮子。发送消息时，已固定的文件会自动以 @mention 形式加入上下文。
权限模式
控制 Claude 在会话中拥有多少自主权。你可以随时从工具栏切换模式。
- 默认：Claude 在编辑文件、执行 Shell 命令及其他敏感操作前请求批准；读取文件会自动获批。
- 完全访问：自动批准所有工具调用。适合你信任且希望不中断执行的工作流。
- 计划模式：Claude 先以结构化计划提出变更；你审阅并批准计划后，才会开始编写代码。
数据存储位置
Onevium 的全部数据都保存在本机的 ~/.onevium/ 中。除非 Claude 在会话里明确创建或编辑文件，否则不会向项目目录写入任何内容。
- onevium.db — SQLite 数据库（WAL 模式），用于保存会话、消息、计划任务、渠道配置和审计日志。
- media/ — 生成的图片和媒体文件。
- uploads/{sessionId}/ — 对话中上传的文件，按会话隔离。