A self-contained, one-command installer for Claude Code on Android Termux.
Pinned to a stable version. Privacy-hardened out of the box. Fully personalised.

claude_code_setup.py is a beautiful, interactive Python script that automates the complete setup of Claude Code inside Termux (Android Linux userland).

It handles everything in 4 guided phases:

Later versions of @anthropic-ai/claude-code are known to break on Termux due to filesystem changes and claude code moved to x86 native architecture only. Also disabled Auto updates to prevent auto updates. This script deliberately pins to v2.1.112 — tested, confirmed stable, and production-ready on Termux.

• 🎨 Beautiful TUI — colourful ASCII banner, braille spinner, phase headers
• 📦 Auto-installs Node.js if not present via pkg
• 📌 Pinned version — no surprise breakage from upstream updates
• 👤 Interactive user profiling — name, coding level, languages, device specs
• 🔍 Auto-detects ABIs, RAM, Android version from device
• 🛡️ Privacy-first — all telemetry and non-essential traffic disabled by default
• 🔒 Hardened permissions — safe bash allowlist + dangerous command blocklist
• 📊 Token Status Bar — live context %, 5-hour & 7-day rate-limit bars inside Claude Code
• 🗑️ Clean uninstaller — double-confirm safety, removes every Claude-related file
• ✅ Post-install verification — confirms everything is correctly set up

Note: Install Termux from F-Droid only. The Play Store version is Experimental and will cause issues.

1. Open Termux and update packages:

pkg update && pkg upgrade -y

2. Clone this repo or download the script:

# Clone
git clone https://github.com/Graywizard888/Claude_code_setup.git
cd Claude_code_setup

# OR download directly
curl -O https://raw.githubusercontent.com/Graywizard888/Claude_code_setup/main/claude_code_setup.py

3. Run the setup script:

python claude_code_setup.py

That's it. The interactive menu takes it from here.

╔═══════════════════════════════════════════════╗
║                                               ║
║   1   Install Claude Code                     ║
║       ┃ Full install + personalised config    ║
║       ┃ Pinned to v2.1.112 (stable)           ║
║                                               ║
║   2   Uninstall Claude Code                   ║
║       ┃ Complete removal                      ║
║       ┃ Two-step confirmation                 ║
║                                               ║
║   3   Add Settings Only                       ║
║       ┃ Write recommended settings.json       ║
║       ┃ Safe to run on existing install       ║
║                                               ║
║   4   Enable Token Status Bar                 ║
║       ┃ Install statusline.py                 ║
║       ┃ Shows ctx%, 5-hour & 7-day limits     ║
║                                               ║
║   5   Exit                                    ║
╚═══════════════════════════════════════════════╝

Walks you through 4 phases:

1. Dependencies — Checks for Node.js, installs if missing
2. Claude Code — Installs pinned v2.1.112 globally via npm
3. User Profile — Asks for your name, skill level, languages, device info, and Claude plan type
4. Config Files — Writes ~/.claude/settings.json and ~/.claude/CLAUDE.md

At the end, you are offered to also enable the Token Status Bar immediately.

Performs a clean, complete removal with two separate confirmation prompts (YES → UNINSTALL) to prevent accidents.

Writes (or overwrites) ~/.claude/settings.json with the latest recommended config without doing a full install. Safe to run on an existing Claude Code setup.

Installs ~/.claude/statusline.py and wires the statusLine key into settings.json. Prompts you to select your Claude plan (Pro / Max5 / Max20) so the bars show the correct token limits.

{
  "env": {
    "DISABLE_TELEMETRY": "1",
    "DISABLE_ERROR_REPORTING": "1",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "DISABLE_NON_ESSENTIAL_MODEL_CALLS": "1",
    "MAX_THINKING_TOKENS": "10000",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "8000",
    "CLAUDE_CODE_AUTOCOMPACT_PCT_OVERRIDE": "50",
    "CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY": "3",
    "CLAUDE_CODE_TMPDIR": "/data/data/com.termux/files/usr/tmp",
    "ANTHROPIC_SMALL_FAST_MODEL": "claude-haiku-4-5-20251001",
    "CLAUDE_CODE_SUBAGENT_MODEL": "claude-haiku-4-5-20251001",
    "TMPDIR": "/data/data/com.termux/files/usr/tmp",
    "EDITOR": "nano",
    "USE_BUILTIN_RIPGREP": "1"
  },
  "autoUpdates": false,
  "includeCoAuthoredBy": false,
  "effortLevel": "high",
  "showThinkingSummaries": true,
  "autoMemoryEnabled": true
}

Dynamically generated from your answers + auto-detected device info. Also includes token-check rules so Claude warns you before starting heavy tasks when limits are near:

- Name: YourName
- Coding Proficiency: Beginner / Intermediate / Advanced / Expert
- Preferred Languages: python, bash, kotlin ...
- Device: OnePlus 12R IN
- Processor: Snapdragon 8 Gen 2
- ABIs: arm64-v8a, armeabi-v7a
- RAM: 7.0G
- Android: 16 (SDK 36)

- Check token usage in .claude/statusline_cache.json ...
- Warn and ask "can we continue?" if ctx/rl5/rl7 is at 75%+ ...

When enabled, a live status bar appears at the bottom of Claude Code showing:

  🤖 Current Model    claude-sonnet-4-6
  🧠 Chat Context     ████████░░░░░░░░░░░░░░░░   35.0%
  ⏱  5-hour limit     ██░░░░░░░░░░░░░░░░░░░░░░   10.5%
  📅 7-day limit      █░░░░░░░░░░░░░░░░░░░░░░░    4.0%

Supports three plan tiers:

⚠️ Do NOT uninstall Python from Termux — statusline.py requires Python to run.

Every install applies these protections automatically:

grep, cat, ls, find, head, tail, wc, sort
git status, git log, git diff, git branch
node, python, python3, Read(*)

Write(*), Edit(*)
rm -rf, bash, chmod, curl, wget
WebFetch(*), WebSearch(*)

Read(.env), Read(.env.*)
Read(secrets/**), Read(**/credentials.json)
Read(**/*.pem), Read(**/*.key)

~/ (Termux home)
├── claude_code_setup.py          ← this script
└── .claude/
    ├── settings.json              ← hardened Claude Code settings
    ├── CLAUDE.md                  ← your personalised context file
    ├── statusline.py              ← token status bar (optional, Option 4)
    └── statusline_cache.json      ← live token-usage cache (auto-written)

The uninstaller removes everything:

● @anthropic-ai/claude-code     (global npm package)
● ~/.claude/                    (config, CLAUDE.md, statusline, history)
● ~/.claude.json                (auth / account file)
● ~/.cache/claude-cli-nodejs    (npm CLI cache)
● ~/.config/claude              (system config)

Requires typing YES followed by UNINSTALL — no accidental removals.

# Launch Claude Code
claude

# Check installed version
claude --version

# One-shot prompt (no interactive session)
claude -p "Write a Python hello world"

# View your context file
cat ~/.claude/CLAUDE.md

# View settings
cat ~/.claude/settings.json

# View live token usage
cat ~/.claude/statusline_cache.json

First launch will ask for your Anthropic API key.
Get one at console.anthropic.com

Or login via your google Claude subscription account in claude

1. Go to console.anthropic.com
2. Sign up / log in
3. Navigate to API Keys → Create Key
4. Paste it when claude asks on first launch

Pull requests are welcome. For major changes, please open an issue first to discuss what you'd like to change.

1. Fork the repo
2. Create your branch: git checkout -b feature/your-feature
3. Commit: git commit -m "Add your feature"
4. Push: git push origin feature/your-feature
5. Open a Pull Request

This project is licensed under the MIT License — see the LICENSE file for details.

✦ Created by Graywizard ✦