OpenCode 是开源的终端编程助手,特点是可以在多个已配置的模型之间随时切换。
OpenCode 是基于 Node.js 的命令行工具,必须先装好它。
1)Windows
node -v
如果显示版本号(如 v20.11.0),说明安装成功
2)macOS
3)Linux
# Ubuntu / Debian
sudo apt update && sudo apt install -y nodejs npm
# CentOS / RHEL
sudo yum install -y nodejs npm
# 也可以用 nvm(推荐,灵活切版本)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 20
验证:终端输入 node -v,显示版本号即成功。
三平台命令相同,在终端执行:
npm install -g @opencode-ai/cli
也可使用下载源手动安装
注意:命令行方式默认安装的是 OpenCode v2 的 beta(测试)版本。此时验证、启动、切换模型的命令要用 opencode2 开头(如 opencode2 --version、opencode2);下文统一写 opencode,v2 beta 用户请自行替换为 opencode2。
验证:
opencode2 --version
显示版本号即安装成功。
注意: 建议升级到最新版本(≥ v1.14.24),旧版本可能有兼容性问题。
升级方法:终端执行 npm install -g @opencode-ai/cli@latest 重新安装最新版;或到官网下载页下载最新安装包覆盖安装。
重要提示: OpenCode 桌面版 UI 不支持直接在界面中添加自定义 Provider,正确做法是编辑配置文件。以下同时提供配置文件方式和 UI 界面参考效果图。
| 系统 | 配置文件路径 |
|---|---|
| Windows | C:\Users\你的用户名\.config\opencode\opencode.jsonc |
| macOS | ~/.config/opencode/opencode.jsonc |
| Linux | ~/.config/opencode/opencode.jsonc |
打开 PowerShell,执行如下代码:
New-Item -ItemType Directory -Path "$env:USERPROFILE\.config\opencode" -Force
mkdir -p ~/.config/opencode
nano ~/.config/opencode/opencode.jsonc
在编辑器里粘贴下面的"配置内容",按 Ctrl + O 保存、Ctrl + X 退出。
1)把下面两个 API Key 分别替换成你在第1.2节申请的两个模型的 API Key:
2)如想接入 Xing4.1-Preview模型:按同样格式在 provider 里再加一段——provider 名换成 xinghe4.1-preview、models 换成 Xing4.1-Preview、baseURL 同样填 https://api-maas.teleai.com.cn/v1,apiKey 用该模型自己申请的 Key。
3)然后用记事本打开该路径下创建一个 opencode.jsonc 文件,把下面的"配置内容"粘贴进去。
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"xinghe-telechat-29b": {
"npm": "@ai-sdk/openai-compatible",
"name": "星辰4.0-29B-A4B",
"options": {
"baseURL": "https://api-maas.teleai.com.cn/v1",
"apiKey": "把这里替换成你的API Key"
},
"models": {
"Xing4.0-29B-A4B": {
# 此处填写model id(Xing4.0-29B-A4B、TeleChat3-438B-A24B、Xing4.1-Preview),请勿自定义
"name": "星辰4.0-29B-A4B"
}
}
},
"xinghe-telechat3-438b": {
"npm": "@ai-sdk/openai-compatible",
"name": "TeleChat3-438B",
"options": {
"baseURL": "https://api-maas.teleai.com.cn/v1",
"apiKey": "把这里替换成你的API Key"
},
"models": {
"TeleChat3-438B-A24B": {
"name": "TeleChat3-438B-A24B"
}
}
}
}
}
⚠ 配置文件防错:
1、不可修改部分:上面 JSON 里的 "Xing4.0-29B-A4B"、"TeleChat3-438B-A24B" 是模型的内部 ID,需根据实际情况填写;
2、可修改部分:两个 apiKey 的值换成申请的API Key。
配置保存后重启 OpenCode 生效:
效果图 1:在设置中打开模型选项
效果图 2:使用模型问答
输入ctrl+x → 按键“M”,使用“↑” 、“↓”键或鼠标点击确认来选择模型
切换模型用/models
如已经安装 OpenCode(正在用其他模型),按下面三步切换到【星辰语义大模型】:
npm install -g @opencode-ai/cli@latest
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"xinghe-telechat-29b": {
"npm": "@ai-sdk/openai-compatible",
"name": "星辰4.0-29B-A4B",
"options": {
"baseURL": "https://api-maas.teleai.com.cn/v1",
"apiKey": "把这里替换成你的API Key"
},
"models": {
"Xing4.0-29B-A4B": {
# 此处填写model id(Xing4.0-29B-A4B、TeleChat3-438B-A24B、Xing4.1-Preview),请勿自定义
"name": "星辰4.0-29B-A4B"
}
}
},
"xinghe-telechat3-438b": {
"npm": "@ai-sdk/openai-compatible",
"name": "TeleChat3-438B",
"options": {
"baseURL": "https://api-maas.teleai.com.cn/v1",
"apiKey": "把这里替换成你的API Key"
},
"models": {
"TeleChat3-438B-A24B": {
"name": "TeleChat3-438B-A24B"
}
}
}
}
}
⚠ 配置文件防错:
1、不可修改部分:上面 JSON 里的 "Xing4.0-29B-A4B"、"TeleChat3-438B-A24B" 是模型的内部 ID;
2、可修改部分:两个 apiKey 的值换成申请的API Key。
(v2 beta 启动命令用 opencode2),在设置中启用星辰模型即可。