snow-cli

在终端里用自然语言写代码，一个工具通吃四大AI模型。

snow-cli 是一个运行在终端中的 AI 编程智能体，基于 TypeScript 构建，旨在为开发者提供多模型兼容的命令行编码体验。它同时支持 Deepseek、OpenAI、Gemini 和 Claude 等主流大模型，让用户无需切换工具即可在不同模型间灵活选择，解决开发者在不同模型间切换成本高、终端编码效率低的问题。其核心能力包括：通过自然语言指令直接生成或修改代码、集成多种 AI 提供商的 API、提供交互式终端界面以及支持自定义配置。项目处于成长阶段，星标数已过千，适合追求高效编码、希望在同一环境中利用多家 AI 能力的开发者。

开源 free 编程开发

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1064

维护状态活跃

是否开源是

定价模式 free

项目数据

分类编程开发

开发团队MayDay-wpf

所属国家

官网地址

GitHubhttps://github.com/MayDay-wpf/snow-cli

定价模式free

价格说明开源项目，本地部署使用，无在线服务，全部功能免费。

访问状态

是否开源是

开源协议NOASSERTION

主要语言TypeScript

技术栈/模型ai,ai-agents,ai-coding

GitHub 星标★ 1064

30天Star增速

HF 下载量

上线时间2025-08-16 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数3

使用教程

难度：入门约 10 分钟部署方式：命令行工具 6 步

环境要求

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

安装与启动步骤

1确认 Node 环境

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

使用 npm 以全局方式安装 snow-ai 包，安装完成后即可在任意目录调用 snow 命令。
```
npm install -g snow-ai
```
3Windows 终端准备

Windows 10/11 用户如无 PowerShell 或 Windows Terminal，可用 winget 安装（也可从 Microsoft Store 安装）。
```
winget install Microsoft.PowerShell
winget install Microsoft.WindowsTerminal
```
4启动 snow

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

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

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

关键配置

配置项	必填	说明	示例
`~/.snow/config.json`	是	API 配置，用于填写所用大模型的接入信息	`~/.snow/config.json`
`~/.snow/settings.json`	否	统一设置文件，包含 mcpServers 等配置	`~/.snow/settings.json`
`~/.snow/profiles/`	否	配置档案目录，可保存多套配置	`~/.snow/profiles/`
`~/.snow/log/`	否	运行日志目录，纯本地文件可随时删除	`~/.snow/log/`

如何确认成功

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

常见问题

Q：执行 snow 提示命令不存在怎么办？

A：说明 npm 全局安装目录不在 PATH 中，请把 npm 的全局 bin 路径加入环境变量后重开终端再试。

Q：模型 API 配置写在哪里？

A：写在用户主目录的 ~/.snow/config.json 中，首次运行 snow 后该目录会自动生成。

Q：支持哪些模型？

A：支持 Deepseek、OpenAI、Gemini 和 Claude 等主流大模型，可在配置中按需选择，无需切换工具。

Q：运行产生的日志会占用很多空间吗？

A：日志保存在 ~/.snow/log/，属于本地文件，README 说明可以随时删除。

注意事项

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

核心亮点

同时兼容 Deepseek、OpenAI、Gemini 和 Claude，模型选择灵活，避免供应商锁定。
基于 TypeScript，代码结构清晰，易于扩展和二次开发。
终端原生体验，无需离开编辑器即可完成 AI 辅助编码，提升开发流程度。

不足之处

项目较新，文档和社区生态尚待完善，遇到问题时可参考资源有限。
多模型集成可能导致 API 调用成本控制复杂，需用户自行管理密钥和费用。

适用场景

在终端中快速生成代码片段或函数实现，无需切换到网页端。
在同一个项目中对比不同 AI 模型的代码生成效果，选择最优方案。
为离线或内网开发环境提供本地化的 AI 编程助手，通过自建模型网关接入。

替代项目

Aider、Open Interpreter、Codex CLI

项目介绍

snow-cli 是编程开发领域的开源项目，由 MayDay-wpf 开发，2025 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（1,064）位列前 30%，在编程开发分类中处于中上游。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。本地部署使用，无在线服务，全部功能免费。

它主要面向的使用场景是：在终端中快速生成代码片段或函数实现，无需切换到网页端。同类可对比的替代方案包括 Aider、Open Interpreter、Codex CLI。

上一篇：aider-desk

下一篇：eca