Cortex Code CLI 设置

Cortex Code CLI 设置用于控制工具权限、连接和会话行为。您可以使用托管策略（如果由组织提供）、配置文件、环境变量和命令行实参来配置这些设置。

配置文件

Cortex Code CLI 使用以下配置文件：

文件

目的

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

组织管理的策略文件（可选）。有关 OS 特定的位置，请参阅 托管设置（组织策略）。

~/.snowflake/cortex/settings.json

Cortex Code CLI 主设置文件。

~/.snowflake/cortex/permissions.json

权限首选项

~/.snowflake/cortex/mcp.json

MCP 服务器配置（请参阅 模型上下文协议 (MCP)）。

~/.snowflake/config.toml

Snowflake 连接（请参阅 Cortex Code 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.json 中的 settings.* 字段）。不能被任何用户级配置覆盖。请参阅 托管设置（组织策略）。

  2. 配置文件覆盖（来自活动配置文件的 settingsOverrides，如果有的话）。

  3. 项目设置（工作目录中的 .cortex/settings.json 或 .claude/settings.json）。

  4. 托管设置默认值（managed-settings.json 中的 defaults.* 字段）。用户可以在自己的 settings.json 中覆盖这些设置。

  5. 全局用户设置（~/.snowflake/cortex/settings.json）。

  6. 嵌入在 Cortex Code CLI 中的默认值。

权限遵循独立的评估顺序。请参阅 权限评估。

settings.json

~/.snowflake/cortex/settings.json

Cortex Code 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：选择使用 时默认使用的角色和仓库。允许所有工具而不进行提示（不安全）。

托管设置（组织策略）

管理员可以部署系统级 JSON 策略文件，以在整个组织中强制执行 Cortex Code CLI 行为，限制工具、账户和最低版本。 是 Web 令牌 (托管设置（组织策略）)、 令牌或 编程访问令牌 。有关详细信息，请参阅 托管设置（组织策略）。

环境变量

Cortex Code CLI 可识别以下配置环境变量：

变量

描述

SNOWFLAKE_HOME

替换默认的 ~/.snowflake 目录。

CORTEX_AGENT_MODEL

替换模型选择。

CORTEX_ENABLE_MEMORY

启用内存工具（设置为 true 或 1）。

COCO_DANGEROUS_MODE_REQUIRE_SQL_WRITE_PERMISSION

在旁路模式下执行 SQL 写入操作时需要确认。

备注

有关更多与权限相关的环境变量，请参阅 安全性。

命令行替换

Cortex Code CLI 设置可以通过命令行实参替换，其中包括以下内容：

示例

描述

cortex -c production

指定连接。

cortex --workdir /path

设置工作目录。

cortex --continue

继续上一个会话。

cortex --resume <session_id>

恢复特定会话。

cortex --plan

启用计划模式。

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

禁用权限提示（不安全）。

会话存储

对话和设置存储位置：

位置

描述

~/.snowflake/cortex/conversations/

会话文件。

~/.snowflake/cortex/permissions.json

权限首选项

~/.snowflake/cortex/mcp.json

MCP 配置。