快速开始
本页带你从零开始安装并运行 zqagent，完成第一次对话。
不想用命令行？直接看桌面应用，下载安装包即可图形化使用。
安装
三个平台都提供零依赖的运行包，不需要预装 Node。下面是给您当前的系统准备的下载：
未能识别你的系统。 请从下面选择对应平台的安装包。
不确定选哪个？第一个通常就对了。
Linux 与 macOS 也可以用一行命令安装（自动注册开机自启）：
bash
curl -fsSL https://agent.cd-zq.com/install.sh | sh已有 Node.js 18+ 时，也可以用 npm 安装：
bash
# 全局安装（发布在公共 npm，无需配置额外软件源）
npm i -g @zqagent/core装好后运行 zqagent 启动 CLI。
需要选择版本通道（稳定版 / 测试版）、查看系统要求或排查安装问题，见 安装。
连接 LLM
启动后无需手动写 .env，输入 /connect 即可交互式配置 LLM 连接：
- 选择 provider（OpenAI / DeepSeek / 通义千问 / 智谱 GLM / Kimi / 小米 MiMo / 自定义）
- 输入 API Key
- 自动刷新模型列表并选择模型（对话模型排在前面；向量/语音/图像/专用通道 等非对话模型标了 ⚠️ 并排到末尾）
- 自检：真发一条最小请求确认该模型在这个端点上可用，不通会提示原因并让你重选
- 设置推理强度
API Key 会 AES-256-GCM 加密保存到本机 ~/.config/zqagent/，不会明文落盘。
选到不能对话的模型时，网关通常只回一句
Required parameter(s) missing or invalid， 看不出问题在哪——上面的列表排序与自检就是为了让你在配置阶段而不是第一次对话时 发现它。排查办法见常见问题。
本地开发
bash
# 安装依赖
pnpm install
# 配置环境变量（复制为 .env 后填写），或启动后直接 /connect
# OPENAI_API_KEY=sk-... # 必填（未用 /connect 时）
# OPENAI_MODEL=你的模型名 # 可选，不设则启动后 /connect 选择
# OPENAI_BASE_URL=... # 可选，自定义端点
# WORKSPACE=./ # 可选，工作区根目录，默认当前目录
cp .env.example .env
# 启动 CLI
pnpm run dev第一个任务
启动后进入交互式 CLI，直接输入自然语言任务即可，例如：
> 帮我在当前目录初始化一个 TypeScript 项目它会自动规划并调用工具完成任务。默认运行在 交互模式，有副作用的操作会弹出审批卡片等你确认。
更多命令、运行模式与审批细节见 CLI 使用。