1. Termux安装

1.1 google play

android软件安装，首选就是google play。
有条件的直接通过该方案安装，会检测安装环境是否可行，还提供详细的软件说明及介绍。

ps: 网上有说google play的Termux版本太老，无法正常运行。小编实测，是可以使用的，版本还是26年最新的。

1.2 f-droid

F-Droid 是一款专门收录各类自由软件的 Android 应用商店。
它流行于自由软件爱好者圈子内，相较于境外的许多应用商店，F-Droid 不仅在国内更易访问，而且更加安全。
虽然不能开箱即用，F-Droid 的使用配置并不复杂。
通过它安装Termux是一个不错的选择。

---

2. 详细内容 (Details)

2.1 基础环境准备

在 Termux 中，首先需要确保软件包列表是最新的，并安装核心构建工具：

pkg update && pkg upgrade
pkg install -y nodejs git cmake clang make tree zip

2.2 安装 Gemini CLI

通过 npm 全局安装 Gemini CLI：

npm install -g @google/gemini-cli

安装完成后，通过 gemini login 进行身份验证。

2.3 进阶配置：自动编辑模式 (autoEdit)

为了提高在手机端的效率，建议开启自动编辑模式，减少重复的确认弹窗。

• 永久开启方法：修改 ~/.gemini/settings.json：

{
  "general": {
    "defaultApprovalMode": "auto_edit"
  }
}

2.4 技能系统 (Skills) 的应用

通过创建自定义技能（如 article-recorder），可以将复杂的指令流固化。

• 关键命令:
  • /skills list: 查看已安装技能。
  • /skills reload: 刷新技能缓存（修改技能后必做）。

2.5 竞品对比：为什么选择 Gemini CLI？

在 Android (Termux) 环境下，Gemini CLI 展现了极强的原生适配能力。

• Gemini CLI: 真正的“开箱即用”。只需 npm install 即可完美运行，能够直接访问 Termux 的文件系统并调用本地工具（如 cmake, git），无需任何复杂的环境模拟。
• Claude CLI (Claude Code): 目前对 Android 环境支持欠佳。由于其依赖于特定的 GLIBC 版本及某些原生 Node.js 扩展，在 Termux 的 Bionic 环境下经常会出现安装失败或运行报错。若想运行 Claude 往往需要通过 proot-distro 搭建虚拟 Linux 容器，过程繁琐且性能损耗大。

---

3. 环境对比 (Environment Comparison)

特性/工具	Gemini CLI	Claude CLI (Claude Code)	说明
Android 原生支持	⭐⭐⭐⭐⭐ (完美支持)	⭐ (需 Proot 容器)	Gemini 直接运行于 Termux
安装复杂度	极低 (npm 一键安装)	极高 (环境不兼容)	Claude 在手机端门槛极高
本地工具调用	直接调用 Termux 工具	需跨容器调用	Gemini 能直接感知手机环境
包管理器	pkg / apt	winget / choco	Termux 使用轻量级 Linux 包管理
快捷键	Shift+Tab 较难执行	完美支持	手机端建议使用 /settings 菜单切换模式
资源限制	内存与 CPU 受限	性能充沛	建议在手机端避免进行超大型项目的索引
文件系统	/data/data/.../home	C:\Users\...	路径结构完全不同，编写脚本时需注意

---

4. 补充说明

本文详细记录了在 Android Termux 环境下从零开始搭建 Gemini CLI 开发环境的全过程，涵盖了基础工具安装、Node.js 环境配置、Git 部署以及自定义技能的进阶玩法。

使用中需要配置配置编辑器，否则部分功能将被限制。可以通过下面命令行安装。

pkg install neovim
pkg install vim   # 失败了

Gemini中通过/editor命令查看并设置使用的编辑器

---

4. 总结

本文详细记录了在 Android Termux 环境下从零开始搭建 Gemini CLI 开发环境的全过程，涵盖了基础工具安装、Node.js 环境配置、Git 部署以及自定义技能的进阶玩法。

---

5. 参考资料 (References)

• Termux Wiki
• Gemini CLI GitHub Repository
• f-droid官网 https://f-droid.org/