クイックスタート
このページでは、ゼロから zqagent をインストールして実行し、最初の会話を完了するまでを案内します。
コマンドラインを使いたくない場合はデスクトップアプリをご覧ください。インストーラーをダウンロードすれば GUI で使えます。
インストール
3 つのプラットフォームすべてに依存関係不要の実行パッケージがあり、Node を事前にインストールする必要はありません。お使いのシステム向けのダウンロードはこちらです：
未能识别你的系统。 请从下面选择对应平台的安装包。
不确定选哪个？第一个通常就对了。
Linux と macOS では 1 行のコマンドでもインストールできます（自動起動も登録されます）：
curl -fsSL https://agent.cd-zq.com/install.sh | shNode.js 18+ がある場合は npm でもインストールできます：
# グローバルインストール（公共 npm に公開済み。追加のレジストリ設定は不要）
npm i -g @zqagent/coreインストール後、zqagent を実行して CLI を起動します。
バージョンチャネル（安定版 / テスト版）の選択、システム要件、インストール問題の調査は インストール をご覧ください。
LLM への接続
起動後に .env を手書きする必要はありません。/connect と入力すると対話式で LLM 接続を設定できます：
- provider を選択（OpenAI / DeepSeek / Qwen / Zhipu GLM / Kimi / Xiaomi MiMo / カスタム）
- API Key を入力
- モデル一覧を自動更新して選択（対話モデルが先頭。ベクトル/音声/画像/専用チャネル などの非対話モデルは ⚠️ 付きで末尾に並びます）
- セルフチェック：最小リクエストを実際に送信し、このエンドポイントでモデルが使えるか確認。通らなければ理由を表示して再選択を促します
- 推論の強度を設定
API Key は AES-256-GCM で暗号化され、本機の ~/.config/zqagent/ に保存されます。平文でディスクに残りません。
対話できないモデルを選ぶと、ゲートウェイは通常
Required parameter(s) missing or invalidとだけ返し、 問題の箇所が分かりません。上記の並び替えとセルフチェックは、最初の会話ではなく設定段階で 気づけるようにするためのものです。調査方法はよくある質問をご覧ください。
ローカル開発
# 依存関係をインストール
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 の使い方 をご覧ください。