在手机上玩转 Claude Code：用 Termux 把安卓变成「掌上 IDE」（含国内模型配置）

1. 为什么要在安卓手机上跑 Claude Code

Claude Code 是 Anthropic 推出的终端 AI 编程助手，它不是一个带图形界面的编辑器插件，而是一个跑在命令行里的 Agent：你输入自然语言需求，它读你当前目录的代码、改文件、跑命令、解释报错。很多人第一次听说「手机上跑 Claude Code」会觉得别扭，但实际用下来，碎片时间的价值被放大了——地铁上改一个函数、排队时让 AI 读一段日志、睡前把白天没想通的报错丢进去，这些场景掏出手机就能干，比等回到电脑前再打开 IDE 快得多。

安卓手机能跑 Claude Code 的关键在于 Termux。Termux 是一个不需要 root 的终端模拟器，它自带包管理器，能装 Node.js、Git、Python 这些开发工具，本质上就是把一个精简的 Linux 环境塞进了安卓应用里。Claude Code 是 Node.js 写的，只要 Termux 里 Node 环境正常，它就能跑起来。所以整条路径是：Termux 提供 Linux 终端 → 装 Node.js → 全局装 Claude Code → 配置模型 API → 在终端里对话和改代码。

这篇教程面向的是没接触过 Termux 的新手，也照顾已经用过终端但没在手机上配过 AI 编程工具的人。我会把每一步的命令、配置文件片段、验证方法都写清楚，尤其是国内模型 API 的接入参数——因为 Claude Code 默认走 Anthropic 官方接口，国内直连不稳定，用兼容 Anthropic 协议的国内模型服务或中转服务是更实际的选择。你跟着做，最后能在手机上看到 Claude Code 的交互界面，输入一句「帮我写个快排」它能返回代码，就算打通了。

需要提前说明的是，Termux 里的 Claude Code 体验和桌面端有差异：屏幕小、输入慢、没有图形化的 diff 预览，适合轻量任务和快速验证，不适合长时间大型重构。把它当成「掌上应急 IDE」而不是主力开发环境，心态就对了。

2. Termux 环境初始化与 Claude Code 安装全流程

2.1 安装 Termux 并更新包列表

Termux 不要从应用商店装，商店版本往往停更，包源也旧。去 GitHub 的 termux/termux-app releases 页面下载最新 APK。大多数安卓手机是 arm64-v8a 架构，选对应的包；如果不确定，装个 CPU-Z 看一眼架构再下。安装时如果提示「应用与设备不兼容」，基本就是架构选错了，换一个包重试。

装好打开，第一件事是更新包列表和已装包：

pkg update && pkg upgrade

中途会问你是否覆盖配置文件，一路回车默认即可。这一步在旧版本 Termux 上可能要跑几分钟，耐心等。

2.2 装 Node.js 和 Git

Claude Code 依赖 Node.js，Git 用于版本管理和后续拉取项目：

pkg install nodejs git

装完验证：

node -v npm -v git --version

Node 版本建议 18 以上，Claude Code 对低版本 Node 支持不好。如果node -v显示的是 16 或更低，先pkg upgrade nodejs升一下。

2.3 全局安装 Claude Code

一条命令：

npm install -g @anthropic-ai/claude-code

安装过程中如果 npm 报权限或网络错误，先换国内镜像源再装：

npm config set registry https://registry.npmmirror.com npm install -g @anthropic-ai/claude-code

装完可以切回官方源，避免后续其他包兼容问题：

npm config set registry https://registry.npmjs.org

验证安装：

claude --version

能打印版本号就说明二进制已经就位。

2.4 首次启动与登录方式选择

直接输入：

claude

首次启动会引导你选择认证方式：一种是 Anthropic 账号登录（OAuth），一种是 API key。如果你打算用国内模型或中转服务，必须选 API key 这条路，因为账号登录走的是官方 OAuth，国内网络下大概率卡住。选 API key 后它会让你输入 key，但更推荐的做法是先退出，用环境变量统一配置，这样每次启动自动生效，不用重复输入。

按 Ctrl+C 退出当前引导，进入下一步配置。

3. 国内模型 API 配置：Base URL、Key 与 Model ID 三件套

Claude Code 读取的是 Anthropic 风格的环境变量，核心是三个：ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_MODEL。国内模型服务只要兼容 Anthropic 的/v1/messages协议，就能通过改 Base URL 接进来。TaoToken 提供的就是这类兼容接入，官网在 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 入口是 https://taotoken.net/api 。

3.1 把配置写进 shell 配置文件

Termux 默认 shell 是 bash，配置文件是~/.bashrc。先装个顺手的编辑器：

pkg install nano nano ~/.bashrc

在文件末尾追加以下内容（把 Key 换成你自己的）：

export ANTHROPIC_BASE_URL=https://taotoken.net/api export ANTHROPIC_AUTH_TOKEN=sk-你的实际Key export ANTHROPIC_MODEL=claude-sonnet-4-20250514

保存退出：Ctrl 组合键在 Termux 里通过顶部工具栏的 Ctrl 键触发，按 Ctrl+X，提示保存时按 Y，回车确认文件名。

让配置立即生效：

source ~/.bashrc

3.2 用 settings.json 做项目级配置

除了环境变量，Claude Code 还支持项目级配置文件.claude/settings.json，适合给不同项目配不同模型。在项目根目录建这个文件：

{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_AUTH_TOKEN": "sk-你的实际Key", "ANTHROPIC_MODEL": "claude-sonnet-4-20250514" } }

这个文件里的配置会覆盖全局环境变量，适合你同时维护多个项目、每个项目用不同模型或不同额度 Key 的情况。注意别把带真实 Key 的 settings.json 提交到公开仓库，加进.gitignore。

3.3 三件套参数对照

三个缺一不可。只配 Base URL 不配 Key 会 401，只配 Key 不配 Base URL 会走官方默认地址导致超时，Model ID 写错会报模型不存在。Model ID 要以你所用服务实际提供的为准，不同服务商命名可能不同。

注意：环境变量里等号两边不要有空格，Key 不要加引号，否则会被当成字符串的一部分传进去，导致鉴权失败。

4. 验证请求：确认代码补全与对话交互生效

配置写完，重启 Termux 或source ~/.bashrc，然后进入一个测试目录：

mkdir -p ~/test-claude && cd ~/test-claude claude

启动后如果看到欢迎信息里显示的 API base URL 是你配置的地址，说明环境变量读到了。接下来做两个验证。

4.1 验证对话交互

在 Claude Code 交互界面里直接输入：

帮我写一个 Python 函数，判断一个数是不是素数

正常情况它会返回一段带解释的代码。如果卡住不动或报连接错误，说明 Base URL 或网络有问题，往下看第 5 节的排查。

4.2 验证文件读写与代码补全

让它实际改一个文件，才能确认 Agent 能力生效。先建个文件：

echo "def add(a, b):" > calc.py echo " return a + b" >> calc.py

然后在 Claude Code 里输入：

读取 calc.py，给它加一个 subtract 函数，并补一个简单的测试

它会读文件、改文件、可能还会跑一下测试。完成后你cat calc.py看内容是否被正确修改。这一步能跑通，说明 Claude Code 的读文件、写文件、执行命令这条链路在 Termux 里是通的。

4.3 验证结果对照

5. 常见报错排查：401、local proxy failed 与 OAuth 问题

5.1 401 鉴权失败

最常见的报错。先确认环境变量真的生效了：

echo $ANTHROPIC_AUTH_TOKEN echo $ANTHROPIC_BASE_URL

如果输出为空，说明~/.bashrc没写对或没 source。检查有没有多余空格、有没有把 Key 写成了占位符没替换。如果输出正常但还是 401，去服务商控制台确认 Key 是否有效、额度是否用完。TaoToken 的 Key 可以在控制台 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 里查看和管理。

5.2 local proxy failed

这个报错通常出现在 Claude Code 尝试走本地代理但代理没起来的时候。如果你没配代理，检查环境里有没有残留的HTTP_PROXY、HTTPS_PROXY变量：

env | grep -i proxy

有的话在~/.bashrc里 unset 掉：

unset HTTP_PROXY unset HTTPS_PROXY

然后 source 重试。Termux 环境下不需要额外代理层，直连 Base URL 即可。

5.3 reading choices 相关报错

这类报错一般是响应体解析失败，常见原因是 Base URL 指向的接口返回的不是 Anthropic 标准格式。确认你用的地址是兼容/v1/messages的，而不是 OpenAI 风格的/v1/chat/completions。两者协议不同，Claude Code 只认前者。TaoToken 的 API 入口 https://taotoken.net/api 是 Anthropic 兼容的，直接填这个即可。

5.4 OAuth 登录卡住

如果你不小心选了账号登录，会卡在浏览器跳转或回调。退出 Claude Code，删掉配置目录重新来：

rm -rf ~/.claude claude

重新选 API key 方式。或者干脆靠环境变量，启动时它检测到ANTHROPIC_AUTH_TOKEN就不会再走 OAuth 引导。

5.5 npm 安装慢或失败

换镜像源，前面提过。如果npm install -g报 EACCES 权限错误，Termux 里一般不会遇到，因为它是用户空间。真遇到就加--force或检查 node 版本。

5.6 环境变量改了不生效

确认写在~/.bashrc而不是~/.profile或~/.zshrc（Termux 默认 bash）。改完必须source ~/.bashrc或重开 Termux。如果用了 tmux 或 screen，新开的会话可能读的是旧环境，重连一下。

6. 长期使用建议与接入入口

手机端跑 Claude Code，几个实际经验值得说。第一，Termux 后台容易被安卓杀，长时间任务建议开termux-wake-lock防止休眠断连。第二，输入长 prompt 很痛苦，可以先把需求写在备忘录里，粘贴进去。第三，屏幕小，claude的输出会刷屏，善用Ctrl+L清屏，或者把结果重定向到文件再cat。

如果你打算长期在手机上做编码和 Agent 任务，Coding Plan 比按量计费更划算，入口在 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。只是想先验证模型对话效果，可以用模型对话页 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 快速试。Key 的创建和管理在 API Keys 页面 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，接入细节看文档 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 。

最后提醒一句：API Key 是账号凭证，别截图发群、别提交到公开仓库。Termux 的~/.bashrc里存着明文 Key，手机借人前留意一下。配置一次，之后每次打开 Termux 输入claude就能用，碎片时间写代码这件事，算是真正落地了。