跳到主要内容

快速开始

目标：5分钟内完成 iFlow CLI 的安装、配置并运行第一个AI辅助任务
前置条件：基本的终端操作经验
您将学到：安装iFlow CLI、设置API密钥、执行基础命令

iFlow CLI 是一款终端AI助手，可以分析代码、执行编程任务、处理文件操作。本指南帮您快速上手核心功能。

核心概念（30秒了解）​

术语说明
iFlow CLI基于终端的AI助手工具
斜杠命令以 / 开头的控制命令（如 /init、/help）
@文件引用 @文件路径(如@src/App.tsx)
$以$开头执行某个subagent(如$code-reviewer)
Shell命令以 ! 开头，可在CLI中执行系统命令
yolo默认允许CLI执行所有操作的执行模式
MCP模型上下文协议，用于扩展AI能力的服务器系统
Sub Agent智能Agent系统,适用于执行不同专业的任务
Sub Command命令行扩展
context leftCLI右下角的提示信息，代表模型在对话过程中剩余的上下文长度

💡 更多术语：查看完整的 术语词汇表 了解所有概念定义

第1步：安装（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

1. 访问 https://nodejs.org/zh-cn/download 下载最新的 Node.js 安装程序
2. 运行安装程序来安装 Node.js
3. 重启终端：CMD(Windows + r 输入cmd) 或 PowerShell
4. 运行 `npm install -g @iflow-ai/iflow-cli@latest` 来安装 iFlow CLI
5. 运行 `iflow` 来启动 iFlow CLI

验证安装：运行 iflow --version 确认安装成功

第2步：首次设置（1分钟）​

获取API密钥​

  1. 访问 iFlow 设置页面
  2. 点击"重置"生成API密钥
  3. 复制生成的密钥

启动并配置​

iflow
# 首次启动会提示输入API密钥，粘贴刚才复制的密钥

第3步：运行第一个任务（2分钟）​

方式A：项目分析​

# 在任意代码项目目录下
cd your-project/
iflow
> /init
> 分析这个项目的结构和主要功能

方式B：简单任务​

iflow
> 创建一个Python脚本，计算斐波那契数列的前10项

方式C：Shell命令辅助​

iflow
> !ls -la
> 帮我分析这个目录结构，建议如何整理文件

常用命令速查​

命令功能示例
/help查看帮助/help
/init分析项目结构/init
/clear清空对话历史/clear
/exit退出CLI/exit
!命令执行系统命令!npm install

故障排除​

安装问题​

# 检查Node.js版本
node --version  # 需要 22+

# 检查网络连接
curl -I https://apis.iflow.cn/v1

认证问题​

  • 确保API密钥正确复制（无多余空格）
  • 检查网络连接是否正常
  • 重新生成API密钥并重试

命令不响应​

  • 使用 Ctrl+C 中断当前操作
  • 运行 /clear 清空上下文
  • 重启CLI：/exit 后重新运行 iflow

下一步学习​

完成快速开始后，推荐按以下顺序深入学习：

  1. 基础操作 - 掌握日常使用技巧（10分钟）
  2. 交互模式 - 学习高效交互方式（15分钟）
  3. MCP扩展 - 扩展AI能力（15分钟）
  4. 最佳实践 - 提升工作效率（20分钟）

获得帮助：遇到问题？查看 完整文档 或 提交反馈