Cortexコード CLI¶

Cortexコード CLI をインストールする¶

Cortex Code CLI is available for macOS, Linux, and Windows (both WSL and native). Use the instructions below to install Cortex Code CLI on your platform.

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

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

Snowflakeに接続する¶

Cortex Code CLI をインストールした後、 cortex コマンドを発行します。設定ウィザードは、Snowflakeへの接続の選択または設定を含む、初期設定のステップをガイドします。

最初のプロンプトは、 ~/.snowflake/connections.toml ファイル内の既存の接続から接続を選択するか、新しい接続を作成するか尋ねられます。

• 既存の接続を使用するには、および矢印キーを使ってリストから接続を選択し、Enterキーを押します。

• 新しい接続を作成するには、下矢印キーを押して More options* を選択し、強調表示されてからEnterキーを押します。プロンプトに従って、Snowflakeアカウントの詳細を入力します。

Cortexコードの使用を開始する¶

接続したら、最初の要求を試してください。

What can I do with Cortex Code?

自然言語リクエスト（「PII タグ付きのテーブルを検索する」または「SALES_MART.REVENUE 用Streamlitアプリを生成する」など）を入力すると、Cortexコードは、Snowflakeネイティブスキルと構成済みの MCP ツールをオーケストレーションして要求を実行しようとします。MCP ツールの構成の詳細については、 モデルコンテキストプロトコル（MCP） をご参照ください。

リクエストに応じて動作するため、Cortexコード 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

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

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

前提条件¶

Cortexコード CLI を使う場合、以下が必要です。

• Cortexコード CLI で使用する予定のデータにアクセスし、それらに対して操作を実行するために必要な権限を持つSnowflakeユーザーアカウント。このユーザーは、SNOWFLAKE.CORTEX_USERデータベースロールも持っている必要があります。（初期状態では、すべてのユーザーがPUBLICロールを通じてSNOWFLAKE.CORTEX_USERロールを持っていますが、より厳格なアクセス制御を実装するために、組織がこのロールを明示的に取り消している場合があります。）

• Snowflakeサーバーへのネットワークアクセス。

• ワークステーションに Snowflake CLI がインストールされています。

• 次のサポートされているプラットフォームのいずれかです。

  • Apple SiliconまたはIntel上の macOS

  • Linux on Intel or ARM

  • Intel上のLinux用Windowsサブシステム（WSL）

  • Windows Native on Intel

  注釈

  Snowflakeは、他のプラットフォームのサポートを追加することがあります。特定のプラットフォーム要件がある場合は、Snowflake担当者にお知らせください。

• プラットフォーム上の bash、 zsh``または ``fish シェルへのローカルターミナルアクセス。

その他の構成オプション、トラブルシューティング、高度な設定については、 Cortexコード CLI 参照 をご参照ください。

サポートされているプラットフォームとモデル¶

ALTER ACCOUNT SET CORTEX_ENABLED_CROSS_REGION = 'AWS_US';

法的通知¶

Cortexコードの設定が `モデルとサービスのパススルー規約<https://www.snowflake.com/en/legal/optional-offerings/offering-specific-terms/ai-features/model-pass-through-terms/>`__ において提供されるモデルを使用する場合、そのモデルの使用にはそのページにあるモデルの規約も適用されます。

インプットとアウトプットのデータ分類は以下の表の通りです。

詳細については、 Snowflake AI と ML をご参照ください。