OpenCode & andere Agents: OpenAI-kompatible Einrichtung

​

Bevor Sie beginnen

• Wählen Sie einen GoModel-Master-Key, zum Beispiel change-me.
• Starten Sie GoModel mit dem API-Key mindestens eines Upstream-Providers.
• Verwenden Sie die Standard-URL von GoModel http://localhost:8080/v1, sofern Ihr Client nicht ausdrücklich eine vollständige Endpunkt-URL verlangt.

​

1. GoModel starten

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

​

2. Die OpenAI-kompatible API prüfen

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. Ihren Coding-Agent konfigurieren

​

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: ein Modell, das GET /v1/models zurückgibt

​

Roo Code

• API Provider: OpenAI Compatible
• Base URL: http://localhost:8080/v1
• API Key: change-me
• Model ID: ein Modell, das GET /v1/models zurückgibt

​

Kilo Code

• API Provider: OpenAI Compatible
• Base URL: http://localhost:8080/v1
• API Key: change-me
• Model ID: ein Modell, das GET /v1/models zurückgibt

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

​

4. Einen Test-Prompt ausführen

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

ok

Reply with exactly ok and no punctuation.

​

5. Den Traffic in GoModel prüfen

​

Aktueller Stand

• OpenCode wurde lokal geprüft und funktionierte mit dem Standard-Endpunkt http://localhost:8080/v1
• Cline, Roo Code und Kilo Code folgen demselben OpenAI-kompatiblen Einrichtungsmodell
• Roo Code benötigt Unterstützung für natives Tool Calling durch das gewählte Modell
• Kilo Code kann entweder eine Base-URL oder eine vollständige Endpunkt-URL verwenden

​

Referenzen

• OpenCode-Dokumentation zu Providern: Providers
• Cline-Dokumentation zum OpenAI-kompatiblen Provider: OpenAI Compatible
• Roo-Code-Dokumentation zum OpenAI-kompatiblen Provider: OpenAI Compatible
• Kilo-Code-Dokumentation zum OpenAI-kompatiblen Provider: OpenAI Compatible

​

Geprüft am 10. März 2026

• lokale Prüfung mit einer GoModel-Instanz unter http://localhost:8080
• lokale Prüfung mit OpenCode 1.1.36
• die offizielle Dokumentation von Cline, Roo Code und Kilo Code

• OpenCode funktionierte mit http://localhost:8080/v1
• der geprüfte OpenCode-Request verwendete POST /v1/chat/completions
• die Audit-Logs im GoModel Dashboard zeigten den OpenCode-Traffic sofort an