Skip to content

接入 OpenCode

功能概述

OpenCode 是基于终端的 AI 编程助手,支持通过配置文件指定自定义 OpenAI 兼容 API 端点。无量AI开放平台提供完全兼容 OpenAI 协议的接口,可作为 OpenCode 的后端服务。

前提条件

  • 已安装 OpenCode(npm install -g opencode-ai 或参考官方文档)
  • 已在无量AI开放平台创建 API Key(前往创建

配置步骤

1. 编辑 opencode.json

根据您的操作系统,找到并编辑以下配置文件(如文件不存在则新建):

操作系统文件路径
macOS / Linux~/.config/opencode/opencode.json
Windows%APPDATA%\opencode\opencode.json

写入以下内容,将 your-api-key 替换为您在无量AI开放平台获取的 API Key:

json
{
  "models": {
    "gpt-5.5": {
      "name": "GPT-5.5"
    }
  },
  "npm": "@ai-sdk/openai-compatible",
  "options": {
    "apiKey": "your-api-key",
    "baseURL": "https://open.dieyuyun.com/v1"
  }
}
配置项说明
models可用模型定义,键为模型代码
npm固定值 @ai-sdk/openai-compatible
options.apiKey您的无量AI开放平台 API Key
options.baseURL无量AI开放平台 OpenAI 兼容接口地址

2. 启动 OpenCode

保存配置文件后,在终端中运行:

bash
opencode

在会话中输入 /models 可查看并切换可用模型。

OpenCode 切换模型成功

OpenCode 启动成功

平台接口说明

无量AI开放平台的 OpenAI 协议接入信息如下:

配置项
Base URLhttps://open.dieyuyun.com/v1
认证请求头Authorization: Bearer your-api-key
数据格式JSON

完整请求示例:

bash
curl --request POST 'https://open.dieyuyun.com/v1/chat/completions' \
  --header 'Authorization: Bearer your-api-key' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-5.5",
    "messages": [
      {"role": "system", "content": "你是一个有用的助手"},
      {"role": "user", "content": "你好,请介绍一下你自己"}
    ],
    "temperature": 0.7,
    "max_tokens": 1024
  }'

注意事项

  • JSON 格式:请确保配置文件为合法的 JSON 格式。
  • 模型 IDmodels[].id 必须与平台提供的模型代码完全一致,可在 模型列表与定价 页面查看。
  • API Key 安全:不要将 opencode.json 文件中的 API Key 提交到版本控制系统,建议通过环境变量 OPENAI_API_KEY 传入。

相关文档