OpenCode CLI 安装教程
一、安装Node.JS
如果通过 npm 安装 OpenCode CLI,需要先安装 Node.js。首先是进入 Node.js 官网,点击“获取 Node.js®”按钮。

然后点击“Windows 安装程序(.msi)”按钮,下载后进行安装,

安装 Node.js 时一直默认安装即可(内存紧张可以将 Node.js 安装路径改到D盘或者其他非C盘路径)。安装后推荐重启一下电脑,确保 Node.js 的安装全部生效。
Node.js官网:Node.js — 在任何地方运行 JavaScript
二、安装OpenCode CLI
安装 OpenCode CLI 之前可以先在 cmd 中使用 npm -v 和 node -v 指令查一下 node.js 是否正确安装并且 PATH 是否配置正常,一切正常会显示以下内容。

使用 opencode 官网给的安装指令 npm i -g opencode-ai 安装 opencode cli 即可。
当前 npm 的 global prefix 默认是在C盘的,所以直接执行 npm i -g opencode-ai 也会默认安装在C盘中(不确定可以使用 npm config get prefix 获取当前路径),如果想要将 opencode cli 安装在D盘(其他非C盘与此步骤一致),就需要先修改 npm 的 global prefix 路径。首先在D盘创建 D:\NodeJS\npm-global ,不推荐使用带空格或其他非法字符命名的路径,然后使用 npm config set prefix "D:\NodeJS\npm-global" 指令将 npm 的 global prefix 路径修改为 D:\NodeJS\npm-global。修改 global prefix 后一定要将这个路径手动加入到Windows系统环境变量PATH中,否则执行 opencode 指令会提示“opencode 不是内部命令”。最后再用 npm config get prefix 查看是否修改成功。成功会变成
,此时再执行 npm i -g opencode-ai 指令,opencode cli 就会安装在重新设置的路径中。
opencode cli 安装好后,打开cmd,输入 opencode 指令打开 opencode。

也可以使用 powershell 打开,但是需要修改一下 powershell 的用户执行策略,否则输入 opencode 指令,powershell 无法执行这条指令。先使用 Get-ExecutionPolicy 指令查看当前的策略,会显示 Restricted,此时就需要使用 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser 指令修改此策略为 RemoteSigned。再用 Get-ExecutionPolicy 指令查询策略是否被修改,修改成功会显示

接着直接使用 opencode 指令就可以在 powershell 中打开 opencode cli 了。

三、接入外部模型
进入 opencode cli 界面后,ctrl+p 进入命令界面,

点击“Switch model”也可以使用 ctrl+x m 快捷键直接进入到 Select model,需要注意,这里的原始模型均是 opencode 自带一定免费额度的模型。若要外部接入自己的模型,可以使用鼠标点击“Connect provider”或者使用快捷键 ctrl+a 进入,

先搜索你要外接模型的厂商名称,我这里以 DeepSeek 为例,然后选中 Providers 中的 DeepSeek,

输入自己创建的API key,

输入后使用快捷键 crtl+x m 进入模型选择页面,会发现额外出现 DeepSeek 厂商,下面附带的就是对应厂商可选用的模型,


当使用过某一模型后,模型会显示在“Recent”下。
以上步骤完成后,你就可以使用 opencode cli 进行项目的开发了。当然,这些只是最基本的内容,想要 opencode cli 搭载你自己的模型在项目中真正的好用还要配合项目中的 sub-agent、安装的插件等等对执行内容进行约束、优化和制定执行规则。

本文是 Windows 平台下 OpenCode CLI 的完整实操安装配置教程。首先讲解 Node.js 环境的下载与安装,可自定义安装路径规避 C 盘空间不足问题,安装完成后校验 node、npm 版本确认环境变量生效;接着使用 npm 全局命令安装 OpenCode CLI,详细介绍修改 npm global prefix 全局路径,把工具安装到 D 盘等非系统盘的操作方案,同时解决 PowerShell 执行策略限制导致指令无法运行的问题。进入 OpenCode CLI 交互界面后,以 DeepSeek 模型作为示例,讲解通过命令面板、快捷键调用 Connect provider,填入个人 API Key 接入外部大模型的完整步骤,接入成功后即可切换使用自己的外部模型进行项目开发。
浙公网安备 33010602011771号