OpenCode CLI 安装教程

一、安装Node.JS

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

image

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

image

   安装 Node.js 时一直默认安装即可(内存紧张可以将 Node.js 安装路径改到D盘或者其他非C盘路径)。安装后推荐重启一下电脑,确保 Node.js 的安装全部生效。

Node.js官网:Node.js — 在任何地方运行 JavaScript

二、安装OpenCode CLI

   安装 OpenCode CLI 之前可以先在 cmd 中使用 npm -vnode -v 指令查一下 node.js 是否正确安装并且 PATH 是否配置正常,一切正常会显示以下内容。

image

   使用 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 查看是否修改成功。成功会变成image,此时再执行 npm i -g opencode-ai 指令,opencode cli 就会安装在重新设置的路径中。

  opencode cli 安装好后,打开cmd,输入 opencode 指令打开 opencode。

image

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

image

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

image

三、接入外部模型

   进入 opencode cli 界面后,ctrl+p 进入命令界面,

image

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

image

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

image

   输入自己创建的API key,

image

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

imageimage

   当使用过某一模型后,模型会显示在“Recent”下。

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

posted @ 2026-08-14 22:46  。叁焑港  阅读(78)  评论(0)    收藏  举报