文章目录1. 什么是OpenCode1.1 OpenCode的官网1.2 OpenCode的GitHub地址2. OpenCode和ClaudeCode有什么区别2.1 开源性与生态2.2 模型提供商支持3. 安装OpenCode3.1 下载Node.js3.1.1 通过安装包安装Node.js适合新手3.1.2 通过NVM安装Node.js适合开发人员3.2 下载OpenCode3.2.1 使用cmd下载3.2.2 使用powershell下载3.3 验证OpenCode是否成功安装3.4 使用powershell下载OpenCode时可能遇到的问题3.4.1 问题一npm : 无法加载文件 D:\Nvm\nodejs\npm.ps1因为在此系统上禁止运行脚本。3.4.2 问题二opencode : 无法加载文件 D:\Nvm\nodejs\opencode.ps1因为在此系统上禁止运行脚本。3.4.3 两个问题产生的原因Windows本身的安全防护机制与npm/Node.js 无关3.4.4 解决方法以普通用户身份修改PowerShell的执行策略3.5 更新OpenCode4. 如何在OpenCode中切换模型5. 如何在OpenCode中连接模型提供商5.1 连接第三方模型提供商以阿里云为例5.1.1 在阿里云百炼创建Api Key5.1.2 在阿里云百炼中查看模型用量5.2 连接本地部署的大模型以LM Studio为例5.2.1 在OpenCode中连接通过LM Studio部署的大模型5.2.2 解决本地部署的多模态大模型无法识别图片的问题5.3 OpenCode提供的免费模型5.3.1 查看OpenCode提供的免费模型5.3.2 在OpenCode中使用免费模型6. OpenCode内置的两个AgentBuild和Plan有什么区别6.1 两个Agent的核心定位与视角6.2 两个Agent在工作方式上的区别6.3 两个Agent的使用流程与最佳实践7. OpenCode中的常用指令7.1 /compact压缩上下文7.2 /connect连接模型提供商7.3 /export导出对话7.4 /fork创建对话分支7.5 /init初始化项目7.6 /models查看/切换模型7.7 /new新建会话7.8 /sessions会话管理7.9 /share分享会话7.10 /themes更换主题7.11 explore探索模式 文件引用8. 参考视频1. 什么是OpenCodeOpenCode 是一款开源的、在终端中运行的 AI 编程智能体OpenCode 本质上是一个强大的“模型调度层”不绑定特定 AI支持接入 GPT、DeepSeek 等 75 种模型1.1 OpenCode的官网OpenCode 的官网https://opencode.ai/https://opencode.ai/1.2 OpenCode的GitHub地址OpenCode 的 GitHub 地址https://github.com/anomalyco/opencodehttps://github.com/anomalyco/opencode如果无法正常访问 GitHub可以参考我的另一篇博文GitHub的使用技巧加速访问GitHub、查看GitHub的热门项目、查看GitHub推荐的项目、Fork、Issue、快速找到项目的安装包、GitHub的各种快捷键2. OpenCode和ClaudeCode有什么区别2.1 开源性与生态OpenCode100%开源MIT许可证代码完全透明可审计400 贡献者持续维护。作为一个开源项目它由社区驱动任何人都可以查看、修改和分发其代码Claude Code商业闭源产品由 Anthropic 官方开发维护。Anthropic 对其拥有完全的控制权从底层模型优化到上层功能实现都经过精心打磨以确保稳定、流畅的用户体验2.2 模型提供商支持OpenCode支持 75 模型提供商Claude、GPT、Gemini、智谱AI、DeepSeek等可以自由切换模型提供商甚至可以使用本地模型(Ollama)Claude CodeClaude Code原生仅支持 Anthropic 的 Claude 系列模型通过配置可扩展支持 75 模型提供商包括国产大模型和 GPT 系列3. 安装OpenCode3.1 下载Node.js3.1.1 通过安装包安装Node.js适合新手下载地址https://nodejs.org/zh-cn/downloadhttps://nodejs.org/zh-cn/download在下拉列表中选择最新的长期支持的版本带有 LTS 后缀的版本后点击左下角的Windows 安装程序(.msi)按钮开始下载下载完成后双击node-v24.13.0-x64.msi文件一路点击 Next 就可以了更改安装路径后点击 Next 按钮3.1.2 通过NVM安装Node.js适合开发人员参考我的另一篇博文Windows环境使用NVM高效管理多个Node.js版本NVM的完整安装流程、NVM相关配置、NVM的常用命令、使用NVM时可能遇到的问题、NVM管理多个Node.js版本的原理3.2 下载OpenCode3.2.1 使用cmd下载按下Win R快捷键输入cmd打开终端在终端中输入 npm i -g opencode-ai 指令下载 OpenCodenpmi-gopencode-ai3.2.2 使用powershell下载按下 win x 快捷键接着按下 I 键打开 powershell 窗口也可以按下 A 键以管理员的身份打开 powershell 窗口3.3 验证OpenCode是否成功安装在终端中输入opencode指令opencode如果能看到以下指令说明 OpenCode 安装成功了我们简单地跟 OpenCode 聊个天3.4 使用powershell下载OpenCode时可能遇到的问题3.4.1 问题一npm : 无法加载文件 D:\Nvm\nodejs\npm.ps1因为在此系统上禁止运行脚本。PS C:\Users\NieKeYi npm i -g opencode-ainpm : 无法加载文件 D:\Nvm\nodejs\npm.ps1因为在此系统上禁止运行脚本。有关详细信息请参阅 https:/go.microsoft.com/fwlink/?LinkID135170 中的 about_Execution_Policies。3.4.2 问题二opencode : 无法加载文件 D:\Nvm\nodejs\opencode.ps1因为在此系统上禁止运行脚本。opencode : 无法加载文件 D:\Nvm\nodejs\opencode.ps1因为在此系统上禁止运行脚本。有关详细信息请参阅 https:/go.microsoft.com/fwlink/?LinkID135170 中的 about_Execution_Policies。3.4.3 两个问题产生的原因Windows本身的安全防护机制与npm/Node.js 无关PowerShell 默认执行策略为Restricted会主动拦截所有.ps1脚本包括 Node.js 生成的npm.ps1属于 Windows 本身的安全防护机制与 npm/Node.js 无关3.4.4 解决方法以普通用户身份修改PowerShell的执行策略复制以下指令粘贴到 PowerShell 中执行Set-ExecutionPolicyRemoteSigned-Scope CurrentUser-ForceRemoteSigned允许运行本地脚本如 npm.ps1仅要求网络下载脚本需签名-Scope CurrentUser仅影响当前用户安全无风险-Force跳过确认提示避免卡在 Y/N 选择执行完Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force指令后我们验证指令是否生效Get-ExecutionPolicy-Scope CurrentUser再次输入与 npm 有关的指令npm-v3.5 更新OpenCode更新 OpenCode 前最好先关闭正在运行的 OpenCode 实例按下Win R快捷键输入cmd打开终端在终端中输入 npm update -g opencode-ai 指令更新 OpenCodenpmupdate-gopencode-ai4. 如何在OpenCode中切换模型在 OpenCode 中输入 /models 指令后按下回车/models使用键盘上的 ↑、↓、←、→ 键选取模型选择完成后按下回车也可以使用鼠标选取模型如果模型右边带有 Free 关键字说明该模型有一定的免费额度我们可以薅一波羊毛最近刚出的小米大模型也可以白嫖5. 如何在OpenCode中连接模型提供商5.1 连接第三方模型提供商以阿里云为例我们以阿里云为例演示如何连接第三方模型提供商5.1.1 在阿里云百炼创建Api Key阿里云提供了 Coding Plan 套餐如果需要长期使用建议购买 Coding Plan 套餐Coding Planhttps://bailian.console.aliyun.com/cn-beijing/?tabcoding-plan#/efm/coding-plan-index首先我们打开阿里云百炼的模型广场https://bailian.console.aliyun.com/cn-beijing/?tabmodel#/model-markethttps://bailian.console.aliyun.com/cn-beijing/?tabmodel#/model-market点击左下角的API Key选项创建一个 API Key填入描述后点击确定按钮在 OpenCode 中输入 /connect 指令在输入框中搜索 Alibaba 关键字选择 Alibaba (China) 选项把刚才创建好的 API Key 粘贴到输入框内按下回车键输入 API Key 后会弹出模型列表让你选择在输入框中可以搜索模型选择好模型后就可以正常开始对话了5.1.2 在阿里云百炼中查看模型用量阿里云百炼开通后 90 天内会赠送一定的免费额度在模型用量中可以看到每个模型的免费额度剩余量主流的国产模型qwen3.6-plus、glm-5.1、kimi-k2.5都有一百万的免费额度我们可以选择免费额度用完即停只要买过一次包月或者包季下一次买任何一个套餐将不会有折扣所以首次购买可以选择优惠力度比较大的且量大的套餐如果使用量比较大建议购买 Coding Plan 套餐在可以模型差距不大的情况下哪个云厂商的 Coding Plan 便宜就买哪个如果是首次购买还可以享受优惠https://www.aliyun.com/benefit/scene/ai-discounthttps://www.aliyun.com/benefit/scene/ai-discount首次包季低至 4.5 折非广模型调用计费规则模型调用计费https://bailian.console.aliyun.com/cn-beijing/?tabdoc#/doc/?typemodelurl29871485.2 连接本地部署的大模型以LM Studio为例5.2.1 在OpenCode中连接通过LM Studio部署的大模型首先我们在 LM Studio 内查看模型的 ID 值点击按钮可以复制接着在C:\Users\NieKeYi\.config\opencode目录其中 NieKeYi 改成你的用户名下找到 opencode.json 文件如果没有就手动创建一个C:\Users\NieKeYi\.config\opencode在 opencode.json 文件中添加以下内容将 qwen/qwen3.5-9b 改成LM Studio 中模型的 ID 值{$schema:https://opencode.ai/config.json,provider:{lmstudio:{npm:ai-sdk/openai-compatible,name:LM Studio,options:{baseURL:http://localhost:1234/v1},models:{qwen/qwen3.5-9b:{name:qwen/qwen3.5-9b}}}}}保存 opencode.json 文件需要重启 OpenCode 才能生效重启 OpenCode 后输入 /connect 指令找到 LM Studio 分组输入 API Key 后按下回车如果没有 LM Studio 没有设置 API Key 的话输入一个空格后按下回车选择我们在 LM Studio 中部署的模型5.2.2 解决本地部署的多模态大模型无法识别图片的问题多模态大模型可以理解为能够直接识图的大模型无需借助 OCR 工具例如 qwen3.5 模型目前 OpenCode 尚不支持直接粘贴图片到聊天框只能将图片文件拖拽到聊天窗口发送图片给本地部署的多模态大模型时大模型会说无法直接处理图片通常不是因为模型本身不支持而是 OpenCode 的配置文件中没有明确说明“这个模型可以处理图片”即使使用的本地模型如 Qwen3.5具备多模态能力OpenCode 默认也可能只把它当作一个纯文本模型来使用我们需要通过配置来“解锁”多模态大模型的图像识别功能我们在 opencode.json 文件中添加以下配置“解锁”多模态大模型的图像识别功能modalities:{input:[text,image],output:[text]}{$schema:https://opencode.ai/config.json,provider:{lmstudio:{npm:ai-sdk/openai-compatible,name:LM Studio,options:{baseURL:http://localhost:1234/v1},models:{qwen/qwen3.5-9b:{name:qwen/qwen3.5-9b,modalities:{input:[text,image],output:[text]}}}}}保存 opencode.json 文件后重启 OpenCode发送图片给 OpenCode 测试发现模型已经能够正常处理图片了我们在 LM Studio 中的控制台中可以看到图片是以 Base64 的方式传输的5.3 OpenCode提供的免费模型使用 OpenCode 提供的免费模型时偶尔会出现发送消息后迟迟不回复的情况大概率是因为“薅羊毛”的人太多导致算力资源供不应求请求只能在后台排队处理5.3.1 查看OpenCode提供的免费模型一些模型刚发布时OpenCode 会限时免费提供例如之前小米发布的 MiMo V2 Pro 模型在 OpenCode 的官网可以查看 OpenCode 提供哪些免费模型https://opencode.ai/docs/zh-cn/zenhttps://opencode.ai/docs/zh-cn/zen值得注意的是如果使用免费的模型你的数据是有可能会被模型提供商收集用来改进模型的说白了就是你免费用它的模型它免费用你的数据具体可以参考 OpenCode 官网隐私https://opencode.ai/docs/zh-cn/zen#%E9%9A%90%E7%A7%815.3.2 在OpenCode中使用免费模型OpenCode 提供了一个名为OpenCode Zen的精选模型列表列表里的模型可以免费使用因为是免费模型所以我们无需获取 API Key输入空格后按下回车就可以了我们选择刚出的小米大模型社区反馈 Big Pickle 模型的效果不错可以试一下6. OpenCode内置的两个AgentBuild和Plan有什么区别OpenCode 内置内置了 Build 和 Plan 两个 Agent按下 Tab 键可以切换6.1 两个Agent的核心定位与视角特性Plan Agent规划模式Build Agent构建模式角色定位架构师视角工程师视角主要功能项目结构设计、技术选型建议、任务拆解等宏观规划代码补全、函数生成、语法修复等即时操作权限级别只读Agent拒绝文件编辑全权限Agent可直接修改文件6.2 两个Agent在工作方式上的区别方面Plan AgentBuild Agent输出形式生成自然语言形式的实施计划和设计文档生成实际代码并执行文件修改操作权限默认拒绝文件编辑运行bash命令前会请求权限可直接执行文件修改和终端命令适用场景探索陌生代码库、规划变更、分析依赖关系日常开发工作、代码生成与修改安全级别高只读模式中全权限模式6.3 两个Agent的使用流程与最佳实践OpenCode 推荐的标准化操作路径启动与规划在终端输入需求后默认进入Plan模式AI分析代码库并提出修改建议模式切换确认计划无误后按下Tab键或输入/build将上下文切换至执行状态代码落地AI 开始生成 Diff 并写入文件根据社区测试数据采用先Plan后Build策略的复杂重构任务代码一次性通过率提升了约40%7. OpenCode中的常用指令7.1 /compact压缩上下文对话内容过多时压缩上下文7.2 /connect连接模型提供商切换 API 提供商配置模型连接7.3 /export导出对话导出对话记录导出的文件默认会存放在当前用户的家目录下例如 C:\Users\NieKeYi 目录7.4 /fork创建对话分支复制当前对话上下文创建一个独立的分支在不影响原对话的情况下尝试新的思路或修改7.5 /init初始化项目在项目根目录创建 AGENTS.md 文件分析项目结构7.6 /models查看/切换模型查看可用模型列表并切换当前使用的模型7.7 /new新建会话创建新的对话会话7.8 /sessions会话管理查看并切换历史会话7.9 /share分享会话生成分享链接7.10 /themes更换主题更换 OpenCode 的界面主题7.11 explore探索模式 文件引用explore调用探索型子代理适合快速理解陌生仓库结构、查找相关代码模块或搜索特定关键词侧重于侦察而非修改文件引用先输入explore指令再输入符号引用特定文件或文件夹进入上下文让 AI 精准关注指定代码内容选中 explore 后删除聊天框的 explore 内容再次输入 就能引用文件或文件夹了删除聊天框的 explore 内容再次输入 就能引用文件或文件夹了8. 参考视频OpenCode 是近期热度最高的AI编程工具。 它的最大优势是有开箱即用的免费模型通过简单配置还能免费接入Gemini3 ProClaude 4.5 Opus等顶级编程模型。OpenCode 可以看作是一个开源版的Claude Code几乎具备Claude Code一切功能。非常适合小白上手AI编程可以随便造随便玩可以用它练习 Agent SkillsMCPSubagnet 等高级特性。 本期视频是一个OpenCode的完整教程。第7集 | opencode 里面的 big pickle 模型是哪一家的效果还不错仅次于这个 GPT5 nano可以作为一个备份优于 MINIMax M2.5第9集 | AI 编程还能开源无限制opencode 封神 它是 100% 开源的 AI 编码代理支持 Claude、OpenAI 等多模型终端和桌面端都能用#GitHub #github优质项目 #程序员 #ai #青年创作者成长计划OpenCode保姆级教程第2期白嫖Claude模型 上期根据文档手把手带大家安装了OpenCode相信很多朋友已经感受到了它的强大本期是opencode的第二期主要带你完成三件事1. 免费接入最强编程模型Gemini 3 pro 与Claude 4.5 opus; 2.教你安装Skills与MCP; 3.安装超级增强插件 oh-my-opencode