OpenCode是一个开源的AI编程助手（AI coding agent），旨在帮助开发者更高效地编写、调试和重构代码。本文记录OpenCode使用过程中遇到的问题定位和解决措施。
1、问题1：在终端命令中输入“opencode”，但没有回应，无法启动
无法启动截图
ps -ef |grep opencode 发现opencode的进程没有启动
1.1 查看机器的资源情况
资源充足
top查看系统资源情况
1.2 查看安装目录
因为当前的opencode是通过npm安装命令 npm i -g opencode-ai 安装的，且安装在全局环境下。
1.3.1 先查询一下node的版本号
通过nvm安装的node，使用如下命令查看，可知版本为v25.6.1
nvm list
查看node的版本
1.3.2 查询node的安装路径
使用如下命令
which node
which npm
node的安装目录
可以找到opencode的安装路径，安装在node的v25.6.1版本下的./lib/node_modules下面，相对路径如下（绝对路径见截图）：
~/.config/nvm/versions/node/v25.6.1/lib/node_modules
opencode的安装目录
1.4 查看安装目录
查看后发现opencode-ai的node_modules为空
opencode-ai的node_modules
查看package.json可以看出opencode-ai当前版本是1.2.26
当前opencode的版本号
但之前正常使用时候的版本是1.2.24
之前使用正常时候的版本号
问题根因：
基于上述的分析，可以得出结论：opencode-ai于3月14日20:16做升级的时候，但没有升级成功，导致后续无法启动。
解决措施：
使用如下命令，继续安装未升级成功的版本
npm install -g opencode-ai@1.2.26
未升级成功的版本安装成功
重新启动成功
启动成功
2、问题2：调用离线模型qwen-coder报错
报错截图
"auto" tool choice requires --enable-auto-tool-choice and --tool-call-parser to be set
解决措施：
export OMP_NUM_THREADS=4
VLLM_ATTENTION_BACKEND=FLASHINFER \
vllm serve Qwen/Qwen3-Coder-30B-A3B-Instruct-FP8 \
--served-model-name qwen3-coder-flash \
--max-model-len 200000 \
--gpu-memory-utilization 0.85 \
--kv-cache-dtype fp8_e4m3 \
--enable-auto-tool-choice \ #启用自动工具选择功能
--tool-call-parser hermes \ #指定工具调用解析器,对于 Qwen 系列模型,推荐使用 hermes 解析器
--port 6006
其他问题定位和解决措施：
1 重装opencode
实在定位不出问题，只能采取重装的措施
Uninstall opencode （npm un -g opencode-ai）
删除文件夹（.config/opencode）
Reinstall Opencode （npm i -g opencode-ai）
