Cortex Code CLI-Einstellungen

Cortex Code CLI-Einstellungen steuern die Tool-Berechtigungen, die Verbindungen und das Verhalten der Sitzung. Sie können Einstellungen mit verwalteten Richtlinien (falls von Ihrer Organisation bereitgestellt), Konfigurationsdateien, Umgebungsvariablen und Befehlszeilenargumenten konfigurieren.

Konfigurationsdateien

Die folgenden Konfigurationsdateien werden von der Cortex Code CLI verwendet:

Datei

Zweck

<admin-managed path>/managed-settings.json

Organisationsverwaltete Richtliniendatei (optional). Für OS-spezifische Speicherorte siehe Verwaltete Einstellungen (Organisationsrichtlinie).

~/.snowflake/cortex/settings.json

Cortex Code CLI-Haupteinstellungsdatei.

~/.snowflake/cortex/permissions.json

Berechtigungseinstellungen.

~/.snowflake/cortex/mcp.json

MCP-Serverkonfiguration (siehe Model Context Protocol (MCP)).

~/.snowflake/config.toml

Snowflake-Verbindungen (siehe Cortex Code-CLI). Gemeinsam mit Snowflake CLI genutzt.

Das vollständige Layout des Hauptkonfigurationsverzeichnisses ist wie folgt:

~/.snowflake/cortex/        # Main Cortex Code CLI config directory
├── settings.json          # Main settings
├── mcp.json               # MCP server configs
├── permissions.json       # Saved permissions
├── hooks.json             # Global hooks
├── history                # Command history
├── conversations/         # Session files
├── cache/                 # Temporary cache
│   ├── table_cache.json   # SQL result metadata
│   └── sql_result_cache/  # Parquet files
├── logs/                  # Log files
├── memory/                # Persistent memory
├── agents/                # Custom agents
├── skills/                # Global skills
├── commands/              # Custom commands
├── hooks/                 # Hook scripts
└── remote_cache/          # Cloned repos

Rangfolge der Einstellungen

Die Einstellungen werden in der folgenden Reihenfolge angewendet (von der höchsten bis zur niedrigsten):

  1. Beschränkungen für verwaltete Einstellungen (settings.*-Felder in managed-settings.json). Kann nicht durch eine Konfiguration auf Benutzerebene überschrieben werden. Siehe Verwaltete Einstellungen (Organisationsrichtlinie).

  2. Profil-Überschreibungen (settingsOverrides aus dem aktiven Profil, falls vorhanden).

  3. Projekteinstellungen (.cortex/settings.json oder .claude/settings.json im Arbeitsverzeichnis).

  4. Verwaltete Standardeinstellungen (defaults.*-Felder in managed-settings.json). Benutzer können diese in ihren eigenen settings.json überschreiben.

  5. Globale Benutzereinstellungen (~/.snowflake/cortex/settings.json).

  6. Standardwerte, eingebettet in die Cortex Code-CLI.

Berechtigungen folgen einer separaten Auswertungsreihenfolge. Siehe Auswertung der Berechtigung.

settings.json

~/.snowflake/cortex/settings.json

Haupteinstellungsdatei für Cortex Code CLI.

Beispielinhalt:

{
   "compactMode": true,
   "autoUpdate": true,
   "theme": "dark"
}

Die folgenden Einstellungen sind verfügbar:

  • compactMode: Aktiviert die kompakte Ausgabeformatierung.

  • autoUpdate: Aktiviert automatische Updates.

  • theme: Legt das CLI-Thema fest (light oder dark).

permissions.json

~/.snowflake/cortex/permissions.json

Steuert die Zugriffsberechtigungen für Tools.

Beispielinhalt:

{
  "onlyAllow": ["read_file", "execute_sql"],
  "defaultMode": "ask",
  "dangerouslyAllowAll": false
}

Die folgenden Einstellungen sind verfügbar:

  • onlyAllow: Liste der zulässigen Tool-Muster.

  • defaultMode: Standardberechtigungsmodus (ask, allow, deny).

  • dangerouslyAllowAll: Lässt alle Tools ohne Eingabeaufforderung zu (unsicher).

Verwaltete Einstellungen (Organisationsrichtlinie)

Administratoren können eine JSON-Richtliniendatei auf Systemebene bereitstellen, um Cortex Code CLI-Verhalten in einer Organisation durchzusetzen, das Tools, Konten und Mindestversionen einschränkt. Weitere Details dazu finden Sie unter Verwaltete Einstellungen (Organisationsrichtlinie).

Umgebungsvariablen

Cortex Code CLI erkennt die folgenden Umgebungsvariablen für die Konfiguration:

Variable

Beschreibung

SNOWFLAKE_HOME

Überschreibt das standardmäßige ~/.snowflake-Verzeichnis.

CORTEX_AGENT_MODEL

Überschreibt die Modellauswahl.

CORTEX_ENABLE_MEMORY

Aktiviert das Speichertool (festgelegt auf true oder 1).

COCO_DANGEROUS_MODE_REQUIRE_SQL_WRITE_PERMISSION

Erfordert eine Bestätigung für SQL-Schreiboperationen im Umgehungsmodus.

Bemerkung

Weitere berechtigungsbezogene Umgebungsvariablen finden Sie unter Sicherheit.

Befehlszeilenüberschreibungen

Cortex Code CLI-Einstellungen können mittels Befehlszeilenargumenten überschrieben werden, die Folgende umfassen:

Beispiel

Beschreibung

cortex -c production

Gibt die Verbindung an.

cortex --workdir /path

Legt das Arbeitsverzeichnis fest.

cortex --continue

Setzt die letzte Sitzung fort.

cortex --resume <Sitzungs-ID>

Setzt eine bestimmte Sitzung fort.

cortex --plan

Aktiviert den Planungsmodus.

cortex --dangerously-allow-all-tool-calls

Deaktiviert Eingabeaufforderungen für Berechtigungen (unsicher).

Sitzungsspeicher

Konversationen und Einstellungen werden gespeichert in:

Location

Beschreibung

~/.snowflake/cortex/conversations/

Sitzungsdateien.

~/.snowflake/cortex/permissions.json

Berechtigungseinstellungen.

~/.snowflake/cortex/mcp.json

MCP-Konfiguration