Cortex Code CLI 설정

Cortex Code CLI 설정은 도구 권한, 연결 및 세션 동작을 제어합니다. 관리형 정책(조직에서 제공하는 경우), 구성 파일, 환경 변수, 명령줄 인자를 사용하여 설정을 구성할 수 있습니다.

구성 파일

다음 구성 파일은 Cortex Code CLI에서 사용됩니다.

파일

목적

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

조직 관리 정책 파일(선택 사항). OS별 위치는 Managed settings (organization policy) 섹션을 참조하세요.

~/.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 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 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: 허용되는 도구 패턴을 나열합니다.

  • deny 기본 권한 모드(defaultMode, ask, allow)입니다.

  • 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 Code 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 Code CLI 설정은 다음을 포함한 명령줄 인자를 통해 재정의할 수 있습니다.

예

설명

cortex -c production

연결을 지정합니다.

cortex --workdir /path

작업 디렉터리를 설정합니다.

cortex --continue

마지막 세션을 계속합니다.

cortex --resume <세션_ID>

특정 세션을 재개합니다.

cortex --plan

계획 모드를 활성화합니다.

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

권한 프롬프트를 비활성화합니다(안전하지 않음).

세션 저장소

대화 및 설정은 다음 위치에 저장됩니다.

location

설명

~/.snowflake/cortex/conversations/

세션 파일입니다.

~/.snowflake/cortex/permissions.json

권한 기본 설정.

~/.snowflake/cortex/mcp.json

MCP 구성입니다.