Ubuntu 24 安装 OpenCode 后命令找不到

问题

在 Ubuntu 24 上运行官方安装脚本后，终端提示 opencode: command not found，重启终端也无效。

bash

curl -fsSL https://opencode.ai/install | bash
# 安装显示成功，但执行 opencode 报错

安装程序会将可执行文件放到 ~/.opencode/bin/，但该目录没有被自动加入 PATH，或者写入了 ~/.bashrc 但当前 shell 未重新加载。

手动将 opencode bin 目录添加到 PATH 并重新加载：

bash

echo 'export PATH="$HOME/.opencode/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

之后验证：

bash

opencode --version

如果使用 deb 包安装：deb 包安装的可执行文件名为 opencode-cli 而非 opencode，这是已知问题。可以手动创建软链接：

bash

sudo ln -s /usr/bin/opencode-cli /usr/local/bin/opencode

如果默认 shell 是 fish：需要将路径加入 fish 配置：

fish

fish_add_path ~/.opencode/bin

来源：GitHub #11319