什么是 iFlow CLI
iFlow CLI 是一款强大的终端AI助手，专为开发者设计。它可以分析代码、执行编程任务、处理文件操作，成为你开发过程中的智能伙伴。基于最新的2025年版本，iFlow CLI 提供了更加完善的功能和更优秀的用户体验。
核心概念快速了解
在开始使用之前，先了解一些基本术语：
| 术语 |
说明 |
| iFlow CLI |
基于终端的AI助手工具 |
| 斜杠命令 |
以 /开头的控制命令（如/init、/help） |
| @ |
文件引用 @文件路径(如 @src/App.tsx) |
| $ |
以 $开头执行某个subagent(如$code-reviewer) |
| Shell命令 |
以 !开头，可在CLI中执行系统命令 |
| yolo |
默认允许CLI执行所有操作的执行模式 |
| MCP |
模型上下文协议，用于扩展AI能力的服务器系统 |
| Sub Agent |
智能Agent系统,适用于执行不同专业的任务 |
| context left |
CLI右下角的提示信息，代表模型在对话过程中剩余的上下文长度 |
第1步：安装 iFlow CLI
系统要求
- Node.js 20+
- 4GB+ 内存
- 互联网连接
快速安装
macOS/Linux 系统
1
2
3
4
5
|
bash -c "$(curl -fsSL https://gitee.com/iflow-ai/iflow-cli/raw/main/install.sh)"
npm i -g @iflow-ai/iflow-cli@latest
|
Windows 系统
1
2
3
4
5
6
7
8
|
npm install -g @iflow-ai/iflow-cli@latest
iflow
|
推荐使用 Windows Terminal：为了获得更好的兼容性和使用体验，强烈推荐使用 Windows Terminal 运行 iFlow CLI，可以大幅减少环境兼容性问题。
验证安装
第2步：登录和设置
启动 iFlow CLI
选择登录方式
iFlow CLI 支持三种登录方式，不同方式提供的功能有所差异：
🌟 方式一：Login with iFlow 登录（强烈推荐）
强烈推荐使用 Login with iFlow 方式登录心流平台，享受最完整的功能体验：
完整功能支持：
- WebSearch 服务：智能网络搜索，获取最新信息
- WebFetch 服务：网页内容抓取和分析
- 多模态能力：内置图像理解等多模态功能
- 工具调用优化：心流平台提供的模型经过专门优化，工具调用更加精准高效
最佳使用体验：
- 自动续期：令牌自动刷新，永不过期
- 无缝连接：一次授权，持续使用
登录步骤：
- 运行
iflow 后选择 “Login with iFlow” 登录
- CLI 会自动打开浏览器跳转到心流平台
- 完成注册/登录后授权 iFlow CLI
- 自动返回终端，开始使用
方式二：心流 API Key 登录
适用场景：服务器环境或无浏览器访问的场景
功能支持：与第一种登录相同，享受心流平台的完整功能（WebSearch、WebFetch、多模态、工具调用优化等）
注意事项：API Key 有效期为 7 天，需定期更新
登录步骤：
- 访问心流官网完成注册
- 在用户设置页面生成 API KEY
- 在 iFlow CLI 中选择 API Key 登录并输入密钥
方式三：OpenAI Compatible API
适用场景：使用自有模型服务或其他兼容 OpenAI 协议的服务
功能限制：
- 不支持 WebSearch 服务
- 不支持 WebFetch 服务
- 不支持心流平台的内置多模态能力
- 无法享受心流平台模型的工具调用优化
配置步骤：
- 选择 “OpenAI Compatible API” 选项
- 输入服务端点 URL
- 输入对应的 API Key
选择模型
登录成功后，选择一个心仪的大模型就可以开始使用了。
第3步：运行第一个任务
方式A：项目分析
1
2
3
4
5
|
cd your-project/
iflow
> /init
> 分析这个项目的结构和主要功能
|
方式B：简单任务
1
2
| iflow
> 创建一个Python脚本，计算斐波那契数列的前10项
|
方式C：Shell命令辅助
1
2
3
| iflow
> !ls -la
> 帮我分析这个目录结构，建议如何整理文件
|
常用命令速查
基础控制命令
| 命令 |
功能 |
示例 |
/help |
查看帮助 |
/help |
/init |
分析项目结构 |
/init |
/clear |
清空对话历史 |
/clear |
/exit |
退出CLI |
/exit |
/auth |
重新认证 |
/auth |
系统命令执行
1
2
3
4
5
6
7
|
!npm install
!ls -la
!git status
!npm run build && npm run test
|
文件引用
1
2
3
4
5
|
@src/App.tsx 分析这个React组件
@package.json @src/index.js 分析项目入口
|
Sub Agent 调用
1
2
3
4
5
|
$code-reviewer 审查这段代码的质量
$general-purpose 帮我研究这个技术问题
|
高级功能
1. 项目上下文理解
iFlow CLI 能够自动分析项目结构，识别技术栈：
1
2
3
4
5
|
/init
这个项目用了什么技术栈？主要功能是什么？
|
2. 智能代码生成
根据项目上下文生成符合规范的代码：
1
2
3
4
5
6
7
8
|
创建一个用户管理的React组件，包含增删改查功能
创建一个用户登录的Express路由
为utils.js创建完整的单元测试
|
3. 代码分析和重构
1
2
3
4
5
6
7
8
|
分析这段代码的性能问题和安全风险
帮我重构这个函数，使其更加简洁高效
将项目中所有的console.log替换为logger.info
|
4. 文档生成
1
2
3
4
5
6
7
8
|
为这个模块生成详细的API文档
为这个项目生成完整的README文件
为这个函数添加详细的JSDoc注释
|
自动更新
iFlow CLI 在启动时会检测是否有最新版本，会自动更新。
手动更新
如果自动更新失败，可以手动更新：
1
2
3
4
5
|
npm i -g @iflow-ai/iflow-cli@latest
iflow -v
|
卸载重新安装
如果手动更新也失败，需要卸载并重新安装：
1
2
3
4
5
6
7
8
|
npm uninstall -g @iflow-ai/iflow-cli
iflow -v
npm i -g @iflow-ai/iflow-cli@latest
|
故障排除
安装问题
1
2
3
4
5
|
node --version
curl -I https://apis.iflow.cn/v1
|
认证问题
- 确保API密钥正确复制（无多余空格）
- 检查网络连接是否正常
- 重新生成API密钥并重试
命令不响应
- 使用
Ctrl+C 中断当前操作
- 运行
/clear 清空上下文
- 重启CLI：
/exit 后重新运行 iflow
最佳实践
1. 项目初始化
1
2
3
4
5
6
7
|
cd your-project
iflow
> /init
> 分析项目结构并生成文档
|
2. 复杂任务分解
1
2
3
4
5
6
7
8
|
我需要重构这个项目：
1. 分析现有代码结构
2. 识别需要改进的地方
3. 制定重构计划
4. 逐步实施重构
5. 添加测试
6. 更新文档
|
3. 安全操作
1
2
3
4
5
|
> 在重构前创建当前状态的备份
> 确认要删除这些文件吗？
|
4. 上下文管理
1
2
3
4
5
|
/clear
@src/long-file.js 分析这个文件
|
进阶技巧
1. 自定义工作流
1
2
3
4
5
6
|
创建一个React组件的标准模板，包含：
- TypeScript类型定义
- 基础样式
- 单元测试
- Storybook故事
|
2. 多项目协作
1
2
|
@project-a/package.json @project-b/package.json 比较这两个项目的依赖差异
|
3. 性能优化
1
2
3
4
5
|
只在src目录下搜索性能问题
@src/utils/performance.js 优化这个文件的性能
|
总结
iFlow CLI 是一个功能强大的智能终端助手，通过本文的介绍，你已经掌握了从安装到高级使用的完整流程。关键要点：
- 推荐使用 “Login with iFlow” 登录方式，获得完整功能体验
- 善用斜杠命令（
/init、/help、/clear）提高效率
- 利用文件引用（@文件路径）进行精确分析
- 定期清理上下文保持良好性能
- 将复杂任务分解为小步骤逐步完成
随着使用经验的积累，你会发现更多实用功能。建议定期查看官方文档了解最新功能更新，让 iFlow CLI 成为你的开发利器。
记住，iFlow CLI 的最大优势在于理解项目上下文和遵循代码规范，合理使用这些特性将让你的开发工作更加高效和愉快。
