{"meta":{"title":"Programmgesteuerte Referenz für die GitHub Copilot-CLI","intro":"Hier finden Sie Optionen für die programmgesteuerte Ausführung Copilot CLI .","product":"GitHub Copilot","breadcrumbs":[{"href":"/de/enterprise-cloud@latest/copilot","title":"GitHub Copilot"},{"href":"/de/enterprise-cloud@latest/copilot/reference","title":"Verweis"},{"href":"/de/enterprise-cloud@latest/copilot/reference/copilot-cli-reference","title":"Copilot CLI Verweis"},{"href":"/de/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-programmatic-reference","title":"Programmmatische CLI-Referenz"}],"documentType":"article"},"body":"# Programmgesteuerte Referenz für die GitHub Copilot-CLI\n\nHier finden Sie Optionen für die programmgesteuerte Ausführung Copilot CLI .\n\nZusätzlich zur interaktiven Ausführung von Copilot CLI können Sie auch einen Eingabebefehl direkt an die CLI in einem einzigen Befehl übergeben, ohne eine interaktive Sitzung zu starten. Auf diese Weise können Sie Copilot programmgesteuert in Skripts, CI/CD-Pipelines und Automatisierungsworkflows verwenden. Weitere Informationen findest du unter [Programmatisches Ausführen GitHub Copilot CLI](/de/enterprise-cloud@latest/copilot/how-tos/copilot-cli/automate-copilot-cli/run-cli-programmatically).\n\nIn diesem Artikel werden Befehlszeilenoptionen und Umgebungsvariablen beschrieben, die bei der programmgesteuerten Ausführung Copilot CLI besonders relevant sind.\n\nEine vollständige Liste der verfügbaren Optionen finden Sie unter [GitHub Copilot CLI-Befehlsreferenz](/de/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-command-reference#command-line-options) , oder geben Sie den folgenden Befehl in Ihr Terminal ein:\n\n```shell copy\ncopilot help\n```\n\n## Befehlszeilenoptionen\n\nEs gibt eine Reihe von Befehlszeilenoptionen, die bei der programmgesteuerten Ausführung Copilot CLI besonders nützlich sind.\n\n| Auswahl | Beschreibung |\n| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `-p PROMPT` | Führen Sie eine Eingabeaufforderung im nicht interaktiven Modus aus. Die CLI führt die Eingabeaufforderung aus und beendet den Vorgang nach Abschluss. |\n| `-s` | Unterdrücken Sie Statistiken und Dekoration, und geben Sie nur die Antwort des Agenten aus. Ideal für die Ausgabe über die Pipe in Skripts. |\n| `--add-dir=DIRECTORY` | Fügen Sie der Liste der zulässigen Pfade ein Verzeichnis hinzu. Dies kann mehrmals verwendet werden, um mehrere Verzeichnisse hinzuzufügen. Nützlich, wenn der Agent außerhalb des aktuellen Arbeitsverzeichnisses Lese-/Schreibzugriff benötigt. |\n| `--agent=AGENT` | Geben Sie eine custom agent an, die verwendet werden soll. |\n| `--allow-all` (oder `--yolo`) | Zulassen, dass die CLI alle Berechtigungen besitzt. Entspricht `--allow-all-tools --allow-all-paths --allow-all-urls`. |\n| `--allow-all-paths` | Deaktivieren Sie die Überprüfung des Dateipfads vollständig. Einfachere Alternative zu `--add-dir`, wenn keine Pfadeinschränkungen erforderlich sind. |\n| `--allow-all-tools` | Lässt die Ausführung jedes Tools ohne explizite Berechtigung für jedes Tool zu. |\n| `--allow-all-urls` | Zugriff auf alle URLs ohne explizite Berechtigung für jede URL zulassen. |\n| `--allow-tool=TOOL ...` | Erteilen Sie selektiv berechtigungen für ein bestimmtes Tool. Verwenden Sie für mehrere Tools eine in Anführungszeichen gesetzte, durch Kommas getrennte Liste. |\n| `--allow-url=URL ...` | Zulassen, dass der Agent eine bestimmte URL oder Domäne abruft. Nützlich, wenn ein Workflow Webzugriff auf bekannte Endpunkte benötigt. Verwenden Sie für mehrere URLs eine in Anführungszeichen gesetzte, durch Kommas getrennte Liste. |\n| `--attachment=PATH ...` | Fügen Sie eine Datei (Bild oder systemeigenes Dokument) an die anfängliche Eingabeaufforderung an. Nur gültig im nicht interaktiven Modus. Kann mehrmals verwendet werden, um mehrere Dateien anzufügen. |\n| `--available-tools=TOOL ...` | Beschränken Sie das Modell auf die Tools, die Sie auflisten; alle anderen Tools sind nicht verfügbar. Nützlich, um den Handlungsspielraum des Agenten in einem automatisierten Workflow eng zu begrenzen. Verwenden Sie für mehrere Tools eine in Anführungszeichen gesetzte, durch Kommas getrennte Liste. |\n| `--deny-tool=TOOL ...` | Verweigern sie ein bestimmtes Tool. Nützlich zum Einschränken der Aktionen des Agents in einem gesperrten Workflow. Verwenden Sie für mehrere Tools eine in Anführungszeichen gesetzte, durch Kommas getrennte Liste. |\n| `--deny-url=URL ...` | Verweigern des Zugriffs auf eine bestimmte URL oder Domäne. Hat Vorrang vor `--allow-url`. Verwenden Sie für mehrere URLs eine in Anführungszeichen gesetzte, durch Kommas getrennte Liste. |\n| `--excluded-tools=TOOL ...` | Entfernen Sie bestimmte Tools aus den für das Modell verfügbaren Tools. Verwenden Sie für mehrere Tools eine in Anführungszeichen gesetzte, durch Kommas getrennte Liste. |\n| `--fleet` | Führen Sie den Prompt im Flottenmodus aus, sodass Copilot parallele Subagenten verwendet, um an verschiedenen Teilen der Aufgabe zu arbeiten. Kombinieren Sie dies mit `-p` für nicht-interaktive Automatisierung, `-i` für eine interaktive Sitzung oder mit einer umgeleiteten Eingabeaufforderung. Im ACP-Servermodus nicht unterstützt. Siehe [Beschleunigen des Aufgabenabschlusses mit dem \\`/fleet\\` Befehl](/de/enterprise-cloud@latest/copilot/how-tos/copilot-cli/use-copilot-cli/speed-up-task-completion). |\n| `--model=MODEL` | Wählen Sie das KI-Modell aus (z. B `gpt-5.4` . oder `claude-haiku-4.5`). Nützlich zum Anheften eines Modells in einen reproduzierbaren Workflow. Siehe [\"Auswählen eines Modells](#choosing-a-model) unten\". |\n| `--no-ask-user` | Verhindern Sie, dass der Agent anhält, um zusätzliche Benutzereingaben einzuholen. |\n| `--output-format=FORMAT` | Legen Sie das Ausgabeformat fest: `text` (Standard) oder `json`. Mit `json` gibt die CLI JSONL aus (ein JSON-Objekt pro Zeile), was zum Parsen der Ausgabe des Agenten in Skripten praktisch ist. |\n| `--secret-env-vars=VAR ...` | Eine Umgebungsvariable, deren Wert in der Ausgabe entfernt werden soll. Verwenden Sie für mehrere Variablen eine in Anführungszeichen gesetzte, kommagetrennte Liste. Wichtig, um zu verhindern, dass geheime Schlüssel in Protokollen verfügbar gemacht werden. Die Werte in den `GITHUB_TOKEN` Variablen und `COPILOT_GITHUB_TOKEN` Umgebungsvariablen sind standardmäßig redigiert. |\n| `--share=PATH` | Exportieren Sie das Sitzungstranskript nach einem nicht interaktiven Abschluss in eine Markdowndatei (Standardeinstellung `./copilot-session-.md`). Nützlich für die Auditierung oder Archivierung dessen, was der Agent getan hat. Beachten Sie, dass Sitzungstranskripte möglicherweise vertrauliche Informationen enthalten. |\n| `--share-gist` | Veröffentlichen Sie das Sitzungstranskript als geheimer GitHub Gist nach Abschluss. Praktisch für die Freigabe von CI-Ergebnissen. Beachten Sie, dass Sitzungstranskripte möglicherweise vertrauliche Informationen enthalten. |\n\n## Ausführen dynamischer Workflows\n\nWird `copilot workflow run WORKFLOW-NAME` verwendet, um einen dynamischen Workflow aus einem Skript auszuführen. Informationen zu dynamischen Workflows finden Sie unter [Dynamische Workflows](/de/enterprise-cloud@latest/copilot/concepts/agents/dynamic-workflows).\n\nVerwenden Sie `--args` für Inline-JSON oder einen mit `@` präfigierten JSON-Dateipfad. Argumente werden nicht aus der Standardeingabe gelesen.\n\n```shell copy\ncopilot workflow run WORKFLOW-NAME \\\n --args @workflow-input.json \\\n --silent --output-format json\n```\n\nKonfigurieren Sie die Authentifizierung und erteilen Sie die erforderlichen Tool-Berechtigungen, bevor Sie den Befehl ausführen. Freigegebene Optionen wie `--model`, `--allow-tool`, `--allow-url`und `--add-dir` wenden Sie an. Der Befehl zeigt keine Berechtigungsgenehmigungsaufforderungen an. Prompt- und Sitzungsmodusoptionen wie `-p`, `-i`, `--agent`, `--fleet`, `--autopilot`, `--resume` und `--continue` werden mit `workflow run` nicht unterstützt.\n\nProject-Erweiterungen werden nur aus vertrauenswürdigen Ordnern oder mit ausdrücklicher Zustimmung geladen. In der Automatisierung `GITHUB_COPILOT_PROMPT_MODE_EXTENSIONS=true` lässt das Laden von Projekterweiterungen für diesen Aufruf zu. Aktivieren Sie dies nur für Repositorycode, dem Sie vertrauen. Es gewährt keine Berechtigungen für Tools.\n\nAlle workflow-spezifischen Optionen finden Sie unter [GitHub Copilot CLI-Befehlsreferenz](/de/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-command-reference#using-copilot-workflow-run).\n\n### Workflowausgabe\n\nBei `--output-format json`der Standardausgabe wird JSONL verwendet. Wenn die Ausführung abgeschlossen wird oder angehalten wird, weist der letzte Datensatz die folgenden Felder auf. Zum Unterdrücken von Status- und anderen Ereignisdatensätzen hinzufügen `--silent` .\n\n| Feld | Beschreibung |\n| ----------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |\n| `type` | Immer `workflow.result`. |\n| `data.name` | Der Name des Workflows. |\n| `data.run.runId` | Der Bezeichner des Laufs. |\n| `data.run.status` | Der Endstatus der Ausführung: `completed`, `halted`, `paused`, `cancelled` oder `error`. |\n| `data.run.result` | Der zurückgegebene Wert( falls vorhanden). Wird ausgelassen, wenn `--result-file` angegeben wird. |\n| `data.run.pauseInfo`, `data.run.reason`, `data.run.error`, `data.run.failure` | Weitere Details dazu, warum eine Ausführung angehalten oder beendet wurde, wenn verfügbar. |\n| `data.resultFile` | Der angeforderte Ergebnisdateipfad, der nur angegeben wird, nachdem die Ergebnisdatei erfolgreich geschrieben wurde. |\n\nMit `--result-file PATH`, die Datei enthält nur den zurückgegebenen Wert als JSON. Eine angehaltene, fehlgeschlagene oder unterbrochene Ausführung ersetzt keine vorhandene Ergebnisdatei. Ein abgeschlossener Durchlauf, der keinen Wert zurückgibt, erstellt keine Ergebnisdatei.\n\nFehler und Diagnose für Ausführungen, die nicht abgeschlossen sind, werden in Standardfehler geschrieben, einschließlich im unbeaufsichtigten Modus. Ein Fehler vor dem Start des Workflows oder eine Unterbrechung kann den Befehl ohne einen endgültigen JSON-Eintrag beenden.\n\n### Workflowausgangscodes\n\n| Exitcode | Bedeutung |\n| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| `0` | Der Workflow wurde erfolgreich abgeschlossen, und jede angeforderte Ergebnisdatei wurde erfolgreich geschrieben. Ein Workflow, der keinen Wert zurückgibt, kann auch ohne Erstellen einer Ergebnisdatei erfolgreich abgeschlossen werden. |\n| `1` | Die Ausführung wurde nicht abgeschlossen, aufgrund einer Pause, einer Begrenzung, die die Ausführung beendet hat, eines Abbruchs oder eines Fehlers. Wird auch für allgemeine Befehlsfehler verwendet, z. B. ungültige Befehlszeilensyntax oder ein Fehler beim Speichern des Ergebnisses. |\n| `2` | Der Workflow wurde nicht gefunden, oder seine Argumente konnten nicht gelesen, nicht als JSON analysiert oder nicht gegen die vom Workflow akzeptierten Eingaben validiert werden. |\n| `130` | Der Befehl wurde von `SIGINT` oder `SIGTERM`, z. B. durch Drücken von STRG+C, unterbrochen. |\n\nÜberprüfen Sie den Exit-Code, bevor Sie eine Ergebnisdatei verarbeiten. Nach einer erfolglosen Ausführung ist möglicherweise noch eine frühere Ergebnisdatei vorhanden. Ein abschließender Datensatz, bei dem `data.run.status` auf `completed` festgelegt ist, ist keine Garantie dafür, dass die Ergebnisdatei erfolgreich gespeichert wurde.\n\n## Tools für die `--allow-tool` Option\n\nSie können verschiedene Arten von Tools mit der `--allow-tool` Option angeben.\n\n| Art des Tools | Was sie steuert |\n| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| Shell | Ausführen von Shellbefehlen. |\n| write | Erstellen oder Ändern von Dateien |\n| read | Lesen von Dateien oder Verzeichnissen. |\n| url | Abrufen von Inhalten aus einer URL. |\n| Gedächtnis | Speichern neuer Fakten im beständigen Speicher des Agents. Dies wirkt sich nicht auf die Verwendung vorhandener Erinnerungen aus. Siehe [Informationen zu GitHub Copilot Memory](/de/enterprise-cloud@latest/copilot/concepts/agents/copilot-memory). |\n| MCP-SERVER | Aufrufen von Tools von einem bestimmten MCP-Server. Verwenden Sie den konfigurierten Namen des Servers als Bezeichner, `github`z. B. . Siehe [Hinzufügen von MCP-Servern für GitHub Copilot CLI](/de/enterprise-cloud@latest/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers). |\n\n### Werkzeugfilter\n\nMit den Tooltypen `shell`, `write`, `url` und dem MCP-Server-Tool können Sie einen Filter in Klammern angeben, um zu steuern, welche spezifischen Tools zulässig sind.\n\n\n\n| Art des Tools | Beispiel | Erläuterung des Beispiels |\n| -------------- | ---------------------------------------- | ----------------------------------------------------------------------------------------------------------- |\n| **Shell** | `shell(git:*)` | Alle Git-Unterbefehle zulassen (`git push`, `git status`usw.). |\n| | `shell(npm test)` | Lässt den exakten Befehl `npm test` zu. |\n| **schreiben** | `write(.github/copilot-instructions.md)` | Ermöglichen Sie der CLI, in diesen spezifischen Pfad zu schreiben. |\n| | `write(README.md)` | Erlauben Sie der CLI, in jede Datei zu schreiben, deren Pfad mit `/README.md` endet. |\n| **url** | `url(github.com)` | Zulassen, dass die CLI auf HTTPS-URLs auf github.com zugreifen kann. |\n| | `url(http://localhost:3000)` | Ermöglichen Sie der CLI den Zugriff auf den lokalen Entwicklungsserver mit expliziten Protokollen und Port. |\n| | `url(https://*.github.com)` | Ermöglichen Sie der CLI den Zugriff auf eine unterdomäne GitHub (z. B `api.github.com`. ). |\n| | `url(https://docs.github.com/copilot/*)` | Zugriff auf Copilot-Dokumentation auf dieser Website zulassen. |\n| **MCP-SERVER** | `github(create_issue)` | Nur das `create_issue` Tool vom `github` MCP-Server zulassen. |\n\n\n\n> \\[!NOTE]\n> Platzhalter werden für `shell` nur unterstützt, um alle Unterbefehle eines angegebenen Tools abzugleichen, sowie für `url` am Anfang eines Hostnamens, um mit einer beliebigen Subdomäne zu korrespondieren, oder am Ende eines Pfads, um eine beliebige Pfadendung abzugleichen, wie in der vorherigen Tabelle gezeigt.\n\n## Umgebungsvariablen\n\nSie können Umgebungsvariablen verwenden, um verschiedene Aspekte des Cli-Verhaltens bei der programmgesteuerten Ausführung zu konfigurieren. Dies ist besonders nützlich für das Festlegen der Konfiguration in CI/CD-Workflows oder anderen automatisierten Umgebungen, in denen Sie bestimmte Optionen möglicherweise nicht direkt in der Befehlszeile angeben möchten.\n\n| Variable | Beschreibung |\n| --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `COPILOT_ALLOW_ALL` | Für vollständige Berechtigungen festlegen auf `true` |\n| `COPILOT_MODEL` | Festlegen des Modells (z. B `gpt-5.4`. , `claude-haiku-4.5`) |\n| `COPILOT_HOME` | Festlegen des Verzeichnisses für die CLI-Konfigurationsdatei (`~/.copilot` standardmäßig) |\n| `COPILOT_AUTO_UPDATE` | Stellen Sie `false` ein, um automatische Updates zu deaktivieren. Nützlich in CI und anderen automatisierten Umgebungen, in denen Sie die CLI-Version festlegen möchten. |\n| `COPILOT_GITHUB_TOKEN` | Authentifizierungstoken (höchste Priorität) |\n| `GH_TOKEN` | Authentifizierungstoken (zweite Rangfolge) |\n| `GITHUB_TOKEN` | Authentifizierungstoken (dritte Rangfolge) |\n| `GITHUB_COPILOT_PROMPT_MODE_EXTENSIONS` | Auf `true` setzen, um das Laden von Projekterweiterungen bei einer Prompt- oder direkten Workflow-Ausführung zu erlauben. Verwenden Sie diesen nur für Repositorycode, dem Sie vertrauen. Dies gewährt keine Toolberechtigungen. |\n\nVerwenden Sie für vollständige Details zu Umgebungsvariablen Copilot CLIden Befehl `copilot help environment` in Ihrem Terminal.\n\n## Auswählen eines Modells\n\nWenn Sie eine Eingabeaufforderung an Copilot CLI im nicht-interaktiven Modus senden, wird das Modell, das von der CLI zum Generieren einer Antwort verwendet wird, in der Antwortausgabe angezeigt (wenn die `-s`- oder die `--silent`-Option nicht verwendet wird).\n\nSie können die `--model` Option verwenden, um anzugeben, welches KI-Modell die CLI verwenden soll. Auf diese Weise können Sie ein Modell auswählen, das am besten für Ihren Prompt geeignet ist, indem es Faktoren wie Geschwindigkeit, Kosten und Fähigkeiten ausbalanciert.\n\nBeispielsweise können Sie für einfache Aufgaben, z. B. die Erläuterung von Code oder das Generieren einer Zusammenfassung, ein schnelles, niedrigeres Kostenmodell wie ein Claude Haiku-Modell auswählen:\n\n```bash copy\ncopilot -p \"What does this project do?\" -s --model claude-haiku-4.5\n```\n\nFür komplexere Aufgaben, die eine tiefere Begründung erfordern , z. B. Debuggen oder Umgestaltung von Code, können Sie ein leistungsfähigeres Modell auswählen, z. B. ein GPT Codex-Modell:\n\n```bash copy\ncopilot -p \"Fix the race condition in the worker pool\" \\\n --model gpt-5.3-codex \\\n --allow-tool='write, shell'\n```\n\n> \\[!NOTE]\n> Um die Modellzeichenfolgen für alle verfügbaren Modelle anzuzeigen, führen Sie den `/model` Befehl in einer interaktiven Copilot CLI Sitzung aus. Die vollständige Liste der Modelle und der Clients, die sie unterstützen, finden Sie unter [Unterstützte KI-Modelle in GitHub Copilot](/de/enterprise-cloud@latest/copilot/reference/ai-models/supported-models).\n\nAlternativ können Sie die `COPILOT_MODEL` Umgebungsvariable so festlegen, dass ein Modell für die Dauer der Shellsitzung angegeben wird.\n\nUm eine Modellauswahl über Shellsitzungen hinweg beizubehalten, können Sie den `model` Schlüssel in der CLI-Konfigurationsdatei festlegen. Diese Datei befindet sich unter `~/.copilot/settings.json` (oder `$COPILOT_HOME/settings.json` wenn Sie die `COPILOT_HOME` Umgebungsvariable festgelegt haben). Einige Modelle ermöglichen es Ihnen auch, einen Denkaufwand festzulegen, der steuert, wie viel Zeit das Modell vor dem Reagieren investiert.\n\n```json copy\n{\n \"model\": \"gpt-5.3-codex\",\n \"effortLevel\": \"low\"\n}\n```\n\n> \\[!TIP]\n> Die einfachste Möglichkeit zum dauerhaften Festlegen eines Modells in der Konfigurationsdatei ist der `/model` Schrägstrichbefehl in einer interaktiven Sitzung. Die Auswahl, die Sie mit diesem Befehl treffen, wird in die Konfigurationsdatei geschrieben.\n\n### Modellrangfolge\n\nBei der Bestimmung, welches Modell für eine bestimmte Eingabeaufforderung verwendet werden soll, sucht die CLI nach Modellspezifikationen in der folgenden Reihenfolge der Rangfolge (von der höchsten zur niedrigsten):\n\n* Dabei wird ein benutzerdefinierter Agent verwendet: das in der definition des benutzerdefinierten Agents angegebene Modell (falls vorhanden).\n* Die `--model` Befehlszeilenoption.\n* Die `COPILOT_MODEL` Umgebungsvariable.\n* Der `model` Schlüssel in der Konfigurationsdatei (`~/.copilot/settings.json` oder `$COPILOT_HOME/settings.json`).\n* Das Standardmodell der CLI.\n\n## Verwenden von benutzerdefinierten Agenten\n\nSie können Die Arbeit an einen spezialisierten Agent delegieren, indem Sie die `--agent` Option verwenden. Weitere Informationen findest du unter [Erstellen und Verwenden von benutzerdefinierten Agenten für GitHub Copilot CLI](/de/enterprise-cloud@latest/copilot/how-tos/copilot-cli/customize-copilot/create-custom-agents-for-cli).\n\nIn diesem Beispiel wird der `code-review` Agent verwendet. Dies erfordert, dass ein benutzerdefinierter Agent mit diesem Namen erstellt wurde.\n\n```bash\ncopilot -p \"Review the latest commit\" \\\n --allow-tool='shell' \\\n --agent code-review\n```\n\n## Weiterführende Lektüre\n\n* [GitHub Copilot CLI](/de/enterprise-cloud@latest/copilot/how-tos/copilot-cli)\n* [GitHub Copilot CLI-Befehlsreferenz](/de/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-command-reference)\n* [GitHub Copilot CLI-Plug-In-Referenz](/de/enterprise-cloud@latest/copilot/reference/copilot-cli-reference/cli-plugin-reference)"}