Skip to main content

一、产品简介

OpenCode 是一款开源 AI 编程助手,支持 75+ 模型与本地部署。通过 LeapX API,可在 OpenCode 中统一使用各类主流与最新模型(如 GPT、Claude、Gemini 等),并支持自定义提供商与模型配置。 下载地址https://opencode.ai/

二、快速配置(LeapX API)

1. 获取 API 密钥

LeapX API 控制台 创建并复制 API 密钥。

2. 在 OpenCode 中配置自定义提供商

  1. 打开 OpenCode,进入 服务器 / 提供商 设置。
  2. 添加 自定义提供商(Configure an OpenAI compatible provider)。
  3. 填写:
    • 提供商 ID:如 leapx(小写、数字、连字符或下划线)
    • 显示名称:如 LeapX API
    • 基础 URLhttps://api.leapx-hub.com/v1(必须以 /v1 结尾)
    • API 密钥:粘贴 LeapX API 密钥
  4. 模型 中添加需要使用的模型(如 gpt-4oclaude-sonnet-4-20250514 等),模型 ID 与 LeapX 模型列表 一致。
  5. 保存后,在模型选择中使用 提供商ID/模型ID(如 leapx/gpt-4o)。
OpenCode 配置自定义供应商 具体配置信息(与上图对应):
  • 基础 URLhttps://api.leapx-hub.com/v1
  • API 密钥:在 LeapX 控制台 获取(格式如 sk-xxxxxxxxxxxxx
  • 模型:从 LeapX 模型列表 选择并填入模型 ID
OpenCode 提供商与 API 配置 OpenCode 模型配置

3. 切换模型

在对话或设置中选择已配置的提供商与模型(如 leapx/gpt-4o)即可切换。 OpenCode 切换模型
  • 若使用自建或备用 LeapX 服务,将 基础 URL 改为对应地址,例如 http://your-server:3003/v1
  • 默认模型可在项目或全局 opencode.json 中设置 "model": "leapx/模型ID"

三、部分模型需使用 Responses API(重要)

部分模型的访问接口与常规 Chat Completions 不同,需使用 Responses API。若在 OpenCode 中选用这类模型时出现类似错误: 部分 Azure / OpenAI 新模型仅支持 Responses API,不支持传统的 Chat Completions 接口。错误示例:
The chatCompletion operation does not work with the specified model, gpt-5.1-codex. Please choose different model and try again.
下图为该错误在界面中的实际表现: gpt-5.1-codex 使用 Chat Completions 时的报错界面 说明当前请求走了 Chat Completions,而该模型在服务端只开放 Responses API,需通过配置改为使用正确接口。

3.1 需要走 Responses API 的模型(典型)

完整列表及更新以 Azure / 厂商官方文档 为准,例如:

3.2 在 OpenCode 中如何配置(推荐:配置文件添加参数)

通过在配置文件中为对应模型添加 apiCompatibility 参数,即可让 OpenCode 对该模型使用 Responses API,无需改代码。 1. 找到配置文件
  • WindowsC:\Users\<用户名>\.config\opencode\opencode.jsonc
  • macOS / Linux~/.config/opencode/opencode.jsonc
    如图:
部分模型需使用 Responses API 说明 2. 在自定义提供商的模型配置中添加参数 在已配置的提供商(如指向 LeapX 或自建 API 的 custom provider)里,对需要走 Responses API 的模型(如 gpt-5.1-codex)增加 "apiCompatibility": "responses",例如: opencode.jsonc 中为 gpt-5.1-codex 配置 apiCompatibility: responses
保存后,在 OpenCode 中选择该提供商下的 gpt-5.1-codex(如 backup_leapx/gpt-5.1-codex),请求会以 Responses API 格式发往该 baseURL。 3. 配置成功示例 下图为在 OpenCode 中选用配置好的模型(如 backup_v1/gpt-5.1-chat)正常对话的示例。 OpenCode 配置成功后对话示例

3.3 小结

四、推荐模型(经 LeapX 使用)

具体可用模型与 ID 以 LeapX 模型列表 为准。

配置成功示例

下图为使用 LeapX API 在 OpenCode 中正常对话的示例。 OpenCode 使用 LeapX API 成功样例

五、参考链接