Configurações da Cortex Code CLI

As configurações da Cortex Code CLI controlam permissões de ferramentas, conexões e comportamento de sessão. É possível definir as configurações usando uma política gerenciada (se fornecida por sua organização), arquivos de configuração, variáveis de ambiente e argumentos de linha de comando.

Arquivos de configuração

Os seguintes arquivos de configuração são usados pela Cortex Code CLI:

Arquivo

Objetivo

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

Arquivo de política gerenciada pela organização (opcional). Para locais específicos do OS, consulte Managed settings (organization policy).

~/.snowflake/cortex/settings.json

Arquivo de configurações principal da Cortex Code CLI.

~/.snowflake/cortex/permissions.json

Preferências de permissão.

~/.snowflake/cortex/mcp.json

Configuração do servidor MCP (consulte Model Context Protocol (MCP))

~/.snowflake/config.toml

Conexões do Snowflake (consulte Cortex Code CLI). Compartilhado com a Snowflake CLI.

O layout completo do diretório de configuração principal é:

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

Precedência de configurações

As configurações são aplicadas na seguinte ordem de precedência (maior para menor):

  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

Arquivo de configurações principal para a Cortex Code CLI.

Exemplo de conteúdo:

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

As seguintes configurações estão disponíveis:

  • compactMode: habilita a formatação de saída compacta.

  • autoUpdate: habilita as atualizações automáticas.

  • theme: define o tema da CLI (light ou dark).

permissions.json

~/.snowflake/cortex/permissions.json

Controla as permissões de acesso à ferramenta.

Exemplo de conteúdo:

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

As seguintes configurações estão disponíveis:

  • onlyAllow: lista de padrões de ferramenta permitidos.

  • defaultMode: modo de permissão padrão (ask, allow, deny).

  • dangerouslyAllowAll: permite todas as ferramentas sem avisos (não é seguro).

Configurações gerenciadas (política da organização)

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

Variáveis de ambiente

A Cortex Code CLI reconhece as seguintes variáveis de ambiente de configuração:

Variável

Descrição

SNOWFLAKE_HOME

Substitui o diretório padrão ~/.snowflake.

CORTEX_AGENT_MODEL

Substitui a seleção de modelo.

CORTEX_ENABLE_MEMORY

Habilita a ferramenta de memória (definida como true ou 1).

COCO_DANGEROUS_MODE_REQUIRE_SQL_WRITE_PERMISSION

Requer confirmação para operações de gravação SQL no modo bypass.

Nota

Para obter variáveis de ambiente adicionais relacionadas à permissão, consulte Segurança.

Substituições de linha de comando

As configurações da Cortex Code CLI podem ser substituídas por meio de argumentos de linha de comando como estes:

Exemplo

Descrição

cortex -c production

Especifica a conexão.

cortex --workdir /path

Define o diretório de trabalho.

cortex --continue

Continua a última sessão.

cortex --resume <session_id>

Retoma uma sessão específica.

cortex --plan

Habilita o modo de planejamento.

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

Desabilita os avisos de permissão (não é seguro).

Armazenamento de sessões

As conversas e as configurações são armazenadas em:

Local

Descrição

~/.snowflake/cortex/conversations/

Arquivos de sessão.

~/.snowflake/cortex/permissions.json

Preferências de permissão.

~/.snowflake/cortex/mcp.json

Configuração do MCP.