Termux原生运行Claude Code：一键安装bun版AI编码神器
速览
本帖分享了在Termux上轻松部署Claude Code的创新方案。开发者无需依赖官方繁琐安装或魔改版bun，采用社区开发的原生bun运行方式即可直接体验Claude Code的强大能力。该工具融合了Claude Code的AI编码智能与Termux的便捷性，特别适合移动设备上的开发者快速搭建AI工作流。不仅解决了传统安装的麻烦，还强调使用原生bun以避免官方账号风控风险。通过一键安装依赖和简洁运行命令，用户能立即上手，加速AI辅助编程与代码工作的效率。
AI 深度解读
深度解读：Termux 原生运行 Claude Code
背景
Claude Code 是 Anthropic 推出的终端级 AI 编码代理工具，由 Bun 编译而成。它支持在终端中理解代码库、执行自然语言命令、处理代码修改和 Git 工作流等复杂任务。Termux 作为 Android 终端模拟器，在移动环境中提供了类似桌面终端的体验，但官方 npm 安装的 Claude Code（v2.1.113 及以后版本）因切换为原生 glibc ELF 二进制文件而导致兼容性缺失。用户在 Termux 中运行时常出现依赖缺失或运行失败的问题。
社区开发者 naiyQAQ 为解决这一痛点，开发了「claudecode」项目。该项目通过原生 Bun 打包方式适配 Termux，允许在 Termux 环境中直接运行官方 Claude Code，无需复杂 proot 或 glibc-runner 环境。
核心内容
项目目标与开发背景
开发者指出，现有在 Termux 运行 Claude Code 的方式普遍麻烦且依赖繁杂，因此专门开发了可在 Termux 使用原生 Bun 运行的 claudecode 项目。该项目由朋友 naiyQAQ 开发（未使用 Linux DO 账号进行代发）。
依赖库
项目依赖以下库：
- bun
- rg
- alsa-lib
- unzip
一键安装依赖
在 Termux 中执行：
apt update
apt install ripgrep alsa-lib unzip curl -y
export _pwd=$(pwd)
cd $PREFIX/tmp
curl -L https://github.com/oven-sh/bun/releases/latest/download/bun-linux-aarch64-android.zip > bun.zip
unzip -j bun.zip '*/bun' -d $PREFIX/bin && chmod +x $PREFIX/bin/bun
cd $_pwd
项目本体与运行方式
从 Releases 页面下载最新的 anthropic-ai-claude-code-<version>-termux.tgz，然后在本地执行（将路径替换为实际下载的 tgz 路径）：
npm i -g @anthropic-ai/[email protected]
npm i -g /path/to/your/tgz/file
claude --version
若显示 2.1.153 (Claude Code)，即可愉快使用 claudecode。
注意事项与风险
- 请不要在本客户端登录官方账号（Claude 官方账号），因项目使用的原生 Bun 已对官方 Bun 进行了魔改，导致发送的请求发生变化，可能触发严重风控。
- 本项目使用原生 Bun 运行。
所用代码开源地址
该项目代码已开源，链接详见具体帖子。
关键要点
- 这是 Termux 原生适配 Claude Code 的社区开源项目，无需额外 glibc 环境或 proot。
- 核心运行依赖官方 npm 包
@anthropic-ai/claude-code版本 2.1.112（含 JS 入口），搭配开发者打包的 termux 版本 tgz。 - Bun 安装命令专门针对 Android aarch64 平台，无需 proot。
- 必须安装 ripgrep（rg，用于 Claude Code 的代码搜索工具）等依赖库。
- 明确警告：原生 Bun 魔改可能导致请求变化，禁止使用官方账号，避免风控风险。
- 验证方式：运行
claude --version确认版本为 2.1.153 及以上。 - 项目完全开源，遵循社区推广要求，承诺永久有效且接受监督。
意义与影响
该项目为 Termux 用户提供了无需桌面电脑、无需复杂虚拟环境即可在手机上运行 Claude Code 的直接途径，极大降低了移动端 AI 编码工具的使用门槛。它扩展了 Claude Code 的适用场景，尤其适合移动办公、远程开发或随时随地调试代码的场景。
同时，项目暴露了 Anthropic Claude Code 官方对移动平台的适配痛点（Bun 二进制文件对 Android 环境不兼容），推动了社区进一步探索 Bun 在移动端的原生兼容性解决方案。开源特性也便于开发者自定义或扩展，未来可能催生更多 Termux 专用 AI 代理工具。整体而言，这是一次实用且低门槛的社区贡献，为终端级 AI 工具在 Android 生态中的普及奠定了基础。