快速上手

安装 Mirasim

Mirasim 是桌面应用，支持 macOS、Linux 和 Windows。在下载页获取适合当前电脑的安装包。

1. 下载安装包

   macOS 要求 macOS 13 Ventura 或更高版本。M 系列 Mac 选 Apple 芯片版，Intel Mac 选 Intel（x86_64）版。Linux 以 AppImage 或 .deb 发布，x64 与 Arm64 均有，适用于 Ubuntu 22.04 或同代 glibc 发行版。Windows 要求 Windows 10 1809 或更高；首次安装时如果 SmartScreen 弹出提示，确认后继续安装即可。

2. 拖入「应用程序」并打开

   首次启动时，系统可能要求确认打开来自互联网的应用，选择「打开」即可。

3. 校验安装包（可选）

   每个版本都会发布 SHA256SUMS，覆盖所有公开下载的文件。打开安装包之前可以先比对校验值。

shasum -a 256 ~/Downloads/Mirasim-*.dmg
# compare the hash against the matching line in SHA256SUMS

点左下角的账号卡，再点「版本」，可以看到当前版本、上次检查的时间，以及是否有新版本。新版本会自动下载，下载完成后点一下即可更新。帮助也在这一页，包括使用文档和反馈。反馈可以匿名提交，匿名提交的反馈无法收到回复。

首次启动的设置向导

首次启动会先打开设置向导，再进入工作台。必须登录，不能跳过。第一步之后的每一步都可以返回上一步。

1. 登录

   可以用 GitHub、Google 或邮箱验证码登录，并同意服务条款和隐私政策。登录后这一步会显示账号的套餐，有兑换码也在这一步兑换。

2. 安装智能体

   Claude Code 和 Codex 至少装一个。向导会列出这台电脑上已经装好的，缺的由它来装，安装期间可以继续下一步。

3. 技能与插件

   这台电脑上已有的技能、插件和 MCP 原样沿用，这一步也可以打开 Computer Use。之后可以在设置的「插件」页调整。

4. 开始使用

   进入工作台。

有套餐的账号，智能体经由平台运行，使用套餐额度；免费账号的智能体用它们自己的账号运行（「自有」）。之后可以在设置里切换。

添加工作区并选择智能体

1. 添加工作区

   在侧栏点「添加工作区」，选择一个目录，可以是已有仓库，也可以是空目录。

2. 选择智能体

   可选 Claude Code、Codex 或其他已安装的智能体，已有的登录状态会沿用。尚未安装的智能体可以在「智能体配置」中安装。

3. 选择模型与推理强度

   每个会话单独设置模型与推理强度。模型列表分为「官方」和「你的模型」两组。

4. 决定是否隔离

   在输入区打开 worktree，会话会在新建的 Git worktree 中运行，基于你选择的分支。

完成一项真实任务

1. 发送需求

   在输入框写下想要的结果并发送。

2. 查看进度并引导

   对话记录实时显示推理过程、工具调用及其返回、子任务的执行情况，以及本轮用量。执行期间可以排入下一条指令、引导正在执行的这一轮，或者中止。

3. 审阅并提交

   改动直接写在仓库里。在右侧工具条打开 Git 面板查看 diff，再暂存并提交需要保留的部分。

• ⌘K命令面板：跳转到任意会话、执行任意工作台命令、检索全部对话记录
• ⌘N新建窗口
• ⌘D向右分出新窗格
• ⇧⌘E打开当前窗格所属工作区的文件面板

其他使用方式

各端连接同一个服务端，在一端创建的会话，在其他端同样可见。

~/.mirasim/bin/mirasim doctor       # check the install and its environment
~/.mirasim/bin/mirasim claude       # Claude Code, with its own TUI and auth
~/.mirasim/bin/mirasim codex        # Codex, with its own TUI and auth
~/.mirasim/bin/mirasim ui-cli help  # the scriptable control surface