Linkitty

开始使用 Linkitty

Linkitty 连接你自己的 Coding Agent、网站和 API。项目、会话与模型登录保存在电脑；平台处理账号、授权与连接元数据。可信 HTTPS 网关会处理经它转发的正文。电脑需保持唤醒、联网，业务程序和 Linkitty 后台均需运行。

选择系统

系统当前可用性准备
macOS Apple Silicon桌面 ZIP、配套 CLI tarball 已发布Node.js 22+、自己的 Agent 与模型登录
Linux用户级 systemd 接入代码已实现，原生制品尚未发布/验收Node.js 22+、Agent、可用的用户级 systemd；发布前不能使用 macOS tarball
Windows用户任务接入代码已实现，原生制品尚未发布/验收Node.js 22+、PowerShell、Agent；发布前不能使用 macOS tarball
Android ARM64管理 App APK 已发布用同一账号登录，在插件市场安装 Coding
iOS / 其他架构尚未发布以官网下载区实际提供的制品为准

官网下载：linkitty.spark-data.cn。安装包从阿里云 OSS 获取；校验 SHA256SUMS.txt。当前 macOS 使用临时签名，尚未公证。不要关闭系统安全保护。

在 macOS 接入

从下载区取得同版 linkitty 与 linkitty-desktop tarball，按页面命令一起安装；npm 公共仓库仍暂缓发布。随后运行：


linkitty --lang zh

linkitty --region cn

linkitty login

linkitty connect codex

首次连接 Codex，请先完成当前任务并退出独立运行的 Codex。接入成功后正常打开 Codex，即可在电脑、手机继续原生会话；不需要日常共控脚本，不默认绑定项目。linkitty connect codex -qr 可改用手机认领。


linkitty connect pi --executable /absolute/path/to/pi

linkitty connect claude --profile /absolute/private/claude/profile.json

linkitty connect dsh --profile /absolute/private/deepseek/profile.json

linkitty connect web 127.0.0.1:8080

Pi 使用已有本机环境；Claude / DSH 使用已有受保护配置。模型登录由各自运行端处理。接入不授予额外工具权限；Codex 桌面共享连接目前只支持 macOS。更多命令见 CLI 中文 / English。

在手机或桌面继续

登录相同中国区账号，打开插件市场安装 Coding，在“我的服务”选择已接入的服务，再选择项目与会话。查看输出、发送任务、编辑排队消息和审批均受运行端支持能力与当前授权约束。分享只授予明确使用权，不转移管理、凭据和再次分享权。

地域与语言

中国区入口为 https://cn.linkitty.spark-data.cn/gateway。现有 https://112.124.32.189/gateway 继续保留，旧账号和绑定不会因为新增域名而被迁移或清空。新加坡、美国尚未开放；不要向尚未验证的域名发送登录资料。

App 在登录页和账号页切换语言；CLI 使用 --lang zh|en|ja|ru 或 LINKITTY_LANG。语言不改变账号地域。现有账号、配置和运行数据由本机 ~/.linkitty/ 保存，CLI 与桌面共享配置；不要把该目录打包或提交。

停止与删除

linkitty disconnect ID 暂停连接，linkitty service uninstall 停止后台并保留配置。linkitty delete INSTANCE_ID --yes 永久删除服务登记和分享授权；项目、原生会话和电脑文件保留。永久删除前在管理界面核对目标。