# 1 配置模型（桌面版）


安装好 OpenCode 之后，有的是在公司服务器上部署了模型，有些是直接买了会员，那在 OpenCode 上如何配置这些模型呢？
配置模型有 2 种方式：
1. 直接修改配置文件
2. 客户端页面上配置


## 1.1 配置文件中配置模型


进入 C 盘的用户目录：
``` markdown
C:\Users\你的名字\.config\opencode
```
![image-20260822235627319](https://developer.qcloudimg.com/http-save/yehe-5902794/82678d0fc676dea47f73311b88aeffcd.png)

找到 opencode.jsonc 文件
![image-20260822235817568](https://developer.qcloudimg.com/http-save/yehe-5902794/fb4a4477718881c2e6752fe03beffc1e.png)

原本只有一行配置的，我们要配置的模型地址、模型名称、apiKey，都是在这个文件中配置，怎么配置模型呢？
```yaml
{
  "$schema": "https://opencode.ai/config.json", &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;# 固定配置
  "provider": {                                                  &nbsp; # 模型提供商
 &nbsp;  "chirou": {                                                  &nbsp; # 提供商的名字：吃肉，注意不是模型名字
 &nbsp; &nbsp;  "npm": "@ai-sdk/openai-compatible",                        &nbsp; # 固定写死的
 &nbsp; &nbsp;  "name": "chirou", &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;# 提供商的名字，跟前面的名字保持一致
 &nbsp; &nbsp;  "options": {                                               &nbsp; # 选项
 &nbsp; &nbsp; &nbsp;  "apiKey": "sk-123456789", &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;# apiKey，这个大家都很熟了
 &nbsp; &nbsp; &nbsp;  "baseURL": "http://192.168.0.1:3000/v1" &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;# 模型的基础地址
 &nbsp; &nbsp; &nbsp;},
 &nbsp; &nbsp;  "models": { &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;# 模型列表，因为一家公司可能会提供多个模型
 &nbsp; &nbsp; &nbsp;  "deepseek-v4-pro": { "name": "deepseek-v4-pro" }, &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;# 第一个模型名称，注意：key和name的值尽量一致
 &nbsp; &nbsp; &nbsp;  "deepseek-v4-flash": { "name": "deepseek-v4-flash" }, &nbsp; &nbsp; &nbsp;# 第二个模型名称
        "glm-5.3": { "name": "glm-5.3" },
 &nbsp; &nbsp; &nbsp;  "glm-5.2": { "name": "glm-5.2" },
 &nbsp; &nbsp; &nbsp;  "glm-5.1": { "name": "glm-5.1" },
 &nbsp; &nbsp; &nbsp;  "glm-5-turbo": { "name": "glm-5-turbo" }
 &nbsp; &nbsp; &nbsp;}
 &nbsp; &nbsp;}
 &nbsp;},
  "model": "chirou/glm-5.3" &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;# 默认使用哪个模型
}
```
可能大家对上面的配置还是不太理解，下面详细讲解一下：
- chirou（吃肉） : 这是模型提供是商的名字，允许随便写。提供商就是提供模型的公司
- apikey 和 baseURL 必须填准确，我在上面是随便写的，真实的肯定不能写出来，泄漏公司机密
- models : 是模型列表，比如千问大模型就有 qwen3.5-27B、qwen3.8-27B 等多个版本


此时打开 opencode ➞ 文件 ➞ 设置
![image-20260823003150467](https://developer.qcloudimg.com/http-save/yehe-5902794/6731d72f5f8103d8aebaa59f36d0b155.png)


提供商，可以看到 chirou 这个随便写的提供商名字已经展示出来了
![image-20260823003340716](https://developer.qcloudimg.com/http-save/yehe-5902794/6620a41e68fe66fef97143b2333c2d17.png)

选择模型，也能看到 吃肉 这个模型提供商下面有 6 个模型，正好就是我们在 opencode.jsonc 文件中配置的模型
![image-20260823003505071](https://developer.qcloudimg.com/http-save/yehe-5902794/63049587807deb0ce97a83aff32c5432.png)

而上面的 OpenCode Zen 是 opencode 自带的提供商，Big Pickle 、Hy3 Free 等都是 opencode 自带的模型，所以我们在安装好 opencode 之后什么都没配置，立马对话，也能生成回答，就是因为 opencode 自带了模型，还能免费使用。
![image-20260823003644096](https://developer.qcloudimg.com/http-save/yehe-5902794/d0b666a53f9e1ab8d112a2ca91c4d0fe.png)


## 1.2 页面上配置模型


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

打开 opencode，还是 文件 ➞ 设置
还是 提供商
![image-20260823004238695](https://developer.qcloudimg.com/http-save/yehe-5902794/9d1a417bb910bcf00914cbe17cee229b.png)

滑到底，找到 **自定义提供商**，点击 连接
![image-20260823004344657](https://developer.qcloudimg.com/http-save/yehe-5902794/b788b5f24f0dc07af8ad2088e4f26b0a.png)

接着就来到了配置页面
比如我这次配置一个模型提供商（提供模型的公司）叫 chiji（吃鸡），基础地址和 apiKey 我都是随便填的
![image-20260823004639375](https://developer.qcloudimg.com/http-save/yehe-5902794/0ad90758334df043cc66f92175377ea2.png)

然后我配置了 2 个模型，qwen3.5-27B 和 qwen3.8-27B，模型 id 和 模型名称可以保持一致，也可以不一致，只是我习惯保持一致
![image-20260823011430243](https://developer.qcloudimg.com/http-save/yehe-5902794/c343076f052c29450cdf6c83ea7f1c48.png)


请求头不用配置，直接提交，然后右下角就会提示 吃鸡 这个模型提供商已经配好了，可以使用了
![image-20260823004928474](https://developer.qcloudimg.com/http-save/yehe-5902794/6f3678c6efe8cf19e30e65c3188e197c.png)

回到 提供商 页面，可以看到，已经有 吃鸡 这个模型提供商了
![image-20260823005057196](https://developer.qcloudimg.com/http-save/yehe-5902794/ff40d317af4123c0e411a1d7c3c3d48a.png)

在模型页面，也能看到 吃鸡 下面的 2 个模型
![image-20260823011528917](https://developer.qcloudimg.com/http-save/yehe-5902794/b02e39c36b06987c28125ef9b35d61e0.png)


首页对话时，也能看到 吃鸡 和 吃肉 这 2 个模型提供商下面的模型，可以自由切换
![image-20260823011603639](https://developer.qcloudimg.com/http-save/yehe-5902794/59aa75ef7c21a85ac4461b09c798241f.png)

最后回到 opencode.jsonc 文件
打开文件，发现 吃鸡 这个模型提供商和 2 个 qwen 模型，也都在，说明页面上的配置，就是保存在这个文件中
![image-20260823011716433](https://developer.qcloudimg.com/http-save/yehe-5902794/d6e49c55a4dbb6ae0a8d2c097dc87538.png)

## 1.3 官方文档


授人以鱼不如授人以渔，以上 2 种配置方式，我是怎么知道的呢？
当然是看官方文档了，opencode 官网：https://opencode.ai/  
官方文档中讲了一大堆，可能大家看的云里雾里，下面我挑重点的讲，争取让大家都能看懂

文档
![image-20260823012624047](https://developer.qcloudimg.com/http-save/yehe-5902794/bdc9f528d00dd0ea405e4c941d3c222e.png)

配置，这个页面就介绍了怎么配置
![image-20260823012742774](https://developer.qcloudimg.com/http-save/yehe-5902794/9a063f75b09ca83f0a8636dcacc90552.png)

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


官方文档中说了，全局配置就是去 ~/.config/opencode/opencode.json 这个文件中配置
![image-20260823013047814](https://developer.qcloudimg.com/http-save/yehe-5902794/6becd0e3257b616dfb511bd30f5fbbfc.png)

而我们的配置文件，目录确实对得上，只不过文件名称，我们是 opencode.jsonc ，也就后缀多了个 c
![image-20260823013224099](https://developer.qcloudimg.com/http-save/yehe-5902794/a06fec1ce82ae77008e9ba8befb3c176.png)

接着往下滑，官方文档中也说了 **通过 `provider`、`model` 和 `small_model` 选项在 OpenCode 配置中设置要使用的提供商和模型**
- provider : 提供商，名字随便写
- model : 提供商提供的模型，比如千问提供的模型，模型名可不能随便乱填，千问官方提供的是什么，就得填什么。但是有些情况特殊，比如公司会下载模型部署在公司内网的服务器上，部署时是可以自定义模型名字的，比如 qwen35-27B ，少了一个点。那此时部署的人提供的模型名字是什么，你就得填什么

![image-20260823013643277](https://developer.qcloudimg.com/http-save/yehe-5902794/91dd1a780501b9e304ada83dd3958fd0.png)

接着往下看，禁止提供商，我是不是讲到过，断开连接，就会变成禁止提供商，就会出现在 disabled_providers 里面
![image-20260823014127891](https://developer.qcloudimg.com/http-save/yehe-5902794/334e0d0e5856b1c3d51d56283842da54.png)

如果要启动供应商，我前面介绍的方式是把整个 disabled_providers 删除，但是官方文档中介绍的方式是把它放在 enabled_providers 中，表示可用的提供商
![image-20260823014512159](https://developer.qcloudimg.com/http-save/yehe-5902794/1c4662cc9008dbdd81f1dee288e84258.png)

在官方文档的 【提供商】 章节，也介绍了如何配置自定义提供商
![image-20260823014902125](https://developer.qcloudimg.com/http-save/yehe-5902794/291626e3ff18262446ab2d182b7218c9.png)

文档中还介绍了这些配置说明
![image-20260823015046305](https://developer.qcloudimg.com/http-save/yehe-5902794/2dbb25f8058d5265297477aaaf1e7922.png)

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

还有一些不起眼的配置，比如：
- **limit.context**：模型接受的最大输入 Token 数。输入的内容对应的 token 数量超过指定大小，就会报错
- **limit.output**：模型可生成的最大 Token 数。控制大模型输出的内容大小

![image-20260823015834652](https://developer.qcloudimg.com/http-save/yehe-5902794/63a16de8850c1b532aa4e42800099cb7.png)


# 2 常见问题


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


我突然手痒，不小心把 吃鸡 这个提供商给断开连接了怎么办？
![image-20260823010003004](https://developer.qcloudimg.com/http-save/yehe-5902794/e22d6d439a2d07fa4419760cd930da21.png)

点了之后，右下角就会弹框提示 吃鸡 下的模型都不可用
![image-20260823010038012](https://developer.qcloudimg.com/http-save/yehe-5902794/1266627bf55e36f14c53205d8e816785.png)

可以看到，已经找不到 吃鸡 这个模型了
![image-20260823010121771](https://developer.qcloudimg.com/http-save/yehe-5902794/4cc1dc418308006147180666a494ad0e.png)

对话时切换模型，也找不到 吃鸡 这个提供商和 2 个 qwen 模型了
![image-20260823010223416](https://developer.qcloudimg.com/http-save/yehe-5902794/32aebf48c6547b5dec3a451550939fbe.png)

这时候我想还原回来怎么办？页面上肯定是没有还原这个操作的，但是有个特别简单的办法，还是找到 C 盘下的 opencode.jsonc 文件
![image-20260823011815208](https://developer.qcloudimg.com/http-save/yehe-5902794/35df24d6f1b0027485c2df3561876ba4.png)

上图可以看到，吃鸡 这个提供商还在，并没有删除，但是在最下面多了 3 行
```yaml
  "disabled_providers": [
 &nbsp; &nbsp;"chiji"
 &nbsp;]
```
什么意思呢？表示不可用的提供商有 吃鸡

那我把这 3 行删掉，连同上一行结尾的逗号也删掉，就可以还原了
![image-20260823011844720](https://developer.qcloudimg.com/http-save/yehe-5902794/ae07223c658890706e72ebc7ce4f8b95.png)


现在我已经删了
![image-20260823011917300](https://developer.qcloudimg.com/http-save/yehe-5902794/3e2afc3a4f62606e83422757db65d5c3.png)


opencode 需要关闭重新打开，这样才会重新加载文件
可以看到，吃鸡 这个提供商又回来了
![image-20260823010854439](https://developer.qcloudimg.com/http-save/yehe-5902794/755a0afd6a891d2d81cd0d05245596e1.png)

吃鸡 下的 2 个qwen 模型也回来了
![image-20260823012016132](https://developer.qcloudimg.com/http-save/yehe-5902794/e9276caafbeab49c483814b8a86a74bb.png)


对话时也能切换到 吃鸡 下的 2 个qwen 模型了
![image-20260823012049999](https://developer.qcloudimg.com/http-save/yehe-5902794/8d530ebd62c53f77edcb7268a9c9ae38.png)

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


比如公司为了节省资源，把 qwen3.5-27B 这个模型给铲掉了，毕竟已经有 qwen3.8-27B 了，那旧的自然也没啥用，点一下关闭就可以了
![image-20260823012309287](https://developer.qcloudimg.com/http-save/yehe-5902794/fbd0e3e1ef219adb4337e50d754708b2.png)

现在对话时已经选不到 qwen3.5-27B 了
![image-20260823012346999](https://developer.qcloudimg.com/http-save/yehe-5902794/0bff89ee7ee2b1cde1e4950475a324cb.png)

# 3 彻底卸载 OpenCode


## 3.1 桌面版卸载


桌面上卸载
![image-20260823020759409](https://developer.qcloudimg.com/http-save/yehe-5902794/1a4d163afb0fd42e34889cfa0258a98f.png)

然后跳转到了 【程序和功能】
![image-20260823020933525](https://developer.qcloudimg.com/http-save/yehe-5902794/d73bf7c18df3fcf98d47a71294b89b40.png)

选中它 ➞ 右键 ➞ 卸载
![image-20260823021009800](https://developer.qcloudimg.com/http-save/yehe-5902794/f1b2f76373f5991ace09a068c5589741.png)

卸载完发现，`C:\Users\你的用户名\.config\opencode` 目录下怎么还有文件，说明没卸载干净啊，还有残留，占用存储空间，怎么办呢？
![image-20260823021125683](https://developer.qcloudimg.com/http-save/yehe-5902794/963462c8c156a3e10e143431d7af6a83.png)

网上找到了一种方法，亲测可用，找到下面 4 个文件夹，然后删掉
``` markdown
%USERPROFILE%\.local\share\opencode
%USERPROFILE%\.cache\opencode
%USERPROFILE%\.config\opencode
%APPDATA%\ai.opencode.desktop
```
先试下第一个目录，原封不动，直接输入，回车
![image-20260823021440973](https://developer.qcloudimg.com/http-save/yehe-5902794/0619db99dbaa6ca2575c6d3e2ef6d432.png)
还真有 opencode 这个文件夹，把opencode 文件夹删掉。其它 3 个文件夹也是同样的操作

## 3.2 命令行卸载


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

前面命令行安装时是输入命令
``` shell
npm i -g opencode-ai
```
![image-20260823035537612](https://developer.qcloudimg.com/http-save/yehe-5902794/f58f93e630dadcbb8f6a9e64ccbcb362.png)

现在卸载就是
``` shell
npm uninstall -g opencode-ai
```
还是 Win + R ，然后输入 cmd ，进入命令行后，输入 npm uninstall -g opencode-ai，出现 removed 3 packages  则表示已经卸载了
![image-20260823035727720](https://developer.qcloudimg.com/http-save/yehe-5902794/90ce0f024e94de419fe1086c52da7bae.png)

此时输入 opencode -v 已经无法展示版本号了
![image-20260823035852936](https://developer.qcloudimg.com/http-save/yehe-5902794/b4a7932c645ff914166fa77a5ad7f8f6.png)

但是肯定还是有残留文件，还是删除下面 4 个文件夹
``` markdown
%USERPROFILE%\.local\share\opencode
%USERPROFILE%\.cache\opencode
%USERPROFILE%\.config\opencode
%APPDATA%\ai.opencode.desktop
```

安装好 OpenCode 之后，有的是在公司服务器上部署了模型，有些是直接买了会员，那在 OpenCode 上如何配置这些模型呢？配置模型有 2 种方式：

OpenCode 如何配置模型，如何彻底卸载 OpenCode

本文详细介绍了 OpenCode 配置模型的两种方法：一是直接修改 opencode.jsonc 配置文件，设置提供商名称、API Key、BaseURL 及模型列表；二是通过客户端“文件-设置-自定义提供商”页面进行可视化配置，两种方式数据互通。文章还讲解了如何恢复误断开的提供商、禁用特定模型，以及桌面版和命令行版的彻底卸载与残留清理步骤，帮助用户全面掌握 OpenCode 的模型管理与维护。

开发工具

人工智能

后端

本文全面解析OpenCode模型配置方法：通过编辑opencode.jsonc文件或页面可视化操作，配置模型提供商、API密钥及模型列表，支持全局与项目级配置，并详解提供商禁用恢复、模型停用及彻底卸载步骤。

代码解释

服务器

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

OpenCode 如何配置模型，如何彻底卸载 OpenCode-腾讯云开发者社区-腾讯云

OpenCode 如何配置模型，如何彻底卸载 OpenCode

OpenCode 如何配置模型，如何彻底卸载 OpenCode

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐