🌟 iFlow CLI 一键部署指南（跨平台全支持）

由心流AI团队开发的终端智能助手，支持自然语言交互与代码自动化
​适用场景​：代码生成/调试｜文档自动化｜文件管理｜信息检索
​核心优势​：免费调用Qwen3-Coder/Kimi K2等模型｜开箱即用｜GitHub Actions集成

目录

一、前置环境准备

二、安装步骤

▎Windows 系统（需管理员权限）

▎macOS/Linux 系统

三、关键配置项

四、验证安装 & 基础使用

⚠️ 常见问题排障

五、进阶技巧

参考资料

---

iFlow CLI 是一款深度适配终端环境的智能 AI 助手工具，其核心架构基于 Gemini CLI 进行重构优化，并整合了 Claude Code 的典型功能特性（如待办事项管理、环境初始化指令等）。该工具支持对代码库的智能解析与编程任务执行，具备精准的上下文理解能力，可自动化处理从基础文件操作到复杂工作流的全场景需求，显著提升开发工作效率。

---

一、前置环境准备

1️⃣ ​Node.js 20+​​（强制要求）

# 验证安装（所有平台）
node -v  # 需输出 v20.x 或更高
npm -v   # 需输出 10.x+

▸ Windows方案：
- 官网下载 Node.js LTS
- 或使用WSL2（推荐）：

cmd wsl --install -d Ubuntu-20.04 # 自动安装Linux子系统

---

二、安装步骤

▎Windows 系统（需管理员权限）

# 1. 配置国内镜像加速
npm config set registry https://registry.npmmirror.com

# 2. 全局安装CLI
npm install -g @iflow-ai/iflow-cli

# 3. 启动配置向导
iflow

▎macOS/Linux 系统

# 一键安装（自动下载脚本）
bash -c "$(curl -fsSL http://cloud.iflow.cn/iflow-cli/install.sh)"

# 按提示选择模型（推荐Qwen3-Coder）

---

三、关键配置项

首次启动自动进入向导：

1. ​API密钥绑定​
   → 访问心流开放平台注册账号

   

   
   → 在【个人中心】生成并复制API Key

   

   
   → 粘贴到终端提示处（输入不可见，直接回车提交）

2. ​模型选择​（免费选项）

   │ Model Selection                                                                                          │
   │                                                                                                          │
   │ Please select the model you want to use with iFlow.                                                      │
   │                                                                                                          │
   │ Enter To Use Default selection: Qwen3 Coder                                                              │
   │                                                                                                          │
   │ ● 1. Qwen3-Coder-480B-A35B(recommend)                                                                    │
   │   2. Qwen3-235B-A22B                                                                                     │
   │   3. Kimi K2                                                                                             │
   │   4. GLM-4.5                                                                                             │
   │   5. Qwen3-235B-A22B-Thinking                                                                            │
   │   6. Qwen3-235B-A22B-Instruct                                                                            │
   │   7. Qwen-VL-Max(direct multimodal)                                                                      │
   │                                                                                                          │
   │ (Use Enter to select, Esc to cancel) 

   按上下键选择，按需求，回车确认（推荐“Qwen3-Coder-480B-A35B”）

---

四、验证安装 & 基础使用

# 启动交互终端
iflow

# 示例命令测试
>> 请用HTML+CSS创建蓝色渐变登录页面  
>> @src/app.js 请解释此文件功能  
>> !ls -la  # 执行系统命令

✅ ​成功标志​：

• 生成代码文件/分析报告
• 支持ctrl+y切换YOLO模式（自动执行无确认）

---

⚠️ 常见问题排障

问题现象	解决方案
iflow命令未找到	重装后执行 npm link iflow-cli
API密钥无效	检查密钥空格/重新生成
连接超时	切换网络或配置代理
文件操作权限拒绝	Windows需以管理员启动终端

---

五、进阶技巧

# 项目深度集成
cd your-project/
iflow > /init          # 扫描代码库生成IFLOW.md

# 会话存档/恢复
/chat save auth-fix    # 保存当前对话
/chat resume auth-fix  # 恢复历史会话

# 查看资源统计
/stats model  # 模型调用频次

​版权声明​：本教程所述方法均来自iFlow官方文档，实践截图由作者生成，转载请注明出处。

---

​立即体验​：在终端输入 iflow "帮我创建贪吃蛇游戏" ！
​更多案例​：访问心流AI案例库获取自动化脚本模板（注：此为示例链接，实际请参考平台资源）

---

部署问题可留言交流 ➜ ​24小时内回复​
👍 ​如果帮到您，欢迎点赞/收藏/关注三连支持​！

---

参考资料

[1] iFlow CLI快速入门 - CSDN
[2] iFlow终端智能体详解 - 掘金
[3] iFlow官方文档 - PHP中文网