在手机上用 Codex。

Codex 留在电脑上跑,终端和手机同时在线。进度、改动和请求实时到手机,在 iPhone、Android 或 Apple Watch 上批准、插话,哪一端都能接着干。

Codexapi-server
运行测试,确认接口改动没有回归

需要你的批准

pnpm test

正在电脑上运行 pnpm test… 36 项测试通过,Codex 接着干 已拒绝,Codex 会换个办法

这就是手机上收到的请求。点一下试试。

终端和手机,同时在线

用 linkshell codex 打开的终端和手机共用同一个会话:任何一端都能发消息、打断、审批。普通 codex 和 Codex 桌面 App 里开的会话,手机上也能跟进。

$ linkshell codex
# 参数原样传给 codex

手机上也能用 Computer Use

在手机上让 Codex 操作电脑里的浏览器和桌面应用,画面在会话浮窗里实时预览。边看边聊,随时补充要求。浮窗可以拖动、放大或收起。(目前支持 macOS 上的 Codex)

手机端 Computer Use:Codex 会话上方的实时画面浮窗

不用打开 App,锁屏和手表上就能批准

实时活动在锁屏和灵动岛上显示进度;Codex 要权限时,卡片上直接给出「拒绝」和「允许」。Apple Watch 上也能看会话、回请求、发一句短消息。

iPhone 锁屏上的 LinkShell 实时活动:一条待确认的请求,带拒绝和允许按钮

实时活动需要 iOS 16.2 及以上,卡片上的按钮需要 iOS 17;手表 App 需要 watchOS 10 及以上。

Codex 的功能,手机上都在

它正忙,照样能插话
忙的时候发的消息先排队,可以调整顺序、取回重写,或者立即发送,直接插进当前这一轮;正在跑的一轮,手机上也能停。
用 /side 旁支提问
一个只读的临时分叉,问答不进入会话。
持久目标 /goal
设置、暂停、恢复、清除,还能设 Token 预算。
斜杠命令和 skills
/compact、/review、/init 和你的 skills 都能在手机上用。
后台命令
查看状态和输出,单独停掉其中一个任务。
回答提问,切换计划模式
回答 Codex 的提问,包括桌面版的异步提问;计划模式在手机上直接切换。
登录方式照旧
ChatGPT 登录、API Key 或自定义提供商(包括 CC Switch 管理的)都能用。

代码和 Codex 都留在你的电脑上

端到端加密
X25519 交换密钥,每一帧用 XChaCha20-Poly1305 加密。网关只转发密文。
用你自己的 Codex 登录
Codex 以你的用户身份、用它自己的登录运行,LinkShell 不经手账号和密钥。
不用同一个 Wi-Fi
手机经网关连进电脑,不用开放端口;网关用官方的或自建的都行。

三步开始

在电脑上安装

Mac 和 Windows 可以下载桌面 App,自带 CLI;macOS 和 Linux 也可以装 CLI,需要 Node.js 22.13 或更新版本。

下载桌面 App

$ npm i -g linkshell-cli
# 或
$ brew install LiuTianjie/linkshell/linkshell
$ linkshell setup

连接手机

iTool 会员:电脑和 App 登录同一账号,电脑自动出现。自建网关:配对一次,扫码即可。

# iTool
$ linkshell login
# 自建网关
$ docker run -d -p 8787:8787 -v linkshell-gateway:/data nickname4th/linkshell-gateway
$ linkshell host --gateway wss://gw.you
$ linkshell pair

开始工作

$ linkshell codex

更多细节在文档里。

价格

Free

¥0

全部功能,用自建网关

  • 全部 Agent、接力、审批、终端、预览
  • 自建网关:一条命令或 Docker
自建网关指南

iTool 会员

¥9.9/月起

国际信用卡 US$3.19/月

  • 官方网关,不用部署服务器
  • 登录同一账号即可连接,免扫码
  • 年度 ¥99,含全部 iTool 产品
开通 iTool 会员 ↗

常见问题

手机要和电脑连同一个 Wi-Fi 吗?

不用。手机经网关连到电脑,在外面用蜂窝网络也行,也不用开放端口。

Codex 的账号和 API Key 会经过 LinkShell 吗?

不会。Codex 用电脑上已经登录的那一份运行,LinkShell 不经手账号和密钥。

能在手机上让 Codex 操作电脑吗?

能。用 Computer Use 让 Codex 操作电脑上的浏览器和桌面应用,画面在会话浮窗里实时预览。目前支持 macOS 上的 Codex。

不打开 App 能批准请求吗?

能。iPhone 锁屏的实时活动带「拒绝」和「允许」按钮(iOS 17 及以上),Apple Watch 上也能回复请求(watchOS 10 及以上)。

要多少钱?

自建网关(一条命令或 Docker)就能免费使用全部功能。不想自己部署,可以开通 iTool 会员用官方网关:月度 ¥9.9 起,国际信用卡 US$3.19/月。

下次离开电脑,让 Codex 接着干

也在用 Claude Code?看看 Claude Code 怎么用。