Cortexコード CLI 設定¶

設定の優先順位¶

設定は次の優先順位で適用されます（高い順）。

1. 管理設定（システム管理のポリシーファイルが存在する場合は、そのファイル）。管理設定（組織ポリシー） をご参照ください。

2. セッション中のコマンド（/plan など）

3. コマンドライン引数

4. 環境変数

5. 構成ファイル（~/.snowflake/cortex/）

6. CortexコードCLIに埋め込まれたデフォルト値

settings.json¶

~/.snowflake/cortex/settings.json

Cortexコード CLI の主な設定ファイル。

コンテンツ例:

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

次の設定を使用できます。

• compactMode：コンパクトな出力フォーマットを有効にします。

• autoUpdate：自動更新を有効にします。

• theme：CLIテーマ（light``または``dark）を設定します。

permissions.json¶

~/.snowflake/cortex/permissions.json

ツールのアクセス許可を制御します。

コンテンツ例:

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

次の設定を使用できます。

• onlyAllow：許可されたツールパターンのリスト。

• defaultMode：デフォルトの権限モード（ask、allow、deny）。

• dangerouslyAllowAll：プロンプトなしですべてのツールを許可（安全でない）。

管理設定（組織ポリシー）¶

管理設定を使用すると、ITの管理者はCortex CodeCLIに対して組織全体のポリシーを適用できます。たとえば、管理者は使用できるツールやアカウントを制限したり、最小のCLIバージョンを強制したり、バイパス機能を無効にしたりできます。

これらの設定は通常、エンタープライズ構成管理ツール（MDMやSCCMなど）を通じてデプロイされます。ユーザーは通常、管理者権限またはルート権限を持っていない限り、管理設定を変更できません。

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

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

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

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

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

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

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

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