Termux から Google Drive を rclone で操作する手順

1. 前提条件

• Android 端末に Termux がインストール済み
• Google アカウント
• インターネット接続

注意: Android では FUSE（/dev/fuse）への一般アプリからのアクセスが制限されているため、rclone mount は使用できない。代わりに rclone copy / rclone sync によるコマンドベースの操作を行う。

2. rclone のインストール

pkg update
pkg install rclone

Termux のパッケージは古い場合がある（v1.60 など）。bisync 等の機能を安定して使いたい場合は、公式インストーラーで最新版を入れる：

curl https://rclone.org/install.sh | bash
rclone version

3. rclone の設定

rclone config

対話形式で設定する。

項目	入力内容
n/s/q>	n（新規作成）
name>	任意（例: gdrive）
Storage>	Google Drive を選択
client_id>	自作の OAuth クライアント ID（空でも可）
client_secret>	自作の OAuth クライアントシークレット（空でも可）
service_account_file>	空のまま Enter
Use auto config?	No を選択

「Use auto config?」で No を選ぶと URL が表示されるので、Android のブラウザで開いて認証し、表示されたトークンを Termux に貼り付ける。

OAuth クライアント ID の作成（推奨）

空のままでも動作するが、rclone 内蔵の共有キーはレートリミットに引っかかりやすい。自分専用の ID を作る手順は以下の通り。

1. Google Cloud Console にアクセス
2. プロジェクトを作成
3. API とサービス → ライブラリ で「Google Drive API」を有効化
4. API とサービス → OAuth 同意画面 を設定
   • ユーザータイプ: 外部
   • アプリ名: 任意（例: my-rclone）
   • テストユーザーに自分の Gmail を追加
5. 認証情報 → OAuth クライアント ID を作成
   • アプリケーションの種類: デスクトップアプリ
6. 表示されたクライアント ID とシークレットを控える

テストユーザーに自分を追加しないと「アクセスをブロック」エラーが出る。認証画面で警告が出た場合は「詳細」→「(アプリ名)（安全ではないページ）に移動」で進める。

4. ストレージアクセスの許可

Termux からスマホ内のファイルにアクセスするには：

termux-setup-storage

これで ~/storage/ 配下に Downloads 等がマウントされる。

5. ヘルパースクリプトの準備

ディレクトリ作成

mkdir -p ~/bin ~/gdrive-work

gdrive-pull（リモート → ローカル）

cat > ~/bin/gdrive-pull << 'EOF'
#!/bin/bash
# 使い方: gdrive-pull [リモートパス]
# 例: gdrive-pull Projects/myapp
REMOTE_PATH="${1:-.}"
LOCAL_DIR="$HOME/gdrive-work"

rclone copy "gdrive:$REMOTE_PATH" "$LOCAL_DIR/$REMOTE_PATH" --progress
echo "Pulled: gdrive:$REMOTE_PATH → $LOCAL_DIR/$REMOTE_PATH"
EOF
chmod +x ~/bin/gdrive-pull

gdrive-push（ローカル → リモート）

cat > ~/bin/gdrive-push << 'EOF'
#!/bin/bash
# 使い方: gdrive-push [ローカルパス]
# 例: gdrive-push Projects/myapp
LOCAL_PATH="${1:-.}"
LOCAL_DIR="$HOME/gdrive-work"

rclone copy "$LOCAL_DIR/$LOCAL_PATH" "gdrive:$LOCAL_PATH" --progress
echo "Pushed: $LOCAL_DIR/$LOCAL_PATH → gdrive:$LOCAL_PATH"
EOF
chmod +x ~/bin/gdrive-push

gdrive-sync（簡易双方向同期）

cat > ~/bin/gdrive-sync << 'EOF'
#!/bin/bash
# 使い方: gdrive-sync [パス]
SYNC_PATH="${1:-.}"
LOCAL_DIR="$HOME/gdrive-work"

echo "Pulling from remote..."
rclone copy "gdrive:$SYNC_PATH" "$LOCAL_DIR/$SYNC_PATH" --update
echo "Pushing to remote..."
rclone copy "$LOCAL_DIR/$SYNC_PATH" "gdrive:$SYNC_PATH" --update
echo "Synced: $SYNC_PATH"
EOF
chmod +x ~/bin/gdrive-sync

--update により更新日時が新しいファイルだけがコピーされる。

gdrive-ls（リモートのファイル一覧）

cat > ~/bin/gdrive-ls << 'EOF'
#!/bin/bash
rclone lsf "gdrive:${1:-.}" --format "tsp" | sort -k1 -r | head -30
EOF
chmod +x ~/bin/gdrive-ls

gdrive-edit（単一ファイルの編集）

cat > ~/bin/gdrive-edit << 'EOF'
#!/bin/bash
# 使い方: gdrive-edit path/to/file.txt
FILE="$1"
TMPDIR=$(mktemp -d)
BASENAME=$(basename "$FILE")

rclone copy "gdrive:$FILE" "$TMPDIR/"
${EDITOR:-vim} "$TMPDIR/$BASENAME"
rclone copy "$TMPDIR/$BASENAME" "gdrive:$(dirname "$FILE")/"
rm -rf "$TMPDIR"
echo "Uploaded: $FILE"
EOF
chmod +x ~/bin/gdrive-edit

6. Claude Code との連携

作業フロー

Google Drive (リモート)
    ↕ gdrive-pull / gdrive-push
~/gdrive-work/ (ローカル作業ディレクトリ)
    ↕ Claude Code が直接編集

CLAUDE.md の配置

Claude Code が作業ルールを自動的に理解できるよう、ワークスペースに配置する。

cat > ~/gdrive-work/CLAUDE.md << 'EOF'
# Google Drive 作業ルール

このディレクトリは Google Drive とのローカル同期用ワークスペースである。

## 利用可能なコマンド

- `gdrive-pull <パス>` - Google Drive からローカルにダウンロード
- `gdrive-push <パス>` - ローカルから Google Drive にアップロード
- `gdrive-sync <パス>` - 簡易双方向同期（--update による新しいファイルのみコピー）
- `gdrive-ls <パス>` - Google Drive のファイル一覧
- `gdrive-edit <ファイル>` - 単一ファイルの取得→編集→アップロード

## 作業フロー

1. 作業開始前に必ず `gdrive-pull` で最新を取得する
2. ~/gdrive-work/ 配下のファイルを編集する
3. 編集完了後に `gdrive-push` でアップロードする

## 注意事項

- 直接 `rclone` コマンドでリモートを操作しない（ローカル経由で操作する）
- 大きなフォルダの pull は時間がかかるため、必要なサブフォルダだけを指定する
EOF

使用例

cd ~/gdrive-work
claude

# Claude Code への指示例:
# 「gdrive-pull Documents/notes してから、TODO.md を整理して、終わったら gdrive-push して」

7. よく使う rclone コマンド

# ファイル一覧
rclone ls gdrive:

# 特定フォルダの中身
rclone lsf gdrive:Documents/

# ダウンロード
rclone copy gdrive:path/to/file.txt ~/storage/downloads/

# アップロード
rclone copy ~/storage/downloads/file.txt gdrive:path/to/

# 差分確認
rclone check gdrive:path ~/gdrive-work/path

# 容量確認
rclone about gdrive:

8. トラブルシューティング

認証トークンの期限切れ

rclone config reconnect gdrive:

ネットワークエラーが頻発する場合

リトライ回数を増やす：

rclone copy gdrive:path ~/gdrive-work/path --retries 5 --low-level-retries 10

Termux のパスが通らない

~/bin にパスが通っていない場合は .bashrc に追加：

export PATH="$HOME/bin:$PATH"