跳到主要内容
ChatGPT API
文档

文档

如何把 ChatGPT 接入 OpenCode

最后更新:

把 OpenCode 配置成使用 ChatGPT 只需要两分钟:在配置里填上密钥和我们的 OpenAI 兼容 base URL,智能体就会通过 ChatGPT API 调用 OpenAI 模型,既不用插件,也不用改代码。

OpenCode 是什么

OpenCode 自称是开源的 AI 编码智能体,可在终端、IDE 或桌面应用中使用。它与各类内置助手最大的不同在于什么都不锁死:客户端开源,模型可以来自 75+ 家提供方中的任意一家,也包括本地模型。

opencode

Ask anything... "Fix broken tests"

Build · GPT-5.6 Luna OpenAI · medium

tab agents ctrl+p commands

开源

项目完全开源、本地安装,不会被某一家厂商和它的套餐绑住。

任意模型

有 75+ 家提供方可选,也支持本地模型。我们的端点就当作普通的 OpenAI 提供方接入。

借助 LSP 理解项目

OpenCode 会自动启动对应的语言服务器,模型面对的是类型和报错,而不只是文件里的纯文本。

终端、IDE 或桌面端

同一个智能体有三种形态,支持多会话并行,还能把任意会话分享成链接。

需要准备什么

  • 已在本机安装好的 OpenCode
  • 仪表盘中的 ChatGPT API 密钥——注册即有 $0.25 余额可用于测试
  • 一个你打算让智能体处理的项目

配置 OpenCode

1. 安装 OpenCode

如果还没装 OpenCode,请到官网下载,那里提供 macOS、Linux 和 Windows 的版本。先运行一次,让它生成自己的配置目录。

下载 OpenCode

2. 在配置里声明提供方

OpenCode 的全部设置都在一个文件里。用任意编辑器打开它:

~/.config/opencode/opencode.jsonc

  • 还没有这个文件——连同上级目录一起新建。
  • 文件已存在——不要整体覆盖,只需把 provider.openai 这一块加到原有内容里。
opencode.jsonc
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "openai": {
      "options": {
        "baseURL": "https://api.llm-gate.tech/v1",
        "apiKey": "[生成的密钥]"
      }
    }
  }
}

3. 运行并验证

保存文件,在项目目录中启动 OpenCode。此后所有发往 openai 提供方的请求都会走 ChatGPT API——请把 [生成的密钥] 换成你仪表盘里的密钥。

创建 API 密钥

常见问题

需要 ChatGPT Plus 订阅吗?

不需要。OpenCode 调用的是 API,而不是 ChatGPT 网页版,因此与订阅无关。费用按 token 结算,注册后还有 $0.25 余额,可以在充值前先把链路跑通。

必须删掉现有的 OpenCode 配置吗?

不必。把 provider.openai 这一块加进现有文件就够了,主题、智能体和快捷键都保持原样。

通过 ChatGPT API 在 OpenCode 里能用哪些模型?

我们通过 API 提供的全部模型:GPT-5.6 系列(sol、terra、luna),以及 GPT-5.5、GPT-5.4 和 GPT-5.4-mini。可以在配置里切换,也可以直接在 OpenCode 界面里切换。

这和官方 OpenAI 密钥有什么区别?

模型相同、请求格式相同,只有 base URL 和密钥不同。区别在价格:同样的 token 比官方标价便宜 50%。

可以把密钥放在环境变量里吗?

可以。与其在配置里写死,不如从环境变量读取密钥,这样它就不会留在一个很容易被误提交的文件里。

下一步

OpenCode 已经接好。接下来挑一个适合你工作的模型,再看看它的花费。