not installed or not executable - OpenCode

Quick fix

升级 CC Switch 至 v3.11.0+ 修复路径检测，或手动将 opencode 软链接至 ~/.local/bin。

Symptom

报错原文复制

not installed or not executable

Cause

在 v3.11.0 之前的版本中，CC Switch 的环境检测逻辑未覆盖 OpenCode 官方安装脚本的默认路径（如 `~/.opencode/bin`），导致 GUI 进程因 PATH 环境变量不一致而漏检。此外，本集群还包含其他 OpenCode 相关的独立问题：在 WSL 环境下，CC Switch 可能无法正确识别配置文件，需手动指向 `\\wsl.localhost\Ubuntu\home\<user>\.config\opencode`；在 v3.16.5 及之前版本中，生成的会话恢复命令格式错误（误用 `opencode session resume`，正确应为 `opencode -s`）。

Fix

1. 1

   升级 CC Switch 至 v3.11.0 或更高版本（建议升级至 v3.16.5 以上，以同时修复会话恢复命令格式错误的问题）。

2. 2

   若无法立即升级，可通过创建软链接将 OpenCode 加入系统 PATH 以绕过环境检测问题：执行 `mkdir -p ~/.local/bin && ln -sf ~/.opencode/bin/opencode ~/.local/bin/opencode`，然后重启 CC Switch 并刷新检测。

3. 3

   对于 WSL 环境，请确保 OpenCode 的配置目录正确指向 `\\wsl.localhost\Ubuntu\home\<user-name>\.config\opencode`。

Affected Versions

Toolcc-switch

Version3.10.3 - 3.16.5

PlatformsmacOSLinuxWindows

Source Issues

本页汇总自 4 个真实 issue

• #896win系统 wsl 中配置opencode 报错
• #1083[Bug] macOS 下 OpenCode 已安装但“本地环境检测”显示 `not installed or not executable`（v3.10.3）
• #1107我安装了opencode，但是没有识别到
• #5065OpenCode session resume 命令格式错误

FAQ

环境检测不识别 OpenCode 会影响正常使用吗？

不影响。该检测仅用于在设置页面显示版本号，只要终端能正常执行 opencode 命令，CC Switch 的核心功能仍可正常使用。

为什么在 WSL 中配置 OpenCode 目录一直报错？

WSL 中 OpenCode 的默认配置文件位置在 `\\wsl.localhost\Ubuntu\home\<user-name>\.config\opencode`，请检查配置的目录是否与此一致。

相关问题

未安装 / not installed or not executable升级 CC Switch 至 v3.20.0+ 以修复自定义 npm prefix 及 macOS 检测失败，Windows 误报多处安装需升级至 v3.16.5+。4 issues mergedenv: node: No such file or directory将 cc-switch 升级至 v3.18.0 或更高版本即可自动修复 GUI 环境下 PATH 缺失导致的环境变量解析失败问题。2 issues merged无法导入供应商，无法进行会话管理 cc-switch升级 cc-switch 以支持 jsonc 配置；WSL2 环境需定时克隆数据库至 Windows 本地路径以绕过 SQLite 锁定。4 issues merged