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

前言

想在地铁上、沙发上、甚至排队时「写两行」？这篇手把手教程教你在 Android 手机上，用 Termux 一把拉起 Claude Code。还贴心附上国内模型/中转的环境变量配置，让你即使没有官方账号也能跑起来。跟着做，不怕你是第一次接触 Termux，也能稳稳当当用上「掌上 AI IDE」。

目录

• 环境准备：安装 Termux
• 配套工具：配置 Git 与 Node.js
• 安装主角：全局安装 Claude Code
• 对接国内：配置 API Base URL 与 Key
• 验证运行：看到成功画面再收工
• 常见问题与小贴士
• 结语

---

一、环境准备：安装 Termux

从官方仓库获取最新版，远离「历史遗留问题」。

• 下载地址：https://github.com/termux/termux-app/releases/tag/v0.118.3
• 优先选择适配自己手机架构的安装包。大多数安卓手机为 arm64-v8a，先试试这个：termux-app_v0.118.3+github-debug_arm64-v8a.apk
• 安装过程中如果看到「兼容与适配问题」的提示，多半是架构不匹配，换个包即可。
  
• 安装成功后打开，看到类似下图的主页面，就说明环境 OK：
  

二、配套工具：配置 Git 与 Node.js

把常用开发工具装上，Claude Code 才能顺利跑。

• 更新软件包列表与已安装包（第一次用 Termux，强烈建议跑一下）：

pkg update && pkg upgrade

• 安装 Node.js 与 Git：

pkg install nodejs
pkg install git

• 验证版本，确认安装成功：

node -v
npm -v
git --version

如果遇到报错，别慌：复制错误信息，让 AI（比如 Claude/GPT）看一下，很快就能给到定位与解决方案。

三、安装主角：全局安装 Claude Code

• 一条命令，搞定安装：

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

• 安装过程如果弹出安全确认，选中 “yes, proceed” 回车继续（下图示意）：

• 首次启动会让你选择「API key 还是账号登录」。如果你计划用国内模型或中转服务，请务必选择「API key」。

之后再次使用，只需输入：

claude

四、对接国内：配置 API Base URL 与 Key

为了每次打开 Termux 都自动生效，我们把环境变量写进 shell 配置文件。

• 用 nano 打开配置文件（没装 nano 的话先安装：pkg install nano）：

nano ~/.bashrc

• 在文件末尾添加以下两行（示例使用 GLM 的 Anthropics 兼容接口为演示，按需替换）：

export ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic

说明：不同平台的兼容地址不同，请替换 = 后面的 URL 为你实际使用的平台/中转地址。

• 再添加你的 API Key（把 YOUR_API_KEY 换成你自己的，不要加引号）：

export ANTHROPIC_AUTH_TOKEN=YOUR_API_KEY

• 保存并退出 nano：
  • 在 Termux 中，按 Ctrl（顶部工具栏）后输入法打出 x（即 Ctrl + X）
  • 输入 Y 确认保存
  • 回车确认文件名

• 最后重启 Termux（或执行 source ~/.bashrc），让配置立即生效。

五、验证运行：成功界面长这样

• 重新打开 Termux，输入：

claude

• 如果看到启动信息里 API base URL 显示为你设置的地址，恭喜，已经「打通经脉」，可以愉快使用了！
  

六、常见问题与小贴士

• 架构不匹配安装不了？

  • 多半是 apk 架构选错了。常见的手机是 arm64-v8a，实在不确定可以用「CPU-Z」等工具看看 CPU 架构。

• npm 装包慢？

  • 国内网络环境下可考虑切换 npm 源（如 npm config set registry https://registry.npmmirror.com），装完后可切回官方源以避免兼容问题。

• 选择登录方式选错了怎么办？

  • 退出后重启 claude，或清理配置重新选择。也可以查看官方文档/命令帮助获取重设方式。

• 没有 nano，保存不了？

  • 先安装 nano：pkg install nano。或者用 vi/vim，也可通过 echo >> ~/.bashrc 追加内容（不推荐新手）。

• 环境变量不生效？

  • 确保写在 ~/.bashrc 且已 source ~/.bashrc 或重启 Termux。注意 export 的拼写与等号两边不要有多余空格。

• 安全提醒

  • API Key 是你的「通行证」，请妥善保管，避免上传到任何公共仓库或分享到公开页面。

结语

至此，你的安卓手机已经化身「掌上 IDE」，Claude Code 也稳稳当当跑了起来。无论是碎片时间写点脚本、在地铁上改个 bug，还是体验下 AI 辅助编码的顺滑流，都不在话下。

如果这篇文章帮到了你，欢迎点赞、收藏、评论交流。你也可以补充你使用的国内兼容地址与踩坑经验，帮助后来者更快少踩坑。祝你玩得开心，敲码顺手！