安装与首次对话
本页只保留第一次成功使用 Mogick 所需的主路径。PATH、权限、Windows 文件占用等失败分支见安装与启动排查。
安装
运行对应平台的一键安装命令：
powershell
# Windows (PowerShell)
iwr https://releases.tongyuan.cc/mogick/install.ps1 -UseBasicParsing | iex通过以下命令验证安装，只要能看到版本，就说明已经安装成功。
bash
mogick version # 显示版本号正常输出类似：
mogick version <版本号>登录认证
运行以下命令，通过 OAuth 设备码完成登录：
bash
mogick setup执行后按以下流程完成：
- 终端显示一条 URL 和一次性设备码，提示在浏览器中打开。
- 在浏览器中打开该 URL，输入设备码，登录你的账户并授权。
- 授权成功后终端自动检测并写入认证凭据到
<config-dir>/auth.json。 - setup 会补齐官方 Provider 和缺失的默认/轻量模型设置；保留已有 Provider 与显式模型选择，并在初始化或补齐配置时保存。
授权完成时间取决于网络和登录流程。Access Token 过期时会尝试自动刷新；授权失效或刷新失败时，重新运行 mogick setup。
如果 setup 无法完成，请转到认证排查。
在项目中启动
bash
cd <your-project>
mogickMogick 使用启动时的当前目录作为工作区。进入 TUI 后发送：
text
Explain the structure of this project.看到模型回复、文件读取或工具结果，即表示安装、认证和首次对话全部成功。
也可以使用 run 子命令执行一次性 prompt：
bash
mogick run "Please help me analyze this code"认识最少操作
| 操作 | 作用 |
|---|---|
Enter | 发送消息 |
Shift+Enter / Alt+Enter / Ctrl+J | 输入换行；Ctrl+Enter 取决于终端支持 |
Esc | 运行中请求停止；有面板时优先处理面板操作 |
Ctrl+C | 连按两次退出；输入框有可复制选区时优先复制 |
Shift+Tab | 切换 Plan / Agent 模式 |
Ctrl+P | 打开命令面板 |
/models | 查看或切换模型 |
继续阅读 TUI 快速上手。完整命令和配置不需要在第一次使用时掌握，可按需查看参考文档。
切换账号见退出登录与切换账号。截图输入和思考档位见文件与图片及思考程度。
路径占位符 <config-dir>、<db-path> 指当前 profile/通道实际生效的路径，见数据目录。