上个月通勤路上我用手机改完一个紧急 bug回来同事问我怎么做到的。我说手机里装了个终端跑着 Claude Code。他第一反应是手机也能写代码能。而且用顺了之后我发现一套以免费开源工具为基础、能在手机上完整运行的 AI 编程工作台比想象中能打得多。这篇文章我就把完整的搭建过程和踩坑实录分享出来。它是什么简单讲就是在 Android 手机上用 Termux 这个开源终端模拟器搭起 Linux 运行环境装上 Node.js用 npm 安装 Claude Code 命令行工具配合 Anthropic 官方接口也能接其他兼容模型组成一套随时能写代码、改代码、聊代码的免费跨端 AI 编程工作台。适合谁经常在路上的开发者、学生党、想折腾终端但不想背电脑出门的人都适用。1. 跨端方案的设计与思路拆解1.1 项目核心需求为什么要把 AI 编程塞进手机主流 AI 编程工具的默认形态都是桌面端启动 IDE、装插件、配环境一顿操作猛如虎。可真正影响效率的往往不是环境而是那些零散的碎片时间地铁上、等车时、午休间隙、会议间隙。这些场景下手边只有手机与其刷短视频不如把手机的终端能力拉满让 AI 直接动真格地写代码。这个项目的核心需求一句话概括在不依赖电脑的情况下用手机获得接近桌面端的 AI 结对编程体验。拆开看有四个子需求。第一要有一个能跑 Linux 工具链的终端环境手机上默认的 App 做不到得靠 Termux 这类开源模拟器第二要有 Node.js 运行时因为 Claude Code 本身是个 npm 包安装和更新都依赖 npm第三要能以命令行的方式调用模型能力解决“手写 vs AI 生成”的效率差第四要能处理碎片时间里的真实任务包括改 bug、写脚本、读代码、整理报错信息。这四个子需求逐一落地工作台就有了完整雏形。动手之前我还做了个判断手机性能到底够不够撑住这套环境实测结论是完全够用。Claude Code 本质是个轻量级 CLI 客户端重活都发生在云端模型侧手机上只需要处理文本交互和本地文件占用的 CPU 和内存可以忽略不计。刚开始我也担心手机会发烫实测几轮大项目代码生成下来温度正常耗电量比刷视频高一些但远低于连续打游戏。1.2 工具选型为什么 CLI 方案比 IDE 方案更适合手机网上关于“Cursor、Windsurf、VS Code Copilot、Trae 谁更强”的讨论很多但那些工具大多是图形化 IDE 的插件或替代品。我也试过把它们搬到手机上体验非常别扭。如果走 IDE 路线手机上装个轻量版 VS Code或者通过 code-server 用浏览器访问技术上可行但有两个痛点。一是虚拟键盘配合 IDE 图形界面效率极低菜单、侧边栏、弹窗在手机屏幕上操作非常费劲二是 IDE 加载项目本身有开销手机系统经常杀后台体验很崩。CLI 方案的优势在于所有交互都收拢到一个终端里。你只需要输入文字指令AI 返回文字和代码片段操作全部发生在键盘层面天然适配手机的小屏幕和软键盘。命令行资源占用极低即使被系统暂时挂起重启后也能快速恢复上下文。另一个现实考量是 Claude Code 的跨端能力。同一套 npm 包在 Linux、macOS、Windows 的 WSL、Android 的 Termux 里都能跑。电脑上写好的一套配置手机上直接复用环境变量和提示词配置完全一致。而 Cursor、Windsurf、Trae 更像是绑定特定编辑器的形态Claude Code 则是一个独立的命令行代理自由度完全不在一个量级。1.3 工作台的整体架构我最终搭出来的是一个三层结构每一层都能独立替换这也是这套方案我认为最有价值的地方。层级组件作用可替换项运行环境层Termux在 Android 上模拟 Linux 运行环境也可以换 proot-distro 跑完整发行版工具链层Node.js、Git、npm提供运行时与包管理能力Node 装 LTS 版基本不用折腾AI 引擎层Claude Codeanthropic-ai/claude-code接收指令、调用模型、操作本地文件也可以接 OpenCode 等开源替代品这个三层结构带来的直接好处是任何一层出问题都能单独排查和替换不会牵一发动全身。比如 Termux 环境坏了不影响电脑上的 Node 环境Claude Code 某个版本有 bug可以回滚到老版本而不是推倒重来。这个架构思维是我实战中反复受益的点建议照抄。2. 环境准备从零搭建手机运行环境2.1 安装 Termux 并完成基础配置Termux 是这个项目的地基它本质上是一个运行在 Android 上的 Linux 终端模拟器自带包管理器和大量预编译软件包。我说的“把 Claude Code 装进手机”第一步就是先把 Termux 立起来。安装建议走官方渠道用 F-Droid 或 GitHub Releases 里的 APK。装完后第一件事是换源和更新包索引Termux 默认软件源在海外直连经常慢到没脾气。我把源切换到了清华 TUNA 和阿里开源镜像速度提升非常明显。源地址配置文件在$PREFIX/etc/apt/sources.list把默认的https://packages.termux.dev/apt/termux-main换成对应镜像地址。改完以后执行pkg update pkg upgrade等所有依赖更新完基础环境就算稳了。这一步特别容易踩坑的是存储权限Termux 首次启动会申请存储空间执行termux-setup-storage后才能访问手机内部存储。后续写项目文件、读取照片、读取文档都需要这个授权千万别跳过。2.2 安装 Node.js 与 npmTermux 软件源里自带 Node.js直接一条命令pkg install nodejs-lts这里有个关键选择要不要用 LTS 版本。Claude Code 对 Node 版本有要求推荐 18 以上LTS 版本踩坑率最低。装完以后跑一下node -v确认版本号到 18.x。如果低于这个版本执行claude大概率直接报语法错误排查起来相当头痛。装完 Node.js 后npm 会自动跟上。建议顺手把 npm registry 切到国内镜像这一步能省掉后续安装时一半以上的等待时间npm config set registry https://registry.npmmirror.com不要小看这个动作。很多人在手机上卡在 network timeout其实就是 registry 没切。我实测默认源下装个中型包要 3 分钟左右换镜像后基本 40 秒内完成速度差距非常直观。2.3 安装 Claude Code 主程序环境就绪后安装 Claude Code 本身只是一条命令npm install -g anthropic-ai/claude-code全局安装的好处是任意目录下都能直接执行claude不需要在每个项目里重复安装。装完验证版本claude --version能正常输出版本号主程序就跑起来了。这里有个细节Termux 默认的$PREFIX/bin是在 PATH 里的但如果你装完发现command not found先重开一个新的终端会话再试Termux 的 PATH 刷新经常比新 shell 慢半拍。同一阶段我建议顺手把 Git 也装上pkg install git因为 Claude Code 在分析项目、切换分支、生成提交信息时都会调用 Git这是它操作本地代码库能力的重要组成部分。没有 Git 的 Claude Code 写起来总感觉少了一条腿强烈建议一起装。3. 核心配置让 Claude Code 真正可用3.1 API Key 与登录方式配置Claude Code 默认需要凭据才能调用模型。有两种方式一是用 Anthropic 账号走登录流程二是直接用 API Key 写进环境变量。我在手机上用的是第二种理由很简单环境变量方式更直观、更好排查不依赖浏览器跳转登录在手机上格外省事。需要设置的环境变量是export ANTHROPIC_API_KEYsk-ant-xxxxxx把这一行追加到~/.bashrc里每次打开终端自动加载。要注意的是API Key 是敏感信息Termux 的共享存储目录权限比较宽松不要把 key 写进项目目录更不要提交到 Git。我一般放在~/.bashrc并把该文件权限设为 600。配置完以后跑一句claude 你好如果返回正常内容说明链路已通。如果报 401 或 403基本就是 key 配错了或者权限不足重新粘贴一次环境变量再试。这个排查路径屡试不爽。3.2 接入第三方兼容模型以 DeepSeek 为例Claude Code 的价值之一在于它支持通过兼容接口切换底层模型。我最常用的备选模型是 DeepSeek接入方法是通过ANTHROPIC_BASE_URL环境变量把请求地址指到兼容端点再配上对应的 key。网上关于“claude code 接入 deepseek”的教程很多实际配置起来也就两行环境变量的事export ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic export ANTHROPIC_API_KEY你的DeepSeek密钥接完以后先做一轮冒烟测试比如让它解释一段正则表达式。为什么测这个因为不同模型对工具调用的理解和代码风格差异很大简单问答能快速验证链路通不通。在预算紧张或 Claude API 限流的时候我把流量切到 DeepSeek 应急成本直接降一个量级某些时段响应速度反而更快。需要提醒的是切换模型不是免费的万能套餐。DeepSeek 在复杂代码生成、长上下文任务上的表现和 Claude 系列并非完全一致尤其是一些依赖深度推理的复杂任务效果会有波动。我的建议是日常任务用主模型批量任务和应急任务用备选模型按需切换而不是一刀切。3.3 打通手机和电脑SSH 远程与 code-server手机上的终端再强屏幕和输入效率还是天然受限。有一种组合拳很实用手机端负责发指令、看结果真正的计算和项目文件留在电脑或服务器上两者用 SSH 连接。这也是我最推荐的长期使用姿势。方案一手机通过 SSH 登录到电脑或 Linux 服务器在远端跑 Claude Code手机本地只保留一个 SSH 客户端。Termux 里装openssh命令式直连就能用。更建议在电脑上先配置好密钥认证省去每次输密码。这个方案的优点是计算资源和项目路径都在远端手机上不残留敏感文件。方案二在服务器或云主机上跑 code-server把 VS Code 的 Web 版暴露给手机浏览器。手机上打开浏览器即可拥有完整 IDE 界面再配合 Claude Code 的集成使用等于把桌面开发环境“搬”进了浏览器。我试过把 code-server 放在内网的小主机上手机和电脑共享同一工作区改动无缝同步。在 VS Code 的集成终端里直接调用claude效果和桌面版完全一致。两个方案并不冲突互相补充。我的习惯是碎片时间用 SSH 跑命令行 Claude Code 处理具体任务需要看图、看部署效果时用 code-server 的 Web IDE。把两个打通一台手机等于一个远程开发终端的完整闭环。4. 实操过程在手机上完成一个真实任务4.1 初始化项目并启动 Claude Code这一节我用一个真实案例走完流程。任务很典型写一个 Python 脚本批量重命名一批照片文件按拍摄时间命名。属于“逻辑简单但手写要几分钟”的类型适合在手机上验证完整工作流。首先建一个工作目录mkdir -p ~/photo-rename cd ~/photo-rename然后启动 Claude Codeclaude进入交互界面后直接描述任务。我的提示词是这样写的帮我写一个 Python 脚本来批量重命名当前目录下的照片文件。规则读取每张照片的 EXIF 拍摄时间按 YYYYMMDD_HHMMSS.jpg 格式重命名如果没有 EXIF 时间就用文件的修改时间作为后备。脚本要支持通配符 .jpg/.jpeg/.png处理完成后打印重命名前后的对照表。Claude Code 会返回一个脚本并附上解释。这时候手机上不需要任何额外操作直接让它写进文件把脚本保存为 rename_photos.py然后告诉我怎么运行。整个流程下来真正需要手动敲的只有 mkdir、cd、claude 三条命令其余全是自然语言对话。我第一次在手机上完成这个任务全程约 4 分钟大部分时间在等模型响应。4.2 验证脚本并让 AI 修复报错脚本写好以后在 Termux 里运行python rename_photos.py --dry-run我第一次运行时遇到问题脚本用到了PIL库读取 EXIF而 Termux 的 Python 环境里没有装 Pillow。报错信息很长但在 Claude Code 的对话窗口中我直接粘贴报错内容要求它“分析这个报错并给出修复方案”。它立刻给出两条路径一是pip install Pillow二是改用exifread这个更轻的库并解释了两者的取舍。这里有一个特别重要的经验让 AI 修复报错时把完整错误日志贴给它而不是只贴最后一行。很多新手习惯只给“最后一行的错误类型”结果 AI 给出的修复建议经常踩不到点上。踩过几次坑以后我学乖了直接把终端输出整段复制粘贴Claude Code 能结合上下文定位到具体行。修复完以后跑通脚本正常工作。整个过程中我几乎没有自己写过一行代码但每一步都清楚它在改什么、为什么改。这才是 AI 编程工作台应有的使用方式AI 提供速度和覆盖面人负责判断和把关。4.3 进阶玩法把 Claude Code 变成项目维护助手写脚本只是入门。我发现更有价值的用法是把 Claude Code 当成本地仓库的“维护助手”让它参与完整项目周期。示例操作在一个 Git 仓库里执行claude然后对它说看一下最近的 git log总结出现有的分支结构再帮我查看问题列表里优先级最高的那个分析可能的原因最后为这个问题创建一个修复分支写一个初步修复方案。这些指令涉及 git log、git branch、文件读取、问题分析等多个能力Claude Code 都能串起来执行。我在手机上维护一个开源小项目时靠它完成了大部分依赖升级和 README 更新提交信息写得比我自己写的规范。这个模式同样适用于嵌入式方向。身边有朋友把类似的 Claude Code 工作台用在 STM32 固件代码、FPGA 寄存器配置这类偏硬件的场景让模型生成初始化代码和寄存器定义再在电脑端做编译验证。虽然手机本地编译硬件工程不现实但把它当作“代码生成前端”已经能省下大量翻手册的时间。进阶用法的关键一步是让 Claude Code 生成代码后你逐段审查再让它根据审查意见调整。不要一键无脑接受所有输出。手机屏幕上虽然看不清大段代码但逐段确认完全能做到。把节奏慢下来AI 工作台才不会变成“代码事故工厂”。5. 常见问题与排查技巧5.1claude: command not found的解法这个是最常见的报错。大部分情况是 PATH 没包含全局安装目录。Termux 里一般执行完 npm install 后需要新开一个终端会话让 PATH 生效。如果新开会话也不行直接指定完整路径$PREFIX/bin/claude或者找到 npm 全局目录npm prefix -g然后把 bin 目录加进 PATHexport PATH$(npm prefix -g)/bin:$PATH这个问题见过无数人卡住其实就两分钟的事。顺手把这条 export 写进~/.bashrc一劳永逸。5.2 npm 安装超时或卡死手机网络环境复杂npm 超时极其常见。第一步把 registry 切到国内镜像。还不行再调 npm 的重试策略npm config set fetch-retries 5 npm config set fetch-timeout 60000安装 Claude Code 时建议加--verbose参数观察进度明确卡在哪一步而不是干瞪眼等超时。实测下来镜像切换 重试调整后安装成功率接近百分之百。5.3 Termux 里中文乱码或字体太小Claude Code 返回的中文在默认字体下有时会挤成一团。Termux 的设置里可以切换终端字体和字号我一般用 Fira Code 或 JetBrains Mono字号调到 12 以上阅读体验会好很多。还有一个技巧代码块里的缩进对不齐多半是字体没启用等宽特性换个等宽字体即可。5.4 手机息屏后终端断连Termux 在手机息屏后经常被系统杀后台。解决方案分两层一是给 Termux 开启后台运行权限并在系统设置里把它的电池优化改为不限制二是在终端里用tmux让会话与 App 生命周期解耦。pkg install tmux tmux new -s work就算 Termux 进程被暂时中断重新打开 App 后执行tmux attach -t work就能恢复会话。我在手机端维护远程工作区时tmux 是保命工具强烈建议装。esc5.5 API 限流和额度不足的应对手机端用 AI 编程最怕突然限流。常见报错包括 429请求过多和 402额度不足。遇到这种情况我的应对策略是第一把任务拆小减少单次对话消耗的上下文第二切换到备选模型应急第三把耗时任务放到电脑端处理。限流不是工具问题是资源分配问题提前做好预案能少很多焦虑。这里有一个降低消耗的技巧在 Claude Code 里用/compact命令压缩对话上下文。每次对话太久后我都会用一次等效于“换一段新会话”token 消耗显著下降响应速度也会更快。5.6 卸载和版本回滚某个版本有问题或者想卸载命令同样简单npm uninstall -g anthropic-ai/claude-code想回滚到指定版本安装时加上版本号npm install -g anthropic-ai/claude-code1.0.38版本号可以先用npm view anthropic-ai/claude-code versions查看。这类工具迭代很快遇到严重 Bug 时回滚到上一版本往往比等官方修复更快是标准应急动作。5.7 环境变量不生效的细节Termux 里改了~/.bashrc但如果登录 shell 是 zsh可能完全不读这个文件。检查一下自己用的是 bash 还是 zsh。Termux 默认 bash但很多人会切到 zsh那就得改~/.zshrc。每次更换 shell 后都要重新加载配置或重开终端环境变量才会生效。这个排查成本不高但容易浪费大量时间。写在最后说实话这套方案用了大概一个月以后我最大的感受不是“手机多能干”而是原来一个可靠的工具链可以轻到什么程度。你不需要背着电脑就能参与代码维护、写脚本、修问题AI 编程的入口被真正拓展到了移动端。最后再分享一个小技巧给 Claude Code 的几个常用指令设置成 shell alias比如alias ccclaude、alias ccqclaude -p后者是单次问答模式适合快速抛一个问题拿到答案。这样在手机上操作会顺手很多。希望这篇记录能帮你也搭出一台随身携带的 AI 编程工作台。