Cortex Code CLI

本主题可帮助您开始使用 Cortex Code CLI，包括安装、连接设置和验证。

在开始之前，请确保您拥有一个可以访问所需 Cortex 模型的 Snowflake 账户。请参阅 先决条件 了解详细信息。

备注

如果您没有 Snowflake 账户，您可以 注册免费 Cortex Code CLI 试用 (https://signup.snowflake.com/cortex-code)。

安装 Cortex Code CLI

Linux（包括 WSL）和 macOS

要在 Linux 或 macOS 上安装 Cortex Code CLI，请在 shell 中发出以下命令：

curl -LsS https://ai.snowflake.com/static/cc-scripts/install.sh | sh
Copy

此命令下载并运行安装脚本，该脚本会安装最新版本的 Cortex Code CLI。cortex 可执行文件默认安装在 ~/.local/bin 中。

Windows 原生

要在 Windows 上安装 Cortex Code CLI，请在 PowerShell 中发出以下命令：

irm https://ai.snowflake.com/static/cc-scripts/install.ps1 | iex
Copy

此命令下载并运行安装脚本，该脚本会安装最新版本的 Cortex Code CLI。cortex 可执行文件默认安装在 %LOCALAPPDATA%\cortex 中。安装脚本会将该可执行文件添加到 PATH 中。

连接到 Snowflake

安装 Cortex Code 后 CLI，发出 cortex 命令。设置向导将指导您完成初始配置步骤，包括选择或设置与 Snowflake 的连接。

第一个提示要求您从 ~/.snowflake/connections.toml 文件中的现有连接中选择一个连接，或创建新连接。

  • 要使用现有连接，请使用向上和向下箭头键从列表中选择连接，然后按 Enter。

  • 要创建新连接，请通过按向下箭头键直到突出显示来选择 More options*，然后按 Enter。按照提示输入您的 Snowflake 账户详细信息。

备注

connections.toml 也可用于 Snowflake CLI</developer-guide/snowflake-cli/index>`（``snow` 命令）。如果您已经设置了用于 Snowflake CLI 的连接，您可以将该连接与 Cortex Code CLI 关联使用。

开始使用 Cortex Code

连接后，请尝试您的第一个请求：

What can I do with Cortex Code?
Copy

输入自然语言请求（例如“查找带有 PII 标签的表”或“为 SALES_MART.REVENUE 生成 Streamlit 应用”），随后 Cortex Code 会尝试通过编排 Snowflake 原生技能和您已配置的任何 MCP 工具来完成请求。有关配置 MCP 工具的更多信息，请参阅 模型上下文协议 (MCP)。

在处理您的请求时，Cortex Code 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
Copy

生成并运行 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
Copy

构建应用程序

Build a Streamlit dashboard on SALES_MART.REVENUE with filters for date and region
Create a dbt project to transform raw sales data
Copy

使用 Cortex Analyst

Use the @models/revenue.yaml semantic model to answer "What was revenue last month?"
Debug my semantic model at @models/revenue.yaml
Copy

先决条件

要使用 Cortex Code CLI，您需要以下内容：

  • 具有必要权限的 Snowflake 用户账户，可访问您打算与 Cortex Code CLI 关联使用的数据并对其执行操作。此用户还必须拥有 SNOWFLAKE.CORTEX_USER 数据库角色。（初始时，所有用户均通过 PUBLIC 角色获得 SNOWFLAKE.CORTEX_USER 角色，但您的组织可能已明确撤销该角色以实施更严格的访问控制。）

  • 能够通过网络访问您的 Snowflake 服务器。

  • 工作站上已安装 Snowflake CLI。

  • 以下支持的平台之一：

    • macOS（Apple 芯片或 Intel 芯片）

    • Linux（Intel 芯片）

    • 适用于 Linux 的 Windows 子系统 (WSL)（Intel 芯片）

    • 基于 Intel 的 Windows Native（预览版）

    备注

    Snowflake 可能会不时增加对其他平台的支持。如果您有特定的平台要求，请告知您的 Snowflake 代表。

  • 能够通过本地终端访问平台上的 bash、zsh 或 fish shell。

有关其他配置选项、故障排除和高级设置，请参阅 Cortex Code CLI 参考。

支持的平台和模型

支持的平台

Cortex Code CLI 目前支持以下平台：

平台

架构

macOS

arm64、x64

Linux

x64、arm64

Windows
x64/amd64 上的 WSL
x64 原生支持（预览版）

备注

Snowflake 可能会不时增加对其他平台的支持。如果您有特定的平台要求，请联系您的 Snowflake 代表。

支持的模型

Cortex Code CLI 支持以下模型。您的账户必须至少启用其中一种模型（例如通过将其添加到账户的允许列表 CORTEX_MODELS_ALLOWLIST 中）。有关更多信息，请参阅 控制模型访问。

Snowflake 建议将模型类型设置为 auto。Cortex 会自动选择您的账户可用的最高质量模型。当出现性能更优的新模型时，auto 将指向该模型。

要选择其他模型，请在 Cortex Code CLI 会话中使用 /model 命令。

模型

标识符

Auto

auto

Claude Opus 4.6

claude-opus-4-6

Claude Sonnet 4.6

claude-sonnet-4-6

Claude Opus 4.5

claude-opus-4-5

Claude Sonnet 4.5

claude-sonnet-4-5

Claude Sonnet 4.0

claude-4-sonnet

模型质量和功能各不相同，因此请根据您的要求选择模型。

云区域

如果您想使用的模型在您所在区域不 可用，您可以使用 Cortex 跨区域推理来访问其他可用区域中的模型。有关配置跨区域推理的更多信息，请参阅 跨区域推理。

Cortex Code 需要 ACCOUNTADMIN 来将 CORTEX_ENABLED_CROSS_REGION 配置为以下值之一。

下表显示了可用于每个跨区域推理设置的模型：

模型
跨云
（任何区域）
AWS US
（跨区域）
AWS EU
（跨区域）
AWS APJ
（跨区域）
Azure US
（跨区域）
Azure EU
（跨区域）

claude-opus-4-6

✔

✔

✔

claude-sonnet-4-6

✔

✔

✔

claude-opus-4-5

✔

✔

✔

claude-sonnet-4-5

✔

✔

✔

claude-4-sonnet

✔

✔

✔

✔

* 表示预览版模型。预览版模型不适合生产工作负载。

要启用跨区域推理，ACCOUNTADMIN 必须运行：

ALTER ACCOUNT SET CORTEX_ENABLED_CROSS_REGION = 'AWS_US';
Copy

将 AWS_US 替换为相应的区域标识符。

重要

当所选模型在您所在区域不可用时，需要使用跨区域推理。 我们建议根据您的需求进行以下设置：

  • AWS_US：推荐使用 Claude Opus 4.x 模型以获得最佳体验。

  • AWS_EU：从 EU 访问 Claude 模型。

  • AWS_APJ：从 APJ 访问 Claude 模型（可能仅限于 Claude Sonnet 4.0）。

  • ANY_REGION：访问 所有 模型（尽力而为的全球路由）。

您的组织可以限制模型访问权限，因此您可能无权访问所有模型。有关详细信息，请参阅 控制模型访问。