snow-cli

环境要求

• 已安装 Node.js 与 npm（snow-cli 通过 npm 全局安装，README 未给出具体版本要求）
• 可访问 npm 源并能执行全局安装（可能需要 sudo 或管理员权限）
• 至少一个受支持大模型的 API 凭据（Deepseek / OpenAI / Gemini / Claude）
• Windows 用户建议使用 PowerShell 或 Windows Terminal（README 提供 winget 安装方式）

安装与启动步骤

1. 1确认 Node 环境

   snow-cli 是 TypeScript 项目，通过 npm 全局安装，请先确认本机已有 node 与 npm 命令。README 未指定具体版本。

   node -v
   npm -v

   复制

2. 2全局安装 snow-cli

   使用 npm 以全局方式安装 snow-ai 包，安装完成后即可在任意目录调用 snow 命令。

   npm install -g snow-ai

   复制

3. 3Windows 终端准备

   Windows 10/11 用户如无 PowerShell 或 Windows Terminal，可用 winget 安装（也可从 Microsoft Store 安装）。

   winget install Microsoft.PowerShell
   winget install Microsoft.WindowsTerminal

   复制

4. 4启动 snow

   在终端直接输入 snow 进入交互式界面，首次运行会在用户主目录生成 .snow/ 配置目录。

   snow

   复制

5. 5填写模型 API 配置

   在 ~/.snow/config.json 中填写所选模型提供商的 API 信息；settings.json 为统一设置，含 mcpServers 等。

6. 6查看配置目录

   确认 ~/.snow/ 下已生成 profiles、sessions、tasks、hooks、log 等目录与配置文件，便于后续排错和备份。

   ls -la ~/.snow/

   复制

关键配置

如何确认成功

终端能正常进入 snow 交互界面，且主目录下已生成 ~/.snow/ 目录及其配置文件。

常见问题

注意事项

• API 密钥等敏感信息请只写入本机的 ~/.snow/ 配置文件，不要提交到代码仓库。
• README 未给出端口、默认模型名等细节，具体参数请以 ~/.snow/config.json 与官方文档为准。
• Windows 用户若终端显示异常，建议改用 PowerShell 或 Windows Terminal。