Persönliche API-Keys

Mit einem persönlichen API-Key erreichst du die Modelle deines Workspace auch außerhalb von Langdock, zum Beispiel in Coding-Tools wie Claude Code, GitHub Copilot oder Codex oder in einem eigenen Projekt. Der Key authentifiziert dich und zählt zu deinem Nutzungsbudget. Dein Admin kann persönlichen Keys zusätzlich die Workflow-Schreib-API und die Scheduled Tasks API erlauben.

Bereich API-Schlüssel in den Account-Einstellungen mit gemeinsamem Nutzungsfortschritt in Prozent und den persönlichen API-Ausgaben diesen Monat

Dein Admin muss dir zuerst Zugriff geben, bevor API-Schlüssel in deinen Account-Einstellungen auftaucht. Dieser Zugriff steuert, ob die Seite angezeigt wird. Die persönliche API-Nutzung zählt zu deinem effektiven Budget und zum Workspace-Ausgabenlimit. Wenn dein effektives persönliches Budget aufgebraucht ist, geben persönliche API-Anfragen einen Fehler zurück und verwenden kein Fallback-Modell. Sobald das Workspace-Ausgabenlimit erreicht ist, geben persönliche API-Anfragen ebenfalls einen Fehler zurück und verwenden kein Fallback-Modell. Dein Workspace-Admin muss das Limit erhöhen oder auf Unbegrenzt setzen. Alternativ musst du warten, bis der aktuelle Abrechnungszeitraum zurückgesetzt wird.

Persönlichen API-Key erstellen

API-Schlüssel öffnen

Gehe zu Einstellungen > Account > API-Schlüssel.

Key-Details eingeben

Bereich Deine API-Keys mit dem Button API-Key erstellen

Klicke auf API-Key erstellen. Gib dem Key einen Namen, der dir zeigt, wo du ihn einsetzt, damit du später weißt, welches Tool du aktualisieren musst, und wähle ein Ablaufdatum.

Key erstellen und kopieren

Dialog zum Erstellen eines neuen API-Keys mit Feldern für Name und Ablaufdatum und einer Übersicht, was der Key kann

Klicke auf API-Key erstellen, kopiere den Key und bewahre ihn sicher auf. Langdock zeigt ihn nur ein einziges Mal.

Teile einen persönlichen API-Key niemals mit anderen. Er authentifiziert sich als du und verbraucht dein Budget. Wer ihn hat, arbeitet also unter deinem Namen. Für gemeinsame Anwendungen und Automatisierungen nimm einen Workspace-API-Key. Wie du Keys sicher aufbewahrst, steht in den Best Practices für API-Schlüssel.

Auf der Seite siehst du den gemeinsamen Nutzungsfortschritt als Prozentwert, getrennt von Persönliche API-Ausgaben diesen Monat. In der Cloud siehst du Gemeinsame Extra Usage. Bei BYOK und Dedicated siehst du Gemeinsame inkludierte Nutzung diese Woche und Gemeinsame Extra Usage, jeweils mit eigenem Zeitpunkt der Zurücksetzung. Wenn dein individuelles Limit aufgebraucht ist, geben persönliche API-Anfragen einen Fehler zurück und verwenden kein Fallback-Modell. Du kannst ein höheres Limit anfragen, sofern Nutzungslimit-Anfragen aktiviert sind, oder du fragst deinen Workspace-Admin. Wenn der Workspace sein Ausgabenlimit erreicht hat, reicht ein höheres individuelles Limit nicht aus. Dein Workspace-Admin muss das Workspace-Ausgabenlimit erhöhen oder auf Unbegrenzt setzen. Alternativ musst du warten, bis der aktuelle Abrechnungszeitraum zurückgesetzt wird.

Tool verbinden

Unter Deine Tools verbinden findest du die Einrichtung für Claude Code, Claude Desktop, OpenCode, Codex, GitHub Copilot und direkte API-Aufrufe mit cURL. Mit demselben Key kannst du auch Cursor verbinden. Wähle ein verfügbares Modell aus, die Beispiele passen sich automatisch an, und folge dann der Anleitung für dein Tool. Die Anleitungen unten entsprechen dieser Einrichtung. Eine Übersicht der Langdock Completion APIs findest du in der API-Dokumentation. Ersetze YOUR_API_KEY durch deinen Key und your-model-id durch eine ID aus Verfügbare Modelle. Nutze eu oder us passend zur Modellregion deines Workspace. Für ein OpenAI-kompatibles Modell in der Region global nutze /openai/global/v1 und liste Modelle unter /openai/global/v1/models auf. Für ein in der Schweiz gehostetes OpenAI-kompatibles Modell nutze /openai/ch/v1 und liste Modelle unter /openai/ch/v1/models auf. In Dedicated Deployments beginnt die Basis-URL mit der Origin deines Deployments statt mit https://api.langdock.com.

Claude Code nutzt die Anthropic Messages API über Langdock.

Verfügbare Claude-Modelle prüfen

curl https://api.langdock.com/anthropic/eu/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

Einstellungen hinterlegen

Füge dies in ~/.claude/settings.json ein (unter Windows: %USERPROFILE%\.claude\settings.json) und erstelle die Datei falls nötig. Ersetze die Modell-IDs durch welche aus dem vorherigen Schritt und stelle sicher, dass ANTHROPIC_API_KEY nicht gesetzt ist:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.langdock.com/anthropic/eu",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "your-model-id",
    "ANTHROPIC_SMALL_FAST_MODEL": "your-model-id"
  }
}

Claude Code starten

claude

Claude Code spricht die Anthropic Messages API, die Langdock unter der Base URL oben bereitstellt. Alle Anfragen laufen jetzt über deinen Workspace.

Claude Desktop kann Chats über Langdock-Modelle mit Third-Party Inference laufen lassen.

Developer Mode aktivieren

Öffne in Claude Desktop Help → Troubleshooting → Enable Developer Mode.

Gateway konfigurieren

Öffne Developer → Configure third-party inference. Setze Inference provider auf Gateway. Trage unter Gateway credentials Folgendes ein:

Gateway base URL:    https://api.langdock.com/anthropic/eu
Gateway API key:     YOUR_API_KEY
Gateway auth scheme: bearer
Credential kind:     Static API key

Testen und übernehmen

Lass Model discovery aktiviert und klicke auf Test connection und Test model discovery. Claude findet die in deinem Workspace verfügbaren Anthropic-Modelle. Klicke auf Save Changes und anschließend auf Apply Changes. Claude startet neu; wähle Continue with Gateway, falls du dazu aufgefordert wirst.

Für Cursor gibt es unter Deine Tools verbinden noch keine eigene Karte. Richte den OpenAI-Provider von Cursor auf Langdock aus:

Modell-Einstellungen öffnen

Öffne in Cursor Cursor Settings > Models.

Key und Basis-URL hinterlegen

Füge deinen persönlichen API-Key beim OpenAI-Provider ein und klicke auf Save. Aktiviere Override OpenAI Base URL und trage diese URL mit /v1 und ohne abschließenden Slash ein:

https://api.langdock.com/openai/eu/v1

Workspace-Modell hinzufügen

Gib die exakte ID eines Modells aus Verfügbare Modelle ein und klicke auf Add Custom Model. Wähle dieses Modell für den Chat.

Eigene API-Keys gelten in Cursor nur für Chat-Modelle. Tab nutzt weiterhin die integrierten Cursor-Modelle. Der Agent-Modus schlägt mit einem HTTP-400-Fehler fehl, weil die Chat Completions API von Langdock nur Tools vom Typ function akzeptiert. Für agentisches Coding nutze stattdessen Claude Code, Codex, GitHub Copilot oder OpenCode.

Codex nutzt den OpenAI Responses-Endpunkt von Langdock (wire_api = "responses").

Config hinterlegen

Füge dies zu ~/.codex/config.toml hinzu (unter Windows: %USERPROFILE%\.codex\config.toml) und lege die Datei an, falls sie noch nicht existiert:

model = "your-model-id"
model_provider = "workspace"

[model_providers.workspace]
name = "Langdock"
base_url = "https://api.langdock.com/openai/eu/v1"
wire_api = "responses"
experimental_bearer_token = "YOUR_API_KEY"

Codex starten

codex

Oder öffne die Codex-/ChatGPT-Desktop-App. Diese Datei speichert deinen Key auf diesem Computer. Wenn du den Rechner teilst, widerrufe den Key in Langdock und erstelle einen neuen.

GitHub Copilot nutzt den OpenAI Chat Completions-Endpunkt von Langdock. Copilot Chat in VS Code, der Agent-Modus und die Copilot CLI brauchen ein OpenAI-kompatibles Modell, das Tools unterstützt.

Custom Endpoint in VS Code hinzufügen

In VS Code öffne die Command Palette und führe Chat: Manage Language Models aus. Wähle Add Models → Custom Endpoint. Nutze Langdock als Gruppennamen, füge deinen API-Key ein und wähle Chat Completions.

Provider hinterlegen

VS Code öffnet chatLanguageModels.json. Füge diesen Provider hinzu oder führe ihn mit vorhandenen zusammen, speichere und wähle das Modell im Chat-Picker:

[
  {
    "name": "Langdock",
    "vendor": "customendpoint",
    "apiKey": "YOUR_API_KEY",
    "apiType": "chat-completions",
    "models": [
      {
        "id": "your-model-id",
        "name": "Your model",
        "url": "https://api.langdock.com/openai/eu/v1/chat/completions",
        "toolCalling": true,
        "streaming": true
      }
    ]
  }
]

Oder die Copilot CLI nutzen

Führe das in deinem Terminal aus. Füge die Exports zu deinem Shell-Profil hinzu, wenn sie dauerhaft gelten sollen. Unter Windows setzt du dieselben Werte mit $env::

export COPILOT_PROVIDER_BASE_URL="https://api.langdock.com/openai/eu/v1"
export COPILOT_PROVIDER_API_KEY="YOUR_API_KEY"
export COPILOT_MODEL="your-model-id"
copilot

Was diese Verbindung abdeckt

Damit laufen Copilot Chat, Agent-Modus und die Copilot CLI über deinen Workspace. Inline-Ghost-Text-Completions nutzen weiterhin GitHub. Bei Copilot Business oder Enterprise muss ein Admin ggf. die Richtlinie Bring Your Own Language Model Key aktivieren.

OpenCode nutzt den Anthropic-kompatiblen Endpunkt über Langdock.

Config hinterlegen

Füge das zu opencode.json in deinem Projekt hinzu, oder zu ~/.config/opencode/opencode.json (unter Windows: %USERPROFILE%\.config\opencode\opencode.json). Unter models kannst du weitere Workspace-Modelle eintragen:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "workspace": {
      "npm": "@ai-sdk/anthropic",
      "name": "Langdock",
      "options": {
        "baseURL": "https://api.langdock.com/anthropic/eu/v1"
      },
      "models": {
        "your-model-id": { "name": "Your model" }
      }
    }
  }
}

OpenCode starten und verbinden

opencode

Führe /connect aus, wähle Other, gib workspace als Provider-ID ein und füge dann deinen API-Key ein.

Modell wählen

Wähle das Modell mit /models oder starte OpenCode direkt damit:

opencode --model workspace/your-model-id

Rufe die Completion-APIs direkt aus eigenen Projekten auf.

Verfügbare Modelle auflisten

curl https://api.langdock.com/openai/eu/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

Chat-Completions-Anfrage senden

curl https://api.langdock.com/openai/eu/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "your-model-id", "messages": [{"role": "user", "content": "Hello"}]}'

Oder die Anthropic-kompatible API nutzen

curl https://api.langdock.com/anthropic/eu/v1/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "your-model-id", "max_tokens": 1024, "messages": [{"role": "user", "content": "Hello"}]}'

Nutze ein beliebiges OpenAI- oder Anthropic-kompatibles SDK und setze dessen Base URL auf die URLs oben. Die vollständigen Request-Formate stehen in der Chat Completions-, Responses- und Anthropic Messages-API-Dokumentation.

Dein Key funktioniert mit der OpenAI-kompatiblen Chat Completions API, der Responses API und der Image Generations API, der Anthropic Messages API, der Google Completion API und der Mistral Completion API. Welche davon du aufrufen kannst, hängt von den Modellen in deinem Workspace ab. Unter Verfügbare Modelle siehst du, was du für die integrierten Anleitungen für OpenAI und Anthropic auswählen kannst. Für Google und Mistral folgst du stattdessen der API-Dokumentation. Completion ist auf jedem persönlichen API-Key enthalten. Dein Admin kann weitere Scopes freigeben, zum Beispiel Agenten, Skills, Prompts, Embedding, Knowledge Folder, Integrations und Workflows. User Management, Audit Logs, Usage Export, Compliance und Governance brauchen weiterhin einen Workspace-API-Key. Erlaubt dein Admin die Scheduled Tasks API, kann ein neuer Key Aufgaben anlegen, die dir gehören und unter Geplant erscheinen. Die Workflow-Schreib-API kann ein neuer Key nutzen, um Workflows zu erstellen, zu aktualisieren und zu veröffentlichen, die du bearbeiten darfst. Bestehende Keys behalten die Scopes, mit denen sie erstellt wurden. Die Workflow-Lösch-API kannst du einem persönlichen Key nicht geben. Ein Workspace-API-Key kann zusätzlich Meetings Read API bekommen, wenn Allgemeiner Zugriff in Meetings aktiv ist. Dieser Key kann Notizen und Transkripte von Meetings in Ordnern lesen, die mit dem ganzen Workspace geteilt sind.

Key rotieren oder widerrufen

Öffne das Menü neben einem Key unter Deine API-Keys:

Key rotieren ersetzt das Secret und zeigt das neue nur einmal an. Das alte funktioniert sofort nicht mehr, aktualisiere also jedes verbundene Tool direkt.
Key widerrufen schaltet den Key endgültig ab.

Auch dein Workspace-Admin kann deine Keys widerrufen. Sie funktionieren außerdem nicht mehr, wenn dein Admin dir den Zugriff auf persönliche API-Keys entzieht oder deine Workspace-Mitgliedschaft deaktiviert.

Erste Schritte

Chat

Skills

Dateien

Agenten

Workflows

Meetings

Apps

Integrationen

Desktop-App

Mobile-App

Microsoft Add-ins

Modelle & Limits

Anleitungen

Account

Ressourcen

Fehlerbehebung

Persönliche API-Keys

Persönlichen API-Key erstellen

Tool verbinden

Key rotieren oder widerrufen

​Persönlichen API-Key erstellen

​Tool verbinden

​Key rotieren oder widerrufen

Persönlichen API-Key erstellen

Tool verbinden

Key rotieren oder widerrufen