ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

手机远程使用Claude Code:SSH连接云服务器的完整实操指南

手机远程使用Claude Code:SSH连接云服务器的完整实操指南 先说结论能用而且我最近几个月已经把这个组合当成了日常主力。Claude Code 本身是跑在命令行里的 AI 编程智能体按说它得待在你电脑上才顺手但只要你把它装在一台随时能连的远程主机里手机就能变成那个“遥控器”。通勤路上改个脚本、睡觉前让 AI 修个 bug、甚至人在机场直接补一段逻辑听起来很科幻实际做下来就是“SSH 连上去、输入 claude、剩下的交给对话”这么简单。这篇东西不是概念介绍而是我踩完坑之后的完整实操记录。内容会覆盖为什么手机能做到、远程环境怎么准备、手机端三种主流接入方式SSH 终端、网页版 VSCode、第三方模型/本地模型、以及一系列真实遇到的问题和对应解法。适合手里有云服务器或闲置电脑的开发者也适合整天被“改个需求”轰炸的运维和全栈同学。就算你手上暂时没有合适的远程机器读完也能把方案的核心步骤放在备忘录里等有条件了直接照抄。1. 先把思路捋清楚手机只是遥控器不是主机1.1 Claude Code 到底是个什么“物种”Claude Code 是 Anthropic 出的一个命令行工具本质上是把 Claude 模型塞进终端环境里让它直接面对你的项目。它不只是聊聊天、吐一串代码给你看而是能真的读取本地文件树、搜索代码、解析报错然后在获得授权之后直接执行终端命令、修改文件、跑测试。你可以理解成给终端请了个“既能看门又能修水管”的老师傅你告诉它“这需求太怪了帮我看看”它会动手翻项目、给你分析、甚至把改动直接写好等你点头再落盘。这个工具和网页版聊天最大的区别是“有上下文”。你在命令行里打开 claude它会以当前目录为工作区自动理解项目结构和已有代码所以修 bug 的时候不用复制粘贴一坨报错和文件内容直接说“这个模块连续三次调用了已经不存在的接口帮我排查一下”就行它自己会去翻代码和 Git 历史。1.2 手机上用的三种姿势哪个靠谱哪个劝退手机不是不能直接跑 Claude Code但绝大多数人不该硬碰硬。我把试过的方法列成了对比表格看完你应该能少走一圈弯路。方案可操作性稳定性适合人群手机装 Termux 直接跑 CLI低依赖安装容易炸一般后台极易被杀极客尝鲜不推荐长期用SSH 远程连到服务器再启动 Claude Code高装好一次后面很顺高配合 tmux 几乎不掉线大多数开发者最推荐服务器部署 Code-Server手机浏览器打开 VSCode中高需要装一个 Web IDE高图形界面更友好习惯 VSCode、刷前端的人通过第三方兼容配置或用本地模型中需要改环境变量或装切换工具视模型稳定性而定想降低使用成本、对隐私敏感的人如果你只是为了尝鲜Termux 确实能装上 Node.js 再装 Claude Code但手机端进程经常被系统清理跑着跑着模型还在会话却断了非常打击士气。所以后面的重点都放在“手机连服务器”这条更省心的路线上。2. 准备一台能跑 Claude Code 的“后端”2.1 用什么机器云服务器还是家里闲置电脑想用手机连你得先有一台 24 小时开机、能连网的远程机器。云服务器和家里的老电脑都行但环境选型有一些区别。云服务器的优势是带宽稳定、IP 固定几乎没有“人在外面但是家里断电了”这种尴尬缺点是按量付费钱包会有点感觉。我自己的选择是一台轻量服务器的 2C4G 配置跑 Claude Code 加 Code-Server 完全不吃力日常占用大概在 30% 到 50% 之间。如果你只是偶尔用2C4G 就够如果希望同时跑多个会话、甚至让 Claude Code 的副驾驶同时干几件事那内存升到 8G 会更从容。家里闲置电脑的优势是零成本但前提是公网访问到位。如果没有固定公网 IP就得靠内网穿透工具或者组网工具有的方案配置起来比将服务器还要折腾。而且手机在外网连家里的机器网络链路长延迟高手感会明显变差。我的建议是能用轻量云服务器就别折腾老本本省下的时间多调试几个 bug 不香吗说完机器选型再强调一下操作系统的问题。Claude Code 在 Linux 和 macOS 上跑得非常顺在 Windows 上则容易触发路径分隔符、权限模型不统一的问题。所以我强烈建议远程机首选 Ubuntu 22.04/24.04如果你是 Windows 电脑也别直接装 npm先整个 WSL 摆好 Ubuntu 环境再继续否则后面会有一堆莫名其妙的坑。2.2 安装 Claude Code 和登录注意点安装其实就一条命令前提是这台机器已经有 Node.js 环境npm install -g anthropic-ai/claude-codeNode.js 版本最好 18 以上装完先跑一下claude --version看到版本号就说明环境通了。登录流程有两种一种是直接用 Claude 订阅账号授权另一种是用 API Key。如果打算长期高频使用订阅账号更划算而且会话历史和上下文管理都比较省心API Key 则适合临时试用或者在多台机器间反复切换的场景。注意这里有一个高频坑如果组织后台禁用了 Claude Code 的订阅访问你会在登录时直接收到错误提示大概率是类似“your organization has disabled claude subscription access”的信息。遇到这个别慌先用个人账号测试登录确认不是机器的问题如果确认是组织策略那就得找管理员开白名单或者干脆走 API Key 方案。至于有人关心的“注册账号和不注册有啥区别”我可以明确告诉你不登录也能跑但功能限制很明显很多工具调用听不听指挥全看模型心情会话连续性也弱。想把 Claude Code 当正经写代码智能体用就老老实实登录一次。还有一点安装时终端里可能报“internetopenurl() failed. 0x800...”之类的网络异常绝大多数情况是这台机器访问官方接口不通。解决办法不是硬改系统参数而是换更稳定的网络出口或者干脆考虑后面要说的第三方模型和本地模型方案。2.3 远程环境的安全与易用加固远程主机不是给你一个人用要防止某天被扫描爆破。我现在的基本操作是禁用 root 密码登录、配置 SSH 密钥、修改默认 SSH 端口再做一个普通用户赋予 sudo 权限。具体可以参考下面这段sudo apt update sudo apt install openssh-server -y sudo systemctl enable --now ssh # 生成密钥后把公钥写进 ~/.ssh/authorized_keys sudo sed -i s/^#PermitRootLogin.*/PermitRootLogin no/ /etc/ssh/sshd_config sudo sed -i s/^#PasswordAuthentication.*/PasswordAuthentication no/ /etc/ssh/sshd_config sudo systemctl restart ssh密钥登录虽然比密码麻烦一点但手机端有 Termius 这类工具能把密钥直接托管配好以后解锁只要指纹一下反而比输密码更顺手。很多第一次做远程方案的人会忽略端口修改这一步。默认 22 端口是扫描机器人最爱的目标改成高位端口能减少绝大多数无差别攻击日志但要注意改完之后云厂商的安全组规则也得放行对应端口不然手机怎么连都连不上。我踩过最深的一次坑就是改完 sshd 配置后忘了在云控制台把防火墙端口加上原地怀疑人生半小时。3. 手机端实操用 SSH 客户端连上去写代码3.1 手机终端工具选型和密钥配置手机上的 SSH 客户端我前后用过不少最后固定在 Termius。原因不外乎三点支持 iOS 和 Android、密钥管理做得顺手、还能在手机和电脑之间同步主机列表。Android 那边也可以用 JuiceSSH老牌且轻快iOS 上还有 Blink如果你喜欢极简终端风格它也不错。但如果只能推荐一个我还是建议 Termius免费版足够日常单机使用付费版则能把多台主机和端口转发功能打开进阶时可以再考虑。配置主机时不要直接用密码登录尤其你要在公共 Wi-Fi 下操作密码很容易在链路上裸奔。正确的姿势是在电脑上生成一对密钥把公钥放到服务器然后把私钥导入 Termius 的 Keychain。需要注意私钥导入后记得设置手机锁屏密码或生物识别否则手机丢了等于给陌生人送了一把通向服务器的钥匙。我之前就有过私钥放 Termius、手机没锁屏密码的“裸奔”阶段现在回想都后怕。3.2 完整的修 bug 会话长什么样想象一个实际场景你在地铁上收到运维消息说某个数据处理脚本偶尔会报KeyError。你打开 Termius连上服务器进入项目目录敲下claude然后直接开始对话。$ cd /home/me/etl-pipeline $ claude Claude Code 已启动正在读取当前项目结构... 帮我排查一下 src/utils.py 里可能出现的 KeyError特别是处理 order_data 的那段逻辑。Claude Code 不会只凭印象回答它会先搜索utils.py里和order_data相关的代码、看调用它的函数、检查数据来源然后告诉你问题出在“旧版数据里没有items字段”而不是“取不到键”本身。接下来你只要说“把这个修复掉顺便跑一遍测试”它会给出具体的 patch经过确认后直接改文件再执行pytest给你看结果。整个过程里你只是拿着手机像发微信一样和终端对话。这段流程我第一次在手机上跑的时候心里最大的震撼不是“AI 能改 bug”而是它一套操作行云流水自己搜索、自己分析、自己改、自己验证我全程只做了两件事说需求、按确认。当然这里也要泼一盆冷水Claude Code 不是每次都一次改对。它执行终端命令前会等你的确认所以你最好盯着点它要跑什么尤其是带rm、mv或者需要改权限的命令别闭着眼睛全按确认。3.3 碎片时间使用效率提升技巧手机上的终端屏幕就那么点大效率提升主要靠三板斧。第一板斧是横屏加放大字号Termius 里可以设置字体和布局横屏后代码折行少很多看着也不容易眼瞎。第二板斧是保持会话不断开。手机切后台、锁屏再回来可能 SSH 已经断开。普通断开还能重连但运行中的 Claude Code 任务可能就中断了。解决办法是在服务器上用tmux包一层tmux new -s work claude下次手机重连进来直接tmux attach -t work就能回到之前的会话现场任务结果还在屏幕上CLI 进程也没被杀。很多老运维喜欢这么干本质上是把“终端的附着点”从单一连接转移到了后台的持续进程里。第三板斧是语音输入。iOS 自带听写在消息框里可以语音转文字Android 用系统输入法的语音输入也可以。说一大段中文需求再让 Claude Code 执行比在九宫格上一个字一个字戳快得多。4. 进阶玩法用网页版 VSCode 和本地模型让门槛更低4.1 部署 Code-Server手机浏览器就是完整 IDE有些人就是适应不了纯黑终端在手机屏幕上盯着命令行总感觉少了点什么。这时候我建议在服务器上把 Code-Server 装上。它本质上是 VSCode 的网页版只要是浏览器就能访问手机上也能看见左边的文件树、右侧的终端和底部那一排状态栏。安装很方便curl -fsSL https://code-server.dev/install.sh | sh sudo systemctl enable --now code-server$USER默认它监听在127.0.0.1:8080如果直接开放公网会被人扫到正规做法是用 Caddy 或 Nginx 反代加 HTTP 基本认证或者配合 Cloudflare Tunnel 之类的机制。我在操作时图省事先用--auth password设了一个强密码再把端口映射到安全组然后用手机浏览器登录第一时间就把“只在局域网”这句话丢到了脑后。你别学我理想做法不是开放给全互联网而是加上一层反代和 HTTPS。Code-Server 的好用之处是能直接装 VSCode 扩展所以你可以同时打开网页端自带的终端跑claude再把 AI 生成的代码显示在左边编辑器里。这个组合比纯 SSH 更直观适合看代码状态时用。4.2 用 CC Switch 这类工具接入第三方模型一些同学可能没有 Claude 订阅账号或者想把 Claude Code 的能力底稿换成其他模型这时候可以走“兼容接口”路线。社区里已经有人写了 CC Switch 这样的配置工具用来切换 Claude Code 背后调用的模型。它本质上是在环境变量或配置文件上做文章让你能用 DeepSeek、通义千问 Qwen、智谱 GLM 这类模型替代默认服务。具体配置思路很简单Claude Code 支持通过环境变量指向自建接口。你可以在启动前指定这样的变量export ANTHROPIC_BASE_URLhttps://your-api-endpoint.example.com export ANTHROPIC_AUTH_TOKENyour-api-key export CLAUDE_MODELdeepseek-chat claude如果你喜欢用图形界面管理这些预设CC Switch 就相当于给这些环境变量做了一个切换面板每次要换模型点一下就能重启 Claude Code。用这种方式相当于把 Claude Code 从“只能绑定官方账号”变成了一个“通用终端智能体壳子”模型不好用就换掉。我实测下来DeepSeek 最新版模型在处理中文需求和代码解释时手感不错Qwen 系列在生成完整函数和补全逻辑时也比较稳。不过要注意Claude Code 内置的一些高级工具调用格式可能和某些第三方模型不完全兼容会出现“模型回复了但 CLI 看不懂”的情况。所以别指望切换后体验和原版完全一致还是要根据项目类型挑模型。4.3 完全离线用 LM Studio 跑本地模型如果你对隐私特别敏感或者希望在没有外部网络的环境下也能让 Claude Code 工作可以试试 LM Studio 加本地模型的路线。LM Studio 能加载本地 GGUF 格式模型并暴露一个 OpenAI 兼容的本地 HTTP 接口Claude Code 通过改环境变量把请求指到127.0.0.1:1234就能用了。实际效果取决于你本机模型的规模和显存。在手机连接远程服务器时模型运行在服务器上手机只负责敲命令和看输出所以即使人在地铁里模型处理数据也完全不会受手机性能影响。但这里有一个非常务实的提醒本地模型的工具调用能力参差不齐。Claude Code 之所以好用是因为模型能理解“该读文件、该执行命令、该确认结果”这些复杂指令本地模型如果工具调用训练不够经常会出现“让它改代码它只回复一串建议根本不会真正动文件”的情况。如果你只是想离线改点简单脚本本地模型完全可以胜任如果项目复杂、需要大量多文件编辑我还是建议用它做备份方案而不是主力工具。5. 真实踩坑记录与高频问题速查5.1 我在手机端使用中遇到过的坑第一批坑集中在“手机连接不稳”上。比如走着走着从 Wi-Fi 切到蜂窝网络SSH 连接必定断有时候终端直接冻结一半敲什么反应都没有。后面我用 tmux 把所有 Claude Code 会话都包起来才彻底解决这个问题。还有一次我半夜起床改一个线上小 bug手机屏幕自动旋转导致键盘遮挡了终端输入框气得我第二天把自动旋转彻底关了。第二批坑和工具配置有关。Termius 的免费版在同一时间只能开一个终端 Tab你要是同时挂着几台服务器想在手机上看两个会话就有点捉襟见肘。解决方法是少开并行会话认认真真用一个 tmux 会话把不同任务拆成多个窗口靠快捷键切换会比堆终端 Tab 更省资源。另外手机端复制粘贴是一大痛点。Termius 虽然支持长按选择文本但在翻页查看长输出时还是会选中错行。我现在的习惯是把 Claude Code 的输出重定向到日志文件然后用tail看最后几行避免在手机上翻几百行日志。第三批坑是安装阶段的网络问题。你的云服务器如果在某些区域或网络环境下访问不上官方接口安装后登录会一直卡在“连接中”。这时候与其到处找镜像不如直接切到兼容接口或者本地模型方案。本质上 Claude Code 的“模型后脑勺”是可替换的卡住官方网络不一定是死路。5.2 高频问题速查表我把身边同事问得最多的几个问题整理成一张速查表基本覆盖了从安装到使用的所有高频报错。症状大概率原因可行的排查方向EACCES: permission denied安装失败npm 全局目录权限不足用 Node 版本管理器重新装 Node或加sudo但要注意全局包路径登录时报组织禁用企业管理员关闭了 Claude 订阅访问找管理员开权限或改用 API Key32/64 位 Windows 不兼容Windows 原生 CLI 兼容性问题用 WSL 装 Ubuntu 再跑 npm手机 SSH 常常断线网络切换或服务器超时用 tmux 持久会话调整 Termius 的心跳间隔Claude Code 执行命令后一直没反应网络到模型后端超时检查服务器 DNS、出口网络必要时切换第三方接口输入中文变成乱码终端编码问题设置 UTF-8或改用 Code-Server 自带的输入法支持切换模型后工具调用失效第三方模型和工具格式不兼容换备用模型或回退官方模型不要看到报错就急着重装很多时候是网络或权限问题先看英文错误里的前两行提示方向马上就会清晰起来。5.3 一个稳妥的最小配置清单如果你准备照着做我最后给你列一个“不会翻大车”的最小配置清单。服务器选 Ubuntu 22.04内存至少 4G磁盘留出 10G 以上给 Node 模块、项目缓存和模型文件如果你要玩本地模型磁盘再大一点。Node.js 用 18 或 20npm 源如果缓慢就换一个可用的镜像源但我更建议网络正常时直接用官方源避免奇怪的版本差异。SSH 配置密钥登录并改端口手机上装 Termius服务器再装 tmux 用来包会话。Claude Code 装好后先用一个最简单的单文件项目跑一次“帮我创建一个 hello.py 并运行”确认链路是通的再扔进真实项目里使用。这套组合我已经用了几个月最大的体会是手机端写代码这件事体验上限完全取决于你远程环境的稳定程度而不是手机性能。只要后端配置稳、网络通路顺、会话能保持剩下的就是适应用手指触控去操作 CLI 的问题。最后再贡献一个小技巧在 tmux 里给每个项目单独命名一个 session比如tmux new -s blog、tmux new -s work这样手机切后台再回来只要记住 session 名字一句话就能接上断掉的工作现场比反复翻历史记录高效太多了。
返回列表