iFlow CLI 配置指南

阿里推出的终端 Agent 框架配置记录

iFlow CLI 配置指南

iFlow 是阿里推出的一个在终端中运行的 Agent 框架,可以接入多种大模型 API,目前提供限免的 GLM5.0、Kimi-K2.5、MiniMax-M2.5 等模型。

下面以 Windows 为例,配置记录如下:

1. 安装 NodeJS

安装 NodeJS,选择对应系统与指令集的预编译安装包,下载后双击,同意协议并安装。

安装NodeJS

2. 安装 iFlow

打开 PowerShell 安装 iFlow:

1
2
3
# 访问 https://nodejs.org/zh-cn/download 下载最新的 Node.js 安装程序
npm install -g @iflow-ai/iflow-cli@latest
iflow --version # 有输出验证安装成功

linux安装

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
# 1. 直接安装
bash -c "$(curl -fsSL https://gitee.com/iflow-ai/iflow-cli/raw/main/install.sh)"

# 2. 通过 npm 安装 依赖nodejs
npm i -g @iflow-ai/iflow-cli@latest
iflow --version # 有输出验证安装成功

# 如果索引不到iflow命令,可以尝试以下命令
# 激活nvm
echo '
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"' >> ~/.zshrc
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"
nvm --version # 验证nvm
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node # 设置镜像源
# 如果nodejs版本过低,可以使用nvm安装最新版本的nodejs
nvm install 20 # 安装nodejs 20版本

3. 登录配置

打开 shell,启动 iFlow 后进入登录界面:

1
iflow

共有三个登录方式:

  1. 打开网页授权
  2. 使用 API Key:需要在心流 API 平台设置,这个 Key 每周会刷新,过期后可以通过 /auth 命令刷新
  3. 使用 OpenAI 兼容的第三方 API

登录界面

配置好 Key 后,可以选择使用的模型:

选择模型

4. 常用命令

命令 说明
/resume 恢复之前的对话,继续之前的上下文
/clear 清除之前的对话上下文,重新开始
/compress 压缩之前的对话上下文,保留关键信息,释放上下文空间
/init 初始化一个新的对话,会在目录下生成 AGENTS.md 文件,记录初始化信息

5. 结束但不是终点

公告: iFlow CLI 产品于 2026 年 3 月 20 日 起停止维护,于 4 月 17 日 正式关闭,iFlow API 服务、模型库 同步关停。

感谢iflow团队的努力它提供了一个便捷的终端 Agent 体验,支持多种大模型 API 的接入和使用,推动终端 Agent 技术的应用。

Licensed under CC BY-NC-SA 4.0
最后更新于 2026-02-26