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

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

  1. Restrictions des paramètres gérés (champs settings.* dans``managed-settings.json``). Ne peut être remplacé par aucune configuration au niveau de l’utilisateur. Voir Paramètres gérés (politique de l’organisation).

  2. Remplacements des profils (settingsOverrides du profil actif, le cas échéant).

  3. Paramètres des projets (.cortex/settings.json ou .claude/settings.json dans le répertoire de travail).

  4. Valeurs par défaut des paramètres gérés (champs defaults.* dans managed-settings.json). Les utilisateurs peuvent les remplacer dans leurs propres settings.json.

  5. Paramètres utilisateur globaux (~/.snowflake/cortex/settings.json).

  6. Valeurs par défaut intégrées dans Cortex Code CLI.

Les autorisations suivent un ordre d’évaluation distinct. Voir Évaluation des autorisations.

settings.json

~/.snowflake/cortex/settings.json

Fichier de paramètres CLI principal de Cortex Code.

Exemple de contenu :

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

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
}

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 administrateurs peuvent déployer un fichier de politique JSON au niveau du système afin de faire respecter le comportement de Cortex Code CLI au sein d’une organisation, en restreignant les outils, les comptes et les versions minimales. Pour plus de détails, voir Paramètres gérés (politique de l’organisation).

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.