什么是 iFlow CLI?

iFlow CLI 是一款基于Gemini CLI改造直接在终端中运行的强大 AI 助手,融合了一些Claude Code的特性,比如todo任务、初始化指令等。

它能够无缝分析代码仓库、执行编程任务、理解上下文需求,通过自动化处理从简单的文件操作到复杂的工作流程,全面提升您的工作效率。

核心特性

⭐️免费AI模型- 通过iFlow开放平台,访问强大的免费 AI 模型,包括 Kimi K2、Qwen3 Coder、DeepSeek v3 ,并可以使用在C3代码

🔧 灵活集成 - 完整支持OpenAI协议的模型提供商。

🚀 开箱即用 - 预配置好的MCP servers和专业代理协同工作,自动解决复杂问题

💪🏻 更加稳定 - 长周期任务比Claude Code更加稳定

💻 直观体验 - 简洁的终端体验,提供上下文感知的智能辅助。


您可以前往GitHub查看详细内容:

https://github.com/iflow-ai/iflow-cli


如果您是第一次使用本地化部署产品,可以参考我们下面的手把手部署教程,在您的电脑中安装👇

安装与配置

系统要求

  • 操作系统:macOS 10.15+、Ubuntu 20.04+/Debian 10+,或 Windows 10+(使用 WSL 1、WSL 2 或 Git for Windows)
  • 硬件:4GB+ 内存
  • 软件:Node.js 18+
  • 网络:需要互联网连接用于身份验证和 AI 处理
  • Shell:在 Bash、Zsh 或 Fish 中效果最佳

 安装命令

mac用户(一键安装)

bash -c "$(curl -fsSL https://cloud.iflow.cn/iflow-cli/install.sh)"

Windows 用户

  1. 访问 https://cloud.iflow.cn/iflow-cli/nvm-setup.exe 下载最新的 nvm 安装程序
  2. 运行安装程序来安装 nvm
  3. 打开新的终端:CMD 或 PowerShell
  4. 运行2行命令 
    nvm node_mirror https://npmmirror.com/mirrors/node
    nvm npm_mirror https://npmmirror.com/mirrors/npm/
  5. 运行以下命令来安装 Node.js 22,稍等片刻
    nvm install 22 
  6. 运行这个命令来使用 Node.js 22 
    nvm use 22 
  7. 运行这个命令来安装 iFlow CLI 
    npm install -g @iflow-ai/iflow-cli
  8. 运行 iflow 来启动 iFlow CLI
    iflow 

身份验证 

iFlow Cli提供两种身份验证方式:

  1. 推荐方式:使用 iFlow 原生身份验证
  2. 备选方式:通过 OpenAI 兼容 API 连接

    ​ 

 获取 API Key的步骤:

  1. 注册 iFlow 账户
  2. 进入个人设置页面或点击此直达链接
  3. 在弹出对话框中点击"重置"生成新的 API 密钥

生成密钥后,将其粘贴到终端提示符中即可完成设置。注意:在 Windows 的 CMD 或者 PowerShell 中,请点击右键进行粘贴。

快速开始

输入iflow进入iFlow CLI终端对话界面,如果是在已有代码库中运行,可使用命令/init完成对当前代码库的扫描,学习其结构,并创建包含完整文档的 IFLOW.md 文件。

iflow

如果不想把整个项目塞AI,也可以使用@精准投喂:

@views/register.tsx这个文件是做什么的? 

 用 YOLO 模式加速

使用iflow -y可以开启iFlow CLI YOLO模式,AI 会自动执行所有操作,不用你一次次确认。也可以直接在后面加上-p提问,比如:

iflow -y -p "创建用户注册页面,包含邮箱、密码、验证码"

​ 也可以在使用iflow直接进入iFlow CLI终端对话界面后,使用ctrl+y进行YOLO mode和正常模式的切换。

开发实践

  • 日常对话

请介绍一下你自己

 注意:对话内容要明确,比如❌ “修一下那里”✅ “修复 /api/login 接口返回 500 错误的问题”

  •  可以直接提出任务目标, 它就会开始逐步规划、生成、执行、确认修改,必要时提醒你测试或备份。比如:

请用 HTML 和 CSS 创建一个简洁美观的登录页面。

  •  对项目中某个问题对应的代码进行分析并修复,比如:

@views/competition/app.tsx这个文件中存在用户点击按钮之后弹出了两次提示的问题,请分析原因并修复

  •  使用!进入shell模式

 !<shell命令> 可以在 iFlow CLI 内直接执行系统 shell 命令,命令输出显示在终端中。

  • 支持WebSearch

  • 使用 /stats 查看使用情况

/stats model    # 查看模型调用情况
/stats tools    # 查看工具使用频率

  • 保存重要对话

/chat save login-fix
  •  将当前正在进行的对话保存为一个命名会话,便于后续恢复和查阅。

/chat resume login-fix
  •  Deep Research

你会根据用户的问题/需求,根据任务执行的顺序收集信息,最终以HTML的方式产出一份报告。
  ## 任务执行顺序
  - 你会生成非常详细的信息搜集计划。
  - 然后根据信息搜集计划生成一个html template作为index.html,他包含了一些顶部菜单的预留位置,以及一个section模块预留位。
  - 根据信息搜集计划设计index.html的顶部菜单
  - 接着,你会按照信息搜集计划挨个进行信息收集,每收集一份信息,即生成对应的section代码插入到index.html中。
  - 插入过程中,你需要关注整体页面的样式,修复一些常见的显示错误,保障整体的风格一致性
  - 不断进行信息收集、section代码生成、html template内容填充,直到所有信息收集完毕
  - MUST:确保按照计划完成所有的action
  ## 对于最终的html产出
  - 设计趋势和最佳实践有深入理解,尤其擅长创造具有极高审美价值的用户界面。你的设计作品不仅功能完备,而且在视觉上令人惊叹,能够给用户带来强烈的"Aha-moment"体验。
  - 可能包括HTML、CSS、和JavaScript文件。不断根据任务,优化这个网页项目,使网页内容逐渐完整。最终,你需要产出一个**美观、现代、易读**的"中文"可视化网页。
  # 设计要求
  **设计目标:**
  *   **视觉吸引力:** 创造一个在视觉上令人印象深刻的网页,能够立即吸引用户的注意力,并激发他们的阅读兴趣。
  *   **可读性:** 确保内容清晰易读,无论在桌面端还是移动端,都能提供舒适的阅读体验。
  *   **信息传达:** 以一种既美观又高效的方式呈现信息,突出关键内容,引导用户理解核心思想。
  *   **情感共鸣:** 通过设计激发与内容主题相关的情感(例如,对于励志内容,激发积极向上的情绪;对于严肃内容,营造庄重、专业的氛围)。
  **设计指导(请灵活运用,而非严格遵循):**
  *   **整体风格:** 可以考虑杂志风格、出版物风格,或者其他你认为合适的现代 Web 设计风格。目标是创造一个既有信息量,又有视觉吸引力的页面,就像一本精心设计的数字杂志或一篇深度报道。
  *   **Hero 模块(可选,但强烈建议):** 如果你认为合适,可以设计一个引人注目的 Hero 模块。它可以包含大标题、副标题、一段引人入胜的引言,以及一张高质量的背景图片或插图。
  *   **排版:**
      *   精心选择字体组合(衬线和无衬线),以提升中文阅读体验。
      *   利用不同的字号、字重、颜色和样式,创建清晰的视觉层次结构。
      *   可以考虑使用一些精致的排版细节(如首字下沉、悬挂标点)来提升整体质感。
      *   Font-Awesome中有很多图标,选合适的点缀增加趣味性。
  *   **配色方案:**
      *   选择一套既和谐又具有视觉冲击力的配色方案。
      *   考虑使用高对比度的颜色组合来突出重要元素。
      *   可以探索渐变、阴影等效果来增加视觉深度。
  *   **布局:**
      *   使用基于网格的布局系统来组织页面元素。
      *   充分利用负空间(留白),创造视觉平衡和呼吸感。
      *   可以考虑使用卡片、分割线、图标等视觉元素来分隔和组织内容。
  *   **调性:**整体风格精致, 营造一种高级感。
  *   **数据可视化:**
      *   设计一个或多个数据可视化元素,展示Naval思想的关键概念和它们之间的关系。
      *   可以考虑使用思想导图、概念关系图、时间线或主题聚类展示等方式。
      *   确保可视化设计既美观又有洞察性,帮助用户更直观地理解Naval思想体系的整体框架。
      *   使用Mermaid.js来实现交互式图表,允许用户探索不同概念之间的关联。
  **技术规范:**
  *   使用 HTML5、Font Awesome、Tailwind CSS 和必要的 JavaScript。
      *   Font Awesome: [https://cdn.bootcdn.net/ajax/libs/font-awesome/6.4.0/css/all.min.css](https://cdn.bootcdn.net/ajax/libs/font-awesome/6.4.0/css/all.min.css)
      *   Tailwind CSS: [https://g.alicdn.com/code/lib/tailwindcss/2.2.19/tailwind.min.css](https://g.alicdn.com/code/lib/tailwindcss/2.2.19/tailwind.min.css)
      *   非中文字体: [https://fonts.font.im/css?family=Noto+Serif+SC:wght@400;500;600;700&family=Noto+Sans+SC:wght@300;400;500;700&display=swap rel="stylesheet" media="print" onload="this.media='all';
  this.onload=null"]
      *   `font-family: Tahoma,Arial,Roboto,"Droid Sans","Helvetica Neue","Droid Sans Fallback","Heiti SC","Hiragino Sans GB",Simsun,sans-self;`
      *   Mermaid: [https://g.alicdn.com/code/lib/mermaid/11.5.0/mermaid.min.js](https://g.alicdn.com/code/lib/mermaid/11.5.0/mermaid.min.js),在使用mermaid的时候,需要做mermaid initialize初始化
      *   Chart.js: [https://g.alicdn.com/code/lib/Chart.js/4.4.1/chart.umd.min.js](https://g.alicdn.com/code/lib/Chart.js/4.4.1/chart.umd.min.js)
  *   代码结构清晰、语义化,包含适当的注释。
  *   实现完整的响应式,必须在所有设备上(手机、平板、桌面)完美展示。
  **额外加分项:**
  *   **微交互:** 添加微妙而有意义的微交互效果来提升用户体验(例如,按钮悬停效果、卡片悬停效果、页面滚动效果)。
  *   **补充信息:** 可以主动搜索并补充其他重要信息或模块(例如,关键概念的解释、相关人物的介绍等),以增强用户对内容的理解。
  **输出要求:**
  *   提供一个完整、可运行的网页项目,其中包含所有必要的多个 HTML、CSS 和 JavaScript文件。
  *   每一个文件内容尽量少,可以通过文件引用来避免重复,重复读/重复写会浪费token数量。
  *   确保代码符合 W3C 标准,没有错误或警告。
  *   在根目录下维护**项目大纲**文档,来记录你的设计思路、代码模块功能、文件内容概要等,每一次变动都会记录在项目大纲中,方便下一次优化时定位优化文件。
  <用户的问题>
计划8月15到8月24或25去西欧旅游,杭州出发亲子游,共9天。地点选择Amsterdam、Cologne、Paris和Saarbrücken。为这个行程做规划和设计,要求是: 1. 少走回头路,自驾旅游,亲子为主。 2.8月23号要在Saarbrücken参观比赛 3. Cologne预留3天 4.回城的飞机可以在巴黎或者德国,找价格低的航班。
  </用户的问题>
  当前时间是2025年6月26日,我们开始吧!

 

  •  小游戏开发

做一个十分精美的斗兽棋游戏

工作流推荐 

核心原则:

  • 计划优先:复杂任务先让AI制定详细计划

  • 分层配置:创建多个层次的 IFLOW.md 文件

  • 避免 YOLO 模式:倾向于拦截并重新提示

  • 代码要测试:确保代码质量

 上下文管理技巧:

  • @ 精准引用文件,避免信息过载

  • /memory refresh 强制重新加载上下文

  • /memory show 显示当前上下文

写在最后 

心流团队在探索AGI的路上会继续走下去,如果你对我们的产品有兴趣、有自己的想法没人给你解决、产品使用有任何问题,  加入社区群进行交流讨论,我们一起探索AGI!

Logo

有“AI”的1024 = 2048,欢迎大家加入2048 AI社区

更多推荐