【笔记】Windows 上安装 OpenCode AI 编码助理：从踩坑到成功的简单记录
Windows 上安装 OpenCode AI 编码助理：从踩坑到成功的简单记录
日期：2026 年 1 月 9 日
作者：AITechLab
大家好，我是 AITechLab。
最近在网上看到 OpenCode 这个开源 AI 编码助理（官网：https://opencode.ai/），它声称可以帮助开发者在终端或桌面模式下用 AI 写代码、调试项目，支持 75 多种模型，包括免费的开源模型，还强调隐私保护（不上传代码）。
OpenCode |开源AI编码代理
介绍及操作文档 |OpenCode
桌面版 | 版本 v1.1.6 ·Anomalyco/OpenCode
作为 Windows 用户，我决定试试看，结果安装过程各种曲折，花了好长时间才搞定。
使用下来，感觉中规中矩，没宣传那么神。
以下是我的完整记录，目的是分享经验，避免大家重复踩坑。
整个过程我总结了两个关键点：一是用管理员身份运行终端安装，二是网络一定要通畅。建议避开网络高峰期，在清晨操作，能大大提高成功率。
本博客会简单直白，重点说事实。
OpenCode 是什么，为什么想试
OpenCode 是由 Anomaly Co. 开发的开源工具，GitHub 上有 50k+ 星。它像一个 AI 助手，能在命令行或专用窗口里聊天，让模型帮你生成代码、解释 bug 或管理项目。核心看点：
- 支持 Claude、GPT、Gemini 等大模型，也兼容本地模型。
- 有免费模型直接用（如 Big PickLe、GLM-4 等）。
- 多模式：CLI（命令行）、桌面 app、IDE 扩展。
- 强调开源、隐私（本地运行，不存代码）。
我为什么想试？因为我常写 Python 脚本和简单项目，希望有个免费工具能快速生成 boilerplate 代码或调试。官网说安装简单，一键 curl 脚本就行，但事实证明，对 Windows 用户来说远没那么容易。接下来详说安装过程。
安装过程：坑多，但有解决办法
Windows 安装 OpenCode 真是个大坑。官方文档偏向 Linux/macOS，也有 Windows 指南，但实际支持明显不足。
我试了多种方式，前几个都失败了，最后用 Chocolatey 在清晨管理员模式下一次成功。
以下按时间顺序记录。
第一尝试：官方 curl 脚本（失败，假成功）
官网首页推荐：curl -fsSL https://opencode.ai/install | bash。我在 cmd（带 Clink）里跑，进度条到 100%，还显示欢迎界面和 “Successfully added opencode to $PATH”。但一跑 opencode --version，直接 “command not found”。
原因分析：脚本是为 Linux 写的，会用 Podman 容器（Windows 不兼容），报 “permission denied” 和路径错误。它把 PATH 加到 ~/.bashrc，Windows 根本不认。这让我以为成功了，其实啥都没装。浪费了 30 分钟。
教训：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 版稳定，能集成工作流。
建议：
- 直接用 Chocolatey 安装：管理员 PowerShell，choco install opencode。
- 保持网络通畅或等清晨。
- 先试免费模型，满意再加 API key。
- 如果只想玩玩，下 ZIP 便携版够了。
希望这篇帮到你！如果有问题，评论交流。
