Claude Code hangs on startup in Termux (Android) with Node.js v24

Resolved 💬 3 comments Opened Feb 6, 2026 by dragonbornjedi-code Closed Feb 10, 2026

Environment

  • Platform: Termux on Android (Samsung S24 Ultra)
  • Node.js: v24.x (installed via pkg)
  • Claude Code: Latest from npm

Description

Claude Code hangs for 60+ seconds on startup in Termux. Debug logs show the process stalls between configureGlobalAgents complete and any subsequent activity.

Steps to Reproduce

  1. Install Termux on Android
  2. pkg install nodejs-lts (installs Node v24)
  3. npm install -g @anthropic-ai/claude-code
  4. Run claude - hangs with no output

Debug Output

[DEBUG] Starting CLI...
[DEBUG] configureGlobalAgents complete
# 60+ second gap here
[DEBUG] ... eventually continues or times out

Investigation Done

  • Network connectivity confirmed working (curl to api.anthropic.com succeeds)
  • --no-update-check flag doesn't help
  • ANTHROPIC_TIMEOUT environment variable doesn't help
  • Issue appears to be in initialization, possibly:
  • Keytar/credential storage not available on Android
  • Native module compatibility with Node v24 on Android/ARM

Workaround

Created HTTP proxy through a Linux server where Claude Code works normally:

# On working server
app.post('/api/claude/run', (req, res) => {
  exec(`echo '${prompt}' | claude`, ...);
});

# On phone
curl -X POST server:3030/api/claude/run -d '{"prompt":"..."}'

Expected Behavior

Claude Code should start and reach the interactive prompt within a few seconds.

Additional Context

This may be related to Node.js v24 specifically, or to missing native dependencies in Termux's sandboxed environment.

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗