-
打开终端
按
⌘+空格,输入「终端」后回车。 打开终端程序(很多系统是Ctrl+Alt+T),或者 ssh 登录到这台机器。 -
复制这一行,粘贴到终端里,回车
不用 sudo,也不用先装 Node。会下载约 150 MB,大约 1–3 分钟;完成后终端里会出现一个二维码。
curl -fsSL https://affido-dev.fukaya.qzz.io/install.sh | sh
-
用手机 Affido 扫码
手机上:顶部电脑菜单 → 连接我的电脑 → 扫码。扫不了的话,复制终端里
happy://terminal?…那一行,在手机上选「粘贴链接」。 终端里显示「Authentication successful」、手机的电脑列表里出现这台电脑,就连好了。
手机上开的对话默认用你的 Affido 额度,新用户的赠送额度可以直接用,生图也一样。有 Claude 订阅、想用自己的账号:在终端运行 claude 登录一次,再在手机上「电脑设置 › 用谁的额度」里改成「这台电脑的 Claude 账号」(或在终端运行 affido backend own)。在电脑终端里直接开的对话,始终用这台电脑自己的 Claude 登录。
Windows 版还在做。这之前可以先在手机上用 Affido 的云电脑:打开即用,不用在电脑上装任何东西。
装了什么、怎么关掉
- 只装在你的用户目录
~/.affido里,另外在终端配置文件(如~/.zshrc)里加一行,让affido命令能直接用。 - 登录后自动运行:电脑重启后会自己连回手机。不想要:
affido autostart off;安装时就不要:命令末尾改成| sh -s -- --no-autostart。 - 看状态:
affido doctor。卸载:affido uninstall(加--purge连登录凭据和日志一起删)。 - 升级:再运行一次上面那条命令就行,已经连好的不用重新扫码。
常见问题
下载失败,或者提示网络不通
检查网络或代理后再运行一次命令,重复运行是安全的。安装脚本会自动使用
HTTPS_PROXY。公司网络要能访问 affido-dev.fukaya.qzz.io、nodejs.org 和 registry.npmjs.org(国内访问慢时会自动换镜像,下载的文件都会校验)。提示「下载的文件不完整或被改动」
安装已经停下,什么都没改。换个网络再试;还不行请联系我们,并把终端里的输出发过来。
扫码后手机上没出现这台电脑
看终端里有没有显示「Authentication successful」。没有的话再扫一次;有的话在终端里运行
affido daemon start,再用 affido doctor 看原因。电脑显示离线
电脑睡眠或合上盖子时会离线,醒来后会自动回来。长时间要用的话,在系统设置里关掉自动睡眠。
我已经装过原版 Happy,会冲突吗?
不会。Affido 用自己的目录(
~/.affido)、自己的命令(affido)和自己的后台,不读、不改原版 Happy 的任何东西。是 root 用户或服务器
请用普通用户运行。Linux 服务器上没人登录时也要运行的话,请管理员执行
loginctl enable-linger 用户名,再运行 affido autostart on。