GitHub Copilot CLI Programmreferenz

Zusätzlich zum interaktiven Ausführen von Copilot CLI können Sie auch eine Eingabeaufforderung direkt an die CLI in einem einzigen Befehl übergeben, ohne in eine interaktive Sitzung zu wechseln. Auf diese Weise können Sie Copilot programmgesteuert in Skripts, CI/CD-Pipelines und Automatisierungsworkflows verwenden. Weitere Informationen findest du unter Programmgesteuertes Ausführen von GitHub Copilot CLI.

In diesem Artikel werden Befehlszeilenoptionen und Umgebungsvariablen beschrieben, die bei der automatisierten Ausführung von Copilot CLI besonders relevant sind.

Eine vollständige Liste der verfügbaren Optionen finden Sie unter GitHub Copilot CLI-Befehlsreferenz , oder geben Sie den folgenden Befehl in Ihr Terminal ein:

copilot help

copilot help

Befehlszeilenoptionen

Es gibt eine Reihe von Befehlszeilenoptionen, die besonders nützlich sind, wenn Copilot CLI programmatisch ausgeführt werden.

          `--allow-all` (oder `--yolo`)   | Zulassen, dass die CLI alle Berechtigungen besitzt. Entspricht `--allow-all-tools --allow-all-paths --allow-all-urls`. |

| --allow-all-paths | Deaktivieren Sie die Überprüfung des Dateipfads vollständig. Einfachere Alternative zu --add-dir, wenn keine Pfadeinschränkungen erforderlich sind. | | --allow-all-tools | Zulassen, dass jedes Tool ohne explizite Berechtigung für jedes Tool ausgeführt werden kann. | | --allow-all-urls | Zugriff auf alle URLs ohne explizite Berechtigung für jede URL zulassen. | | --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. | | --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. | | --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. | | --model=MODEL | Wählen Sie das KI-Modell aus (z. B gpt-5.2 . oder claude-sonnet-4.6). Nützlich zum Anheften eines Modells in einen reproduzierbaren Workflow. Siehe "Auswählen eines Modells unten". | | --no-ask-user | Verhindern Sie, dass der Agent anhält, um zusätzliche Benutzereingaben einzuholen. | | --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. | | --share=PATH | Exportieren Sie das Sitzungstranskript nach einem nicht interaktiven Abschluss in eine Markdowndatei (Standardeinstellung ./copilot-session-<ID>.md). Nützlich für die Auditierung oder Archivierung dessen, was der Agent getan hat. Beachten Sie, dass Sitzungstranskripte möglicherweise vertrauliche Informationen enthalten. | | --share-gist | Veröffentlichen Sie das Sitzungstranskript als geheimen GitHub-Gist nach Abschluss. Praktisch für die Freigabe von Ergebnissen aus der kontinuierlichen Integration (CI). Beachten Sie, dass Sitzungstranskripte möglicherweise vertrauliche Informationen enthalten. |

Tools für die --allow-tool Option

Sie können verschiedene Arten von Tools mit der --allow-tool Option angeben.

Werkzeugfilter

Mit 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.

          **Shell** | `shell(git:*)` | Alle Git-Unterbefehle zulassen (`git push`, `git status`usw.). |

| | shell(npm test) | Exakten Befehl npm test zulassen. | | schreiben | write(.github/copilot-instructions.md) | Ermöglichen Sie der CLI, in diesen spezifischen Pfad zu schreiben. | | | write(README.md) | Erlauben Sie der CLI, in jede Datei zu schreiben, deren Pfad mit /README.md endet. | | url | url(github.com) | Zulassen, dass die CLI auf HTTPS-URLs auf github.com zugreifen kann. | | | url(http://localhost:3000) | Ermöglichen Sie der CLI den Zugriff auf den lokalen Entwicklungsserver mit expliziten Protokollen und Port. | | | url(https://*.github.com) | Ermöglichen Sie der CLI den Zugriff auf GitHub Subdomäne (z. B api.github.com. ). | | | url(https://docs.github.com/copilot/*) | Zugriff auf Copilot Dokumentation auf dieser Website zulassen. | | MCP-SERVER | github(create_issue) | Nur das create_issue Tool vom github MCP-Server zulassen. |

Umgebungsvariablen

Sie 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.

Um vollständige Details zu Umgebungsvariablen für Copilot CLIzu erhalten, verwenden Sie den Befehl copilot help environment in Ihrem Terminal.

Auswählen eines Modells

Wenn 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 Optionen -s oder --silent nicht verwendet werden).

Sie 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.

Beispielsweise 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:

copilot -p "What does this project do?" -s --model claude-haiku-4.5

copilot -p "What does this project do?" -s --model claude-haiku-4.5

Fü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:

copilot -p "Fix the race condition in the worker pool" \
  --model gpt-5.3-codex \
  --allow-tool='write, shell'

copilot -p "Fix the race condition in the worker pool" \
  --model gpt-5.3-codex \
  --allow-tool='write, shell'

Alternativ können Sie die COPILOT_MODEL Umgebungsvariable so festlegen, dass ein Modell für die Dauer der Shellsitzung angegeben wird.

Um eine Modellauswahl über Shellsitzungen hinweg beizubehalten, können Sie den model Schlüssel in der CLI-Konfigurationsdatei festlegen. Diese Datei befindet sich unter ~/.copilot/config.json (oder $COPILOT_HOME/.copilot/config.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.

{
  "model": "gpt-5.3-codex",
  "reasoning_effort": "low"
}

{
  "model": "gpt-5.3-codex",
  "reasoning_effort": "low"
}

Modellrangfolge

Bei 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):

• Dabei wird ein benutzerdefinierter Agent verwendet: das in der definition des benutzerdefinierten Agents angegebene Modell (falls vorhanden).
• Die --model Befehlszeilenoption.
• Die COPILOT_MODEL Umgebungsvariable.
• Der model Schlüssel in der Konfigurationsdatei (~/.copilot/config.json oder $COPILOT_HOME/.copilot/config.json).
• Das Standardmodell der CLI.

Verwenden von benutzerdefinierten Agenten

Sie können Die Arbeit an einen spezialisierten Agent delegieren, indem Sie die --agent Option verwenden. Weitere Informationen findest du unter Erstellen und verwenden von kundenspezifischen Agenten für GitHub Copilot CLI.

In diesem Beispiel wird der code-review Agent verwendet. Dies erfordert, dass ein benutzerdefinierter Agent mit diesem Namen erstellt wurde.

copilot -p "Review the latest commit" \
  --allow-tool='shell' \
  --agent code-review

Weiterführende Lektüre

•         [AUTOTITLE](/copilot/how-tos/copilot-cli)
  

•         [AUTOTITLE](/copilot/reference/copilot-cli-reference/cli-command-reference)
  

•         [AUTOTITLE](/copilot/reference/copilot-cli-reference/cli-plugin-reference)