把 Claude Code 装进口袋:陪女朋友逛街也能写代码的 4 条配置路线
把 Claude Code 装进口袋:陪女朋友逛街也能写代码的 4 条配置路线
真正的「移动开发」不是把笔记本背出门,而是把电脑留在家、人空着手出去——只带一部手机,照样能指挥 Claude Code 把活干完。
逛街的时候被晾在试衣间外面,是每个有女朋友的程序员都懂的「死亡两小时」。
后来我想明白一件事:我不需要把 MacBook 背出门,我只需要一个能连上「那台一直开着的机器」的入口。手机就是这个入口。等她试第三条裙子的时候,我已经用手机让 Claude Code 把一个 bug 修完、跑过测试、提交了。
这篇就是把「手机上用 Claude Code」这件事彻底讲清楚:它其实是两类完全不同的需求,对应 4 条配置路线。每条都给你能直接抄的命令清单,最后告诉你哪条适合你。
先分清:你要的是「在手机上跑」还是「用手机遥控」
绝大多数人一上来就搜「手机怎么装 Claude Code」,然后掉进 Termux 的坑里折腾半天。其实你该先问自己一句:
算力到底放在哪?是放在这部巴掌大、一编译就发烫掉电的手机里,还是放在家里那台一直插着电、风扇随便转的开发机里?
想清楚这一点,路线自然就分成两类:
- 在手机上跑:手机自己当开发机,Termux 里直接装 Node 和 Claude Code。适合轻量改文档、写脚本、应急。
- 用手机遥控:手机只负责「显示 + 打字」,真正干活的是远端那台机器。这才是「逛街党」的正解——人在外面,机器在家里冒烟。
下面四条路,路线一属于第一类,路线二三四属于第二类。
路线一:Termux 原生——让安卓手机自己变成开发机
如果你就想图个「手机里真的装了一个 Claude Code」,安卓 + Termux 是最直接的。iOS 因为沙盒限制基本走不通这条,老实选后面的遥控路线。
第 1 步:装对版本的 Termux
别去应用商店下,那里的版本早就停更了。去 GitHub releases 拿:
https://github.com/termux/termux-app/releases/tag/v0.118.3
绝大多数安卓手机是 arm64-v8a 架构,第一次直接选这个包试:
termux-app_v0.118.3+github-debug_arm64-v8a.apk
装的时候系统提示「兼容与适配问题」就是选错架构了,换一个;没提示就是对的。
第 2 步:装 Node.js 和 Git
打开 Termux,先更新源,再装依赖:
pkg update && pkg upgrade
pkg install nodejs git
装完验一下,三条命令都有版本号才算成功:
node -v
npm -v
git --version
这一步要是报错,把日志整段复制下来丢给 AI 让它给你解,比自己瞎猜快得多——这本来就是 AI 时代该有的 debug 姿势。
第 3 步:全局装 Claude Code
npm install -g @anthropic-ai/claude-code
中途弹出确认时,光标移到 yes, proceed 那行直接回车。第一次启动会问你用「账号」还是「API key」登录:
- 有官方 Claude 账号 → 选账号,到这一步就能
claude起飞了。 - 用国产模型平替 → 一定要选 API key 那一项,否则后面的中转配置不生效。
第 4 步:配国产模型的 URL 和 Key
让配置每次开机都生效,得写进 shell 配置文件。用 nano 打开:
nano ~/.bashrc
提示没装 nano 就先 pkg install nano。在文件里加两行(以智谱 GLM 的 Anthropic 兼容端点为例):
export ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic
export ANTHROPIC_AUTH_TOKEN=YOUR_API_KEY
ANTHROPIC_BASE_URL 换成你用的中转/官方平替地址,ANTHROPIC_AUTH_TOKEN 换成你自己的 key。在 Termux 里按 Ctrl + X 保存(点屏幕上的 Ctrl 键再用输入法打 x),按 Y 确认。
重启 Termux,输入 claude,看到顶部的 API base URL 是你刚填的那个地址,就成了。
gotcha:手机原生跑 CC,编译/装依赖会明显发烫、掉电快,大项目还容易内存不足被系统杀进程。它适合「改个配置、写段脚本、读段代码」的轻活,别拿它当主力机用——主力请看下面的遥控路线。
路线二:SSH 遥控——手机当瘦客户端,家里的机器冒烟
这是「逛街党」的标准答案,也是我自己天天在用的。架构一句话说清:
手机(Termux / Blink)→ 经 SSH 隧道 → 连到家里的开发机 → 在 tmux 里跑 Claude Code。手机只管显示和打字,不管计算。
远端机器(家里那台,提前装好)
npm install -g @anthropic-ai/claude-code
sudo apt install tmux
curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up
这里的关键是 Tailscale:它给你的手机和家里机器拉一条点对点的虚拟内网,不用做公网端口映射、不用搞 DDNS,装完两端登录同一个账号,就能用一个 100.x.x.x 的内网 IP 互相直连。安全又省心。
手机端(Android 用 Termux)
pkg update && pkg install openssh
ssh your-username@100.x.x.x
tmux new -s code
claude
iOS 党把 Termux 换成 Blink Shell(App Store 里的老牌终端,也可以用 Termius、a-Shell),SSH 命令一模一样。
为什么必须有 tmux
这是整条路线的灵魂。手机一锁屏、或者从 WiFi 切到 4G,传统 SSH 连接秒断。但因为 Claude Code 是跑在远端的 tmux 会话里,断的只是你的「显示器」,活还在后台接着干。重新连上后一句话就回到现场:
tmux attach -t code
你试衣间外面信号断了八回,CC 该跑的测试一样跑完。
进阶:嫌 SSH 切网必断烦人,可以把入口换成 Mosh(Mobile Shell)。它走 UDP,天生支持 WiFi/蜂窝无缝切换、换 IP 也不掉线,代价是多一点配置。tmux 保会话、Mosh 保连接,两个解决的是不同层的问题。
路线三:官方远程控制——一句 /rc 扫码遥控
前两条都要你自己搭。如果你只是想「人在外面,瞄一眼家里 CC 跑到哪了、点个同意」,官方的远程控制更省事。
在家里那台正在运行的 Claude Code 会话里敲:
/rc
它会吐出一个 URL 和二维码。用手机浏览器或 Claude App 扫一下,手机和电脑就双向同步了——电脑上 CC 的输出实时推到手机,你在手机上敲的指令也实时回传。
它的工程取舍很克制:
- 走仅出站连接 + TLS 加密,不用动防火墙、不用开端口。
- 网络恢复后 10 分钟内自动重连,地铁钻隧道也不怕。
但要知道它的边界:
- 家里那台机器必须开着(它才是真正干活的)。
- 不能从手机新开一个会话,只能接管已有的。
- 一个会话同时只允许一个远程连接。
对「逛街临时盯一眼、批个改动」这种需求,
/rc是体验最顺的。要从零起新任务、跑长流程,还是回到路线二的 SSH + tmux。
路线四:Claude Code 网页版——啥都不装,开浏览器就用
最后一条,连 SSH 都省了。Claude Code 现在有网页版,直接在浏览器里打开:
https://claude.ai/code
手机浏览器登录就能开云端会话,代码跑在云上,你纯靠一个网页指挥。它的好处是零配置——不装 Termux、不配 Tailscale、不留机器开机;代价是它跑在云端沙盒里,碰不到你本地那台机器上的私有项目和环境。
适合:手机上临时起一个独立的小任务、改个开源仓库、写段东西。不适合:要操作你自家那台机器上特定环境的活。
四条路怎么选
| 路线 | 算力在哪 | 要装什么 | 最适合的场景 |
|---|---|---|---|
| 一·Termux 原生 | 手机 | Termux + Node + CC | 安卓手机当应急开发机,轻活 |
| 二·SSH 遥控 | 家里的机器 | Termux/Blink + Tailscale + tmux | 逛街党主力,长任务、私有项目 |
三·官方 /rc | 家里的机器 | 一句命令,扫码 | 在外盯进度、批改动,体验最顺 |
| 四·网页版 | 云端 | 啥都不装 | 临时起独立小任务,零配置 |
一句话决策:要碰自家机器上的项目 → 路线二(重)或三(轻);只想随手起个独立小活 → 路线四。 安卓重度党想要一个离线也能玩的本地环境,再考虑路线一。
真话:手机用 CC,什么场景真香,什么场景别硬来
折腾完你会发现一个反直觉的结论:手机上用 Claude Code,瓶颈从来不是「能不能连上」,而是「适不适合在小屏幕上做」。
真香的场景,都有一个共同点——你是在「指挥和确认」,不是在「精读和操刀」:
- 在外面起一个任务:「把这个测试补全」「修一下这个报错」,扔给它,回头收。
- 盯进度、点同意:CC 跑到要你拍板的地方,手机上一句话放行。
- 应急救火:线上出问题,手机连上去让 CC 先定位先回滚。
别硬来的场景,也很明确——凡是需要「大量视觉信息」的活,小屏幕都是灾难:
你在手机上没法舒服地看一大段 diff、没法把组件和设计稿并排比对、没法在十几个文件之间反复横跳。这些恰恰是写代码时最吃屏幕的部分。
所以我的用法很简单:出门前在电脑上把活儿「开好头、定好方向」,出门后用手机「推进、确认、收尾」。 逛街这两小时,干的是后半段——而不是指望在手机上从零写一个新功能。
想明白这件事,比配通任何一条路线都重要。
给逛街党的最小可复制清单
懒得读全文,照这个抄就能出门:
- 家里机器装好:
npm install -g @anthropic-ai/claude-code、tmux、Tailscale(curl -fsSL https://tailscale.com/install.sh | sh→sudo tailscale up)。 - 手机装 Termux(安卓,GitHub 下 v0.118.3 的 arm64-v8a 包)或 Blink(iOS),登同一个 Tailscale 账号。
- 出门前在电脑上把任务开好头、把方向交代清楚。
- 在外面:手机
ssh user@100.x.x.x→tmux attach -t code,接着推进;信号断了重连再tmux attach即可。 - 嫌搭建麻烦只想盯一眼:电脑 CC 会话里敲
/rc,手机扫码遥控。
她试衣服,你修 bug。两不耽误。