Cortex Code CLI 참조¶

예¶

작업 디렉터리로 시작:

cortex -w /path/to/project

특정 연결로 마지막 세션 재개:

cortex --continue -c production

일회성 프롬프트(JSON 출력):

cortex -p "List all Python files" --output-format stream-json

update¶

mcp¶

자세한 내용은 모델 컨텍스트 프로토콜(MCP) 섹션을 참조하십시오.

바로 가기 키¶

슬래시 명령¶

세션 저장소¶

구성 세부 정보는 Cortex Code CLI 설정 섹션을 참조하세요.

명령 세부 정보¶

/sql SELECT * FROM users

/sql SELECT * FROM large_table --limit 1000

/sql SELECT
  customer_id,
  SUM(amount) as total
FROM orders
GROUP BY customer_id

Cortex Code CLI 업데이트하기¶

Cortex Code CLI는 새 버전이 출시되면 자동으로 업데이트됩니다. ``cortex update``를 실행하여 최신 버전으로 수동으로 업데이트할 수도 있습니다. ``cortex update <version>``을 실행하여 지정된 버전을 설치합니다.

자동 업데이트를 비활성화하려면 ~/.snowflake/cortex/settings.json`을 편집하고 `”autoUpdate”: false``를 추가합니다.

수동으로 연결 추가하기¶

수동으로 ~/.snowflake/connections.toml 파일을 생성하거나 편집하여 연결을 정의하려면 아래 단계를 따릅니다.

1. ~/.snowflake/connections.toml 파일이 아직 없는 경우 생성합니다.

   mkdir -p ~/.snowflake
   touch ~/.snowflake/connections.toml
   

   Copy

2. chmod 명령을 사용하여 자신만 읽고 쓸 수 있도록 권한을 설정합니다.

   chmod 600 ~/.snowflake/connections.toml
   

   Copy

3. 텍스트 편집기(여기서는 nano)에서 파일을 엽니다.

   nano ~/.snowflake/connections.toml
   

   Copy

4. 다음과 같은 줄을 추가하여 연결을 정의합니다. myaccount 대신 연결 이름을 입력하고 자리 표시자 값을 Snowflake 계정 세부 정보로 바꿉니다. 브라우저 기반 SSO(외부 브라우저 인증) 또는 PAT(프로그래밍 방식 액세스 토큰)를 사용합니다. Snowsight 에서 PAT를 받을 수 있습니다(인증을 위해 프로그래밍 방식의 액세스 토큰 사용 참조). 선택한 인증 방법에 따라 authenticator 값 또는 password 값만 포함합니다.

   [myaccount]
   account       = "<ACCOUNT>"
   user          = "<USERNAME>"
   authenticator = "externalbrowser" # For browser-based SSO; omit for PAT
   password      = "<PAT>"           # For PAT authentication; omit for SSO
   warehouse     = "<WAREHOUSE>"
   role          = "<ROLE>"
   database      = "<DATABASE>"
   schema        = "<SCHEMA>"
   

   Copy

5. 파일을 저장하고 닫습니다.

셸 완성 설정하기¶

셸에 Cortex Code CLI 명령 및 옵션 자동 완성 기능을 제공하려면 셸에 대한 아래 지침을 따릅니다.

셸에 대해 위의 적절한 명령을 실행한 후 ``exec $SHELL``을 사용하여 셸을 다시 시작합니다.

디렉터리 구조¶

Cortex Code CLI를 설치하여 홈 디렉터리에 다음 디렉터리 구조를 생성합니다.

~/.snowflake/cortex/
   ├── settings.json          # Main configuration
   ├── mcp.json               # MCP server configs
   ├── conversations/         # Session history
   ├── skills/                # Global skills
   ├── commands/              # Custom commands
   ├── hooks/                 # Hook scripts
   ├── profiles/              # Team profiles
   └── cache/                 # Temporary cache

명령을 찾을 수 없음¶

설치 디렉터리 ~/.local/bin`이 ``PATH` 환경 변수에 포함되어 있는지 확인합니다. 예를 들어, ``bash``를 사용하는 경우 다음 명령을 실행합니다.

export PATH="~/.local/bin:$PATH"
echo 'export PATH="~/.local/bin:$PATH"' >> ~/.bashrc

권한 거부됨¶

cortex 실행 파일에 실행 권한이 있는지 확인합니다. 다음 명령을 실행합니다.

chmod +x ~/.local/bin/cortex

연결 오류¶

연결 파일 :file:`~/.snowflake/connections.toml`이 존재하며 유효한 연결 세부 정보를 포함하는지 확인합니다.

cat ~/.snowflake/connections.toml

-c 옵션을 사용하여 명시적으로 지정된 연결로 cortex 명령을 호출해 봅니다. 예:

cortex -c myaccount