Cortexコード 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コード 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コード CLI の更新¶

Cortexコード CLI は、新しいバージョンが利用可能になると自動的に更新されます。cortex update を発行して、手動で最新バージョンに更新することもできます。cortex update <バージョン> を発行して、指定されたバージョンをインストールします。

自動更新を無効にするには、 ~/.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（プログラムのアクセストークン）を使用します。PAT を Snowsight から取得できます（認証のためのプログラム アクセス トークンの使用 を参照）選択した認証方法に応じて 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コード CLI コマンドとオプションのオートコンプリート機能を与えるには、シェルについて以下の手順に従ってください。

シェルに対して上記の適切なコマンドを実行した後、 exec $SHELL を使用してシェルを再起動します。

ディレクトリ構造¶

Cortexコード 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

接続エラー¶

接続ファイル ~/.snowflake/connections.toml が存在し、有効な接続の詳細が含まれています。

cat ~/.snowflake/connections.toml

-c オプションを使用して明示的に指定された接続で cortex コマンドを呼び出してみます。例:

cortex -c myaccount