手机搞定远程AI编程:连接Claude Code和Codex的4套方案
2026/9/8 17:41:42 网站建设 项目流程

大半年没在手机上正经写过代码了,直到最近被拉进一个远程联调的坑——人在外面,服务器上的 Claude Code 和 Codex 挂着跑任务,突然要改提示词、看日志、重启进程,手边只有一台手机。说实话一开始我也觉得这不靠谱,但折腾了几天之后发现,只要方案选对、配置得当,手机远程连接这两个 AI 编程工具还真能撑起大部分运维和调试工作。

这篇文章把我实际踩过、用过的 4 套方案完整梳理一遍。不是网上那种泛泛而谈的"介绍",而是从怎么选、怎么配、到怎么避坑全套讲清楚。无论你是想在外面救急看一眼日志,还是真想用手机长时间挂着跑任务,这 4 套方案里总有一套适合你。

1. 四种方案怎么选,先想清楚你要什么

在动手配置之前,先别急着下载 App。远程连接 Claude Code 和 Codex 这件事,本质上和你平时用 SSH 连服务器没区别,核心就三件事:终端能不能稳定保持连接、键盘能不能顺手输入、任务挂断了会不会丢。把这三点想明白了,选方案就是按需求对号入座。

1.1 方案特点对比,一张表看懂

我自己实际体验下来,这 4 套方案分别覆盖了不同使用场景:

方案连接方式适合场景上手难度稳定性
Termius手机 App 直连 SSH轻量运维、快速看日志、改提示词
ServerBox手机 App 直连 SSH 加系统监控长时间挂机、需要同时看服务器资源
vscode.dev 加隧道手机浏览器访问完整 VS Code需要可视化编辑文件、用插件调试
Termux 本地方案手机本地 Linux 环境直装 CLI折腾型用户,不依赖外部服务器

这 4 套方案里,前两套的核心思路是"把手机当遥控器",服务器和 AI 编程工具都跑在远端,手机只是显示和输入的窗口。第三套是把 VS Code 的界面搬进浏览器,偏向桌面端体验。第四套则是另辟蹊径,直接在手机上装 Linux 环境,让 Claude Code 和 Codex 在手机本地跑。

1.2 为什么推荐先试 Termius 和 ServerBox

如果你之前没有在手机上配过 SSH,我的建议是先从 Termius 入手。它支持 iOS 和 Android,可以保存密钥,可以分组管理服务器,最关键的是连接稳定,断线后重连速度快。

ServerBox 则更偏向"监控加终端二合一"。我长期跑任务的时候,习惯左半屏开着 ServerBox 看 CPU 和内存趋势,右半屏挂着终端窗口。这种组合让我在外面也能第一时间判断服务器是不是被某个任务吃满了,省得每次都要敲htop

从本质上看,remote 连接 Claude Code 和 Codex 并不要求特殊网络环境,只要服务器开了 SSH 端口,公网能访问或者你在同一局域网内,手机就能连上。真正影响体验的往往是键盘布局、屏幕尺寸和断线重连策略,这也是我在后面每个方案里要展开的重点。

2. 方案一:Termius 手机直连,做好这几步就够了

Termius 是目前我用过的最省心的手机 SSH 客户端。免费版就能满足基本需求,如果你想同步主机列表、使用端口转发这些高级功能,再考虑订阅。不过对于远程连接 Claude Code 和 Codex 来说,免费版完全够用。

2.1 基础配置与密钥登录

在电脑上先确认服务器的 SSH 端口和用户名,然后在 Termius 里新建 Host,填上 IP、端口、用户名,认证方式建议选密钥。手机端生成密钥对也可以,但更推荐把电脑上已有的公钥放进服务器的~/.ssh/authorized_keys,然后把私钥导入 Termius。

这样做的好处是省掉了每次输密码的麻烦,而且密钥登录比密码登录更安全,不容易被暴力破解。导入之后实测下来,Termius 的密钥加载速度很快,基本是秒连。

2.2 连接之后怎么让 Claude Code 正常显示

这里有一个容易踩的坑:Claude Code 和 Codex 的终端界面大量使用颜色、边框和特殊字符,如果 Termius 的终端类型设置不对,界面会乱码或者对齐错乱。

我建议把终端类型设置成xterm-256color,并开启 UTF-8 编码。操作路径是 Host 配置页里的 SSH 设置,下拉选择终端类型。

连接成功后,直接在终端里进入你存放 Claude Code 的项目目录,运行对应启动命令。手机屏幕小没关系,Termius 支持横屏模式,横过来之后显示区域大了不少,日常查看任务输出和输入修改指令都够用。

2.3 保持会话不断的三个技巧

在外面用手机连服务器,最烦的就是网络切换导致断线。Termius 里有几个设置能明显改善这个问题。

第一,开启 Keepalive。在 Host 配置的 SSH 选项里,把 keepalive 间隔设为 30 秒左右,这样长时间没有输入也不会被服务器踢掉。

第二,配合 tmux 使用。这是我最推荐的做法:在服务器上开一个 tmux 会话,把 Claude Code 或 Codex 跑在 tmux 里,即使手机断线重连,tmux 里的任务也不会中断。重连之后执行tmux attach -t 会话名就能回到原来的界面,看到完整的任务日志。

第三,Termius 的设置里有一个"自动重连"选项,打开之后断线会自动尝试恢复会话。我实测在手机从 WiFi 切到 5G 网络时,大概 10 秒以内就能自动重连上,体验接近桌面端 SSH。

3. 方案二:ServerBox,挂机监控两不误

如果你和一样经常在服务器上长时间跑 Claude Code 任务,那 ServerBox 绝对能帮你省不少心。它最大的特色是终端加监控二合一,界面做得非常干净,开源免费。

3.1 添加主机与监控面板

ServerBox 支持标准的 SSH 连接,也支持通过 JSON 方式一次性导入多台服务器配置。我通常是在电脑上先把所有主机的 SSH 信息整理成 JSON,然后通过 App 的导入功能一键添加,省去了在手机上一个个输入的麻烦。

添加主机时要填的字段和 Termius 差不多:IP、端口、用户名、密码或密钥、终端类型。ServerBox 也支持私钥认证,我用的就是之前生成好的密钥。连接成功后,首页会展示 CPU 使用率、内存占用、磁盘 IO、网络速率等实时数据。

3.2 如何一边看资源一边操作任务

ServerBox 的界面布局很巧妙,上下分屏可以同时显示监控面板和终端窗口。我在跑 Codex 批量任务的时候,经常切到监控面板确认内存有没有涨到危险值,再切回终端查看任务输出。

如果你打算让服务器长时间跑任务,这一步一定要做:打开 App 的通知提醒功能,ServerBox 支持设置 CPU、内存、磁盘的告警阈值。举个例子,当内存使用率超过 90%,手机就会收到推送,这时候再进终端手动干预,效率比一直盯着屏幕高得多。

3.3 和 Termius 的互补使用方式

其实我不是只用一个 App 走天下。遇到需要频繁切换到多台服务器的场景,我会用 ServerBox 的终端列表功能,把常用的几台服务器放在同一个页面上,左右滑动就能切换。

而当我在外面需要快速改个代码文件,或者重启某个服务时,还是会切回 Termius,因为它的键盘栏在横屏模式下更好用,输入命令的体验更接近桌面端。

经常有人问 ServerBox 是不是只能连 Linux 服务器,我实测对主流 Linux 发行版都没问题,只要机器上开了 SSH 服务就行。Windows 服务器也能连,但个别监控指标可能读不到,比如 CPU 温度、各核心频率等。

4. 方案三:vscode.dev 加隧道,浏览器里的完整 IDE

第三种方案有点特殊,它不依赖手机 App,而是通过浏览器访问 VS Code 的 Web 版本,再连回服务器。这种方式的最大优势是界面几乎还原桌面版 VS Code,文件管理、搜索、插件安装通通能用,特别适合需要改代码而不是只敲命令的场景。

4.1 隧道模式怎么启动

先在这台用于中转的电脑上安装 VS Code,并开启远程隧道功能。微软官方提供了一套名为 "Remote Tunnels" 的机制,使用 GitHub 账号登录后,会生成一个隧道 ID,把这个 ID 记下来。

之后在任何设备上打开vscode.dev/tunnel/你的隧道ID,就会被引导到 GitHub 账号授权页面,授权后浏览器里会出现一个完整的 VS Code 界面,并且已经连接到那台中转电脑的环境。

4.2 在 Web 版 VS Code 里跑 Claude Code

隧道连上之后,你可以在 Web 版 VS Code 中打开终端面板,理论上可以安装或调用 Claude Code。但这里有个大坑:浏览器里的终端对交互式界面的兼容性不一定完美,尤其是 Claude Code 这种带 TUI 风格的工具,偶尔会出现光标错位或者快捷键失效的情况。

我的建议是:在 Web 版 VS Code 里主要做文件编辑和管理,真正跑 Claude Code 还是通过内置终端配合 tmux 来做。如果只是想临时打开某个项目文件看一眼、改两行代码,这个方案非常顺手,比在手机终端里用 vim 强太多。

4.3 浏览器端字体和快捷键的调整

手机浏览器打开 vscode.dev 之后,默认字号会比较小,建议先在设置里把终端字号调大到 16 甚至 18,否则长时间看代码会非常费眼。快捷键方面,手机上本来就没有物理键盘,浏览器端的快捷键映射多少有点别扭。我的办法是外接一个蓝牙键盘,这样基本能获得接近桌面端的输入体验。

值得注意的一点:vscode.dev 的使用流畅度很依赖网络质量,4G 环境下打开大型项目目录可能会卡顿。如果你主要是想快速查看文件,建议用文件树进行按需展开,而不是直接搜索全项目内容。

5. 方案四:Termux 实战,把手机变成第二台开发机

最后这套方案可能是最有折腾乐趣的,那就是在安卓手机上装 Termux,直接在本地跑一个 Linux 环境,再把 Claude Code 和 Codex 装进去。它适合手上没有服务器、又想尝试远程编码的同学,也适合那些喜欢把手机榨干的人。

5.1 Termux 初始化与必备软件安装

Termux 可以在 F-Droid 上找到,安装后第一步是更新软件源和安装基础工具。顺序很重要:先执行pkg update && pkg upgrade,再安装opensshgitnodejs-lts

由于 Claude Code 和 Codex 都需要 Node.js 环境,这里建议直接安装 LTS 版本而不是最新版,兼容性会更好。安装完成后验证一下 Node.js 和 npm 是否正常,输入对应的版本号命令能输出版本信息就说明环境没问题。

5.2 安装 Claude Code 和 Codex 的具体命令

在 Termux 里安装 Claude Code 的方式与在服务器上基本一致,核心就是使用 npm 全局安装。Codex 同样可以通过 npm 安装,安装完成后要确认可执行文件路径在 Termux 的 PATH 里。

执行启动命令后,首次运行会要求登录账号并完成授权,按照终端提示操作即可。在 Termux 里跑 Claude Code 的体验和 PC 上大体一致,界面渲染不会因为手机屏幕小而出现严重变形,但建议打开横屏模式,显示内容更多。

5.3 为什么说 Termux 适合折腾但不太建议重度使用

Termux 方案并不是万能的。实测下来,它在低配置手机上启动 Claude Code 会比较慢,尤其是遇到大项目时,内存不够容易导致进程被杀。另外,手机长时间高负载运行会导致发热和耗电,我试过在连续跑任务十分钟后,机身就开始发烫。

所以我的态度是:Termux 方案适合临时应急、适合学习原理、适合那些没有服务器又想体验 AI 编程工具的用户,但不建议作为长期重度使用的方式。真要长时间跑任务,还是把任务放到服务器上更稳妥。

6. 避坑清单与常见问题排查

4 套方案的配置方法和使用体验聊完了,这一节把我在实际使用中遇到的典型问题和解决方法整理出来,尤其是那些你在文档里未必能直接找到答案的坑。

6.1 断线重连后任务会不会丢

这是新手最常问的问题。直接在终端前台跑的 Claude Code 或 Codex 任务,如果 SSH 断线,进程很可能被 SIGHUP 信号杀掉,任务自然就中断了。解决办法就是我前面反复提到的 tmux。

一定要记住这个组合拳:先用tmux new -s work新建会话,再在里面启动任务。下次重连后执行tmux attach -t work,就能完整恢复到原来的界面,看到所有输出。如果你已经有一个跑了一半的任务没有用 tmux,可以用screen类似,原理是一样的,但 tmux 的窗口管理和复制模式更顺手。

6.2 关闭显示器后远程分辨率降低的问题

如果你通过 VNC 连接服务器桌面,会发现关闭显示器后分辨率会降到很低。这个问题的根源在于显卡没有检测到显示器信号,自动切换到了最小分辨率。

但如果你和我们一样用的是终端连接方式,比如 Termius 或 ServerBox,分辨率完全由终端窗口大小决定,与物理显示器无关。所以关闭显示器后再重连,不会出现分辨率降低的问题。

6.3 Claude Code / Codex 相关报错与处理

在我手机远程操作的过程中,遇到最多的报错有三类:

第一类是代理端点报错,报错信息形如cc switch local proxy failed while handling codex endpoint /responses。这类问题通常是因为本机某个代理工具占用了 8080 或 8000 端口,导致 Codex 请求转发失败。排查方法是先停掉代理工具,或者修改 Codex 配置指向新的端点地址。

第二类错误是模型不支持提示,报错信息形如the 'gpt-5.6-sol' model is not supported,多半是因为 Codex 配置里指定的模型名称在当前登录账号不可用。解决办法是去掉自定义模型名称,回退到默认模型,或者确认账号权限是否覆盖该模型。

第三类是组织订阅限制,提示your organization has disabled claude subscription access。这通常是企业账号策略限制,个人账号一般不会遇到。遇到时要么联系管理员开通权限,要么切换到个人账号登录。

6.4 键盘、屏幕与输入体验的优化建议

手机端使用终端类工具,最大的瓶颈就是键盘。我的经验是优先考虑外接蓝牙键盘,哪怕是几十块钱的便携键盘,输入命令的效率都能提升好几倍。

如果要纯触屏输入,建议开启 Termius 或 ServerBox 的额外快捷键栏,把常用的 Esc、Ctrl、Tab 放在屏幕上,这样操作 vim 和切换 tmux 窗口时会顺手很多。

另外还可以在手机系统层面开启"放大手势"或"字体大小调整",终端 App 里的字体一般都能单独设置,调到清晰可见的大小再开始工作,避免因为看不清而漏掉重要日志。

7. 我的最终建议

说了这么多,按我自己目前的习惯来排序,日常外出应急会优先用 Termius 配合 tmux,长时间挂机观察用 ServerBox,需要改代码时再打开 vscode.dev 隧道,Termux 则更多是最近在地铁上做实验时的玩具。这 4 套方案不是互斥关系,你完全可以像我一样组合着用。

如果你是从零开始,我建议先花半小时把 Termius 和 tmux 的组合跑通,这套方案最稳定也最接近桌面端体验。等熟悉之后,再根据实际需求扩展其他方案。

最后分享一个实操细节:给手机端 SSH 连接单独建一个低权限用户。这样一来,即使手机丢失,对方拿到终端控制权也没法直接操作 root 权限的内容。我在服务器上给手机连接专门建了一个用户,目录权限只放开项目目录,安全性提升很明显。

远程连接 Claude Code 和 Codex 这件事,本质上考验的不是工具本身,而是你对自己工作流的理解。想清楚在什么场景下需要什么能力,再选对应的方案,就不会被各种新出的 App 和脚本牵着走。希望这篇文章能把你在手机远程编码这条路上最绕的几个弯提前帮你掰直了。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询