把 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、没法把组件和设计稿并排比对、没法在十几个文件之间反复横跳。这些恰恰是写代码时最吃屏幕的部分。

所以我的用法很简单:出门前在电脑上把活儿「开好头、定好方向」,出门后用手机「推进、确认、收尾」。 逛街这两小时,干的是后半段——而不是指望在手机上从零写一个新功能。

想明白这件事,比配通任何一条路线都重要。


给逛街党的最小可复制清单

懒得读全文,照这个抄就能出门:

  1. 家里机器装好:npm install -g @anthropic-ai/claude-codetmux、Tailscale(curl -fsSL https://tailscale.com/install.sh | shsudo tailscale up)。
  2. 手机装 Termux(安卓,GitHub 下 v0.118.3 的 arm64-v8a 包)或 Blink(iOS),登同一个 Tailscale 账号。
  3. 出门前在电脑上把任务开好头、把方向交代清楚。
  4. 在外面:手机 ssh user@100.x.x.xtmux attach -t code,接着推进;信号断了重连再 tmux attach 即可。
  5. 嫌搭建麻烦只想盯一眼:电脑 CC 会话里敲 /rc,手机扫码遥控。

她试衣服,你修 bug。两不耽误。