Referenz für die Cortex Code-CLI¶

Beispiele¶

Starten mit dem Arbeitsverzeichnis:

cortex -w /path/to/project

Fortsetzen der letzten Sitzung mit bestimmter Verbindung:

cortex --continue -c production

Eindeutige Eingabeaufforderung (JSON-Ausgabe):

cortex -p "List all Python files" --output-format stream-json

update¶

mcp¶

Weitere Informationen dazu finden Sie unter Model Context Protocol (MCP).

Tastaturkürzel¶

Befehle mit vorangestelltem Schrägstrich¶

Sitzungsspeicher¶

Siehe Cortex Code CLI-Einstellungen für Details zur Konfiguration.

Befehlsdetails¶

/sql SELECT * FROM users

/sql SELECT * FROM large_table --limit 1000

/sql SELECT
  customer_id,
  SUM(amount) as total
FROM orders
GROUP BY customer_id

Aktualisieren der Cortex Code-CLI¶

Die Cortex Code-CLI aktualisiert sich selbst, sobald eine neue Version verfügbar ist. Sie können auch manuell auf die neueste Version aktualisieren, indem Sie cortex update ausführen. Geben Sie cortex update <version> an, um die angegebene Version zu installieren.

Um automatische Aktualisierungen zu deaktivieren, bearbeiten Sie die Datei ~/.snowflake/cortex/settings.json und fügen Sie "autoUpdate": false hinzu.

Manuelles Hinzufügen einer Verbindung¶

Um die Datei ~/.snowflake/connections.toml manuell zum Definieren Ihrer Verbindung zu erstellen oder zu bearbeiten, führen Sie die folgenden Schritte aus:

1. Erstellen Sie die Datei ~/.snowflake/connections.toml, wenn sie noch nicht existiert.

   mkdir -p ~/.snowflake
   touch ~/.snowflake/connections.toml
   

   Copy

2. Verwenden Sie den chmod-Befehl, um die Berechtigungen so festzulegen, dass nur Sie die Datei lesen und in sie schreiben können.

   chmod 600 ~/.snowflake/connections.toml
   

   Copy

3. Öffnen Sie die Datei in einem Texteditor (hier nano).

   nano ~/.snowflake/connections.toml
   

   Copy

4. Fügen Sie Zeilen wie die folgenden hinzu, um eine Verbindung zu definieren. Geben Sie den Namen der Verbindung anstelle von myaccount ein und ersetzen Sie die Platzhalterwerte durch Ihre Snowflake-Kontodaten. Verwenden Sie browserbasiertes SSO (externe Browser-Authentifizierung) oder ein PAT (programmgesteuertes Zugriffstoken). Sie können ein PAT von Snowsight erhalten (siehe Verwenden von programmatische Zugriffstoken für die Authentifizierung). Schließen Sie nur den authenticator- oder den password-Wert ein, abhängig von der von Ihnen gewählten Authentifizierungsmethode.

   [myaccount]
   account       = "<ACCOUNT>"
   user          = "<USERNAME>"
   authenticator = "externalbrowser" # For browser-based SSO; omit for PAT
   password      = "<PAT>"           # For PAT authentication; omit for SSO
   warehouse     = "<WAREHOUSE>"
   role          = "<ROLE>"
   database      = "<DATABASE>"
   schema        = "<SCHEMA>"
   

   Copy

5. Speichern und schließen Sie die Datei.

Einrichten von Shell-Vervollständigungen¶

Um Ihrer Shell die Möglichkeit zu geben, Cortex Code-CLI-Befehle und -Optionen automatisch zu vervollständigen, folgen Sie den Anweisungen unten für Ihre Shell.

Nachdem Sie den entsprechenden -Befehl oben für Ihre Shell ausgeführt haben, starten Sie Ihre Shell mit exec $SHELL neu.

Verzeichnisstruktur¶

Durch die Installation der Cortex Code-CLI wird die folgende Verzeichnisstruktur in Ihrem Basisverzeichnis erstellt:

~/.snowflake/cortex/
   ├── settings.json          # Main configuration
   ├── mcp.json               # MCP server configs
   ├── conversations/         # Session history
   ├── skills/                # Global skills
   ├── commands/              # Custom commands
   ├── hooks/                 # Hook scripts
   ├── profiles/              # Team profiles
   └── cache/                 # Temporary cache

Befehl nicht gefunden¶

Stellen Sie sicher, dass das Installationsverzeichnis ~/.local/bin ist in Ihrer PATH-Umgebungsvariable enthalten ist. Wenn Sie beispielsweise bash verwenden, geben Sie die folgenden Befehle aus:

export PATH="~/.local/bin:$PATH"
echo 'export PATH="~/.local/bin:$PATH"' >> ~/.bashrc

Berechtigung verweigert¶

Stellen Sie sicher, dass die ausführbare cortex-Datei über Ausführungsberechtigungen verfügt. Geben Sie den folgenden Befehl aus:

chmod +x ~/.local/bin/cortex

Verbindungsfehler¶

Stellen Sie sicher, dass die Verbindungsdatei :file:`~/.snowflake/connections.toml`vorhanden ist und gültige Verbindungsdetails enthält.

cat ~/.snowflake/connections.toml

Versuchen Sie, den cortex-Befehl auszuführen, wobei Sie die Verbindung explizit mit der -c-Option angeben. Beispiel:

cortex -c myaccount