Mars Agent CLI
用手机远程接管你电脑上的 Claude Code。
快速开始
在你的项目目录里运行:
npx @aubea/mars
终端打印一个二维码后,Mars 转入后台运行(关掉终端也继续)。打开 Mars App(登录后)→ 设置 → 配对的电脑 → 扫码,即可在手机上:
- 发消息、看流式回复与工具卡
- 审批高风险操作(可 Face ID 二次确认)
- 审查 diff、提交、切分支、多 Agent 分派与合并评审
- 看成本 / 今日本周 / Agent 赛马
前提
- 电脑已安装并登录 Claude Code(Mars 负责远程接管,不替代它)
- Node.js ≥ 18
常用参数
npx @aubea/mars --repo /path/to/project # 指定项目目录(默认当前目录)
npx @aubea/mars --model opus # 指定模型
npx @aubea/mars --open # 启动即打开一个会话(电脑端发起、手机接管)
npx @aubea/mars --foreground # 前台运行(调试用,不进后台)
后台运行控制
mars 默认后台启动:打印二维码后转后台,关闭终端也继续。日志 ~/.mars/daemon.log,PID ~/.mars/daemon.pid。
npx @aubea/mars --status # 查看是否在跑 / 重看二维码
npx @aubea/mars --stop # 停止后台 daemon
已配对过的电脑重连免扫码。撤销配对:删除 ~/.mars/devices.json。
关于 @aubea/mars 的常见问题
@aubea/mars 是什么？
Mars Agent CLI — 在你的电脑上运行,手机扫码即可远程接管 Claude Code。
如何安装 @aubea/mars？
在项目目录运行 npm install @aubea/mars，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 mars，可以用 npx mars 直接运行。
@aubea/mars 支持 TypeScript 吗？
该包的 package.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/aubea__mars 是否存在。
@aubea/mars 支持 ESM 还是 CommonJS？
以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module，更早的版本需要改用动态 import()。
@aubea/mars 需要什么版本的 Node.js？
package.json 的 engines 字段要求 Node.js >=18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。
@aubea/mars 可以商用吗？
@aubea/mars 使用 UNLICENSED 许可。作者声明为 UNLICENSED，即不授予公开使用许可（与公共领域的 Unlicense 不同）。使用前需获得作者授权。以上为概括，不构成法律意见，请以许可原文为准。
@aubea/mars 的下载量有多少？
根据 npm 官方下载统计，@aubea/mars 在 2026/10/07 – 2026/11/05 这 30 天内被下载 3,822 次，日均约 127 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
@aubea/mars 还在维护吗？
最新版本 1.2.13 发布于 2026/07/21（3 个月前）；至今共发布 16 个版本，其中过去 12 个月发布了 16 个；首次发布于 2026/07/16。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。