iFlow CLI - 你的终端 AI 编程助手 🚀
什么是 iFlow CLI?
iFlow CLI(中文名:心流 CLI)是一款运行在终端中的智能 AI 助手,就像给你的命令行装上了一个"超级大脑"。它可以:
- 📖 读懂你的代码 - 分析项目结构,理解代码逻辑
- ✍️ 帮你写代码 - 自动生成函数、修复 Bug、重构代码
- 🔍 搜索信息 - 联网搜索最新技术资料
- 🛠️ 执行任务 - 文件操作、命令执行、自动化工作流
- 💬 自然对话 - 用人话交流,不需要记复杂命令
简单来说:把 ChatGPT 搬进了你的终端,还能直接操作你的项目!
为什么选择 iFlow CLI?
✨ 核心优势
| 特点 | 说明 |
|---|---|
| 🎯 开箱即用 | 5 分钟安装配置,无需复杂设置 |
| 🧠 多模型支持 | 支持多种主流 AI 模型(Claude、GPT-4 等) |
| 🌐 联网能力 | 内置 WebSearch 和 WebFetch,获取最新信息 |
| 🔧 深度集成 | 直接读写文件、执行命令、操作项目 |
| 🤖 智能 Agent | 自动规划任务步骤,多步骤自主完成 |
| 📦 可扩展 | 支持 MCP 协议,可接入更多工具和服务 |
快速上手指南
第一步:安装(2 分钟)
系统要求
- Node.js 22 或更高版本
- 4GB 以上内存
- 稳定的网络连接
安装命令
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@latest
Windows 用户
- 访问 Node.js 官网 下载安装包
- 安装 Node.js
- 打开 CMD 或 PowerShell(推荐使用 Windows Terminal)
- 运行:
npm install -g @iflow-ai/iflow-cli@latest - 启动:
iflow
验证安装
iflow --version
第二步:登录配置(1 分钟)
启动 iFlow CLI:
iflow
🌟 推荐登录方式:Login with iFlow
为什么推荐?
- ✅ 完整功能支持(WebSearch、WebFetch、多模态)
- ✅ 工具调用优化,更精准高效
- ✅ 自动登录,无需手动管理密钥
操作步骤:
- 启动
iflow后选择 "Login with iFlow" - 浏览器自动打开心流平台
- 注册/登录并授权
- 自动返回终端,开始使用
其他登录方式
方式二:API Key 登录
- 适合服务器环境
- 需要在心流平台生成 API Key
- 注意:密钥 7 天有效,需定期更新
方式三:OpenAI Compatible API
- 使用自己的模型服务
- ⚠️ 不支持 WebSearch、WebFetch 等心流平台特色功能
第三步:运行第一个任务(2 分钟)
场景 1:分析现有项目
# 进入你的项目目录
cd your-project/
# 启动 iFlow
iflow
# 初始化项目分析
> /init
# 提问
> 分析这个项目的结构和主要功能
场景 2:让 AI 写代码
iflow
> 创建一个 Python 脚本,计算斐波那契数列的前 10 项
场景 3:命令行辅助
iflow
> !ls -la
> 帮我分析这个目录结构,建议如何整理文件
核心概念速查表
| 术语 | 说明 | 示例 |
|---|---|---|
| 斜杠命令 | 以 / 开头的控制命令 | /help /init /clear |
| @ 引用 | 引用特定文件到对话中 | @src/App.tsx |
| $ 子代理 | 调用专业子代理执行任务 | $code-reviewer |
| ! Shell 命令 | 在 CLI 中执行系统命令 | !npm install |
| yolo 模式 | 自动执行所有操作,无需确认 | 启动时选择 |
| MCP | 模型上下文协议,扩展 AI 能力 | 接入外部服务 |
| context left | 右下角显示剩余上下文长度 | 监控对话容量 |
常用命令一览
| 命令 | 功能 | 使用场景 |
|---|---|---|
/help | 查看帮助文档 | 忘记命令时 |
/init | 分析项目结构 | 新项目开始时 |
/clear | 清空对话历史 | 上下文太长时 |
/exit | 退出 CLI | 结束工作 |
/auth | 重新登录 | 切换账号/密钥 |
!命令 | 执行系统命令 | 需要运行 shell 命令 |
实用技巧
💡 技巧 1:引用文件到对话
> @src/utils.js 这个文件的功能是什么?
💡 技巧 2:多步骤任务
> 帮我做以下事情:
> 1. 创建一个新的 React 组件 UserCard
> 2. 添加样式文件
> 3. 在 App.js 中引入并使用
💡 技巧 3:代码审查
> $code-reviewer 审查 src/api.js 的安全性
💡 技巧 4:联网搜索
> 搜索 React 19 的最新特性
常见问题解决
❓ 安装失败
# 检查 Node.js 版本(需要 22+)
node --version
# 检查网络连接
curl -I https://apis.iflow.cn/v1
❓ 认证失败
- 检查 API Key 是否正确复制(注意空格)
- 确认网络连接正常
- 尝试重新生成 API Key
❓ 命令无响应
- 按
Ctrl+C中断当前操作 - 运行
/clear清空上下文 - 重启 CLI:
/exit后重新运行iflow
❓ 自动更新失败
# 手动更新
npm i -g @iflow-ai/iflow-cli@latest
# 如果还是失败,卸载重装
npm uninstall -g @iflow-ai/iflow-cli
npm i -g @iflow-ai/iflow-cli@latest
适用场景
✅ 日常开发
- 快速生成样板代码
- 重构和优化现有代码
- 解释复杂代码逻辑
✅ 学习新技术
- 查询最新技术文档
- 生成学习示例
- 解答技术问题
✅ 调试和修复
- 分析错误日志
- 定位 Bug 根源
- 生成修复方案
✅ 自动化任务
- 批量文件处理
- 自动化脚本生成
- 项目初始化配置
开始你的 AI 编程之旅
现在就试试吧!只需要 5 分钟:
# 1. 安装
npm i -g @iflow-ai/iflow-cli@latest
# 2. 启动
iflow
# 3. 登录并选择模型
# 4. 开始对话
> 你好,帮我分析一下当前目录
更多资源:
让 AI 成为你的编程伙伴,提升 10 倍开发效率! 🚀