310 字
2 分钟
[指南] 在 Termux 中安装 OpenCode
2026-02-21
无标签

Termux 环境配置#

Termux 更新#

Terminal window
pkg upgrade

proot-distro 安装#

由于 OpenCode 官方安装脚本针对标准 Linux 环境设计,我们需要通过 proot-distro 运行完整的 Debian 系统

Terminal window
pkg install proot-distro

查看可用的发行版:

Terminal window
proot-distro list

输出显示支持好多发行版,我选择 Debian (trixie) 以获得最佳的兼容性

部署 Debian 容器#

下载并安装 rootfs:

Terminal window
proot-distro install debian

进入 Debian 环境#

Terminal window
proot-distro login debian

成功进入后,提示符变为 root@localhost:~#,此时我们已处于完整的 Debian trixie 环境中

OpenCode 安装#

执行官方安装脚本:

Terminal window
curl -fsSL https://opencode.ai/install | bash

安装完成后会显示 OpenCode 的 ASCII Logo

官方提示说已自动添加 PATH,但实际测试发现需要手动 source:

Terminal window
# 验证安装位置
find / -type f -name "opencode" 2>/dev/null
# 输出为 /root/.opencode/bin/opencode
Terminal window
# 手动添加环境变量
echo 'export PATH="$HOME/.opencode/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

OpenCode 启动!#

Terminal window
opencode

不要忘记为你的项目初始化 OpenCode:

/init

这样我们就可以在 Termux 愉快的进行 Vibe Coding 了~

常见问题排查#

若键入 opencode 后返回以下内容:

Terminal window
opencode: command not found

你应该检查 ~/.bashrc 中 PATH 配置,然后执行:

Terminal window
source ~/.bashrc

参考链接#

[指南] 在 Termux 中安装 OpenCode
https://fuwari.vercel.app/posts/指南-在-termux-中安装-opencode/
作者
NWMA_FYWF
发布于
2026-02-21
许可协议
CC BY-NC-SA 4.0