CoCo CLI
CoCo CLI
이 항목은 설치, 연결 설정, 검증을 포함해 CoCo CLI를 시작하는 데 도움을 줘요.
시작하기 전에 필요한 Cortex 모델에 접근할 수 있는 Snowflake 계정이 있는지 확인하세요. 전체 세부 정보는 사전 요구 사항을 참고하세요.
출처: CoCo CLI
본문
주의 Snowflake 계정이 없다면 무료 CoCo CLI 체험판에 가입할 수 있어요.
CoCo CLI는 표준 Snowflake 체험판 계정(예: trial.snowflake.com에서 만든 계정)에서는 사용할 수 없어요. CoCo CLI를 사용하려면 유료 Snowflake 계정 또는 위에 연결된 전용 CoCo CLI 체험판이 필요해요.
CoCo CLI 설치
CoCo CLI는 macOS, Linux, Windows(WSL 및 네이티브 모두)에서 사용할 수 있어요. 아래 지침을 사용해 플랫폼에 CoCo CLI를 설치하세요.
macOS 및 Linux(WSL 포함)
macOS, Linux 또는 WSL에 CoCo CLI를 설치하려면 셸에서 다음 명령을 실행해요.
curl -LsS https://ai.snowflake.com/static/cc-scripts/install.sh | sh
이 명령은 설치 스크립트를 다운로드하고 실행하며, 최신 버전의 CoCo CLI를 설치해요. cortex 실행 파일은 기본적으로 ~/.local/bin에 설치돼요. 설치 스크립트는 셸 프로필을 수정해 이 디렉터리를 PATH에 추가해요.
팁
~/.curlrc때문에 curl 명령이 실패하면 아래 명령을 대신 시도해보세요.curl -qLsS https://ai.snowflake.com/static/cc-scripts/install.sh | sh
-q플래그는 curl이~/.curlrc파일을 읽지 못하게 해요..curlrc에 사용자 정의 옵션(예:--verbose)이 있으면 설치 스크립트를 방해할 수 있어요. curl 출력을 셸로 파이프할 때는 항상-q를 포함하세요.
Windows 네이티브
Windows에 CoCo CLI를 설치하려면 PowerShell에서 다음 명령을 실행해요.
irm https://ai.snowflake.com/static/cc-scripts/install.ps1 | iex
이 명령은 설치 스크립트를 다운로드하고 실행하며, 최신 버전의 CoCo CLI를 설치해요. cortex 실행 파일은 기본적으로 %LOCALAPPDATA%\cortex에 설치돼요. 설치 스크립트는 이 디렉터리를 PATH에 추가해요.
설치 후 실행 대화 상자(Win+R), 명령 프롬프트(cmd.exe), 또는 PowerShell에서 CoCo CLI를 호출해요.
Snowflake에 연결
CoCo CLI를 설치한 후 cortex 명령을 실행해요. 설정 마법사가 Snowflake에 대한 연결 선택 또는 설정을 포함한 초기 구성 단계를 안내해요.
첫 번째 프롬프트는 ~/.snowflake/connections.toml 파일의 기존 연결에서 연결을 선택하거나 새 연결을 만들도록 요청해요.
- 기존 연결을 사용하려면 위·아래 화살표 키로 목록에서 연결을 선택한 뒤 Enter를 눌러요.
- 새 연결을 만들려면 아래 화살표 키로 More options가 강조 표시될 때까지 내려간 뒤 Enter를 눌러요. 안내에 따라 Snowflake 계정 세부 정보를 입력해요.
주의
connections.toml은 Snowflake CLI(snow명령)도 사용해요. Snowflake CLI와 함께 사용할 연결을 이미 설정했다면 그 연결을 CoCo CLI에서도 사용할 수 있어요.
CoCo 사용 시작하기
연결한 후 첫 번째 요청을 시도해 보세요.
What can I do with Cortex Code?
"PII 태그가 있는 테이블 찾기" 또는 "SALES_MART.REVENUE용 Streamlit 앱 생성" 같은 자연어 요청을 입력하면 CoCo는 Snowflake 네이티브 스킬과 구성한 MCP 도구를 오케스트레이션해 요청을 이행하려고 해요. MCP 도구 구성에 대한 자세한 내용은 MCP(Model Context Protocol) 문서를 참고하세요.
요청을 처리하는 동안 CoCo CLI는 터미널에 추론 단계와 작업을 표시해요. 때때로 필요한 정보를 요청할 수 있어요. 플랜 모드라면 각 작업을 확인하라고 요청할 거예요.
예시 요청
카탈로그 발견
What databases do I have access to?
List every table tagged PII = TRUE in ANALYTICS_DB
Show the lineage from RAW_DB.ORDERS to downstream dashboards
SQL 생성 및 실행
Write a query for top 10 customers by revenue
Add a 7-day moving average and show me the results
Explain why this query is slow and optimize it
애플리케이션 구축
Build a Streamlit dashboard on SALES_MART.REVENUE with filters for date and region
Create a dbt project to transform raw sales data
Cortex Analyst 작업
Use the @models/revenue.yaml semantic model to answer "What was revenue last month?"
Debug my semantic model at @models/revenue.yaml
사전 요구 사항
CoCo CLI를 사용하려면 다음이 필요해요.
- CoCo CLI와 함께 사용하려는 데이터에 접근하고 작업을 수행할 수 있는 필수 권한이 있는 Snowflake 사용자 계정. 이 사용자는
SNOWFLAKE.CORTEX_USER또는SNOWFLAKE.CORTEX_AGENT_USER데이터베이스 역할도 가져야 해요. 기본적으로SNOWFLAKE.CORTEX_USER는PUBLIC역할을 통해 모든 사용자에게 부여되지만, 조직이 더 엄격한 접근 제어를 구현하기 위해 명시적으로 회수했을 수 있어요. - Snowflake 서버에 대한 네트워크 접근.
- 워크스테이션에 설치된 Snowflake CLI.
- 지원되는 플랫폼 중 하나:
- Apple Silicon 또는 Intel의 macOS
- Intel 또는 ARM의 Linux
- Intel의 WSL(Windows Subsystem for Linux)
- Intel의 Windows 네이티브
주의 Snowflake는 때때로 다른 플랫폼에 대한 지원을 추가할 수 있어요. 특정 플랫폼 요구 사항이 있다면 Snowflake 담당자에게 알려주세요.
플랫폼의
bash,zsh또는fish셸에 대한 로컬 터미널 접근이 필요해요.
추가 구성 옵션, 문제 해결, 고급 설정은 CoCo CLI 참조를 참고하세요.
지원되는 플랫폼
CoCo CLI는 현재 다음 플랫폼을 지원해요.
| 플랫폼 | 아키텍처 |
|---|---|
| macOS | arm64, x64 |
| Linux | x64, arm64 |
| Windows | WSL on x64/amd64; Native on x64 |
주의 Snowflake는 때때로 다른 플랫폼에 대한 지원을 추가할 수 있어요. 특정 플랫폼 요구 사항이 있다면 Snowflake 담당자에게 문의하세요.
지원되는 모델
CoCo는 역할이 접근할 수 있는 Cortex 대규모 언어 모델(Claude, OpenAI GPT, Gemini, Grok 모델 포함)을 사용할 수 있어요. 새 모델은 출시될 때 추가되므로 고정 목록 대신 CoCo는 현재 사용자에게 사용 가능한 모델을 보여줘요. 그 제품 내 목록이 권위 있는 소스예요.
특정 모델을 선택하거나, 모델을 선택해주는 다음 Auto 옵션 중 하나를 선택할 수 있어요.
- Auto: Snowflake가 모델을 선택해요.
- Auto Intelligent: 가장 강력한 모델을 선호해요. 최고 품질, 최고 비용.
- Auto Efficient: 비용에 최적화해요. 최저 비용이며 어려운 작업에서 품질이 낮아질 수 있어요.
선택할 수 있는 모델을 결정하는 두 가지가 있어요.
- 모델 접근: 활성 역할에 부여된 모델. Snowflake Cortex는 RBAC(역할 기반 접근 제어)로 모델 접근을 제어해요.
ACCOUNTADMIN역할을 가진 사용자가 각 역할에 필요한 모델별 애플리케이션 역할 또는 모든 현재·미래 모델에 대한CORTEX-MODEL-ROLE-ALL을 부여해요. 기본적으로 사용자는SNOWFLAKE.PUBLIC부트스트랩 grant를 통해 모든 모델에 대한 접근을 상속해요. 활성 역할이 사용할 수 있는 모델을 나열하려면SHOW CORTEX BASE MODELS IN SCHEMA SNOWFLAKE.MODELS를 실행해요. 자세한 내용은 SHOW CORTEX BASE MODELS 문서를 참고하세요. 모델 접근을 제한하는 방법은 모델 접근 제어를 참고하세요. - 리전별 가용성: 모델이 계정의 리전에서 실행되는지, 크로스 리전 추론을 통해 도달 가능한지 여부. 모델별 리전은 리전별 가용성을 참고하세요. 모델이 귀하의 리전에서 사용할 수 없다면
ACCOUNTADMIN역할을 가진 사용자가 크로스 리전 추론을 활성화해야 해요.
CoCo CLI 세션 내에서 /model 명령을 사용해 역할에 사용 가능한 모델을 나열하거나 모델을 전환해요. 단일 호출에 대한 모델을 설정하려면 cortex --model auto처럼 --model을 전달해요.
법적 고지
Model and Service Pass-Through Terms에 제공된 모델을 사용하도록 Cortex Code를 구성하는 경우, 해당 모델 사용은 해당 페이지의 모델에 대한 약관도 추가로 적용돼요.
입력 및 출력의 데이터 분류는 다음 표에 명시되어 있어요.
| 입력 데이터 분류 | 출력 데이터 분류 | 지정 |
|---|---|---|
| 사용 데이터 | 고객 데이터 | Covered AI Features [1] |
[1] AI 약관 및 허용 가능한 사용 정책에서 사용되는 정의된 용어를 나타내요.
추가 정보는 Snowflake AI 및 ML을 참고하세요.