Cortex Code Setup 是 snowflake-ai-kit 仓库中的一个安装配置技能，用于在本地环境部署 Snowflake CLI（snow）与 Cortex Code CLI（cortex）。
用途
该技能在以下情况使用：Cortex Code CLI 未出现在 PATH 中；用户要求设置或安装 Cortex Code；由于缺少 cortex 二进制文件而导致路由失败。
前置检查
在执行任何其他操作前，技能要求先无条件运行一项检查：读取 ~/.claude/settings.json 中的 mcpServers 配置，判断是否存在名称或命令包含 snowflake 的 MCP 服务器。若检测到冲突（退出码为 1），必须立即停止，并提示用户：已检测到 Snowflake MCP Server，Cortex Code 插件会以更多能力（安全信封、会话管理、多轮对话）替代该 MCP 服务器，需先在 ~/.claude/settings.json 的 mcpServers 中移除 Snowflake MCP 服务器条目，重启 Claude Code 后重新运行本设置流程。此时不得继续、不得检查 CLI 版本、不得安装任何内容。
主要能力
- 检测操作系统并检查当前状态：通过 platform.system() 区分 Windows、Darwin 或 Linux；在 Windows 上使用 where 命令、在 macOS/Linux 上使用 which 命令检查 cortex 与 snow 是否存在及其版本。
- 安装 Cortex Code CLI：安装程序捆绑在 snowflake-ai-kit 仓库中。在 macOS/Linux 上使用 find 查找 install.sh，在 Windows PowerShell 上查找 install.ps1，找到后以 bash install.sh 或 powershell -ExecutionPolicy Bypass -File install.ps1 运行。若未找到，可直接通过官方文档提供的命令安装，或遵循官方安装指南。安装程序会处理 Snowflake CLI、Cortex Code CLI 以及连接验证。
- 验证安装：再次用 where 或 which 检查 cortex 与 snow 并输出其版本号，两者都应返回版本号。
- 配置 Snowflake 连接：使用 snow connection list 检查是否已有连接；若没有，则提示用户运行 snow connection add，该命令为交互式，用户需提供 Snowflake 账户 URL、用户名与认证方式。
- 确认路由可用：设置完成后 cortex-router 技能应可正常工作，提示用户重试原先的 Snowflake 提示词。
使用方式
该技能以脚本与命令行步骤形式给出，包含用于冲突检测的 Python 内联脚本、操作系统的检测代码、安装脚本查找与执行命令，以及版本验证命令。使用时需按顺序执行，并严格遵守前置检查的中止逻辑。
适用场景与限制
适用于需要在本地安装并配置 Snowflake CLI 与 Cortex Code CLI 的开发环境。限制与注意事项包括：Cortex Code CLI 安装程序需要有效的互联网连接；在 macOS 上，Homebrew 可能作为 Snow CLI 的备用安装方式；不要建议 pip install snowflake-cortex-code 或类似命令，该包不存在；在 Windows 上，若 bash 不可用，应使用 PowerShell（install.ps1）或 npx 方式。
关于该技能的具体版本号、支持的 Snowflake 账户类型、认证方式细节、安装器内部逻辑及错误处理，暂未提供。