电脑端配置 · 不是手机 App 安装DESKTOP SETUP · NOT THE MOBILE APP

先准备 AI CLI，再把电脑接到 执简_TermlyPrepare your AI CLI, then connect the desktop to 执简_Termly

执简_Termly App 安装在 HarmonyOS 设备上。本页只配置 macOS、Windows 或 Linux 电脑：用户先自行安装 AI CLI，再安装 Termly CLI 1.9.5，并选择公共或自托管 relay。The 执简_Termly app is installed on HarmonyOS. This page only configures a macOS, Windows, or Linux computer: install your AI CLI first, then Termly CLI 1.9.5, and choose a public or self-hosted relay.

三者缺一不可：All three are required: HarmonyOS 上的 执简_Termly App、电脑上的 Termly CLI 与 AI CLI，以及位于两端之间的 relay 服务。自托管 relay 只是可选部署方式。the 执简_Termly app on HarmonyOS, Termly CLI plus an AI CLI on the desktop, and a relay service between them. Self-hosting the relay is only a deployment choice.
01 · MOBILE执简_Termly App执简_Termly app

HarmonyOS 5.0.0（API 12）及以上；正式版通过 HarmonyOS 分发渠道安装。HarmonyOS 5.0.0 (API 12)+, distributed through HarmonyOS channels.

02 · DESKTOPAI CLI + Termly CLIAI CLI + Termly CLI

AI CLI 由用户自行安装；本页脚本只安装 Termly CLI。You install the AI CLI; this page only installs Termly CLI.

03 · RELAY公共或自托管Public or self-hosted

服务必需；默认公共 relay，自托管是二选一的部署方式。The service is required; use the public relay or self-host it.

curl -fsSL https://www.termlyhos.com/install.sh | bash
支持 Apple 芯片与 Intel Mac，也支持 x64 / ARM64 Linux。Supports Apple silicon, Intel Mac, x64 and ARM64 Linux.查看脚本源码Review script
不需要 sudoNo sudo安装在当前用户的 ~/.termlyInstalls under the current user
依赖可校验Verified runtime缺少 Node 时校验官方 SHA-256Verifies official Node SHA-256
可重复执行Idempotent升级或重装后可再次运行Safe to rerun after upgrades

一键脚本只做三件事The one-command installer does three things

它不会安装 执简_Termly 手机 App，也不会安装、删除或修改 Claude Code、Codex、Gemini、OpenCode 等 AI CLI。It does not install the 执简_Termly mobile app, nor install, remove, or modify Claude Code, Codex, Gemini, OpenCode, or any other AI CLI.

01

准备运行环境Prepare runtime

复用 Node.js 18+；缺少时下载固定 LTS 版本并校验。Reuse Node.js 18+, or download and verify a pinned LTS build.

02

安装 Termly CLIInstall Termly CLI

用户级安装 @termly-dev/cli 1.9.5，不写系统目录。Install @termly-dev/cli 1.9.5 without touching system directories.

03

连接公共 relayConnect the public relay

应用兼容补丁并保留原配置备份；如需自托管，可稍后替换地址。Apply the compatibility patch and keep a backup; replace the address later when self-hosting.

在项目中启动电脑端Start the desktop side in your project

确认目标 AI CLI 已经由你单独安装，然后进入项目目录，用对应的 Termly preset 启动。电脑端会显示二维码与配对码。Make sure you installed the target AI CLI separately, then open the project and launch its Termly preset. The desktop will display a QR code and pairing code.

cd /path/to/your/project termly start --ai claude-code # Termly 1.9.5 内置：codex / opencode / gemini / qwen / aider / copilot
Termly CLI 升级或重新安装后，请再次运行顶部的一键安装命令，让 relay 补丁重新生效。Kimi Code CLI 当前不在 Termly 1.9.5 的内置启动列表中，不能使用 --ai kimi。After upgrading or reinstalling Termly CLI, rerun the one-line installer so the relay patch is applied again. Kimi Code CLI is not a built-in launch target in Termly 1.9.5, so --ai kimi is not currently available.

手动安装Manual setup

希望逐步确认每个动作时，可使用下面三条命令。公共 relay 通过 443/TLS 对外提供 HTTPS/WSS，补丁会自动写入匹配的 API 与 WebSocket 地址。Use these commands when you prefer to inspect every step. The public relay exposes HTTPS/WSS over TLS on port 443, and the patch writes the matching API and WebSocket endpoints.

1 · CLInpm install -g @termly-dev/cli@1.9.5
2 · Relaynpx -y https://www.termlyhos.com/termly-relay-patch-1.1.0.tgz https://relay2.termlyhos.com
3 · Starttermly start --ai claude-code

relay 服务必需，自托管可选A relay service is required; self-hosting is optional

默认一键脚本已经选择 执简_Termly 公共 relay，无需再部署服务器。如果希望连接元数据只经过自己的基础设施，可先部署兼容 relay，再把补丁最后一个参数换成你的 HTTP 或 HTTPS 根地址；不要追加 /ws。The one-command installer selects the 执简_Termly public relay, so no server deployment is needed. To keep connection metadata on your own infrastructure, deploy a compatible relay and replace the patch's final argument with your HTTP or HTTPS base URL; do not append /ws.

npx -y https://www.termlyhos.com/termly-relay-patch-1.1.0.tgz https://relay.example.com
下载 MIT relay 源码包并查看 Docker / Node.js 部署指南Download the MIT relay source and read the Docker / Node.js guide

更新与卸载Update and uninstall

重新运行顶部命令即可更新并重新应用补丁。卸载时删除用户目录 ~/.termly，并移除 shell 配置中的 “执简_Termly desktop CLI” PATH 段；Windows 则从用户 PATH 移除 %USERPROFILE%\.termly。这些操作不会删除或修改任何 AI CLI。Rerun the command above to update and reapply the patch. To uninstall, remove ~/.termly and its “执简_Termly desktop CLI” PATH block; on Windows, also remove %USERPROFILE%\.termly from the user PATH. This never removes or modifies an AI CLI.