在 Termux 上部署 OpenCode：手机端运行 AI 编程助手

对于经常在手机上写代码或维护项目的开发者来说，手边有一个能理解整个代码库的 AI 编程助手会方便很多。OpenCode 是一款开源 AI 编程代理，支持在终端中直接对项目进行代码修改、文件读写和命令执行。本文面向想在 Android 手机上通过 Termux 运行 OpenCode 的用户，说明如何从社区维护的 opencode-termux 项目安装，并配置 DeepSeek、Moonshot 等国产大模型提供商。

背景

OpenCode 官方支持 Linux、macOS、Windows 和桌面应用，但不提供 Android 原生命令行包。原版安装脚本会下载 opencode-linux-arm64 二进制，这个文件依赖 glibc，无法直接在 Android 的 Bionic libc 上运行。

社区项目 opencode-termux（由 Hope2333 维护）通过 bun-termux-loader 技术解决了这个问题：它给官方二进制套上一层 Bionic 兼容封装，运行时通过 glibc 的 ld.so 以 userland exec 方式加载原始程序。目前最新打包版本对应上游 v1.17.18，以 deb 和 pacman 两种格式发布。

前置条件

• 64 位 ARM 设备（aarch64）
• 已安装 Termux（建议从 F-Droid 获取，Play 商店版本可能过旧）
• Termux 有充足存储空间（OpenCode 包约 33 MB，加上依赖约 100 MB）
• 稳定的网络连接（用于下载包和调用 API）

32 位 ARM（armv7）不受支持，因为依赖链存在问题。x86_64 架构在手机上基本不存在，如有需要请直接使用标准 Linux 发行版。

安装步骤

安装 glibc 依赖

OpenCode 的二进制链接到 glibc，所以需要先安装 glibc 兼容层和 OpenSSL 的 glibc 版本。依次执行：

pkg update
pkg install -y glibc-repo
pkg update
pkg install -y glibc openssl-glibc bash ncurses

依赖安装完成后，可以通过 ldd 验证 glibc 是否可用（可选）：

ldd --version | head -1

下载 OpenCode 包

打开最新 release 页面：https://github.com/Hope2333/opencode-termux/releases/latest

找到 opencode_1.17.18_aarch64.deb（或更高版本号），直接在 Termux 中用 wget 或 curl 下载：

curl -LO https://github.com/Hope2333/opencode-termux/releases/download/Push260522/opencode_1.17.18_aarch64.deb

release tag 会随版本更新变化，如果上述链接失效，请到 release 页面查找最新 tag。

安装 deb 包

apt install -y ./opencode_1.17.18_aarch64.deb

如果偏好 pacman，可以从同一 release 下载 .pkg.tar.xz 文件，然后：

pacman -U ./opencode-1.17.18-1-aarch64.pkg.tar.xz

验证安装：

opencode --version

正常输出类似于 1.17.18。

安装时如果遇到依赖错误，先确保 glibc 和 openssl-glibc 已正确安装。如果在非 pure-android 分支的早期版本上升级，建议先卸载旧版再安装新版。

更新到新版本

opencode-termux 的发布节奏通常在上游新版本发布后 1-3 天内跟上。更新步骤和首次安装基本一致：

# 1. 查看当前版本
opencode --version

# 2. 去 release 页面查看是否有更新
#    https://github.com/Hope2333/opencode-termux/releases/latest

# 3. 下载新版 deb 包
curl -LO https://github.com/Hope2333/opencode-termux/releases/download/<新tag>/opencode_<新版本>_aarch64.deb

# 4. 直接安装（apt 会自动升级）
apt install -y ./opencode_<新版本>_aarch64.deb

apt install 会覆盖旧版本，配置文件和认证信息不受影响，无需额外操作。如果切换了打包格式（比如之前用 pacman 装的，现在想换 deb），需要先卸载旧版再安装新版。

配置 DeepSeek 等国产模型

OpenCode 支持 75+ 个 LLM 提供商，国产模型方面内置了 DeepSeek、Moonshot AI（Kimi）、MiniMax、零一万物（302.AI）等。

通过 TUI 交互配置（推荐）

在项目目录中启动 OpenCode：

cd /path/to/your/project
opencode

第一次启动会进入终端交互界面，输入 /connect，在提供商列表中找到 DeepSeek 并回车。终端会要求输入 API Key：

┌ API key
│
└

在 DeepSeek 开放平台（https://platform.deepseek.com/）注册账号后创建 API Key，粘贴进去即可。之后输入 /models 选择模型（如 DeepSeek V4 Flash）。

其他国产提供商的操作类似：Moonshot AI 选择后在 https://platform.moonshot.ai/console 创建 Key；MiniMax 在 https://platform.minimax.io/login 创建。

通过配置文件指定

也可以直接在 opencode.json 中写明配置：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "openai": {
      "name": "DeepSeek",
      "options": {
        "baseURL": "https://api.deepseek.com/v1",
        "apiKey": "sk-你的真实密钥"
      },
      "models": {
        "deepseek-chat": {
          "name": "deepseek-v4-flash"
        }
      }
    }
  }
}

基本使用

终端对话模式

opencode

进入 TUI 后直接输入问题或代码需求，OpenCode 会读取当前项目上下文，生成修改方案并操作文件。支持 Tab 键切换 Build（读写）和 Plan（只读）两种代理模式。

单命令模式

opencode run "解释 src/index.ts 的认证逻辑"
opencode run --mode=dev "修复所有的 TypeScript 类型错误"

--mode=dev 会给予模型更大的自由度执行命令和修改代码。

Web 界面模式

opencode web

启动后可以在手机浏览器中通过 http://localhost:4096 访问 Web 界面，适合不方便在 Termux 终端中操作时使用。

第三方 UI 扩展

如果觉得内置 Web 界面功能不够，可以搭配社区项目 OpenCodeUI（由 lehhair 维护），它是一个功能完整的第三方 Web 前端，提供了独立的聊天界面、内置 xterm.js 终端、文件浏览与 Diff 对比、多主题支持（明暗切换）、PWA 可安装等特性。

在 Termux 中启动 OpenCode 服务端并加上 CORS 参数：

同一设备上访问（手机跑服务，手机打开浏览器）:

opencode serve --cors "https://lehhair.github.io"

然后在浏览器中打开 https://lehhair.github.io/OpenCodeUI/ 即可使用。

同局域网下其他设备访问:

opencode serve --cors "https://lehhair.github.io"

在同一局域网下的设备浏览器中打开 https://lehhair.github.io/OpenCodeUI/ 即可使用。

如果连接失败，先确认 Termux 设备的局域网 IP。查看命令：

ip addr show | grep inet
或
hostname -I

找到类似 192.168.x.x 的地址，OpenCodeUI 连接地址填写这个 IP 加上端口 4096。

远程(非局域网): 如果设备不在同一个局域网，可以通过内网穿透工具（如 Sakura）将服务映射到公网。注意 Sakura 映射的本地 IP 也要填写 0.0.0.0：

opencode serve --hostname 0.0.0.0 --cors "https://lehhair.github.io"

启动后使用 Sakura 将 0.0.0.0:4096 映射到公网，获得一个公网地址，然后在 OpenCodeUI 页面中填写该地址即可连接。

这个项目的代码完全由 AI 编程（Vibe Coding）完成，截至 2026 年 7 月在 GitHub 获得约 500 星，仍在活跃更新中。

已知限制

• glibc 依赖：当前方案仍需要 glibc 包，并非纯 Bionic 构建。项目维护者正在尝试彻底消除 glibc 依赖，但目前受限于 Bun 的 --compile 在 Android 上受限以及编译后字节码不可移植等问题。
• 启动速度：首次启动时 wrapper 需要解包并执行 glibc 加载，比在桌面 Linux 上稍慢（多约 1-2 秒）。
• Termux 稳定性：某些 Android 系统会因省电策略杀死 Termux 后台进程。建议在系统设置中将 Termux 加入白名单或关闭电池优化。
• API 网络：DeepSeek 等国产模型的 API 端点在国内可直接访问，但如果使用境外提供商可能需要代理。OpenCode 的代理配置参考官方网络文档。
• 自动更新：Opencode-termux 的发布节奏略晚于上游，社区打包通常在上游发布后 1-3 天内完成。

总结

通过 opencode-termux 项目，在 Android 手机上运行 OpenCode AI 编程助手是可行的。安装过程不算复杂：添加 glibc 仓库、安装依赖、下载 deb 包即可完成。配置 DeepSeek 等国产模型提供商后，就能在 Termux 中获得完整的 AI 编程辅助能力。需要注意 glibc 依赖目前无法去除，且移动端环境下 Termux 的稳定性和性能与桌面环境仍有差距。适合在通勤、出差等场景下做轻量代码维护，但不建议作为主力开发环境。