Cortexコード CLI 設定

CortexコードCLI設定は、ツールの権限、接続、セッションの動作を制御します。管理ポリシー（組織が提供している場合）、構成ファイル、環境変数、コマンドライン引数を使用して設定を構成できます。

構成ファイル

次の構成ファイルはCortexコード CLI で使用されます。

ファイル

目的

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

組織管理のポリシーファイル（オプション）。OS固有の場所については、:ref:`label-cortex_code_managed_settings`をご参照ください。

~/.snowflake/cortex/settings.json

メインCortexコードCLI設定ファイル。

~/.snowflake/cortex/permissions.json

権限設定。

~/.snowflake/cortex/mcp.json

MCPサーバーの構成（:ref:`extensibility-mcp`を参照）。

~/.snowflake/config.toml

Snowflake接続（Cortexコード CLI を参照）。Snowflake CLI と共有されています。

メイン構成ディレクトリのレイアウト全体は次のとおりです。

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

設定の優先順位

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

  1. Managed settings restrictions (settings.* fields in managed-settings.json). Can't be overridden by any user-level configuration. See Managed settings (organization policy).

  2. Profile overrides (settingsOverrides from the active profile, if any).

  3. Project settings (.cortex/settings.json or .claude/settings.json in the working directory).

  4. Managed settings defaults (defaults.* fields in managed-settings.json). Users can override these in their own settings.json.

  5. Global user settings (~/.snowflake/cortex/settings.json).

  6. Default values embedded in the Cortex Code CLI.

Permissions follow a separate evaluation order. See Permission evaluation.

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：プロンプトなしですべてのツールを許可（安全でない）。

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

Administrators can deploy a system-level JSON policy file to enforce Cortex Code CLI behavior across an organization, restricting tools, accounts, and minimum versions. For details, see Managed settings (organization policy).

環境変数

CortexコードCLIは、以下の構成環境変数を認識します。

変数

説明

SNOWFLAKE_HOME

デフォルトの``~/.snowflake``ディレクトリを上書きします。

CORTEX_AGENT_MODEL

モデルの選択を上書きします。

CORTEX_ENABLE_MEMORY

メモリツールを有効にします（``true``または``1``に設定）。

COCO_DANGEROUS_MODE_REQUIRE_SQL_WRITE_PERMISSION

バイパスモードでのSQL書き込み操作には確認が必要です。

注釈

その他の権限関連の環境変数については、:doc:`セキュリティ</user-guide/cortex-code/security>`をご参照ください。

コマンドラインのオーバーライド

Cortexコード CLI の設定は、次のようなコマンドライン引数でオーバーライドできます。

例

説明

cortex -c production

接続を指定します。

cortex --workdir /path

作業ディレクトリを設定します。

cortex --continue

前回のセッションを続行します。

cortex --resume <セッションID>

特定のセッションを再開します。

cortex --plan

計画モードを有効にします。

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

権限プロンプトを無効にします（安全でない）。

セッションストレージ

会話と設定は以下の場所に保存されます。

場所

説明

~/.snowflake/cortex/conversations/

セッションファイル。

~/.snowflake/cortex/permissions.json

権限設定。

~/.snowflake/cortex/mcp.json

MCP設定。