learn-opencode 安装教程：5 分钟装好 OpenCode 终端 AI 编程助手，附 3 种备用方案与故障排查

文档教程【免费下载链接】learn-opencodeOpenCode 中文实战课源码与内容仓库一课一页覆盖入门到实战工作流。项目地址https://gitcode.com/gh_mirrors/le/learn-opencode点击查看免费下载OpenCode 是一款运行在终端里的 AI 编程助手而 learn-opencode 正是它的中文实战课仓库。这篇 OpenCode 安装教程带你 5 分钟完成安装一条命令搞定 macOS/LinuxWindows 用 Scoop 免管理员安装最后还附上 3 种备用安装方案与常见故障排查新手照着做零门槛上手。 OpenCode 是什么1 分钟认知OpenCode 不是 IDE而是终端原生TUI的 AI 编程助手你说一句需求它读懂项目、修改代码、执行命令。适合习惯终端的程序员、想整理文件的创作者和普通用户。想更系统地了解它可以看课程第一课 docs/1-start/01-intro.md。 5 分钟安装macOS / Linux 一键命令macOS 和 Linux 用户只需三步运行安装命令 → 重启终端 → 验证安装。第 1 步把下面这行命令粘贴到终端按回车curl -fsSL https://opencode.ai/install | bash第 2 步关闭整个终端窗口并重新打开让 PATH 生效。第 3 步输入opencode --version能看到版本号就成功了。安装脚本默认装到~/.opencode/bin/opencode无需任何管理员权限。详细步骤见 docs/1-start/02-install.md。 Windows 最快安装Scoop 免管理员方案Windows 推荐Scoop普通用户权限即可。已有 Scoop 的同学一条命令即可scoop install opencode没装过 Scoop在 PowerShell 里按顺序执行三条命令先设置执行策略Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser再运行Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression安装 Scoop最后scoop install opencode。⚠️ 如果 PowerShell 是以管理员身份运行的安装 Scoop 要改用iex {$(irm get.scoop.sh)} -RunAsAdmin。 3 种备用安装方案网络不佳/公司电脑适用官方脚本超时或者公司电脑有安装限制下面 3 种备选方案任选其一方案适用场景命令① npm 安装已有 Node.js 18可用国内镜像npm install -g opencode-ai② Homebrew 安装macOS 用户brew 有国内镜像brew install anomalyco/tap/opencode③ Docker 尝鲜不想装在系统里隔离试用docker run -it --rm ghcr.io/anomalyco/opencode怎么选网络问题优先选 ①npm 国内镜像快macOS 老用户选 ②只想体验不想污染系统选 ③注意 Docker 里默认只能访问容器内文件。完整说明见 docs/1-start/02a-install-alternatives.md。✅ 验证安装是否成功无论用哪种方式安装最后都要验证opencode --version能输出opencode x.x.x即安装成功。检查点如下能看到版本号没有报command not found错误两项全过就可以进入下一步配置网络与连接模型了详见 docs/1-start/04-connect.md。 故障排查4 个高频问题一次解决遇到问题别慌对照下表排查覆盖率 90% 的翻车场景症状原因解决办法command not found没重启终端 / PATH 未配置关掉整个终端窗口重开仍不行则把~/.opencode/bin加入 PATH下载超时 /ETIMEDOUT网络到安装源不畅换 npm 或 Homebrew 备用方案安装rate limit exceededGitHub API 匿名限流等一小时重试或换备用安装方式Windows 报Running scripts is disabled执行策略限制运行一次Set-ExecutionPolicy RemoteSigned -Scope CurrentUsermacOS 桌面应用提示无法验证开发者执行一次xattr -cr /Applications/OpenCode.app即可解除。完整的逐条排查步骤在 docs/1-start/02b-install-troubleshoot.md。 装好了马上玩起来免费模型零配置启动opencode输入/models选一个带-free后缀的模型如opencode/glm-4.7-free发送任意消息即可开始对话——无需注册、无需 API Key。免费模型清单见 docs/1-start/04a-free-models.md。 延伸阅读课程总览与阶段目标docs/1-start/index.md安装主课docs/1-start/02-install.md仓库说明README.md装好 OpenCode 只是第一步。跟着 learn-opencode 实战课一路走下去30 分钟内你就能完成第一次 AI 对话开始你的终端 AI 编程之旅 赞分享文档教程【免费下载链接】learn-opencodeOpenCode 中文实战课源码与内容仓库一课一页覆盖入门到实战工作流。项目地址https://gitcode.com/gh_mirrors/le/learn-opencode点击查看免费下载相关推荐OpenCode终极指南5分钟快速安装终端AI编程助手OpenCode终极指南5分钟快速安装终端AI编程助手 还在为复杂的AI编程工具配置而头疼OpenCode作为一款专为终端设计的开源AI编程助手让您5分钟人工智能AI 应用AI Agent代码智能体CLI开发者工具OpenCode安装教程5分钟快速上手终端AI编程OpenCode安装教程5分钟快速上手终端AI编程 还在为复杂的AI编程工具配置而头疼想要一个开箱即用、专为终端设计的AI编程助手吗OpenCode正是你人工智能AI 应用AI Agent代码智能体CLI开发者工具3分钟搞定OpenCode终端AI编程助手极速安装指南3分钟搞定OpenCode终端AI编程助手极速安装指南 还在为复杂的AI编程工具配置而头疼OpenCode这款开源终端AI编程助手让你在macOS或Lin人工智能AI 应用AI Agent代码智能体CLI开发者工具创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考