OpenCode
OpenCode 是一个开源 AI 编程助手,提供终端、桌面应用和网页等运行形式。学校的大模型通过 OpenAI 兼容接口接入,终端版与桌面版共用同一份配置。
安装
前往官方下载页面安装或升级,也可以使用 npm:
npm install -g opencode-ai为避免兼容性问题,强烈建议您升级到最新版本:opencode upgrade。
GUI 版本
点击左下角"设置 -> 提供商 -> 自定义提供商",按表单填写:提供商 ID chatecnu、Base URL https://chat.ecnu.edu.cn/open/api/v1、API Key(在 我的令牌 中创建)、模型 ID ecnu-max 和 ecnu-plus,无需再编写配置文件。模型清单详见 模型介绍。
命令行版本
在 我的令牌 中创建并复制您的 API Key,然后在 OpenCode 中执行:
- 在输入框输入
/connect,滚动到列表底部选择 Other; - 提供商 ID 填写
chatecnu(必须与下面配置中的名称一致); - 粘贴您的 API Key。
再将下面的内容保存为全局配置 ~/.config/opencode/opencode.json(Windows 为 %USERPROFILE%\.config\opencode\opencode.json),所有项目都可使用;也可以保存为某个项目根目录下的 opencode.json,仅对该项目生效。如果文件已存在,请把 provider 中的 chatecnu 合并进去。
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"chatecnu": {
"npm": "@ai-sdk/openai-compatible",
"name": "ChatECNU",
"options": {
"baseURL": "https://chat.ecnu.edu.cn/open/api/v1"
},
"models": {
"ecnu-max": {
"name": "ecnu-max",
"limit": {
"context": 512000,
"output": 64000
}
},
"ecnu-plus": {
"name": "ecnu-plus",
"limit": {
"context": 256000,
"output": 32000
}
}
}
}
},
"model": "chatecnu/ecnu-max"
}启动后在输入框输入 /models,应能看到 ChatECNU 下的 ecnu-max 和 ecnu-plus。
配置说明
| 字段 | 说明 |
|---|---|
npm | 固定为 @ai-sdk/openai-compatible,使用 /chat/completions 对话接口 |
options.baseURL | 平台的 OpenAI 兼容端点 |
models | 可用模型列表,键为模型 ID。limit.context 为上下文窗口(ecnu-max 512K、ecnu-plus 256K),limit.output 为单次输出上限,OpenCode 据此计算剩余上下文。输出上限取 64K / 32K 是 Agent 场景的推荐值(模型最大输出为 256K / 128K),把更多窗口留给输入,详见 模型介绍 |
model | 默认模型,格式为 提供商 ID/模型 ID |
您也可以把 API Key 放进环境变量,在配置的 options 中引用,此时可以跳过 /connect:
"options": {
"baseURL": "https://chat.ecnu.edu.cn/open/api/v1",
"apiKey": "{env:CHATECNU_API_KEY}"
}注意:学校模型的思考模式默认关闭,上面的配置不会开启它,详见 思考模式。
注意:
ecnu-max同时最多处理 3 个请求,ecnu-plus为 5 个,超出会返回 429,详见 配额限制。
更多配置
您可以参考 OpenCode 提供商文档 与 OpenCode 配置文档 进一步优化配置。