---
title: "Der eigene Schlüssel für den Coding-Agent von Linear, über Kaeso"
description: "Der Cloud-Coding-Agent von Linear nimmt jetzt Ihren eigenen Schlüssel und jedes Gateway, das Anthropic Messages oder OpenAI Responses spricht. Richten Sie ihn auf Kaeso, und seine Sitzungen laufen über Ihre Schlüssel, Limits, Routen und Anfrageprotokolle. Schritt für Schritt."
url: https://kaeso.app/de/articles/linear-byok-through-kaeso
markdown: https://kaeso.app/de/articles/linear-byok-through-kaeso.md
language: de
alternates:
  en: https://kaeso.app/articles/linear-byok-through-kaeso.md
  zh-CN: https://kaeso.app/zh-CN/articles/linear-byok-through-kaeso.md
published: 2026-11-13
authors:
  - Kaeso Team
tags:
  - linear
  - Agents
  - byok
  - Anleitung
image: https://kaeso.app/articles/linear-byok-through-kaeso/cover.jpg
index: https://kaeso.app/de/llms.txt
---

# Der eigene Schlüssel für den Coding-Agent von Linear, über Kaeso

Der Cloud-Coding-Agent von Linear nimmt jetzt Ihren eigenen Schlüssel und jedes Gateway, das Anthropic Messages oder OpenAI Responses spricht. Richten Sie ihn auf Kaeso, und seine Sitzungen laufen über Ihre Schlüssel, Limits, Routen und Anfrageprotokolle. Schritt für Schritt.

> Jede Seite, jeder Artikel und jede Seite der Doku von Kaeso steht in https://kaeso.app/de/llms.txt.

- Veröffentlicht: 13. November 2026
- Lesezeit: 5 Min.
- Autor: Kaeso Team

Am 12. November hat Linear [seinen Cloud-Coding-Agent für eigene Schlüssel geöffnet](https://linear.app/changelog/2026-11-12-bring-your-own-key). Bis dahin lief jede Sitzung auf Modellen, die Linear für Sie einkaufte. Jetzt kann ein Admin das eigene Anthropic- oder OpenAI-Konto des Workspace verbinden, Amazon Bedrock oder einen eigenen Endpunkt: jedes Gateway, das die Anthropic Messages API oder die OpenAI Responses API spricht.

Kaeso spricht beide. Richten Sie Linear auf Ihre Installation, und jede Anfrage des Agents geht durch ein Projekt, das Sie steuern: abgerechnet über Ihre Anbieterschlüssel zu Ihren Preisen, gehalten an Ihre Limits, geleitet von Ihren Aliassen und festgehalten in Ihrem Anfrageprotokoll.

## Was sich ändert und was nicht

Der Agent von Linear, Linear Code, führt Claude Code oder Codex in einer Sandbox aus. Der eigene Schlüssel verlegt die Modellaufrufe; die Sandbox bleibt bei Linear.

| | Mit Linear-Credits | Über Kaeso |
| --- | --- | --- |
| Modellnutzung | Bezahlt mit Linear-AI-Credits | Bezahlt über Ihre Anbieterschlüssel in Kaeso, zu Ihren Preisen |
| Laufzeit der Sandbox | Linear-AI-Credits | Linear-AI-Credits, unverändert |
| Wer das Modell aufruft | Linear | Ihre Kaeso-Installation, mit Ihren Anbieterschlüsseln |
| Limits und Protokolle | Die von Linear | Die Limits, Budgets und das Anfrageprotokoll Ihres Projekts |

Der Workspace braucht für die Sandbox also weiter AI-Credits. Linear braucht außerdem einen API-Schlüssel, kein ChatGPT- oder Claude-Abo; hinter Kaeso ist dieser Schlüssel ein Kaeso-Schlüssel. Der eigene Schlüssel steht in allen aktuellen Tarifen von Linear bereit, und nur ein Owner oder Admin des Workspace kann ihn einrichten. Für Mitglieder ändert sich nichts: Sie weisen dem Agent Issues zu wie bisher.

## Bevor Sie beginnen

- **Eine Kaeso-Installation, die Linear erreicht.** Die Sandbox läuft in der Cloud von Linear, also braucht die Installation eine öffentliche HTTPS-Adresse, etwa `https://kaeso.example.com`. Eine Installation auf Ihrem Laptop oder hinter einem VPN genügt nicht. [Wo Sie Kaeso betreiben](https://kaeso.app/de/articles/where-to-run-kaeso) hilft bei der Wahl.
- **Ein Projekt für den Agent,** mit den Modellen, die er nutzen soll, in seinem Katalog und Anbieterschlüsseln dafür. Ein eigenes Projekt hält Ausgaben, Limits und Protokolle des Agents getrennt von Ihren Apps.
- **Admin-Rechte in Linear,** und Linear Code, der Cloud-Coding-Agent, eingeschaltet unter **Settings › AI & agents**.

## 1. Einen Schlüssel für Linear erstellen

Öffnen Sie in der Kaeso-Konsole das Projekt und wählen Sie **API-Schlüssel › Schlüssel erstellen**. Geben Sie ihm einen Namen, unter dem Sie die Anfragen von Linear leicht finden, etwa `linear-agent`. Ein Dienstkonto des Projekts ist ein besserer Inhaber als eine Person, so überdauert der Schlüssel jeden, der das Team verlässt.

Wählen Sie unter **Modelle und Limits** die Modelle, die der Agent aufrufen darf, und setzen Sie ein Token-Budget für den Tag oder den Monat ([Limits und Budgets](https://docs.kaeso.app/de/console/limits-and-budgets)). Kopieren Sie den Schlüssel: Kaeso zeigt ihn nur einmal.

Nehmen Sie hier ein Token-Budget statt eines Ausgabenbudgets. Kaeso bepreist eine Anfrage nach ihren Token und kann Server-Tools, die der Anbieter pro Aufruf abrechnet, etwa die Websuche, nicht bepreisen. Solange ein Ausgabenbudget für eine Anfrage gilt, lehnt Kaeso eine Anfrage mit einem solchen Tool ab, und Coding-Agents suchen im Web. Ein Token-Budget lässt diese Anfragen durch.

## 2. Kaeso in Linear verbinden

Öffnen Sie in Linear **Settings › Linear Code**. Unter **Agent configuration** wählt **Agent**, was Linear Code antreibt, etwa Claude Code, und **Model**, welches Modell es nutzt. Darunter hat **Inference** zwei Zeilen, und jede sagt, wer eine Modellfamilie betreibt und bezahlt:

| Zeile | Für | Kaeso-Endpunkt, den sie braucht |
| --- | --- | --- |
| **Anthropic** | Claude-Modelle | Anthropic Messages, `POST /v1/messages` |
| **OpenAI** | OpenAI-Modelle | OpenAI Responses, `POST /v1/responses` |

Beide Zeilen stehen zuerst auf **Linear credits**, und jede Verbindung gilt für den ganzen Workspace. Verbinden Sie die Zeile der Modelle, die Ihr Agent nutzt, oder beide.

Für **Claude-Modelle**, in der Zeile **Anthropic**:

1. Öffnen Sie das Menü mit **Linear credits** und wählen Sie **API key**. **Add API key** öffnet sich.
2. Wählen Sie unter **Provider** den Eintrag **Custom endpoint**.
3. **Endpoint URL**: die Adresse Ihrer Installation, ohne Pfad, so wie der Platzhalter `https://api.anthropic.com` geschrieben ist. Der Agent hängt `/v1/messages` selbst an.
4. **API key**: der Kaeso-Schlüssel aus Schritt 1.
5. Wählen Sie **Test connection**, dann **Save**.

```text
Endpoint URL   https://kaeso.example.com
API key        sk-kso-…
```

Für **OpenAI-Modelle**, in der Zeile **OpenAI**, gehen Sie genauso vor, mit der Adresse Ihrer Installation und `/v1`, so wie die SDKs von OpenAI sie nehmen. Der Agent hängt `/responses` an. Nehmen Sie denselben Kaeso-Schlüssel oder einen zweiten, wenn Sie die Nutzung jeder Familie getrennt sehen wollen.

```text
Endpoint URL   https://kaeso.example.com/v1
API key        sk-kso-…
```

Scheitert **Test connection** mit 404, setzt Linear den Pfad anders zusammen, als Sie ihn eingegeben haben: Fügen Sie `/v1` hinzu oder nehmen Sie es weg. Ein 401 heißt, der Schlüssel ist falsch oder abgelaufen, ein 403, dass ihm der Inferenz-Zugriff fehlt. Brechen Sie den Dialog ab, bleiben die Modelle der Zeile auf Linear-Credits.

Neue Sitzungen nutzen die Verbindung ihrer Modelle, auch Sitzungen, die ein Loop startet. Laufende Sitzungen behalten den Anbieter, mit dem sie begonnen haben. Lassen Sie einen gültigen Schlüssel in einer Zeile, solange Sitzungen darauf weitermachen könnten.

## 3. Die erste Sitzung prüfen

Weisen Sie dem Agent ein Issue zu und öffnen Sie in Kaeso die **Anfrageprotokolle** des Projekts. Filtern Sie nach dem Schlüssel `linear-agent`: Jeder Schritt der Sitzung ist dort eine Anfrage, mit Modell, Token, Kosten und Dauer. Kaeso protokolliert auch eine abgelehnte Anfrage mit dem, was sie verlangt hat, sodass eine Sitzung, die sofort scheitert, Ihnen den Grund zeigt.

Das Protokoll zeigt auch die genauen Modell-IDs, die Linear sendet. Linear wählt das Modell unter **Model**, auf **Auto**, solange Sie keines wählen, etwa Claude Opus 5.5 oder GPT-6 Sol. Auf **Auto** kann eine Sitzung ein Modell der anderen Familie verlangen, also verbinden Sie beide Zeilen oder wählen Sie ein Modell, dessen Zeile Sie verbunden haben. Jede ID, die der Agent verlangt, muss im Katalog des Projekts stehen und für den Schlüssel erlaubt sein; sonst antwortet Kaeso mit 404, und die Sitzung endet. Scheitert eine Sitzung so, nennt die abgelehnte Anfrage im Protokoll die ID, die fehlt.

## 4. Die Modelle des Agents leiten

Linear sendet eine feste Modell-ID, und Kaeso entscheidet, was sie bedient. Ein [Alias](https://docs.kaeso.app/de/console/models-and-aliases) hat Vorrang vor einem gleichnamigen Modell. Sie können also einen Alias genau so nennen wie das Modell, das Linear verlangt, und die Liste kennzeichnet ihn mit **Verdeckt ein Modell**. Geben Sie ihm dann eine Route:

- **Eine Fallback-Kette.** Ist die API von Anthropic überlastet oder das Guthaben eines Schlüssels aufgebraucht, antwortet der nächste Schritt, etwa ein anderer Anbieter, der dasselbe Modell bereitstellt. Kaeso merkt sich einen Schritt, der aus einem dauerhaften Grund scheiterte, und überspringt ihn bei den folgenden Anfragen, sodass eine lange Sitzung nicht bei jedem Schritt auf einen ausgefallenen Anbieter wartet ([Alias-Routen](https://docs.kaeso.app/de/concepts/alias-routes)).
- **Das Modell eines anderen Anbieters.** Kaeso übersetzt zwischen den Formaten, Streams und Tool-Aufrufe eingeschlossen, sodass ein anderes Modell im Katalog den Alias bedienen kann, den der Agent verlangt ([Formatübersetzung](https://docs.kaeso.app/de/concepts/format-translation)). Testen Sie eine solche Route mit echten Issues, bevor Sie sich darauf verlassen: Ein Coding-Agent stützt sich stärker auf die Tool-Nutzung seines Modells als die meisten Apps.
- **Eine Aufteilung.** Schicken Sie einen Teil der Sitzungen an ein zweites Modell, um beide an Ihren eigenen Issues zu vergleichen, mit dem Anfrageprotokoll als Beleg.

Eine geänderte Route gilt ab der nächsten Anfrage. Die Einstellungen in Linear fassen Sie nicht mehr an.

## Zurückwechseln

Um Kaeso zu verlassen, stellen Sie die Zeile unter **Inference** zurück auf **Linear credits** oder ersetzen ihren Schlüssel. Neue Sitzungen nutzen dann die Modelle von Linear; Sitzungen, die über Kaeso begonnen haben, brauchen zum Weitermachen weiter den Kaeso-Schlüssel. Um den Agent sofort abzuschneiden, schalten Sie den Schlüssel in Kaeso unter **API-Schlüssel** aus.

## Mehr erfahren

- [Coding-Tools](https://docs.kaeso.app/de/get-started/coding-tools): Claude Code und Codex auf Ihrem eigenen Rechner mit Kaeso, mit denselben Basis-URLs.
- [Linear cloud coding agent](https://linear.app/docs/linear-cloud-coding-agent): Die Dokumentation von Linear, mit Tarifen, Abrechnung und Umgebungen.
- [Alias-Routen](https://kaeso.app/de/articles/alias-routes): Fallbacks, Bedingungen und Aufteilungen im Routen-Editor von Kaeso.

Von Kaeso Team

## Weitere Artikel

- [Kaeso 0.6: ein Gateway für Chat und Medien, mit Alias-Routen und einem MCP-Portal](https://kaeso.app/de/articles/kaeso-0-6.md): Kaeso 0.6.0 ist erschienen. Apps erzeugen Bilder, Sprache und Video über dasselbe Gateway wie Chat, Gemini-Apps verbinden sich unter /v1beta, Aliasse werden zu Routen mit Fallbacks und Aufteilungen, und jedes Projekt bekommt ein MCP-Portal. Hier steht, was sich geändert hat und wie Sie aktualisieren.
- [Wir stellen das MCP-Portal vor](https://kaeso.app/de/articles/mcp-portal.md): Jedes Kaeso-Projekt hat jetzt ein MCP-Portal. Verbinden Sie die MCP-Server Ihrer Organisation einmal, wählen Sie, welche Tools jedes Projekt anbietet, und lassen Sie claude.ai, ChatGPT, Cursor und Ihre eigenen Agenten sie aufrufen, mit Anmeldung, Rechten, Limits und Protokollen von Kaeso.

[Alle Artikel ansehen](https://kaeso.app/de/articles.md)

## Ihr Gateway. Ihre Request-Logs

```bash
curl -fsSL https://kaeso.app/install.sh | sh
```

[Kaeso installieren](https://docs.kaeso.app/de/self-hosting/installation) · [Live-Demo öffnen](https://demo.kaeso.app)
