Zum Hauptinhalt springen
Die CometAPI CLI liest Einstellungen aus einer TOML-Konfigurationsdatei, Umgebungsvariablen und Kommandozeilen-Flags. Wenn dieselbe Einstellung aus mehreren Quellen verfügbar ist, gilt folgende Prioritätsreihenfolge: CLI-Flags > Konfigurationsdatei > Umgebungsvariablen > Standardwerte

Konfigurationsdatei

Speicherort: ~/.config/cometapi/config.toml Führen Sie den Einrichtungsassistenten aus, um die Konfigurationsdatei interaktiv zu erstellen:
cometapi init
Oder verwalten Sie einzelne Einstellungen mit dem Unterbefehl config:
# View current configuration
cometapi config show

# Set a value
cometapi config set api_key sk-...

# Remove a value
cometapi config unset api_key

# Show the config file path
cometapi config path

Verfügbare Einstellungen

Config keyEnvironment variableDescription
api_keyCOMETAPI_KEYAPI key (für alle Befehle erforderlich)
access_tokenCOMETAPI_ACCESS_TOKENAccess token für Befehle auf Kontoebene
base_urlCOMETAPI_BASE_URLAPI-Basis-URL (Standard: https://api.cometapi.com/v1)
default_modelCOMETAPI_DEFAULT_MODELStandardmodell für chat (Fallback: gpt-5.4)
output_formatStandard-Ausgabeformat: table, json, yaml, csv oder markdown

Anmeldedaten

Die CLI verwendet zwei Arten von Anmeldedaten:

API key

Für alle Befehle erforderlich. Der API key authentifiziert Anfragen an die CometAPI-Modellendpunkte. Erstellen Sie einen API key unter CometAPI Console → API Keys. Legen Sie ihn auf eine der folgenden Arten fest:
export COMETAPI_KEY="<COMETAPI_KEY>"

Access token

Optional. Der Access token ist für Befehle auf Kontoebene erforderlich: account, stats, tokens, logs und tasks. Generieren Sie einen Access token unter CometAPI Console → Personal Settings. Legen Sie ihn auf eine der folgenden Arten fest:
export COMETAPI_ACCESS_TOKEN="your-access-token"

Sicherheit

Die CLI wendet folgende Sicherheitspraktiken an:
  • API keys und Access tokens werden niemals protokolliert oder vollständig angezeigt. In der Diagnoseausgabe werden nur die letzten 4 Zeichen angezeigt.
  • Die Konfigurationsdatei wird mit restriktiven Berechtigungen (0600) erstellt — nur für den Dateieigentümer lesbar.
  • Anmeldedaten sollten niemals in die Versionskontrolle eingecheckt werden. Fügen Sie den Pfad der Konfigurationsdatei zu Ihrer .gitignore hinzu, falls zutreffend.
Sie sind für sämtliche Nutzung und Gebühren verantwortlich, die mit Ihren API keys anfallen. Bewahren Sie Ihre Schlüssel sicher auf und rotieren Sie sie, wenn Sie unbefugten Zugriff vermuten.

Fehlerbehebung

ErrorSolution
API key not configuredFühren Sie cometapi init aus oder setzen Sie die Umgebungsvariable COMETAPI_KEY
Connection failedFühren Sie cometapi doctor aus, um die Konnektivität zu diagnostizieren
Access token not configuredNur erforderlich für account/stats/tokens/logs/tasks. Führen Sie cometapi init aus, um einen hinzuzufügen