OpenCode

212 次浏览 2026年2月6日

第一步:下载Node.js

首先去官网下载最新且稳定的版本。

1.访问官网:打开https://nodejs.org/en

2.版本选择:推荐下载左侧的LTS(Long Term Support)版本。LTS是长期支持版,最稳定,适合工作和生产环境;右侧的Current是尝鲜版,bug相对较多。

第二步:安装步骤(关键配置)

下载好.msi安装包后,双击运行。

1.欢迎界面:点击Next。

2.许可协议:勾选”accept...”,点击Next

3.选择安装路径:

  • 默认路径是C:\Program Files\nodejs\。
  • 点击Next。

4.自定义安装:保持默认即可,直接点击Next。

5.Tools for Native Modules:这个界面不要勾选(除非你需要编译C++模块),否则它会给你自动下载几个G的VS Build Tools和Python,非常慢。直接点击 Next。

6.安装:点击Install,等待进度条走完,点击Finish。

第三步:验证安装

按下win+R键,输入cmd打开命令提示符,分别输入以下命令检查版本:

1 node -v

2 npm -v

第四步:环境配置(核心步骤)

这一步最重要!我们要把npm全局安装的包和缓存文件,也从C盘迁移到我们刚才安装的目录下,方便管理。

1.创建文件夹

打开你的Node.js安装目录(例如C: \Program Files\nodejs),手动新建两个文件夹:

  • node global
  • node cache

2.执行配置命令

在CMD窗口中,依次执行以下两条命令(注意替换成你自己的实际路径)

npm config set prefix "C:\Program Files\nodejs\node_global

npm config set cache "C: \Program Files\nodejs\node_cache

3.配置环境变量

如果不配置这个,以后你用npm instal1-g安装的工具(比如yue,claude-code)都会提示“找不到命令”。

1.在桌面右键“此电脑”->“属性”->“高级系统设置”->“环境变量”。

2.修改[系统变量】中的Path:

  • 找到Path变量,点击“编辑”。
  • 检查是否有默认的C盘npm路径,如果有,删除它。
  • 新建一条,填入你的Node.js安装路径:C:\Program Files\nodejs\。

3.新建/修改[用户变量】中的Path:

1.在[用户变量】里找到Path,点击“编辑”。

2.将默认的c:\Users\用户名\AppData\Roaming\npm修改为:C:\Program Files\nodejs\node_global。

3.如果没有,就新建一条。

4.新建 NODE_PATH变量:

  • 在[系统变量]区域,点击“新建”。
  • 变量名:NODE PATH
  • 变量值: C:\Program Files\nodejs\node_global\node_modules
  • 点击确定保存所有窗口。

第五步:配置国内镜像源(提速)

默认的npm源在国外,下载速度很慢。我们配置淘宝最新的镜像源。

在 CMD中输入:

npm config set registry https://registry.npmmirror.com

验证是否配置成功:

npm config get registry

第六步:修改文件夹权限

1.打开文件资源管理器,找到您的安装目录:C:\Program Files。

2.右键点击nodejs文件夹,选择“属性”(Properties)。

3.点击顶部的“安全”(Security)选项卡。

4.点击中间的“编辑”(Edit)按钮。

5.在“组或用户名”列表中,选中Users(也就是普通用户组)。

6.在下方的“Users的权限”里,勾选“完全控制"(Full control)这一行的“允许”框。

7.点击“确定”,再点击“确定”。

第七步:最终测试

为了确保一切配置完美,我们试着安装一个常用的全局模块(比如express或vue)。

输入命令:

npm install express -g

安装完成后,去你的C:\Program Files\nodejs\node_global\node_modules 目录下看看,如

果看到了express文件夹,说明所有配置大功告成!


第八步:下载与安装 OpenCode

在终端(CMD)里输入这行神级命令:

npm i -g opencode-ai@latest

解释一下:

  • -g表示全局安装,装完后你在电脑任何地方都能用。
  • @1atest确保你装的是最新版本,功能最全。

然后我们可以直接输入命令启动:

opencode

第九步:注意!!关键时刻来了!

第一次启动时,它通常会让你登录或者输入APIKey,可以根据用户激活手册中的步骤,获取自己的API。

1、找到配置文件路径

配置文件位于你电脑的以下位置:c:\Users\你的用户名\.config\opencode \opencode.json

(例如:如果是管理员账户,路径就是

C: \Users \Administrator\.config\opencode \opencode.json)

如何快速打开?(保姆级操作)

1.如果“找不到文件”:说明你还没有这个文件夹。请手动进入c:\Users\你的用户名,新建一个名为.config的文件夹,再在里面建一个opencode文件夹。

2.在该文件夹下,右键新建一个文本文件,重命名为opencode.json。

2、写入专属配置

用记事本或VS Code打开刚才创建的opencode.json,清空里面所有内容,然后将下面的代码完整复制进去。

{

 "$schema": "https://opencode.ai/config.json",

 "provider": {

  "api0Ki": {

   "npm": "@ai-sdk/openai-compatible", 

   "options": {

    "baseURL": "https://api.0ki.cn/api/coding/paas/v4",

    "apiKey": "在这里填入你在后台获取的令牌"

   },

   "models": {

    "GLM-4.7": {

     "name": "zhipu-0ki/GLM-4.7",

     "limit": {

      "context": 200000,

      "output": 64000

     }

    }

   }

  }

 }

}

3、获取“满血版”API密钥

万事俱备,只欠东风。OpenCode的引擎已经装好了,现在我们需要给它加满“燃料”一-APIKey。请根据用户激活手册中的步骤获取你的API。

动作:回到我们在第二步创建的opencode.json文件,找到"apiKey”:把你刚才复制的oki-....密钥粘贴进去,并保存文件(Ctrl+S)。

至此,所有配置全部完成!

第十步:配置全部完成后,我们不需要打开笨重的IDE,直接在轻量级的CMD命令行里就能唤醒这个AI助手。

1、打开命令提示符(CMD)

1.按下键盘上的win+R键。

2.输入cmd并回车。

3.(可选操作)如果你想让AI帮你处理某个具体项目的代码,可以使用cd命令进入该文件夹,例如:

  • d:
  • cd D:\Program Files\Tencent

2、启动OpenCode在黑色的命令行窗口中,直接输入启动指令:

  • opencode

3、切换到okiAPI专属通道(关键!)启动后,你会看到OpenCode 的欢迎界面。默认模型可能不是最强的,我们需要手动切换到okiAPI的通道。

在光标闪烁处输入斜杠命令,输入后需要回车键:/models

此时会出现一个交互式选择列表,请使用键盘上下键(1)移动高亮条,找到我们刚才配置的:

(zhipu-0ki/GLM-4.7 api0Ki),按回车键确认选择。

验证成功:当你看到提示模型已切换为zhipu-0ki/GLM-4.7 api0Ki,说明配置完全生效!现在你已经接通了okiAPI的高速中转服务。

4、极速对话测试现在,感受一下在命令行里对话。

输入测试指令:你好

观察效果:你会发现得益于okiAPI的线路优化,文字生成的流畅度极高。


结语:

现在,你已经拥有一套完全独立、可随身携带(任意终端可用)、且性能拉满的AI编程环境。不再受制于IDE,不再受制于网络。只要有终端,有okiAPI的Key,你就是效率最高的开发者。

返回文档列表