OpenCode 及其他智能体：兼容 OpenAI 的配置

​

开始之前

• 选择一个 GoModel 主密钥，例如 change-me。
• 使用至少一个上游提供商密钥启动 GoModel。
• 使用 GoModel 的标准地址 http://localhost:8080/v1，除非您的客户端明确要求填写完整的端点 URL。

​

1. 运行 GoModel

docker run --rm -p 8080:8080 \
  -e GOMODEL_MASTER_KEY="change-me" \
  -e OPENAI_API_KEY="sk-..." \
  enterpilot/gomodel

​

2. 确认兼容 OpenAI 的 API

curl -s http://localhost:8080/v1/chat/completions \
  -H "Authorization: Bearer change-me" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4.1-mini",
    "messages": [
      {
        "role": "user",
        "content": "Reply with exactly ok"
      }
    ]
  }'

from openai import OpenAI

client = OpenAI(base_url="http://localhost:8080/v1", api_key="change-me")

completion = client.chat.completions.create(
    model="gpt-4.1-mini",
    messages=[{"role": "user", "content": "Reply with exactly ok"}],
)

print(completion.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "http://localhost:8080/v1",
  apiKey: "change-me",
});

const completion = await client.chat.completions.create({
  model: "gpt-4.1-mini",
  messages: [{ role: "user", content: "Reply with exactly ok" }],
});

console.log(completion.choices[0].message.content);

​

3. 配置您的编程智能体

​

OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "gomodel": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "GoModel",
      "options": {
        "baseURL": "http://localhost:8080/v1",
        "apiKey": "{env:OPENAI_API_KEY}"
      },
      "models": {
        "gpt-4.1-mini": {
          "name": "GPT-4.1 Mini",
          "limit": {
            "context": 200000,
            "output": 32768
          }
        }
      }
    }
  }
}

export OPENAI_API_KEY=change-me

​

Cline

• API Provider：OpenAI Compatible
• Base URL：http://localhost:8080/v1
• API Key：change-me
• Model ID：GET /v1/models 返回的某个模型

​

Roo Code

• API Provider：OpenAI Compatible
• Base URL：http://localhost:8080/v1
• API Key：change-me
• Model ID：GET /v1/models 返回的某个模型

​

Kilo Code

• API Provider：OpenAI Compatible
• Base URL：http://localhost:8080/v1
• API Key：change-me
• Model ID：GET /v1/models 返回的某个模型

http://localhost:8080/v1/chat/completions

​

4. 运行测试提示词

opencode run -m gomodel/gpt-4.1-mini \
  'Reply with exactly ok and no punctuation.'

ok

Reply with exactly ok and no punctuation.

​

5. 在 GoModel 中查看流量

​

当前状态

• OpenCode 已在本地验证，可在标准地址 http://localhost:8080/v1 上正常工作
• Cline、Roo Code 和 Kilo Code 遵循相同的兼容 OpenAI 的配置方式
• Roo Code 需要所选模型支持原生工具调用
• Kilo Code 既可以使用基础 URL，也可以使用完整的端点 URL

​

参考

• OpenCode 提供商文档：Providers
• Cline 兼容 OpenAI 的提供商文档：OpenAI Compatible
• Roo Code 兼容 OpenAI 的提供商文档：OpenAI Compatible
• Kilo Code 兼容 OpenAI 的提供商文档：OpenAI Compatible

​

验证日期：2026 年 3 月 10 日

• 针对 http://localhost:8080 上的 GoModel 实例进行的本地验证
• 使用 OpenCode 1.1.36 进行的本地验证
• Cline、Roo Code 和 Kilo Code 的官方文档

• OpenCode 可在 http://localhost:8080/v1 上正常工作
• 经验证的 OpenCode 请求使用了 POST /v1/chat/completions
• GoModel 控制台的审计日志立即显示了 OpenCode 的流量