For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Hauptnavigation

Codex in Linear verwenden

Codex-Chats aus Linear-Issues starten

Nutze Codex in Linear, um Arbeit direkt aus Issues zu delegieren. Weise Codex ein Issue zu oder erwähne @Codex in einem Kommentar. Codex erstellt daraufhin einen Cloud-Chat und informiert dich über Fortschritte und Ergebnisse.

Codex in Linear ist für kostenpflichtige Tarife verfügbar (siehe Preise).

Wenn du einen Enterprise-Tarif nutzt, bitte die Administration deines ChatGPT-Workspace, Codex-Cloud-Chats in den Workspace-Einstellungen und Codex for Linear in den Konnektor-Einstellungen zu aktivieren.

Linear-Integration einrichten

  1. Richte Codex-Cloud-Chats ein, indem du GitHub in Codex verbindest und eine Umgebung für das Repository erstellst, in dem Codex arbeiten soll.
  2. Öffne die Codex-Einstellungen und installiere Codex for Linear für deinen Workspace.
  3. Verknüpfe dein Linear-Konto, indem du @Codex in einem Kommentarthread zu einem Linear-Issue erwähnst.

Arbeit an Codex delegieren

Du kannst Arbeit auf zwei Arten delegieren:

Codex ein Issue zuweisen

Nach der Installation der Integration kannst du Codex genauso Issues zuweisen wie deinen Teammitgliedern. Codex beginnt mit der Arbeit und veröffentlicht Fortschrittsmeldungen im Issue.

@Codex in Kommentaren erwähnen

Du kannst @Codex auch in Kommentarthreads erwähnen, um Arbeit zu delegieren oder Fragen zu stellen. Sobald Codex geantwortet hat, kannst du denselben Chat durch eine Antwort im Thread fortsetzen.

Sobald Codex mit der Bearbeitung eines Issues beginnt, wählt es eine Umgebung und ein Repository aus. Um ein bestimmtes Repository vorzugeben, nenne es in deinem Kommentar, zum Beispiel: @Codex fix this in openai/codex.

So verfolgst du den Fortschritt:

  • Öffne im Issue Aktivität , um Fortschrittsmeldungen zu sehen.
  • Öffne den Chat-Link, um den Fortschritt genauer zu verfolgen.

Sobald Codex fertig ist, veröffentlicht es eine Zusammenfassung und einen Link zum abgeschlossenen Chat, damit du einen Pull Request erstellen kannst.

So wählt Codex eine Umgebung und ein Repository aus

  • Linear schlägt anhand des Issue-Kontexts ein Repository vor. Codex wählt die Umgebung aus, die am besten zu diesem Vorschlag passt. Ist die Anfrage nicht eindeutig, verwendet Codex die zuletzt von dir genutzte Umgebung.
  • Der Chat wird auf dem Standard-Branch des ersten Repositorys ausgeführt, das in der Repository-Zuordnung dieser Umgebung aufgeführt ist. Aktualisiere die Repository-Zuordnung in Codex, wenn du ein anderes Standard-Repository oder weitere Repositorys benötigst.
  • Wenn keine geeignete Umgebung oder kein geeignetes Repository verfügbar ist, erklärt Codex in einer Antwort in Linear, wie du das Problem vor einem erneuten Versuch behebst.

Issues automatisch Codex zuweisen

Mit Triage-Regeln kannst du Issues automatisch Codex zuweisen:

  1. Öffne in Linear die Einstellungen.
  2. Wähle unter Deine Teams dein Team aus.
  3. Öffne in den Workflow-Einstellungen Triage und aktiviere die Funktion.
  4. Erstelle unter Triage-Regeln eine Regel und wähle Delegieren > Codex sowie gegebenenfalls weitere Eigenschaften aus.

Linear weist neue Issues, die in die Triage aufgenommen werden, automatisch Codex zu. Wenn du Triage-Regeln verwendest, führt Codex Chats mit dem Konto der Person aus, die das Issue erstellt hat.

Datennutzung, Datenschutz und Sicherheit

Wenn du @Codex erwähnst oder Codex ein Issue zuweist, erhält Codex dessen Inhalt, um deine Anfrage zu verstehen und einen Chat zu erstellen. Für die Datenverarbeitung gelten die Datenschutzrichtlinie, die Nutzungsbedingungen und weitere geltende Richtlinien von OpenAI. Weitere Informationen zur Sicherheit findest du in der Dokumentation zur Sicherheit von Codex.

Codex verwendet große Sprachmodelle, die Fehler machen können. Überprüfe Antworten und Diffs daher immer.

Tipps und Fehlerbehebung

  • Fehlende Verbindungen: Wenn Codex deine Verbindung mit Linear nicht bestätigen kann, antwortet es im Issue mit einem Link, über den du dein Konto verbinden kannst.
  • Unerwartete Auswahl der Umgebung: Nenne in deiner Antwort im Thread die gewünschte Umgebung (zum Beispiel @Codex please run this in openai/codex).
  • Falscher Codeabschnitt: Ergänze im Issue weiteren Kontext oder gib in deinem Kommentar mit @Codex konkrete Anweisungen.
  • Weitere Hilfe: Besuche das OpenAI-Hilfecenter.

Linear für die lokale Arbeit verbinden (MCP)

Wenn du die ChatGPT-Desktop-App, Codex CLI oder die IDE-Erweiterung verwendest und lokal auf Linear-Issues zugreifen möchtest, konfiguriere den MCP-Server (Model Context Protocol) von Linear.

Weitere Informationen findest du in der Linear-MCP-Dokumentation.

Da die IDE-Erweiterung und die CLI dieselbe Konfiguration verwenden, sind die Schritte zum Einrichten des MCP-Servers in beiden Fällen identisch.

Wenn du die CLI installiert hast, führe Folgendes aus:

codex mcp add linear --url https://mcp.linear.app/mcp

Du wirst aufgefordert, dich mit deinem Linear-Konto anzumelden und es mit Codex zu verbinden.

Manuell konfigurieren

  1. Öffne ~/.codex/config.toml in deinem Editor.
  2. Füge Folgendes hinzu:
[mcp_servers.linear]
url = "https://mcp.linear.app/mcp"
  1. Führe codex mcp login linear aus, um dich anzumelden.