为什么不能照常装?

Termux 用的是 Android 的 bionic libc, 架构标识 linux-arm64-android。
Claude Code 2.x 只发布原生二进制,官方 不给 bionic 架构编译,直接装会报 "native binary not installed",无解。

Node 版本也有坑:Termux 默认的 nodejs 是 v26,太新,会让最后的纯 JS 版 claude 加载即崩(Cannot read properties of undef
ined 'prototype')。
所以两个硬约束缺一不可:

  1. Node 必须用 LTS v24(pkg install nodejs-lts) 2. claude 必须装 1.0.128(最后一个纯 JS、能被 node 直接跑的版本)

完整步骤
第1步 —— 把 Node 换成 LTS v24(关键) pkg install -y nodejs-lts 这会卸掉 nodejs(v26)、装上 nodejs-lts(v24)。验证: node -v # 必须显示 v24.x,不能是 v26 npm -v 注:同机的 gemini-cli / hexo / vercel 在v24 上都正常,不受影响。

第 2 步 —— 装 1.0.128(关键) npm install -g @anthropic-ai/claude-c
[email protected]

为什么锁 1.0.128:1.0.x 系列是纯 JS(node 直接跑 cli.js),2.x 全是原生二进制(Termux 跑不了)。1.0.128 是 1.0 系列最后一个版本。

第 3 步 —— 验证
claude --version # 应输出:1.0.128 (Claude Code) claude --help # 能正常打印用 法即成功 直接敲 claude 进入交互会话,首次使用会走 浏览器 OAuth 登录授权。

一键复制版 pkg install -y nodejs-lts && \ npm install -g @anthropic-ai/[email protected] && \ claude --version

维护与排错

  • 千万别升级:pkg upgrade 可能把 nodejs(v26) 顶回来,claude 会再次启动即崩。
  • 排错口诀:claude 启动崩溃 → 先看 node -v → 若是 v26,重新 pkg install nodejs-lts 即可恢复。
  • 想用最新版 Claude Code(2.x)?只能在 glibc 的 VPS(x64/arm64 有原生二进制)上跑,Termux 这边受架构限制只能停在纯 JS 的 1.0.128。