Skip to content

OpenCode ​

OpenCode 是一个开源 AI 编程助手,提供终端、桌面应用和网页等运行形式。学校的大模型通过 OpenAI 兼容接口接入,终端版与桌面版共用同一份配置。

安装 ​

前往官方下载页面安装或升级,也可以使用 npm:

bash
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 中执行:

  1. 在输入框输入 /connect,滚动到列表底部选择 Other;
  2. 提供商 ID 填写 chatecnu(必须与下面配置中的名称一致);
  3. 粘贴您的 API Key。

再将下面的内容保存为全局配置 ~/.config/opencode/opencode.json(Windows 为 %USERPROFILE%\.config\opencode\opencode.json),所有项目都可使用;也可以保存为某个项目根目录下的 opencode.json,仅对该项目生效。如果文件已存在,请把 provider 中的 chatecnu 合并进去。

json
{
  "$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:

json
"options": {
  "baseURL": "https://chat.ecnu.edu.cn/open/api/v1",
  "apiKey": "{env:CHATECNU_API_KEY}"
}

注意:学校模型的思考模式默认关闭,上面的配置不会开启它,详见 思考模式。

注意:ecnu-max 同时最多处理 3 个请求,ecnu-plus 为 5 个,超出会返回 429,详见 配额限制。

更多配置 ​

您可以参考 OpenCode 提供商文档 与 OpenCode 配置文档 进一步优化配置。