CoCo CLI Settings

CoCo CLI Settings (설정)

CoCo CLI 설정은 도구 권한, 연결, 세션 동작을 제어해요. 관리 정책(조직이 제공하는 경우), 구성 파일, 환경 변수, 명령줄 인자로 설정을 구성할 수 있어요.

출처: CoCo CLI Settings

본문

구성 파일

CoCo CLI가 사용하는 구성 파일은 다음과 같아요.

파일	용도
`<admin-managed path>/managed-settings.json`	조직 관리 정책 파일(선택). OS별 위치는 Managed settings (organization policy)를 참고해요.
`~/.snowflake/cortex/settings.json`	CoCo CLI 기본 설정 파일.
`~/.snowflake/cortex/permissions.json`	권한 선호.
`~/.snowflake/cortex/mcp.json`	MCP 서버 구성.
`~/.snowflake/config.toml`	Snowflake 연결(CoCo 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 (coco.log, coco_errors.log)
├── memory/                # Persistent memory
├── agents/                # Custom agents
├── skills/                # Global skills
├── commands/              # Custom commands
├── hooks/                 # Hook scripts
└── remote_cache/          # Cloned repos

설정 우선순위

설정은 다음 우선순위 순서로 적용돼요(높은 것에서 낮은 것으로).

관리 설정 제한(managed-settings.json의 settings.* 필드). 어떤 사용자 수준 구성으로도 재정의할 수 없어요. Managed settings (organization policy) 참고.
프로필 오버라이드(활성 프로필의 settingsOverrides, 있으면).
프로젝트 설정(작업 디렉터리의 .cortex/settings.json 또는 .claude/settings.json).
관리 설정 기본값(managed-settings.json의 defaults.* 필드). 사용자가 자신의 settings.json에서 재정의할 수 있어요.
전역 사용자 설정(~/.snowflake/cortex/settings.json).
CoCo CLI에 내장된 기본값.

권한은 별도의 평가 순서를 따라요. Permission evaluation 참고.

settings.json

~/.snowflake/cortex/settings.json — CoCo 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: 프롬프트 없이 모든 도구 허용(안전하지 않음).

Managed settings (organization policy)

관리자는 시스템 수준 JSON 정책 파일을 배포해 조직 전체에서 CoCo CLI 동작을 강제할 수 있어요. 도구, 계정, 최소 버전을 제한해요. 자세한 내용은 Managed settings (organization policy)를 참고해요.

환경 변수

CoCo CLI가 인식하는 구성 환경 변수는 다음과 같아요.

변수	설명
`SNOWFLAKE_HOME`	기본 `~/.snowflake` 디렉터리를 오버라이드.
`CORTEX_AGENT_MODEL`	모델 선택 오버라이드.
`CORTEX_ENABLE_MEMORY`	메모리 도구를 켜요(`true` 또는 `1`로 설정).
`COCO_DANGEROUS_MODE_REQUIRE_SQL_WRITE_PERMISSION`	우회 모드에서 SQL 쓰기 동작에 확인을 요구.
`COCO_LOG_LEVEL`	디스크에 쓰는 최소 로그 수준: DEBUG, INFO, WARNING, 또는 ERROR. 기본: INFO.
`COCO_DEBUG`	`1`, `true`, 또는 `yes`로 설정해 디버그 로깅을 강제. COCO_LOG_LEVEL을 오버라이드.
`COCO_LOG_DIR`	coco.log와 coco_errors.log의 디렉터리. 기본: `$SNOWFLAKE_HOME/cortex/logs`. 여기서 SNOWFLAKE_HOME은 기본적으로 `~/.snowflake`.

참고

추가 권한 관련 환경 변수는 Security를 참고해요.

명령줄 오버라이드

CoCo 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 구성.

더 알아보기

Managed settings (organization policy) — 관리 정책
CoCo CLI — CLI 개요
Security — 보안·권한