跳转至
运行系统

接入 OpenCode

在 OpenCode 中配置 LkApi 的 API Key,推荐通过全局配置文件 opencode.json 来完成自定义 Provider 的设置。

安装与升级

可任选一种包管理器执行安装或升级:

npm install -g opencode-ai@latest
pnpm install -g opencode-ai@latest

安装完成后,建议先在您的工程目录下启动一次 opencode,确认命令可用后再按 Ctrl + C 退出,这样会先生成初始化配置文件,后续再修改 opencode.json 会更方便。

配置步骤

请选择对应的运行系统:

【 Windows 】

修改全局配置文件 文件路径通常为:~/.config/opencode/opencode.json(没有就新建)。

在文件中补充或修改以下 JSON 配置:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "lkapi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "LkApi",
      "options": {
        "baseURL": "https://www.lkapi.top/v1",
        "apiKey": "您的-LkApi-Key",
        "wire_api": "responses"
      },
      "models": {
        "gpt-5.3-codex": { "name": "GPT-5.3 Codex" },
        "gpt-5.4": { "name": "GPT-5.4" }
      }
    }
  }
}
注:models 列表可以根据 LkApi 实际支持的模型自行增删。

【 macOS 】

修改全局配置文件 文件路径通常为:~/.config/opencode/opencode.json

在文件中补充或修改以下 JSON 配置:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "lkapi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "LkApi",
      "options": {
        "baseURL": "https://www.lkapi.top/v1",
        "apiKey": "您的-LkApi-Key",
        "wire_api": "responses"
      },
      "models": {
        "gpt-5.3-codex": { "name": "GPT-5.3 Codex" },
        "gpt-5.4": { "name": "GPT-5.4" }
      }
    }
  }
}
注:models 列表可以根据 LkApi 实际支持的模型自行增删。

【 Linux/Wsl 】

修改全局配置文件 文件路径通常为:~/.config/opencode/opencode.json

在文件中补充或修改以下 JSON 配置:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "lkapi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "LkApi",
      "options": {
        "baseURL": "https://www.lkapi.top/v1",
        "apiKey": "您的-LkApi-Key",
        "wire_api": "responses"
      },
      "models": {
        "gpt-5.3-codex": { "name": "GPT-5.3 Codex" },
        "gpt-5.4": { "name": "GPT-5.4" }
      }
    }
  }
}
注:models 列表可以根据 LkApi 实际支持的模型自行增删。

生效验证

配置保存后,在终端中启动 opencode,输入 /models 命令即可查看并切换到刚才配置的 LkApi 模型进行对话。