快速開始
本頁帶你從零開始安裝並執行 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 使用。