春节返乡的高铁上工作群突然弹出一条“线上环境报错了”的消息。我翻了翻背包——电脑塞在行李箱最底层根本掏不出来。手边只有一部手机连充电宝都只剩一半电。那一瞬间我想起来最近社区里非常热闹的 Claude Code既然它本质是命令行工具那在手机上是不是也能想办法接起来于是这个春节我花了两三天时间认认真真把“在手机上跑 Claude Code”这件事测了一遍。最后试出了三套顺手能用的姿势SSH 远程终端、浏览器里的 VS Codecode-server、安卓手机上的 Termux本地环境。三种方式各有各的脾气也各自踩了一些坑。这篇文章就把实测过程、具体命令和避坑经验全部摊开讲给同样被“手机救火”困住的朋友做个参考。1. 为什么要在手机上折腾 Claude Code本质问题不是 App而是“接入”1.1 先把工具属性说清楚很多人第一次搜“Claude Code 怎么用”时会下意识以为它像个手机 App 一样装完点开就能用。其实 Claude Code 是一个跑在终端里的 AI 编程助手核心交互方式是命令行你给它一句自然语言描述它在当前项目目录里读文件、改代码、跑命令、提交补丁全程在终端里输出。这就带来一个关键结论想在手机上“用 Claude Code”真正要解决的不是“装哪个 App”而是“你的手机怎么接到一个能运行 Claude Code 的环境”。计算发生在哪里控制发生在哪里决定了你选择哪种姿势。1.2 三种姿势的划分逻辑我按“计算在哪、控制在哪”把常见做法拆成了三类姿势一把 Claude Code 装在一台常开的电脑或服务器上手机通过 SSH 连过去操作。手机只是一个远程遥控器所有计算都在远端完成。姿势二把 VS Code 变成网页版code-server手机浏览器直接打开一个完整的编辑器界面在网页终端里启动 Claude Code。手机变成一块触屏显示器。姿势三在安卓手机的 Termux 里直接搭建 Linux 环境真机安装 Claude Code手机同时充当计算主机和控制器。社区里大量高频词比如“Claude Code 桌面版”“VS Code 插件配置”“接入本地模型”“Windows 安装”“Mac 安装”其实都是围绕这三种形态的组合展开的。搞清楚这个逻辑之后再去搜安装教程就不会一头雾水。1.3 说实话手机端用 Claude Code 的一天是什么感受先说结论体验肯定不如电脑但绝对可用而且很多场景下比预期的强。我用手机操作时做得最多的事情包括查看报错堆栈、改一行配置、让 Claude 生成一段补丁、把补丁应用到本地分支、重新跑测试、顺手把改动提交到远程仓库。这些操作在手机屏幕上完全能完成只是打字慢一点、显示区域小一点。真正难受的是让 Claude 连续改十几个文件那种大任务——手机键盘误触率高稍不留神就会发错指令所以我的经验是“手机只做短链路、快速处置复杂重构留到电脑前”。正因为想通了这一点我后续的选型都往“稳定、不断线、能快速恢复”的方向靠而这也是下面三种姿势各自侧重解决的痛点。2. 姿势一SSH 终端 一台常开工作机手机只当遥控器2.1 为什么这是最低成本、最稳的一招SSH 是我第一个测的方案也是我最终保留的后备方案。原因很朴素SSH 协议极其成熟稳定性高对手机性能几乎没有任何要求只要能安装一个 SSH 客户端就行安卓和 iPhone 都有现成 App。你只需要提前准备一台能联网的电脑或云服务器装好 Claude Code开启 SSH 服务剩下的就是把手机接上去。2.2 在主机端装好 Claude Code 并激活主机端要求很简单一台能跑 Node.js 的设备Windows、macOS、Linux 都可以。Node 版本建议 18 以上装完 Node 后全局安装 Claude Codenode -v npm install -g anthropic-ai/claude-code claude --version首次运行claude会进入登录流程通常是通过浏览器登录账号或者填写 API Key。如果你用的是官方订阅账号直接按提示完成授权即可。我建议把认证信息写好之后顺手记在你自己的配置文档里因为后面切换手机端时还会用到。如果登录时遇到类似“your organization has disabled claude subscription access for claude code”的报错先别急着在手机端折腾网络。这不是手机问题多半是组织或企业账号在后台把 Claude Code 的订阅访问关了需要用个人账号或者找组织管理员确认权限。当然如果你不方便订阅官方服务也可以在主机端把 Claude Code 接到第三方兼容 API 上。社区里最普遍的玩法是用 DeepSeek 的 Anthropic 兼容端点配置方式也很直接这段我在后面的章节会专门展开。2.3 手机端我只推荐这类 SSH 客户端测过几款 SSH 客户端后我长期留下的是 Termius。免费版够用支持密钥登录、主机分组iOS 和安卓都有。就算偶尔断线重新连接也很快。手机端连接主机的核心参数就是这几项主机 IP、端口、用户名、认证方式。如果你用的是云服务器还要保证安全组/防火墙放行了 SSH 端口。配置完成后一条命令就能连进去ssh workyour-server-ip -p 22进入服务器后先切到项目目录再启动 Claude Codecd /path/to/project claude这时手机上就会出现 Claude 的交互界面你可以直接输入指令。比如让它“看一下 src 目录下最近修改的文件找出可能的报错原因”它会按流程读文件、执行命令最后把结论和修复方案输出在终端里。2.4 实际操作中的三个坑这个方案最大的隐患是“会话中断”。手机锁屏、App 切后台、网络切换都可能导致 SSH 连接断开。如果 Claude Code 正在执行一个长时间任务比如跑测试或者批量改文件断线会让任务直接中断进度丢失。解决办法非常推荐在主机端用 tmux 开一个持久会话。这样即使手机 SSH 断开远端任务依然在 tmux 里继续跑你重新连上后只要执行tmux attach就能恢复现场。tmux new -s work claude # 断开重连后 tmux attach -t work第二个坑是安全问题。手机端 SSH 尽量不要用密码登录密码容易泄露也容易被爆破一步到位用密钥登录。把公钥放到主机的~/.ssh/authorized_keys里手机客户端只需要保存私钥即可。第三个坑是屏幕显示。手机屏幕本来就小终端里中文和代码混排时很容易挤成一团。我是在 Termius 里把字体调大了一档同时开启“触控模式”这样手指轻点就是点击滑动就是滚动误触率低很多。如果主机是 Windows开启自带 OpenSSH ServermacOS 则在“系统设置-通用-共享-远程登录”打开服务。不需要额外安装复杂组件。3. 姿势二把 VS Code 塞进手机浏览器code-server相当于一个网页版工作台3.1 什么时候该用它SSH 方案够稳但有些场景下我明显觉得不够用只看一个报错还能忍但要同时打开多个文件、搜索项目全局变量、查看 Git 改动对比时纯终端界面太吃力了。这时候手机浏览器里能跑一个正儿八经的编辑器就成了刚需。于是第二个姿势就派上用场code-server。它是开源项目把 VS Code 核心搬到浏览器里。你在一台常开机器上运行 code-server手机用浏览器打开一个地址就能得到一个几乎和桌面版一模一样的 VS Code 界面左侧是文件树、中间是编辑区、底部是终端。Claude Code 就直接跑在这个网页终端里。3.2 安装 code-server 的最短路径安装 code-server 的官方推荐方式是一段脚本但我更习惯手动下载安装包因为可控性更高。以 Linux 服务器为例curl -fL https://code-server.dev/install.sh | sh code-server --port 8080默认情况下code-server 会监听所有网卡并且要求输入密码。启动前先设置一个强密码export PASSWORD你自己设的强密码 code-server --port 8080 --host 0.0.0.0手机浏览器访问http://服务器IP:8080输入密码就能进入工作台。如果你只是在家里局域网使用比如让手机连家里的电脑那这个配置就足够安全了。如果要把服务暴露到公网务必加 TLS 和更严格的鉴权不要裸奔。3.3 在网页终端里启动 Claude Code以及我常用的兼容 API 配置进入 code-server 之后打开底部终端先确认一下 Node 环境然后安装 Claude Codenpm install -g anthropic-ai/claude-code claude --version接下来的配置就触及社区里很热的另一个话题第三方 API 接入。我实测中比较顺手的是 DeepSeek 的 Anthropic 兼容端点因为它和 Claude Code 的对接几乎是零成本设置三个环境变量就能跑起来export ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic export ANTHROPIC_AUTH_TOKENsk-你的DeepSeek密钥 export ANTHROPIC_MODELdeepseek-chat claude如果你不想每次都敲一遍环境变量可以写进~/.claude/settings.json的env字段里这样启动claude时它会自动加载{ env: { ANTHROPIC_BASE_URL: https://api.deepseek.com/anthropic, ANTHROPIC_AUTH_TOKEN: sk-你的DeepSeek密钥, ANTHROPIC_MODEL: deepseek-chat } }别的支持 Anthropic 兼容协议的供应商也是同样套路只是换掉 Base URL 和模型名。有人喜欢用 cc-switch 这类工具在不同供应商之间快速切换我试了一下确实比手动改环境变量方便尤其在电脑端和手机端混用时能省不少功夫。想接本地模型也不是不行。不少人在 PC 上用 LMStudio 起一个本地模型服务然后把 Claude Code 的请求转发到本地端点。需要注意一个细节Claude Code 原生使用的协议和 LMStudio 这类本地工具常见的 OpenAI 兼容协议并不完全一致所以通常需要一个中间路由层做协议转换否则启动后会报“返回格式不匹配”一类的错误。这个中间层在社区里已经有不少现成实现我就不重复造轮子了。3.4 实测体感和避坑code-server 方案我连续用了两天整体感受是“比预想流畅”。手机浏览器刷新页面后编辑器和文件状态都会保留终端会话虽然会断开但码农本能的“先 tmux 再干活”习惯在这里同样适用。进到项目目录后先开个 tmux再启动 Claude Code即便浏览器标签被清理或者手机网络切换重新连回来依然能tmux attach恢复任务。比较烦的问题有两个。第一个是手机浏览器的页面可能会“休眠”尤其是省电模式开启后锁屏几分钟再回来页面状态就变了。处理方法是把 code-server 页面加入手机浏览器的“桌面版站点”模式同时关闭针对这个页面的省电限制。第二个是误触。手机上的 VS Code 快捷键和桌面端不同手指在触摸屏上点选文本时经常选中多余内容。有条件的话给手机配一个蓝牙键盘或者外接一个便携折叠键盘体验会提升一个档次。老生常谈但必须再说一遍既然浏览器里跑的是完整的编辑器不要用初始密码不要裸奔到公网。4. 姿势三安卓手机 Termux 里跑本地 Claude Code最折腾但最完整4.1 Termux 到底能干什么SSH 和 code-server 都是“把活往远端推”但有些朋友会在本地有种“必须真正握在手里”的执念我就是想在手机里直接装 Claude Code不依赖别的电脑那 term 第三种姿势就是给你准备的。Termux 是安卓上非常成熟的终端模拟器本质是一个 Linux 环境。安装完基础包之后终端逻辑和 PC 上的 Linux 一样可以用 pkg 安装 Node.js、Git、SSH 等工具也就能安装 Claude Code。4.2 安装四步走Termux 刚启动时自带一个精简环境先把软件源和基础工具更新一遍pkg update -y pkg install nodejs-lts git openssh -y然后全局安装 Claude Codenpm install -g anthropic-ai/claude-code claude --version到这一步Claude Code 已经真正跑在手机里了。接下来配置连接做法和前面一样把兼容 API 的地址和密钥写进环境变量即可。如果你要接 DeepSeekexport ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic export ANTHROPIC_AUTH_TOKENsk-你的DeepSeek密钥 export ANTHROPIC_MODELdeepseek-chat claude如果你想访问手机存储里的工程文件Termux 还需要单独授予存储权限在系统设置里允许 Termux 访问“所有文件”即可否则它默认只能读自己内部目录。4.3 让同一个 Claude Code 环境在手机和电脑之间无缝切换Termux 与电脑端同步用下来我最大的体会是Claude Code 的配置本身是可移植的。项目根目录下的.claude/settings.json和全局~/.claude/settings.json只要两边保持一致同一段对话的历史、技能、自定义提示词都能继续沿用。如果你有自定义 skill 的习惯比如把团队规范、提交信息模板、代码风格检查规则固化下来也可以在.claude/skills/目录下维护手机端 Termux 一样能识别因为它读取的是同一个规则目录。实测中我用手机端跑过一次“帮我按仓库规范生成 commit message”Claude Code 读到了技能文件里的模板输出风格和电脑端完全一致。4.4 Termux 专属的坑掉后台、发热、输入法Termux 方案的问题也很独特而且每一个都挺劝退。第一后台容易被系统杀掉。安卓系统省电策略激进时锁屏后 Termux 进程可能被回收任务直接中断。我在 Termux 里跑长任务前会先执行termux-wake-lock强制保持设备唤醒任务结束再termux-wake-unlock释放。第二发热和耗电。手机端跑 Node.js 加终端交互连续使用十几分钟后机身后盖就能明显感到升温。所以我的建议是Termux 适合做短任务比如改配置、看报错、提交代码不适合让 Claude 连续跑几分钟以上的大任务。想要重活还是交给前两种姿势。第三中文输入法在终端里极容易出错。自带输入法会把逗号句号自动换成全角符号Claude Code 终端里粘贴长文本还会出现缩进丢失。我后来切成英文键盘 蓝牙键盘“误触率”才降下来。如果你也要折腾 Termux这一点越早知道越好。另外如果你在 Termux 里折腾完想卸载重装注意全局卸载命令并不会清掉~/.claude配置目录npm uninstall -g anthropic-ai/claude-code卸载后残留的 settings、skills、历史对话都会留在原目录下次重装还会读取。想彻底干净的话得手动删掉~/.claude和项目下的.claude文件夹。5. 三种姿势同场对比以及我的选择建议5.1 参数对比表三套方案都实测之后我把关键差异整理成了表格方便你对号入座维度SSH 远程终端code-server 网页版Termux 本地 CLI上手门槛低中高手机配置要求很低一般较高输入体验纯终端偏弱接近桌面编辑器纯终端偏弱稳定性高配 tmux 后极稳较高但受浏览器后台限制低安卓后台回收是硬伤网络依赖需要主机可达需要访问 8080 端口仅需要供应商 API 可达适合场景十分钟快速救火长时间改代码、多文件检索极客折腾、本地实验、无远端环境5.2 什么时候选哪一种选 SSH 方案的时机很明确你把稳定放第一位只需要应急处理一个报错、改一小段代码或者配合 tmux 让任务在后台继续跑。它不太依赖手机性能网络通就能用容错率最高。选 code-server 的时机是你要在手机上看完整项目结构、搜索多个文件、查看 Git diff甚至长时间边看边改。它的体验最接近真实开发环境也是我这次春节测试中综合评分最高的一套。如果配一个便携蓝牙键盘你几乎可以把它当临时笔记本用。选 Termux 的时机比较“奢侈”你是安卓用户、手机性能够用、只做短任务或者单纯有折腾精神想在真机上把整个链路跑通。它的最大价值不是效率而是“完整掌握”的自由感。iPhone 用户在这个姿势上比较吃亏iOS 没有等价的 Termux 方案所以我会劝他们优先考虑前面两种。5.3 我个人最终固定下来的一套组合经过这三天实测我最终没有死守某一个方案而是按场景分开用日常通勤和春节在家时主力是 code-server提前在电脑上把服务跑起来手机随时打开浏览器就能干活。遇到网络不稳或者只是快速看一眼时退回 SSH 终端。Termux 则被我留在地铁里偶尔折腾用——信号不好、又没什么大事可做时打开它跑一段本地脚本反而像玩小玩具一样有点快乐。值得一提的是很多搜“Claude Code 嵌入式开发”或者“Claude Code stm32”的朋友其实也用到了同样的思路。编译工具链放在 PC 或远程服务器上手机 SSH 过去让 Claude 生成外设驱动代码再把编译产物拉回来烧录。底层逻辑和我上面讲的完全一致只不过把项目目录换成了单片机工程而已。最后再分享一个实际体会这三天里最让我有“没想到还能这样”感觉的不是某个功能多惊艳而是手机端和电脑端能保持同一套配置、同一份会话历史。我在高铁上用 code-server 让 Claude 改完一个配置到酒店打开电脑tmux attach上下文还接得上。所谓“上班路上也能当牛马”从工具层面讲其实就是“中断不丢失、状态可恢复、想接随时接”。这套思路希望也能帮你少糟心一点多省一点加班的力气。