AI 助理
文档备案控制台
开发者社区 开发与运维 文章 正文

Windows下载安装OpenCode教程（桌面版和命令行安装，如何配置模型，如何彻底卸载OpenCode）

2026-08-24 2242
版权
版权声明：
本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写 侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
简介： 本文详细介绍了OpenCode的完整安装与配置流程：先安装Node.js（必备运行环境），再选择桌面版（图形界面，新手友好）或CLI版（命令行，适合开发者）安装OpenCode；重点讲解了通过配置文件或GUI页面添加自定义AI模型提供商（如Chirou、Chiji）及模型参数；最后涵盖卸载方法与常见问题处理。

1 安装 Node.js

官网地址：https://nodejs.org/zh-cn

为什么要先安装 Node.js 呢？

OpenCode 是一个使用 JavaScript/TypeScript 开发的工具，它的运行环境依赖于 Node.js。Node.js 提供了 JavaScript 的运行时环境，使得 OpenCode 能够在服务器端或命令行中执行

第一步：获取 Node.js

image-20260822224939951

第二步：下载 Windows 安装程序（.msi）

image-20260822225047870

下载完之后，本地就有一个 .msi 文件

image-20260822225256551

第三步：双击，选择 Next

image-20260822225603150

第四步：勾选 "同意"，选择 Next

image-20260822225714037

第五步：选择安装目录

image-20260822225738655

默认是 C 盘，点击 Change 就能切换到其他盘，我一般都安装在 D 盘

image-20260822225938593

第六步：还是 Next

image-20260822230036592

第七步：不用勾选，直接 Next

image-20260822230113169

第八步：完成

image-20260822230147926

然后才真正开始安装

image-20260822230215237

第九步：这个 Finish 才是真正的完成

image-20260822230301603

第十步：验证

直接 win + R，输入 CMD

image-20260822230341839

查看 node 的版本号

node -v

输入 node -v 查看版本号，如果能打印出版本号，说明安装成功了

image-20260822230503022

2 安装 openCode

2.1 安装方式介绍

Windows 安装 OpenCode 主要有 2 种方式，一种是 命令行（ CLI ），一种是 桌面（desktop）

什么意思呢？

通过命令行的方式安装，最后就是下面的效果，只能通过黑框框跟 AI 交互，要配置什么东西只能通过输入命令，对新手、非程序员非常不友好

image-20260823031258708

桌面版就容易理解了，安装好之后通过页面上与 AI 交互，通过点击页面上的按钮就能配置，对新手、非程序员非常友好

image-20260823031446238

两者的区别就好比：

  • 命令行：输入命令才能打开微信，想看朋友圈，输入命令才能看
  • 桌面版：使用安装包安装了微信，直接双击就能打开微信，点一下朋友圈，就能直接看，而不用输入命令，交互方式要友好很多

具体怎么安装呢？

2.2 桌面版安装

OpenCode 官网地址：https://opencode.ai

下载

image-20260822231205419

下载 Windows 桌面版

image-20260822231344977

下载完之后就有一个 OpenCode Desktop Installer.exe 文件，120 M

双击文件

image-20260822233218349

然后等个 10s 昨天就会自动安装好，自动弹出对话框，不需要一直点击 Next ，默认是直接安装在 C 盘的

image-20260822233412536

此时什么都不用配置，直接跟它对话，是能生成回答的，因为默认有免费的模型

image-20260822233534772

到此，opencode 就已经安装好了，但是还远没有结束

2.3 命令行（CLI）下载安装

我把 opencode 卸载了，现在重新使用命令行的方式安装

opencode 官网：https://opencode.ai/

官方文档中已经给出了安装需要输入的命令

image-20260823032217068

下面演示一下，电脑上按 Win + R ，在弹框中输入 cmd

image-20260823032305390

然后输入 opencode 的安装命令

npm i -g opencode-ai

注意 -g 参数，这代表 Global（全局安装），意味着你可以在电脑的任何文件夹下唤醒 OpenCode

image-20260823032454524

等几分钟 出现 added 3 package 就算是安装成功了

image-20260823033204717

下面验证一下

# 查看版本号
opencode -v

image-20260823033343632

能展示版本号，说明安装成功了

接着随便进入一个目录

image-20260823033523305

输入 cmd ，回车

image-20260823033819823

在命令行中输入 opencode ，相当于在这个文件夹里面打开 opencode ，以后生成的所有内容都会放在这个文件夹里面

image-20260823034036008

回车之后就会出现对话框

image-20260823034131810

试一下看能不能对话，发现还真能

image-20260823034243944

3 配置模型（桌面版）

配置模型有 2 种方式：

  1. 直接修改配置文件
  2. 客户端页面上配置

3.1 配置文件中配置模型

进入 C 盘的用户目录：

C:\Users\你的名字\.config\opencode

image-20260822235627319

找到 opencode.jsonc 文件

image-20260822235817568

原本只有一行配置的，我们要配置的模型地址、模型名称、apiKey，都是在这个文件中配置，怎么配置模型呢？

{
   
  "$schema": "https://opencode.ai/config.json",                    # 固定配置
  "provider": {
                                                          # 模型提供商
    "chirou": {
                                                          # 提供商的名字：吃肉，注意不是模型名字
      "npm": "@ai-sdk/openai-compatible",                           # 固定写死的
      "name": "chirou",                                            # 提供商的名字，跟前面的名字保持一致
      "options": {
                                                      # 选项
        "apiKey": "sk-123456789",                                  # apiKey，这个大家都很熟了
        "baseURL": "http://192.168.0.1:3000/v1"                    # 模型的基础地址
      },
      "models": {
                                                     # 模型列表，因为一家公司可能会提供多个模型
        "deepseek-v4-pro": {
    "name": "deepseek-v4-pro" },          # 第一个模型名称，注意：key和name的值尽量一致
        "deepseek-v4-flash": {
    "name": "deepseek-v4-flash" },      # 第二个模型名称
        "glm-5.3": {
    "name": "glm-5.3" },
        "glm-5.2": {
    "name": "glm-5.2" },
        "glm-5.1": {
    "name": "glm-5.1" },
        "glm-5-turbo": {
    "name": "glm-5-turbo" }
      }
    }
  },
  "model": "chirou/glm-5.3"                                        # 默认使用哪个模型
}

可能大家对上面的配置还是不太理解，下面详细讲解一下：

  • chirou（吃肉） : 这是模型提供是商的名字，允许随便写。提供商就是提供模型的公司
  • apikey 和 baseURL 必须填准确，我在上面是随便写的，真实的肯定不能写出来，泄漏公司机密
  • models : 是模型列表，比如千问大模型就有 qwen3.5-27B、qwen3.8-27B 等多个版本

此时打开 opencode ➞ 文件 ➞ 设置

image-20260823003150467

提供商，可以看到 chirou 这个随便写的提供商名字已经展示出来了

image-20260823003340716

选择模型，也能看到 吃肉 这个模型提供商下面有 6 个模型，正好就是我们在 opencode.jsonc 文件中配置的模型

image-20260823003505071

而上面的 OpenCode Zen 是 opencode 自带的提供商，Big Pickle 、Hy3 Free 等都是 opencode 自带的模型，所以我们在安装好 opencode 之后什么都没配置，立马对话，也能生成回答，就是因为 opencode 自带了模型，还能免费使用。

image-20260823003644096

3.2 页面上配置模型

页面上配置模型也很简单，跟配置文件中配置是一样的道理，既然我在配置文件中配置的模型能在页面上展示，那我在页面上配置的模型，也一定会保存到 opencode.jsonc 这个配置文件中。下面就试一下，看是不是这样

打开 opencode，还是 文件 ➞ 设置

image-20260823004158637

还是 提供商

image-20260823004238695

滑到底，找到 自定义提供商，点击 连接

image-20260823004344657

接着就来到了配置页面

image-20260823004443190

比如我这次配置一个模型提供商（提供模型的公司）叫 chiji（吃鸡），基础地址和 apiKey 我都是随便填的

image-20260823004639375

然后我配置了 2 个模型，qwen3.5-27B 和 qwen3.8-27B，模型 id 和 模型名称可以保持一致，也可以不一致，只是我习惯保持一致

image-20260823011430243

请求头不用配置，直接提交，然后右下角就会提示 吃鸡 这个模型提供商已经配好了，可以使用了

image-20260823004928474

回到 提供商 页面，可以看到，已经有 吃鸡 这个模型提供商了

image-20260823005057196

在模型页面，也能看到 吃鸡 下面的 2 个模型

image-20260823011528917

首页对话时，也能看到 吃鸡 和 吃肉 这 2 个模型提供商下面的模型，可以自由切换

image-20260823011603639

最后回到 opencode.jsonc 文件

image-20260823005327887

打开文件，发现 吃鸡 这个模型提供商和 2 个 qwen 模型，也都在，说明页面上的配置，就是保存在这个文件中

image-20260823011716433

3.3 官方文档

授人以鱼不如授人以渔，以上 2 种配置方式，我是怎么知道的呢？

当然是看官方文档了，opencode 官网：https://opencode.ai/

官方文档中讲了一大堆，可能大家看的云里雾里，下面我挑重点的讲，争取让大家都能看懂

文档

image-20260823012624047

配置，这个页面就介绍了怎么配置

image-20260823012742774

配置方式有多种，比如常见的 2 种

  1. 全局配置：一旦配置，所有对话都能使用这些模型，我们上面介绍的就是全局配置
  2. 项目配置：项目 A 对话时只能使用 A1、A2 模型，项目 B 对话时可以使用 B1 、B2 模型，听起来有点反人类

官方文档中说了，全局配置就是去 ~/.config/opencode/opencode.json 这个文件中配置

image-20260823013047814

而我们的配置文件，目录确实对得上，只不过文件名称，我们是 opencode.jsonc ，也就后缀多了个 c

image-20260823013224099

接着往下滑，官方文档中也说了 通过 provider、model 和 small_model 选项在 OpenCode 配置中设置要使用的提供商和模型

  • provider : 提供商，名字随便写
  • model : 提供商提供的模型，比如千问提供的模型，模型名可不能随便乱填，千问官方提供的是什么，就得填什么。但是有些情况特殊，比如公司会下载模型部署在公司内网的服务器上，部署时是可以自定义模型名字的，比如 qwen35-27B ，少了一个点。那此时部署的人提供的模型名字是什么，你就得填什么

image-20260823013643277

接着往下看，禁止提供商，我是不是讲到过，断开连接，就会变成禁止提供商，就会出现在 disabled_providers 里面

image-20260823014127891

如果要启动供应商，我前面介绍的方式是把整个 disabled_providers 删除，但是官方文档中介绍的方式是把它放在 enabled_providers 中，表示可用的提供商

image-20260823014512159

在官方文档的 【提供商】 章节，也介绍了如何配置自定义提供商

image-20260823014902125

文档中还介绍了这些配置说明

image-20260823015046305

这些配置说明，大家还是有必要了解一下的，重点是要关注下 npm 这个选项，我们在配置文件中写死了，这是因为我们配置的模型的接口地址都是 /v1/chat/completions ，尽管我们在文件中配置的是 baseURL 是 http://192.168.0.1:3000/v1 ，但是对话时 opencode 会默认加上 /chat/completions，况且这些模型对应的官网，提供的接口地址也都是 /v1/chat/completions，所以我们配置的模型都是兼容 OpenAI 的

image-20260823015219984

还有一些不起眼的配置，比如：

  • limit.context：模型接受的最大输入 Token 数。输入的内容对应的 token 数量超过指定大小，就会报错
  • limit.output：模型可生成的最大 Token 数。控制大模型输出的内容大小

image-20260823015834652

4 常见问题

4.1 我手痒把提供商断开连接了怎么办

我突然手痒，不小心把 吃鸡 这个提供商给断开连接了怎么办？

image-20260823010003004

点了之后，右下角就会弹框提示 吃鸡 下的模型都不可用

image-20260823010038012

可以看到，已经找不到 吃鸡 这个模型了

image-20260823010121771

对话时切换模型，也找不到 吃鸡 这个提供商和 2 个 qwen 模型了

image-20260823010223416

这时候我想还原回来怎么办？页面上肯定是没有还原这个操作的，但是有个特别简单的办法，还是找到 C 盘下的 opencode.jsonc 文件

image-20260823011815208

上图可以看到，吃鸡 这个提供商还在，并没有删除，但是在最下面多了 3 行

  "disabled_providers": [
    "chiji"
  ]

什么意思呢？表示不可用的提供商有 吃鸡

那我把这 3 行删掉，连同上一行结尾的逗号也删掉，就可以还原了

image-20260823011844720

现在我已经删了

image-20260823011917300

opencode 需要关闭重新打开，这样才会重新加载文件

可以看到，吃鸡 这个提供商又回来了

image-20260823010854439

吃鸡 下的 2 个qwen 模型也回来了

image-20260823012016132

对话时也能切换到 吃鸡 下的 2 个qwen 模型了

image-20260823012049999

4.2 某个模型我不想用了怎么办

比如公司为了节省资源，把 qwen3.5-27B 这个模型给铲掉了，毕竟已经有 qwen3.8-27B 了，那旧的自然也没啥用，点一下关闭就可以了

image-20260823012309287

现在对话时已经选不到 qwen3.5-27B 了

image-20260823012346999

5 彻底卸载 OpenCode

5.1 桌面版卸载

桌面上卸载

image-20260823020759409

然后跳转到了 【程序和功能】

image-20260823020933525

选中它 ➞ 右键 ➞ 卸载

image-20260823021009800

卸载完发现，C:\Users\你的用户名\.config\opencode 目录下怎么还有文件，说明没卸载干净啊，还有残留，占用存储空间，怎么办呢？

image-20260823021125683

网上找到了一种方法，亲测可用，找到下面 4 个文件夹，然后删掉

%USERPROFILE%\.local\share\opencode
%USERPROFILE%\.cache\opencode
%USERPROFILE%\.config\opencode
%APPDATA%\ai.opencode.desktop

先试下第一个目录，原封不动，直接输入，回车

image-20260823021440973

还真有 opencode 这个文件夹，把opencode 文件夹删掉。其它 3 个文件夹也是同样的操作

5.2 命令行卸载

如果是采用命令行的方式安装，那么卸载时也只能通过命令行来卸载

前面命令行安装时是输入命令

npm i -g opencode-ai

image-20260823035537612

现在卸载就是

npm uninstall -g opencode-ai

还是 Win + R ，然后输入 cmd ，进入命令行后，输入 npm uninstall -g opencode-ai，出现 removed 3 packages 则表示已经卸载了

image-20260823035727720

此时输入 opencode -v 已经无法展示版本号了

image-20260823035852936

但是肯定还是有残留文件，还是删除下面 4 个文件夹

%USERPROFILE%\.local\share\opencode
%USERPROFILE%\.cache\opencode
%USERPROFILE%\.config\opencode
%APPDATA%\ai.opencode.desktop
文章标签：
JavaScript
Windows
人工智能
前端开发
程序员
游客gxacrkxssutjq
目录
相关文章
游客43d6l5svxhm72
|
2月前
|
人工智能 IDE 开发工具
OpenCode怎么用？OpenCode从下载到上手图文教程（保姆级，巨详细）
OpenCode 是一款免费开源的终端优先 AI 编程助手，支持命令行、桌面端和 IDE 三端运行。模型中立，兼容 75+ 大模型（含 DeepSeek、Ollama 本地模型），代码与数据默认本地存储，隐私安全。
游客43d6l5svxhm72
4053 1
游客6o7plnck563nw
|
2月前
|
人工智能 IDE 开发工具
【2026】OpenCode安装教程：开源AI编程助手，终端+IDE+桌面三端可用！
OpenCode 是一款免费开源的 AI 编程助手，支持终端、桌面和 VS Code 等多形态使用。它可读写文件、执行命令、修改代码，兼容 Claude、GPT、Gemini、DeepSeek 及本地模型，真正实现模型自由、平台无锁、开箱即用。
游客6o7plnck563nw
1546 0
游客y7nhlfl64adgi
|
1月前
|
人工智能 JSON API
OpenCode 接入第三方模型教程：2026 年配置方法与常见报错
OpenCode 接第三方模型易踩坑：API Key ≠ 模型就绪！需严格对齐凭据、提供商 ID、API 协议（如 `/v1/chat/completions`）与真实模型 ID。内置厂商一键接入；自定义平台须手动配 `opencode.json`，选对 `npm` SDK 包是关键。
游客y7nhlfl64adgi
1591 0
程序员鱼皮
|
1月前
|
人工智能 JSON API
全网刷屏的 Jev 模型正式开放！一手实战测评 + 保姆级教程
全网爆火的 Jev 模型是什么？有什么用？怎么使用？怎么接入 AI 编程工具？效果真的好么？傻子可懂的 Jev 保姆级实战教程 + 项目实战测评来啦
程序员鱼皮
10423 33
软件秘籍
|
29天前
|
Linux API iOS开发
CC-Switch配置DeepSeek教程-2026最新Codex本地调用设置全流程（附下载安装步骤与配置检查清单）
CC-Switch 是一款跨平台的 AI 模型 API 渠道管理工具，作用是统一转发与代理各家大模型的接口请求，适配 Codex、Claude Code 等 AI 编程工具。它要解决的问题很具体：Codex 客户端默认支持的模型范围有限，想改用 DeepSeek，直接在客户端里改配置行不通，需要中间加一层转发。本文把 CC-Switch 接入 DeepSeek 并让 Codex 生效的完整过程拆成九项待办，每项都给出对应操作与自检标准，Windows、macOS、Linux 用户均可对照执行。
软件秘籍
1283 0
CC-Switch配置DeepSeek教程-2026最新Codex本地调用设置全流程（附下载安装步骤与配置检查清单）
AI卷卷
|
3月前
|
人工智能 前端开发 Linux
Codex 桌面版安装 + CC Switch 接入第三方 API 完整教程（2026 最新）
2026最新教程：手把手教你安装Codex桌面版，通过CC Switch v3.17.0一键接入Fenno等国产API（兼容OpenAI Responses格式），跳过账号登录，完整启用代码审查、多步任务与上下文感知功能。零基础友好，全程图文实操。（239字）
AI卷卷
15687 8

热门文章

最新文章

  • 1
    阿里云百炼上线DeepSeek-V4：API 价格与官网一致，百万Tokens输入最低1元、输出最低2元
  • 2
    阿里云盾提醒网站被WebShell木马后门分析与对策
  • 3
    如何使用shp2pgsql 将shp格式的GIS数据导入到PostgreSQL
  • 4
    cassandra使用场景判断：何时使用及何时不用
  • 5
    学生免费领取阿里云服务器一年的方法，以及各种活动
  • 6
    接口的幂等性设计和防重保证，详细分析幂等性的几种实现方法
  • 7
    X-Forwarded-For信息头的处理
  • 8
    intellij 如何引入jar包
  • 9
    XAML引用隐藏代码中的类，遇到的不明报错
  • 10
    VS2005在开发网站时的一个编译BUG
  • 1
    让员工的浏览器"只干该干的事"：企业浏览器管控四道防线
    24
  • 2
    企业邮箱登录入口官网网页版：免费和付费版企业邮箱申请（附价格表）
    23
  • 3
    制作一个 H5 网页大概要多少钱？阿里云万小智AI建站15元搞定！
    27
  • 4
    医药健康 GEO 技术实践：面向大模型的信源工程、知识工程与合规工程
    40
  • 5
    GPT-6.1 Terra上线：更便宜了，干活到底怎么样？
    36
  • 6
    磁盘上找不到病毒，但电脑已经被控制了：聊聊「无文件攻击」
    27
  • 7
    基于阿里云云架构的景区智慧票务系统高并发实践——技术复盘
    33
  • 8
    Issue 怎么关联合并请求：写上 Closes #编号，合并后自动关闭
    34
  • 9
    2026年阿里云双十一老用户省钱攻略，轻量 ECS GPU热门服务器优惠、代金券领取、资格与实操教程
    25
  • 10
    2026年阿里云双十一企业专场，云产品优惠拆解，企业采购门槛与省钱策略
    24

    • 相关电子书

    更多
  • 低代码开发师（初级）实战教程
  • 冬季实战营第三期：MySQL数据库进阶实战
  • 阿里巴巴DevOps 最佳实践手册
    • 下一篇
    一条命令迁移，帮你实现 OpenClaw 与 Hermes Agent 记忆互通！