1. 为什么要在手机上跑 AI 编程助手1.1 一个真实的使用场景先说清楚一件事在手机上跑 Claude Code不是要替代你的主力开发机而是解决一个非常具体的痛点——你不在电脑前但脑子里突然冒出一个需要立刻验证的想法。我自己遇到最多的场景是通勤路上 review 一个 PR 的 diff想快速让 AI 帮我看看有没有逻辑漏洞或者周末在外面突然想改一个 side project 的小 bug但不想背着笔记本出门。这时候如果手机能直接跑一个 AI 编程助手配合 Termux 提供的 Linux 环境实际上你手里就多了一个随时可用的轻量开发终端。Claude Code 本身是 Anthropic 推出的命令行 AI 编程工具它通过 Node.js 安装运行在终端里能读写文件、执行命令、理解项目上下文。这意味着只要你的手机能提供一个可用的终端环境和 Node.js 运行时理论上就能跑起来。Android 上的 Termux 恰好就是干这个的——它不需要 root不需要刷机从应用商店或官方渠道装完就能给你一个接近标准 Linux 的终端环境。这篇文章适合三类人看一是想在移动端折腾 AI 辅助编程的开发者二是对 Termux 感兴趣但不知道怎么把它变成一个真正可用的开发环境的人三是已经装了 Claude Code 但跑不起来、卡在某个报错上的朋友。我会从环境搭建讲到实际使用中的坑尽量把每一步的理由说清楚而不是只丢一堆命令让你复制。1.2 手机端跑 AI 助手的核心限制在动手之前有必要先认清手机端方案的几个硬限制否则你会在预期管理上出问题。第一是性能。手机 SoC 的 CPU 单核性能大概相当于几年前的低压笔记本内存虽然现在动辄 8GB、12GB但 Android 系统的内存管理策略比较激进后台进程容易被杀。Node.js 本身不算重但 Claude Code 在处理大项目时会读取大量文件内存占用会上去。第二是存储和文件系统。Android 的存储权限模型从 Android 11 开始收紧Termux 默认只能访问自己的私有目录要访问/storage/emulated/0/下的共享存储需要额外配置。这直接影响你能否让 Claude Code 操作你手机上的项目文件。第三是网络和 API 调用。Claude Code 需要调用远端模型服务网络稳定性直接影响体验。移动网络下的延迟波动比有线网络大得多这一点要有心理准备。第四是输入体验。在手机软键盘上敲命令是反人类的所以实际使用中你大概率会配合外接键盘或者用 Termux 的额外按键栏。这一点后面会详细讲怎么优化。认清这些限制之后我们再来谈怎么在约束条件下把体验做到最好。2. Termux 环境搭建与基础配置2.1 Termux 的安装与初始设置Termux 的安装渠道很关键。强烈建议从 F-Droid 或 GitHub Releases 页面下载不要用 Google Play 上的版本——Play 版本已经很久没更新了包管理器和依赖库都严重滞后装 Node.js 时大概率会遇到各种奇怪的报错。F-Droid 上的版本更新及时社区维护活跃。装完之后第一件事是更新包索引并升级已有包pkg update pkg upgrade -y这一步会花几分钟取决于你的网络。如果卡在下载环节可以考虑换镜像源。Termux 默认的源在国内访问速度不稳定换成清华源会快很多。具体操作是编辑$PREFIX/etc/apt/sources.list把里面的官方源地址替换为清华镜像地址。不过要注意Termux 的源结构和标准 Debian 不太一样不能直接照搬 Ubuntu 的换源教程得用 Termux 专用的镜像路径。换源之后再次执行pkg update速度会有明显提升。这里有个细节换源后如果出现 GPG 签名错误说明镜像同步有问题换回官方源或者换另一个镜像即可不要强行忽略签名验证。接下来装几个基础工具后面会反复用到pkg install -y git curl wget nano opensshgit用于拉取项目代码curl和wget用于下载文件nano是轻量编辑器vim 也行看个人习惯openssh方便你从电脑 SSH 连到手机上的 Termux这在输入大量命令时非常有用。2.2 存储权限与文件系统访问这是新手最容易卡住的地方。Termux 默认的工作目录是/data/data/com.termux/files/home这个目录在 Android 的沙盒里其他应用访问不到但 Termux 自己读写没问题。问题在于你的项目代码大概率放在共享存储里比如/storage/emulated/0/Projects/。要让 Termux 访问共享存储执行termux-setup-storage这个命令会弹出一个权限请求对话框同意之后Termux 会在 home 目录下创建一个storage软链接指向共享存储。你可以通过~/storage/shared访问到/storage/emulated/0/。但这里有个大坑Android 11 及以上版本对/Android/data/和/Android/obb/目录的访问做了严格限制即使你给了 Termux 存储权限也无法直接读写这两个目录下的内容。如果你看到热词里那些/storage/emulated/0/android/data/com.tencent.tmgp.sgame/...之类的路径那些是其他应用的私有数据目录Termux 在没有 root 的情况下是碰不了的。所以不要把项目放在那些位置老老实实放在/storage/emulated/0/Projects/这种自己创建的目录下。另外共享存储的文件系统是 FUSE 模拟的权限模型和真正的 Linux 文件系统不同不支持符号链接和部分文件权限操作。如果你的项目依赖这些特性建议把项目放在 Termux 的私有 home 目录里用 git 来同步。2.3 Node.js 的安装与版本管理Claude Code 依赖 Node.js而且对版本有要求。截至我写这篇文章时Claude Code 需要 Node.js 18 以上推荐 20 LTS 或更高。Termux 的包管理器里直接有 Node.jspkg install -y nodejs装完之后验证node -v npm -v如果版本低于 18说明你的 Termux 源太旧需要先更新源再装。不建议用 nvm 在 Termux 里管理 Node 版本因为 nvm 下载的预编译二进制是针对标准 glibc 的而 Termux 用的是 bionic libc二进制不兼容跑起来会报cannot execute: required file not found之类的错误。Termux 社区维护的nodejs包是专门编译适配过的直接用 pkg 装最稳。如果你确实需要多个 Node 版本可以考虑用 Termux 的nodejs-lts包或者用 proot 跑一个完整的 Linux 发行版但那是另一套方案了复杂度高不少。npm 的全局包安装路径在 Termux 里也有讲究。默认情况下npm install -g会装到$PREFIX/lib/node_modules这个路径是可写的不需要 sudo。但有些包的 postinstall 脚本会尝试编译原生模块需要node-gyp和 Python、make、clang 等工具链。如果遇到编译错误装一下pkg install -y python make clang不过 Claude Code 本身是纯 JavaScript 的不需要编译原生模块所以这一步大概率用不上。3. Claude Code 的安装与配置3.1 安装 Claude CodeNode.js 就绪之后安装 Claude Code 就是一条命令的事npm install -g anthropic-ai/claude-code装完之后在终端输入claude应该能看到启动界面。如果提示command not found检查一下$PREFIX/bin是否在 PATH 里正常情况下 Termux 已经配好了。这里有个常见问题npm 安装过程中如果卡住不动大概率是网络问题。可以换 npm 的 registrynpm config set registry https://registry.npmmirror.com这是国内的 npm 镜像速度会快很多。但要注意Claude Code 运行时调用的 API 不走 npm registry换源只影响包的下载不影响实际使用。安装完成后第一次运行claude会引导你登录。Claude Code 支持两种认证方式一种是 Anthropic 账号的 OAuth 登录会打开浏览器让你授权另一种是 API Key。在手机上浏览器跳转可能会有点麻烦如果 OAuth 流程走不通可以直接配置 API Key。API Key 的配置方式是在环境变量里设置export ANTHROPIC_API_KEY你的key把这行加到~/.bashrc或~/.zshrc里这样每次启动 Termux 都会自动加载。不要把 API Key 直接写在命令历史里Termux 的 history 文件是明文的而且如果你开了 SSH别人连上来就能看到。3.2 在手机上优化 Claude Code 的使用体验装好只是第一步真正用起来还得解决几个体验问题。第一个是终端尺寸。手机竖屏下终端列数太少Claude Code 的输出会频繁换行很难看。建议横屏使用或者在 Termux 里调整字体大小。Termux 支持双指捏合缩放字体把字号调小一点一屏能显示更多内容。第二个是输入效率。Termux 的额外按键栏可以自定义把常用的符号如/、-、|、~加进去。具体操作是长按键盘上方的按键栏选择 More 或者编辑~/.termux/termux.properties文件配置extra-keys项。我的配置是这样的extra-keys [[ESC,/,-,HOME,UP,END,PGUP],[TAB,CTRL,ALT,LEFT,DOWN,RIGHT,PGDN]]这样一排就能覆盖大部分常用操作不用频繁切换到符号键盘。第三个是外接键盘。如果你打算认真在手机上用 Claude Code一个蓝牙键盘的投资回报率极高。连上之后Termux 支持大部分快捷键CtrlC、CtrlD、Tab 补全都能用体验接近桌面终端。第四个是会话保持。Termux 默认在后台一段时间后可能被系统杀掉导致 Claude Code 会话中断。可以在 Termux 的通知栏里点击 Acquire wakelock 来防止休眠或者在 Android 的电池优化设置里把 Termux 设为不优化。不过这会增加耗电自己权衡。3.3 项目目录的组织方式Claude Code 的工作方式是读取当前目录下的文件作为上下文所以你在哪个目录启动它很重要。我的建议是在共享存储里建一个专门的项目目录mkdir -p ~/storage/shared/Projects cd ~/storage/shared/Projects然后每个项目一个子目录用 git 管理。在项目目录下启动claude它就能看到这个项目的所有文件。但前面提到过共享存储不支持符号链接而且文件读写性能比 Termux 私有目录差。如果你做的是纯文本项目比如写脚本、改配置问题不大。如果涉及大量小文件读写比如 node_modules建议把项目放在~/projects/下用 git 和共享存储同步。还有一个细节Claude Code 会尊重.gitignore文件所以如果你的项目有.gitignore它不会把忽略的文件读进上下文。这既是好事也是坏事——好处是不会把 node_modules 这种大目录塞进去坏处是如果你想让 AI 看某个被忽略的文件得手动指定。4. 实际使用中的问题排查与技巧4.1 常见报错与解决方法我在实际使用中遇到过不少问题这里整理成一张速查表方便你对照排查。报错信息可能原因解决方法command not found: claudenpm 全局 bin 目录不在 PATH检查$PREFIX/bin是否在 PATH或重新npm install -gError: Cannot find module安装不完整或 Node 版本不兼容删除node_modules重装确认 Node 版本 ≥ 18EACCES: permission denied尝试写入无权限的目录换到 Termux 私有目录或共享存储的可写目录ETIMEDOUT/ECONNREFUSED网络问题检查网络连接确认 API 地址可达Killed内存不足被系统杀掉关闭其他应用减少同时处理的文件数Cannot read property of undefined项目文件编码或格式问题检查是否有二进制文件被误读用.gitignore排除其中最常见的是内存不足导致的Killed。Claude Code 在处理大项目时会一次性读取很多文件手机内存吃紧时 Android 的 low memory killer 会直接杀掉进程。解决办法是在项目根目录放一个.claudeignore文件如果支持的话或者用.gitignore排除掉大目录减少上下文体积。另一个高频问题是网络超时。移动网络下API 请求偶尔会超时Claude Code 会报错退出。这种情况重试通常就好了但如果频繁发生可以考虑在更稳定的网络环境下使用或者检查是否有代理配置干扰。4.2 提升效率的实操技巧用了一段时间之后我总结出几个能明显提升体验的技巧。技巧一用 SSH 从电脑连手机。在 Termux 里启动 sshdsshd然后查一下手机的 IPifconfig或ip addr在电脑上ssh -p 8022 u0_aXXX手机IP就能连上。这样你可以用电脑的键盘和屏幕操作手机上的 Claude Code输入效率直接拉满。端口默认是 8022用户名可以用whoami查。技巧二用 tmux 保持会话。Termux 里可以装 tmuxpkg install -y tmux在 tmux 里跑 Claude Code即使 SSH 断开或者 Termux 切到后台会话也不会丢重新连上就能继续。这对长时间运行的任务特别有用。技巧三把常用命令做成别名。在~/.bashrc里加alias cccd ~/storage/shared/Projects claude alias gsgit status alias gpgit pull这样每次输入cc就能直接进入项目目录并启动 Claude Code省去一堆 cd 操作。技巧四善用管道和重定向。Claude Code 的输出可以重定向到文件方便后续查看claude 帮我分析这个项目的结构 analysis.txt不过要注意Claude Code 是交互式的直接重定向可能拿不到完整输出。更实用的方式是用它的非交互模式如果支持的话或者把结果复制出来。4.3 安全与隐私注意事项在手机上跑 AI 编程助手有几个安全点必须注意。第一API Key 的保护。前面说过不要把 Key 写在命令历史里。另外如果你用 SSH确保 sshd 配置了密钥认证而不是密码认证否则别人扫到你的端口就能连上来。Termux 的 sshd 默认端口是 8022虽然不常见但也不是完全安全。第二项目数据的敏感性。Claude Code 会把项目文件内容发送到远端模型服务。如果你的项目包含敏感信息密钥、密码、个人数据要么不要用 AI 助手处理要么提前清理。这一点在手机上尤其要注意因为手机上的项目往往是随手记的笔记或者临时脚本容易混入敏感内容。第三共享存储的可见性。放在/storage/emulated/0/下的文件其他应用只要有存储权限就能读到。如果你的项目涉及隐私放在 Termux 私有目录里更安全。第四定期更新。Termux 和 Claude Code 都在持续更新新版本会修复安全漏洞。定期执行pkg upgrade和npm update -g anthropic-ai/claude-code保持最新。5. 这套方案适合谁不适合谁5.1 适用场景与人群这套方案最适合的是已经熟悉命令行的开发者把它当作一个补充工具而不是主力开发环境。具体来说以下几类人会觉得有价值经常需要在外出时快速查看或修改代码的人想利用碎片时间做 code review 或写小脚本的人对 Termux 感兴趣想把它打造成一个移动开发终端的人需要在一个隔离环境里测试 AI 编程助手行为的人对于学生党来说如果手头只有手机没有电脑这套方案也能让你体验 AI 辅助编程的基本流程虽然体验不如桌面但学习概念足够了。5.2 不推荐的场景如果你打算用这套方案做以下事情我建议直接放弃大型项目的开发。手机的性能和存储都不足以支撑大型项目的构建和测试Claude Code 读取大项目时也会频繁遇到内存问题。需要图形界面的开发。Termux 是纯终端环境虽然可以通过 VNC 跑图形界面但体验很差不值得折腾。对稳定性要求高的生产环境。手机随时可能被电话、通知打断Android 的后台管理也不可靠不适合跑长时间任务。完全零基础的新手。如果你连 Linux 命令行都没用过先在电脑上熟悉基本操作再来折腾手机端会顺利得多。5.3 后续可以扩展的方向如果你已经跑通了基本流程还有几个方向可以继续折腾。一是用 proot 跑完整的 Linux 发行版。Termux 本身是个精简环境有些工具链不全。通过 proot 可以跑 Ubuntu 或 Debian获得更完整的包管理体验。代价是性能损耗和配置复杂度上升。二是配合代码编辑器。虽然 Termux 里跑不了 VS Code但可以用code-server在 Termux 里跑一个 Web 版的 VS Code然后通过浏览器访问。这样你就有图形化的编辑体验同时还能用 Claude Code。三是自动化工作流。Termux 支持termux-api包可以调用手机的传感器、通知、剪贴板等。你可以写脚本让 Claude Code 处理完代码后自动发通知或者从剪贴板读取内容作为输入。四是多设备同步。用 git 把项目同步到手机和电脑这样你在手机上改的代码回到电脑前可以继续。Claude Code 的会话历史如果也能同步就更好了不过目前它主要是本地存储跨设备同步需要自己想办法。我在实际使用中最大的体会是手机端 AI 编程助手的价值不在于替代电脑而在于填补那些电脑不在身边的碎片时间。它让你在等车、排队、躺床上的时候也能随手处理一个小问题而不是非得等到坐在电脑前。这种随时可用的感觉用习惯了之后还挺难戒掉的。最后分享一个小技巧如果你觉得 Termux 的默认配色太刺眼可以在~/.termux/colors.properties里自定义配色方案网上有很多现成的主题可以直接抄。眼睛舒服了折腾的动力也会足一些。