К основному содержанию
плагин

snowflake-cortex-code — плагин Claude Code: установка

Плагин snowflake-cortex-code перенаправляет запросы о Snowflake в Cortex Code, а остальные оставляет Claude Code. Подходит для работы с данными Snowflake из чата с агентом.

Apache-2.0 ★ 45 обновлён 2026-10-23

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin install snowflake-cortex-code@claude-plugins-official
/plugin marketplace add anthropics/claude-plugins-community
/plugin install snowflake-cortex-code@claude-community
/plugin marketplace add anthropics/claude-plugins-official
Открыть на GitHub

Что делает snowflake-cortex-code

Фильтр prompt_filter.py проверяет запросы и передаёт связанные со Snowflake задачи навыку cortex-router; тот запускает Cortex Code. В Cortex Code заявлено 55+ встроенных навыков. Запросы о задачах вне Snowflake остаются у текущего агента. Для ручного запуска добавьте $cortex-run к запросу.

Для работы нужен CLI Cortex Code: команда cortex должна быть доступна в PATH. Без установленного CLI плагину некуда передавать запросы. Если подключаете YAML-конфигурацию, понадобится PyYAML в среде Python, которую выберет скрипт запуска; со встроенными настройками он не требуется.

Какие задачи решает

  • передать запрос о таблицах Snowflake в Cortex Code
  • узнать, к каким базам данных есть доступ
  • запросить сведения о хранилищах Snowflake
  • направить смешанную задачу в Cortex Code вручную

Примеры запросов агенту

  • Покажи таблицы в текущей схеме Snowflake.
  • Узнай, к каким базам данных Snowflake у меня есть доступ.
  • $cortex-run проанализируй производительность запросов за последние 7 дней.

Как установить snowflake-cortex-code

Через маркетплейс плагинов

/plugin install snowflake-cortex-code@claude-plugins-official
/plugin marketplace add anthropics/claude-plugins-community
/plugin install snowflake-cortex-code@claude-community
/plugin marketplace add anthropics/claude-plugins-official

По шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой

Вопросы о snowflake-cortex-code

Как установить snowflake-cortex-code в Claude Code?

Добавьте официальный каталог плагинов и установите плагин: /plugin marketplace add anthropics/claude-plugins-official, затем /plugin install snowflake-cortex-code@claude-plugins-official.

Что делает snowflake-cortex-code?

Фильтр распознаёт запросы о Snowflake и направляет их в Cortex Code через навык cortex-router. Остальные запросы остаются у текущего агента.

Что нужно для работы snowflake-cortex-code?

Установите Cortex Code CLI так, чтобы команда cortex была доступна в PATH. Для YAML-конфигурации также нужен PyYAML в выбранной скриптом среде Python.

Исходный текст

cortex-code · Apache-2.0
# Cortex Code plugin for Claude Code and OpenAI Codex

Route Snowflake work from Claude Code or OpenAI Codex to Cortex Code automatically. Ask about your data naturally — the plugin detects Snowflake intent and delegates to Cortex Code where 55+ built-in skills handle the work. Non-Snowflake prompts stay in your current agent.

## How It Works

**Two ways to route prompts to Cortex Code:**

### Auto-routing (default)

A lightweight keyword filter (`prompt_filter.py`) runs on every prompt. When it detects Snowflake-related patterns, it loads the `cortex-router` skill which delegates to Cortex Code.

Examples that auto-route:
- "Show me my Snowflake warehouses"
- "What databases do I have access to?"
- "List all tables in my current schema"

Examples that stay in your agent:
- "Read the config.json file"
- "Fix the bug in auth.py"
- "Write a Python unit test"

### Explicit invocation (`$cortex-run`)

Type `$cortex-run` followed by your prompt to force routing to Cortex Code, bypassing the keyword filter. Useful when:

- Auto-routing didn't pick up your prompt
- You want to be explicit about using Cortex Code
- Your prompt mixes Snowflake and non-Snowflake work

```
$cortex-run analyze query performance for the last 7 days
```

## Requirements

- **Cortex Code CLI** (`cortex`) installed and on your PATH

## Install

### Claude Code

```bash
claude plugin install snowflake-cortex-code@claude-plugins-official
```

To update: `claude plugin update snowflake-cortex-code`

### OpenAI Codex

```bash
codex plugin marketplace add Snowflake-Labs/snowflake-ai-kit
codex plugin add snowflake-cortex-code@snowflake-ai-kit
```

Or inside Codex, open `/plugins` and install "Snowflake Cortex Code" from the Snowflake AI Kit marketplace.

## Security Model

The router wraps Cortex execution with a security layer. Three approval modes:

| Mode | Behavior | Audit | Best For |
|------|----------|-------|----------|
| `prompt` (default) | Ask user before execution | Optional | Interactive, production |
| `auto` | Auto-approve | Required | Automated workflows |
| `envelope_only` | Auto-approve, no tool prediction | Required | Low latency, trusted envs |

**Security envelopes** control what Cortex can do:
- **RO**: Read-only — blocks Edit, Write, destructive Bash
- **RW**: Read-write — blocks destructive operations
- **RESEARCH**: Read + web access
- **DEPLOY**: Full access (use cautiously)

Built-in protections: PII sanitization, credential path blocking, SHA256-validated cache, structured audit logging.

## Configuration

Hooks and skill commands use `scripts/run_python.sh` in Bash (Git Bash on Windows).
The launcher prefers `python3` and accepts `python` only after verifying Python 3.
It preserves stdin and arguments and never retries a failed script with another interpreter.

The router config file lives at `scripts/router/config.yaml.example`. To customize:

```bash
cp plugins/cortex-code/scripts/router/config.yaml.example ~/.claude/skills/cortex-code/config.yaml
```

Edit the config to change approval mode, allowed envelopes, audit settings, and sanitization options.

YAML configuration requires **PyYAML in the interpreter selected by the launcher**.
From the repository root, install it in that environment with:

```bash
bash plugins/cortex-code/scripts/run_python.sh -m pip install PyYAML
```

If Python is externally managed, create and activate a virtual environment, install
PyYAML there, and start the host from that environment. Restart the host after
changing its PATH. Do not use `--break-system-packages`.

Without configuration files, built-in defaults work without PyYAML. If a user
config or `~/.snowflake/cortex/claude-skill-policy.yaml` exists, missing PyYAML,
unreadable files, invalid YAML, and invalid setting types **stop routing/execution**
with an error identifying the file. Empty files must be replaced with an explicit
mapping such as `{}`. Paths explicitly supplied through flags or
`CORTEX_SKILL_CONFIG` / `CORTEX_SKILL_ORG_POLICY` must exist; missing default paths
remain optional. An empty `allowed_envelopes` list permits no execution.

This validation does not implement approval-mode behavior: the live executor still
uses envelope decisions; the approval-mode wrapper remains a simulation.
The existing Codex execution path still auto-approves individual tool calls; this
change validates configuration and the selected envelope before launching it,
but does not add per-tool envelope enforcement to that path.

Skill discovery runs automatically on session start. To force a re-discovery, start a new session.

## Testing

Tests live in `tests/run-tests.sh` at the repo root. Two tiers:

```bash
# Structural + unit tests (no network, runs in CI)
bash tests/run-tests.sh

# Include integration tests (requires cortex CLI + Snowflake connection)
bash tests/run-tests.sh --integration
```

**Structural tests** (always run): file existence checks, config validation, Python syntax, and unit tests for `envelope_policy.py`, `prompt_filter.py`, and plugin hooks.

CI tests macOS and Windows with and without PyYAML. Launcher/configuration regressions
are in `scripts/router/test_launcher_config.py`; they do not invoke Cortex or Snowflake.
Parsing-specific tests are skipped when PyYAML is absent; missing-dependency and
fail-closed tests still run.

**Integration tests** (`--integration` flag): spawn real Cortex CLI sessions against a live Snowflake connection. Located at `scripts/router/test_integration.py`. Verifies:

- Credential path blocking (prompts referencing `.ssh/`, `.env`, etc. are rejected pre-flight)
- End-to-end query flow (RO envelope, permission protocol, result event)
- Envelope enforcement (RO blocks DDL — via hard gate denial or LLM self-policing)
- Process cleanup (no orphaned `cortex` processes after execution)

Set `CORTEX_TEST_CONNECTION` env var to test against a specific Snowflake connection (defaults to your CLI default).

## License

Copyright (c) Snowflake Inc. All rights reserved.

The skills in this project are licensed under the [Snowflake Skills License](../../LICENSE-SKILLS.md).

© Snowflake · Apache-2.0 · Snowflake-Labs/snowflake-ai-kit

Похожие плагины

Все плагины по теме «Настройка агента: память, контекст, субагенты» →
snowflake-cortex-ai-cursorrules-prompt-file PatrickJS Правило snowflake-cortex-ai-cursorrules-prompt-file для Cursor, Claude Code, Codex, GitHub Copilot, Windsurf и Cline описывает работу с Cortex AI и Cortex Search. Помогает создавать SQL-запросы с ИИ и настраивать RAG-поиск. CX Codex +1 ★ 41 178звёзд репо cortex-code Snowflake Integration Team Передаёт запросы к Snowflake в Cortex Code CLI. Срабатывает на SQL для Snowflake, Cortex AI, Snowpark и хранилища данных. CX Codex +1 1 600установок snowflake-development Alireza Rezvani Плагин snowflake-development для Claude Code помогает работать с Snowflake SQL, пайплайнами данных и Snowpark Python. Он также охватывает Cortex AI и dbt. ★ 30 251звёзд репо snowflake-expert PCL Team Скилл snowflake-expert для Snowflake: помогает выбрать размер виртуального склада, разложить объекты по схемам и заменить полный скан таблицы на стрим. CX Codex +1 239установок snowflake-cli sfc-gh-dflippo Скилл snowflake-cli для Claude Code выполняет SQL-команды и управляет объектами Snowflake через Snowflake CLI. Активируется для скриптов, Streamlit-приложений и операций с файлами в stages. CX Codex +1 5установок snowflake-dbt-airbnb-analytics reason-machines Скилл snowflake-dbt-airbnb-analytics учит агента разворачивать витрину данных в Snowflake через dbt: от загрузки сырых таблиц Inside Airbnb до витрин и дашборда на Streamlit. CX Codex +1 1 700установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой