Quick start

从安装到连接,按这四步走。

先安装 CLI,再登录认证,随后启动 Claude 或 Codex。认证成功后,App 会显示你的设备和会话状态。

1

下载并安装 CLI

在电脑上下载 tgz 文件,然后全局安装。

npm i -g ./mc-1.1.8.tgz
2

登录认证

运行登录命令,终端会显示二维码。打开 App 扫码或手动输入 URL。

mc auth login --force
3

启动 AI Agent

根据你的工作流启动 Claude 或 Codex。启动后 App 会同步看到会话。

mc claude
mc codex
4

检查状态

如果 App 看不到设备,先确认认证和守护进程状态。

mc doctor
mc daemon status

Troubleshooting

设备没出现时,先看这几个状态。

多数连接问题来自 CLI 未登录、守护进程未运行,或者 App 和 CLI 不在同一套账号密钥下。

认证

确认当前账号

运行 `mc doctor`,确认 Authentication 是已认证状态。

守护进程

确认 daemon 在线

运行 `mc daemon status`,如果没启动,重新执行 `mc auth login --force` 或启动 Agent。

会话

启动 Claude 或 Codex

运行 `mc claude` 或 `mc codex`,App 才能进入真正的会话工作流。

Screens

认证和设置页面。

用户最常用的是扫码认证、账户备份、外观设置三个页面。

链接新设备截图

链接新设备

用二维码完成账户和 CLI 之间的加密绑定。

账户页面截图

账户备份

恢复密钥只保存在用户自己的设备上,需要自行备份。

外观页面截图

外观偏好

设置语言、主题和代码显示偏好。