TL;DR: 2026年4月時点で Gemini CLI は実用的ではありません。モデルのレスポンス品質、CLIツールとしての完成度の両面で、Claude Code と Codex に大きく劣ります(参考: Issue #22141)。

Android の Termux で Gemini CLI を動かしたかったので、手順をメモしておきます。最初は公式版だけで進めようとして詰まりましたが、フォーク版で先に認証するとスムーズでした。

1. Termuxの基本パッケージを入れる

まずは更新して、必要なパッケージを入れます。

pkg update && pkg upgrade
pkg install -y nodejs-lts python git bash-completion neovim ripgrep jq gron termux-api
  • nodejs-lts は必須です
  • python はエージェント系ツールが使うことがあるので入れておくと安心です
  • git, bash-completion, neovim, ripgrep, jq, gron は好みでOKです
  • termux-api は現時点だと必須ではないですが、あとで使えると便利です

2. 使いやすいキーを追加して常駐設定する

Termux のソフトウェアキーボードに S-TAB や記号キーを追加しておくと、Vim 操作がかなり楽になります。

mkdir -p ~/.termux && echo "extra-keys = [['ESC',':','/','~','|','UP',{'macro': 'ALT [ Z', 'display': 'S-TAB'}],['TAB','CTRL','ALT','-','LEFT','DOWN','RIGHT']]" > ~/.termux/termux.properties && termux-reload-settings

~/.termux/termux.properties を編集したら、termux-reload-settings で反映します。

バックグラウンドで落ちにくくするため、wake-lock も有効にします。

termux-wake-lock

3. フォーク版でログインしてから公式版に切り替える

ここが今回のポイントです。いきなり公式版で進めるより、先にフォーク版で認証すると楽でした。

npm install -g @mmmbuto/gemini-cli-termux@latest
gemini --version
gemini login

認証が終わったら、フォーク版はアンインストールします(そのまま使ってもよいです)。

npm uninstall -g @mmmbuto/gemini-cli-termux

次に公式版をインストールします。

# 必要なパッケージ
pkg install -y nodejs-lts clang binutils build-essential python

# ビルドで詰まる場合があるので android_ndk_path を空で明示
mkdir -p "$HOME/.gyp"
echo "{ 'variables': { 'android_ndk_path': '' } }" > "$HOME/.gyp/include.gypi"
export GYP_DEFINES="android_ndk_path=''"

npm install -g @google/gemini-cli
gemini --version

必要なら、以下の情報も参考になります。 参考 > Can I run Gemini CLI on Termux?

4. (オプション)共有ストレージを使う

他アプリとファイルをやり取りするなら、ストレージ権限を付与しておくと便利です。

termux-setup-storage

# 共有ディレクトリへ移動
cd ~/storage/shared/Documents

まとめ

以上のような感じで、Android の Termux 環境でも Gemini CLI を実用的に動かせることがわかりました。最初にフォーク版で認証してから公式版へ切り替える手順が、今のところ一番ハマりにくいです。