Cortexコード CLI¶

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

Cortex Code CLIはLinux、macOS、Windows（WSLとネイティブの両方）で利用可能です。プラットフォームにCortex Code CLIをインストールするには、以下の手順に従ってください。

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

  • Intel上のLinux

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

  • Intel上のWindowsネイティブ（プレビュー）

  注釈

  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 をご参照ください。