【笔记】Windows 上安装 OpenCode AI 编码助理：从踩坑到成功的简单记录

教训：Windows 用户别用这个！直接跳过。

第二尝试：npm 安装（失败，PATH 问题）

官网 docs 提到用 npm：先 npm install -g opencode-ai，报错说错版本，再换 npm install -g opencode-windows-x64。安装成功，但命令还是不认。

我查了 npm prefix 是 C:\nvm4w\nodejs（因为用 nvm-windows 管理 Node），手动加到环境变量，重启终端，还是不行。PowerShell 有 conda 环境干扰，conda deactivate 后试了试，偶尔行，但不稳定。

教训：npm 在 Windows 上全局安装 CLI 工具，PATH 容易出问题，尤其有 nvm 或 Anaconda。折腾了一会，放弃。

第三尝试：官网桌面安装器（失败，程序不兼容弹窗）

去 https://opencode.ai/download 下载 Windows x64 NSIS .exe，双击直接跳出弹窗：'此应用无法在你的电脑上运行'。试了右键'属性'解除阻止、以管理员运行、关 Defender，都不行。系统是标准 x64，架构匹配，但兼容性问题明显。

教训：很多用户反馈一样，别指望安装器。官网 beta 版不稳。

第四尝试：Scoop 包管理器（失败，网络问题）

Scoop 轻量，不需管理员权限。先安装 Scoop：iwr -useb get.scoop.sh | iex，然后 scoop bucket add extras 和 scoop install extras/opencode。结果 bucket add 时报 '无法连接 github.com'，国内网络高峰期卡死。

教训：Scoop 依赖 GitHub，网络不稳就废。晚上试了多次，失败。

第五尝试：GitHub Releases ZIP 便携版（部分成功）

去 https://github.com/anomalyco/opencode/releases 下载 opencode-windows-x64.zip（v1.1.6），解压后双击 opencode.exe，界面启动了！黑底终端，Logo 酷炫，底部提示快捷键。

但这是 portable 版，不是完整 CLI。能用免费模型聊天生成代码，但想在任意终端跑 opencode，不行。测试了 'Hello world' 和 Fibonacci 脚本，基本工作，但响应慢（14s），代码简单无注释。

教训：便携版适合快速试用，但不集成系统。

最终成功：Chocolatey 安装（一次过，推荐）

基于前面的失败，我总结经验：在清晨（网络通畅时段）、以管理员身份运行 PowerShell，跑 choco install opencode。

choco --version choco install opencode

过程：

• 先确认 Chocolatey 已装（如果没，用官网脚本装）。
• 管理员 PowerShell 打开，输入命令。
• 它会问确认脚本运行，我选 'A' (all yes)。
• 下载时要连接外部网络，hash 校验失败自动重下。
• 解压到 C:\ProgramData\chocolatey\lib\opencode\tools，创建 shim。
• 成功消息：

'opencode 1.1.4 has been installed successfully!

Run 'opencode' to start using it.'

跑 opencode --version 输出 1.1.4，opencode 直接启动 CLI 界面（v1.1.4）。整个过程仅 几 分钟，完美！

为什么成功：清晨网络好，避免高峰拥堵；管理员权限确保写文件无问题；Chocolatey 处理了 PATH 和 shim。

提醒：版本是 1.1.4（官网最新 1.1.6），但功能够用。升级用 choco upgrade opencode。

安装总体体验：前几个方式太坑，Chocolatey 靠谱。但官方得优化 Windows 支持。

使用体验：能用，但一般般

安装好后，我在 PowerShell 跑 opencode，界面和 ZIP 版一样：黑底、输入框、模型列表。

测试1：简单问答 输入 'Hello world'，用 Big PickLe 模型，2.8s 回复 'Hello world!'。快，但太基础。

测试2：生成代码 输入 'Create a Python script that prints Fibonacci sequence'，14s 后生成 fibonacci.py：

def fibonacci(n): a, b = 0, 1 for _ in range(n): print(a,) a, b = b, a + b print() if __name__ == "__main__": n = int(input("Enter number of terms: ")) fibonacci(n)

代码正确，能跑，但无错误处理、无注释。运行输出如 n=5：0 1 1 2 3 如果输入负数，直接崩。免费模型就这样，智能一般。

测试3：更复杂任务 试了 'Add error handling and comments'，它改了代码，但响应卡（有时没输出）。换 GLM-4 模型，速度慢点，质量类似。

优点：

• 界面现代，快捷键方便（Tab 换模型、Ctrl+P 命令）。
• 免费模型多，不用 key 就能玩。
• 能直接写文件到当前目录，读项目上下文。

缺点：

• 响应慢（5-15s），复杂任务易出错或不完整。
• 免费模型质量中下，bug 多，不如付费 Claude。
• 缺少自动执行代码或深度分析，远不如 VS Code Copilot。
• 版本 1.1.4 可能有小 bug，更新后或许好点。

总体：★★★☆☆（3 星）。适合简单脚本生成或学习，但真开发用，不如直接 ChatGPT。隐私和开源是亮点，但智能需付费模型提升。

总结与建议

这次安装 OpenCode 让我再次意识到：Windows 用户别盲目相信官网和自媒体的宣传，优先 Chocolatey（管理员 + 清晨）。整个过程踩坑多，但最终 CLI 版稳定，能集成工作流。

建议：

1. 直接用 Chocolatey 安装：管理员 PowerShell，choco install opencode。
2. 保持网络通畅或等清晨。
3. 先试免费模型，满意再加 API key。
4. 如果只想玩玩，下 ZIP 便携版够了。

希望这篇帮到你！如果有问题，评论交流。