
快速安装
macOS/Linux
# 一键安装脚本,会安装全部所需依赖
bash-c"$(curl-fsSL https://gitee.com/iflow-ai/iflow-cli/raw/main/install.sh)"
# 已有Node.js 22+
npm i -g @iflow-ai/iflow-cli@latestWindows
1. 访问 https://nodejs.org/zh-cn/download 下载最新的 Node.js 安装程序
2. 运行安装程序来安装 Node.js
3. 重启终端:CMD(Windows + r 输入cmd) 或 PowerShell
4. 运行 `npminstall-g @iflow-ai/iflow-cli@latest` 来安装 iFlow CLI
5. 运行 `iflow` 来启动 iFlow CLI推荐使用 Windows Terminal:为了获得更好的兼容性和使用体验,强烈推荐使用 Windows Terminal 运行 iFlow CLI,可以大幅减少环境兼容性问题。验证安装:运行
iflow --version确认安装成功
第2步:首次设置(1分钟)
启动iFlow
iflow选择登录方式
iFlow CLI 支持三种登录方式,不同方式提供的功能有所差异:
🌟 方式一:Login with iFlow 登录(推荐)
强烈推荐使用 Login with iFlow 方式登录心流平台,享受最完整的功能体验:
✅ 完整功能支持
- WebSearch 服务
:智能网络搜索,获取最新信息 - WebFetch 服务
:网页内容抓取和分析 - 多模态能力
:内置图像理解等多模态功能 - 工具调用优化
:心流平台提供的模型经过专门优化,工具调用更加精准高效
** Login with iFlow 登录步骤:**
-
运行 iflow后选择 OLogin with iFlow 登录 -
CLI 会自动打开浏览器跳转到心流平台 -
完成注册/登录后授权 iFlow CLI -
自动返回终端,开始使用
方式二:心流 API Key 登录
💡 适用场景:服务器环境或无浏览器访问的场景
✅ 功能支持:与 第一种 登录相同,享受心流平台的完整功能(WebSearch、WebFetch、多模态、工具调用优化等)
⚠️ 注意事项:API Key 有效期为 7 天,需定期更新
API Key 登录步骤:
-
访问心流官网完成注册 -
在用户设置页面生成 API KEY -
在 iFlow CLI 中选择 API Key 登录并输入密钥
方式三:OpenAI Compatible API
💡 适用场景:使用自有模型服务或其他兼容 OpenAI 协议的服务
⚠️ 功能限制:
-
不支持 WebSearch 服务 -
不支持 WebFetch 服务 -
不支持心流平台的内置多模态能力 -
无法享受心流平台模型的工具调用优化
配置步骤:
-
选择 "OpenAI Compatible API" 选项 -
输入服务端点 URL -
输入对应的 API Key
选择模型
登录成功后,选择一个心仪的大模型就可以开始使用了


