Paramètres CLI de Cortex Code¶

Les paramètres de la CLI Cortex Code permettent de gérer les autorisations des outils, les connexions et le comportement des sessions. Vous pouvez configurer les paramètres à l’aide de politiques gérées (si elles sont fournies par votre entreprise), de fichiers de configuration, de variables d’environnement et d’arguments de ligne de commande.

Fichiers de configuration¶

Les fichiers de configuration suivants sont utilisés par la CLI de Cortex Code :

Fichier	But
`<admin-managed path>/managed-settings.json`	Fichier de politique géré par l’organisation (facultatif). Pour les emplacements spécifiques OS, voir Paramètres gérés (politique de l’organisation).
`~/.snowflake/cortex/settings.json`	Fichier de paramètres CLI principal de Cortex Code.
`~/.snowflake/cortex/permissions.json`	Préférences d’autorisation.
`~/.snowflake/cortex/mcp.json`	Configuration du serveur MCP (voir Protocole de contexte de modèle (MCP)).
`~/.snowflake/config.toml`	Connexions Snowflake (voir CLI de Cortex Code). Partagées avec la CLI Snowflake.

La disposition complète du répertoire de configuration principal est la suivante :

~/.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

Copy

Ordre de précédence des paramètres¶

Les paramètres sont appliqués dans l’ordre de précédence suivant (du plus élevé au plus bas) :

Paramètres gérés (fichier de politique géré par le système, le cas échéant). Voir Paramètres gérés (politique de l’organisation).
Commandes en session (/plan, etc.)
Arguments de la ligne de commande
Variables d’environnement
Fichiers de configuration (~/.snowflake/cortex/)
Valeurs par défaut intégrées dans la CLI Cortex Code

`settings.json`¶

~/.snowflake/cortex/settings.json: Fichier de paramètres CLI principal de Cortex Code.

Exemple de contenu :

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

Copy

Les paramètres suivants sont disponibles :

compactMode : active le formatage de sortie compact
autoUpdate : active les mises à jour automatiques.
theme : définit le thème de la CLI (light ou dark).

`permissions.json`¶

~/.snowflake/cortex/permissions.json: Contrôle les autorisations d’accès aux outils.

Exemple de contenu :

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

Copy

Les paramètres suivants sont disponibles :

onlyAllow : liste des modèles d’outils autorisés.
defaultMode : mode d’autorisation par défaut (ask, allow, deny).
dangerouslyAllowAll : autoriser tous les outils sans invites (non sécurisé).

Paramètres gérés (politique de l’organisation)¶

Les paramètres gérés autorisent les administrateurs IT à appliquer des politiques à l’ensemble de l’organisation pour la CLI Cortex Code. Par exemple, les administrateurs peuvent restreindre les outils ou les comptes pouvant être utilisés, appliquer des versions de CLI minimales et désactiver les capacités de contournement.

Ces paramètres sont généralement déployés via des outils de gestion de la configuration de l’entreprise (tels que MDM ou SCCM). En règle générale, les utilisateurs ne peuvent pas modifier les paramètres gérés, sauf s’ils disposent de droits d’administrateur ou racine.

Emplacements de fichier¶

Le fichier de paramètres gérés est stocké dans un chemin de niveau système :

Plateforme	Chemin
macOS	`/Library/Application Support/Cortex/managed-settings.json`
Linux et WSL	`/etc/cortex/managed-settings.json`

Schéma de configuration¶

Le fichier de paramètres gérés utilise JSON avec la structure suivante :

{
  "version": "1.0",
  "permissions": { },
  "settings": { },
  "required": { },
  "defaults": { },
  "ui": { }
}

Copy

Autorisations¶

La section permissions peut restreindre l’accès des utilisateurs. Par exemple, vous pouvez autoriser ou refuser des modèles d’outils et des modèles de comptes.

{
  "permissions": {
    "onlyAllow": ["pattern1", "pattern2"],
    "deny": ["pattern3"],
    "defaultMode": "allow",
    "dangerouslyAllowAll": false
  }
}

Copy

Champ	Type	Par défaut	Description
`onlyAllow`	`string[]`	—	Liste de modèles autorisés. Si cette option est activée, seuls les éléments correspondants sont autorisés.
`deny`	`string[]`	—	Liste de modèles non autorisés. L’interdiction a la priorité sur l’autorisation.
`defaultMode`	`"allow"` ou `"deny"`	`"deny"`	Comportement lorsqu’aucune règle ne correspond.
`dangerouslyAllowAll`	`boolean`	`false`	Contrôle si le mode contournement est autorisé.

Paramètres¶

La section settings applique le comportement d’exécution :

{
  "settings": {
    "forceNoHistoryMode": true,
    "forceSandboxEnabled": true,
    "forceSandboxMode": "regular"
  }
}

Copy

Champ	Type	Par défaut	Description
`forceNoHistoryMode`	`boolean`	`false`	Empêcher la conservation de l’historique des conversations.
`forceSandboxEnabled`	`boolean`	`false`	Forcer l’activation permanente de la sandbox.
`forceSandboxMode`	`"regular"` ou `"autoAllow"`	—	Forcer un mode sandbox spécifique.

Obligatoire¶

La section required peut appliquer des versions minimales :

{
  "required": {
    "minimumVersion": "0.25.0"
  }
}

Copy

Champ	Type	Description
`minimumVersion`	`string`	Version minimale de CLI. Les versions antérieures affichent un message d’erreur et se ferment.

Valeurs par défaut¶

La section defaults fournit les valeurs par défaut. Les utilisateurs ne peuvent remplacer ces valeurs par défaut que si la politique l’autorise.

{
  "defaults": {
    "connectionName": "prod",
    "profileName": "corporate",
    "theme": "dark"
  }
}

Copy

Champ	Type	Description
`connectionName`	`string`	Nom de la connexion Snowflake par défaut
`profileName`	`string`	Profil par défaut à charger.
`theme`	`string`	thème d’UI par défaut (par exemple, `dark` ou `light`).

UI¶

La section ui contrôle la présentation de l’interface utilisateur :

{
  "ui": {
    "showManagedBanner": true,
    "bannerText": "[Secure] Managed by Corporate IT",
    "hideDangerousOptions": true
  }
}

Copy

Champ	Type	Par défaut	Description
`showManagedBanner`	`boolean`	`false`	Affichage d’une bannière indiquant l’état géré.
`bannerText`	`string`	—	Texte personnalisé pour la bannière gérée.
`hideDangerousOptions`	`boolean`	`false`	Masquer les options dangereuses de l’aide et de l’UI.

Exemples¶

Configuration d’entreprise de base¶

Autoriser la fonctionnalité par défaut, mais désactiver le mode de contournement et afficher une bannière gérée.

{
  "version": "1.0",
  "permissions": {
    "dangerouslyAllowAll": false,
    "defaultMode": "allow"
  },
  "settings": {},
  "required": {
    "minimumVersion": "0.25.0"
  },
  "ui": {
    "showManagedBanner": true,
    "bannerText": "Managed by IT"
  }
}

Copy

Restriction à des comptes Snowflake spécifiques¶

Autoriser uniquement les connexions aux comptes de production et de mise en zone de préparation.

{
  "version": "1.0",
  "permissions": {
    "dangerouslyAllowAll": false,
    "onlyAllow": [
      "account(mycompany-prod)",
      "account(mycompany-staging)"
    ],
    "defaultMode": "allow"
  }
}

Copy

Variables d’environnement¶

La CLI Cortex Code reconnaît les variables d’environnement de configuration suivantes :

Variable	Description
`SNOWFLAKE_HOME`	Remplace le répertoire `~/.snowflake` par défaut.
`CORTEX_AGENT_MODEL`	Remplace la sélection du modèle.
`CORTEX_ENABLE_MEMORY`	Active l’outil de mémoire (défini sur `true` ou sur `1`).
`COCO_DANGEROUS_MODE_REQUIRE_SQL_WRITE_PERMISSION`	Exige une confirmation pour les opérations d’écriture SQL en mode contournement.

Note

Pour les variables d’environnement supplémentaires liées aux autorisations, voir Sécurité.

Remplacements de la ligne de commande¶

Les paramètres CLI de Cortex Code peuvent être remplacés via des arguments de ligne de commande, qui incluent ce qui suit :

Exemple	Description
`cortex -c production`	Spécifie la connexion.
`cortex --workdir /path`	Définit le répertoire de travail.
`cortex --continue`	Poursuit la dernière session.
`cortex --resume <id_session>`	Reprend une session spécifique.
`cortex --plan`	Active le mode planification.
`cortex --dangerously-allow-all-tool-calls`	Désactive les invites d’autorisation (non sécurisé).

Stockage des sessions¶

Les conversations et les paramètres sont stockés dans :

Emplacement	Description
`~/.snowflake/cortex/conversations/`	Fichiers de session.
`~/.snowflake/cortex/permissions.json`	Préférences d’autorisation.
`~/.snowflake/cortex/mcp.json`	Configuration MCP.

Paramètres CLI de Cortex Code¶

Fichiers de configuration¶

Ordre de précédence des paramètres¶

settings.json¶

permissions.json¶

Paramètres gérés (politique de l’organisation)¶

Emplacements de fichier¶

Schéma de configuration¶

Autorisations¶

Paramètres¶

Obligatoire¶

Valeurs par défaut¶

UI¶

Exemples¶

Configuration d’entreprise de base¶

Restriction à des comptes Snowflake spécifiques¶

Variables d’environnement¶

Remplacements de la ligne de commande¶

Stockage des sessions¶

`settings.json`¶

`permissions.json`¶